03a. How can I make updates to AutoPIPE's default component library?

	Applies To
	Product(s):	AutoPIPE
	Version(s):	2004, XM, V8i, CONNECT;
	Area:	Library
	Original Author:	Bentley Technical Support Group
	Date Logged & Current Version	Feb. 2016 10.00.00.10

Problem:

How can I make updates to AutoPIPE's default component library?

Solution:

AutoPIPE's component libraries can be viewed and modified to include custom data. A person viewing these files for the first time usually has a confusing expression. This document aims to clear up any confusion about the AutoPIPE.SRC and AutoPIPE.LIB files.

All modifications are performed in the "SRC" file. However, before a modified "SRC" file can be used within AutoPIPE, it must be compiled into a "LIB" file. Once compiled and placed into AutoPIPE's 12.01 and higher profile Program Data Path folder (11.04 and lower - place SRC files into AutoPIPE's main folder), only then can the new "LIB" file be used by the application for analysis purposes. Caution, one mistake (extra space, miss-aligned column, wrong value, etc..) in the "SRC" file can cause the modifications to not appear in the application or yield significantly wrong values to be used in AutoPIPE's calculations. Making modifications to the "SRC" file should be done by someone who is very meticulous and vigilant about maintaining format of each line in the file.

Note: Starting with AutoPIPE 12.01, the SRC files are now installed with AutoPIPE. Unfortunately, previous versions requires the user to file a Bentley Service Request here mentioning this WIKI and request an AutoPIPE.SRC file be sent to you. Be sure to include EXACTLY what Version of AutoPIPE (help > About> 8 digit number) will be used with the new library file.

If you would like your component added to a future version of AutoPIPE, please send your "SRC" file with PDF's highlighting all values used to compile it from reputable source (i.e. codes, material testing lab, etc..).

WARNING:

1. A good approach is to always copy an original file and rename it; example original name: AutoPIPE.LIB new name: Auto_new.lib (filename must be 8 characters or less). By renaming it you are flagging that it is a customized file. It is also a benefit to have a separate library file when you reloading or upgrading your version of AutoPIPE.

2. When a "LIB" file does not match the default "LIB" files installed with the application, it is considered a custom module. Being a custom module Bentley cannot be held responsible for the inaccuracy of the new library content. It is your responsibility to verify the following information:

- Verification of relevant data on the Pipe Properties dialog.

AutoPIPE’s “AutoPIPE” component library is one file with data in 6 sections:

1. STANDARD PIPE DATA

2. INSULATION MATERIALS

3. STANDARD VALVE/TYPE DATA

4. STANDARD FLANGE/TYPE DATA

5. LARGE DIA FLANGE SERIES B

6. FLUID PROPERTIES - BULK MODULUS AND SP. G

1. STANDARD PIPE DATA Section

This section contains general information about pipe sizes (i.e. Nominal diameter, Actual OD) and tabulated data (i.e. Schedule, Wall Thickness and Special OD) for each entry. A scan of this table can be viewed with the following instructions:

1. Start AutoPIPE, and select Tool> Library>

Press OK button

2. AutoPIPE Viewer appears with the AUTOPIPE.lib Pipe section, excerpt shown below:

3. The AUTOPIPE.SRC file can be opened with any text editor. The "STANDARD PIPE DATA " starts on line 2 (or perform a search "PIPE") and then scroll down below the table programming lines to see the entries. Excerpt from the AUTOPIPE "SRC" file (line 18) is shown below with explanations of each value:

Note: Corresponding units are visible at the top of the Library scan, shown above

2. INSULATION MATERIALS Section

This section contains general information about pipe insulation material (i.e. Material and Density). The only method of viewing this information from within the application is thru the pipe properties dialog screen using the following procedure:

1. With a model open, Insert / modify a pipe property to view this dialog

2. Select the down arrow to view all the existing insulation materials available in this particular library; excerpt shown below:

3. The AUTOPIPE.SRC file can be opened with any text editor. The "INSULATION MATERIALS " starts on line 722 (or perform a search "INSL") and then scroll down below the table programming lines to see the entries. Excerpt from the AUTOPIPE "SRC" file (line 737) is shown below with explanations of each value:

3. STANDARD VALVE/TYPE DATA Section

This section contains general information about valves (i.e. Type, Nominal dia) and tabulated data (i.e. Rating, Weight, Length, S.A. Factor) for each entry. A scan of this table can be viewed with the following instructions:

1. Start AutoPIPE, and select Tool> Library>

Press OK button

2. AutoPIPE Viewer appears with the AUTOPIPE.lib Valve section, excerpt shown below:

3. The AUTOPIPE.SRC file can be opened with any text editor. The "STANDARD VALVE/TYPE DATA " starts on line 761 (or perform a search "VLV1") and then scroll down below the table programming lines to see the entries. Excerpt from the AUTOPIPE "SRC" file (line 810) is shown below with explanations of each value:

Note: Corresponding units are visable at the top of the Library scan, shown above

4. STANDARD FLANGE/TYPE DATA Section

This section contains general information about Flanges (i.e. Type, Nominal dia) and tabulated data (i.e. Rating, Weight, Length) for each entry. A scan of this table can be viewed with the following instructions:

1. Start AutoPIPE, and select Tool> Library>

Press OK button

2. AutoPIPE Viewer appears with the AUTOPIPE.lib Flange A section, excerpt shown below:

3. The AUTOPIPE.SRC file can be opened with any text editor. The "STANDARD FLANGE/TYPE DATA " starts on line 2369 (or perform a search "FLTP") and then scroll down below the table programming lines to see the entries. Excerpt from the AUTOPIPE "SRC" file (line 2409) is shown below with explanations of each value:

Notes :

1. Corresponding units are visible at the top of the Library scan, shown above.

2. Because an AutoPIPE flange is modeled as a single point, Length = 0.000 (always).

5. LARGE DIA FLANGE SERIES B Section

This section is very similar to "STANDARD FLANGE/TYPE DATA Section" above with the only exception; larger nominal diameters with respective data. A scan of this table can be viewed with the following instructions:

1. Start AutoPIPE, and select Tool> Library>

Press OK button

2. The AUTOPIPE.SRC file can be opened with any text editor. The "STANDARD FLANGE/TYPE DATA " starts on line 4755 (or perform a search "FLNB") and then scroll down below the table programming lines to see the entries.

6. FLUID PROPERTIES - BULK MODULUS AND SP. GR. Data Section

This section contains general information about fluids used in fluid transient analysis (i.e. Fluid Name, Bulk modulus, Specific gravity). The only method of viewing this information from within the application is thru the Fluid Transient dialog screen using the following procedure:

1. With a model open, select Load> Fluid Transient… to view this dialog

2. Select the down arrow to view all the existing fluids available in this particular library; excerpt shown below:

Note: move slider down to view entire listing

3. The AUTOPIPE.SRC file can be opened with any text editor. The "FLUID PROPERTIES - BULK MODULUS AND SP. GR. Data " starts on line 722 (or perform a search "INSL") and then scroll down below the table programming lines to see the entries. Excerpt from the AUTOPIPE "SRC" file (line 737) is shown below with explanations of each value:

Note: Corresponding units are visable at the top of the Library scan, shown above

Modifying the SRC file

As indicated above, the SRC file can be opened by any text editor program. Recommend using a text editor that displays the current row and column location will be a great benefit (i.e. Ultra Edit, Notepad++, etc..) in maintaining column alignment and table format.

AutoPIPE.SRC library is broken into 6 sections where each of these sections starts with lines of table programming information, followed by detailed data on individual data available when selecting this library in AutoPIPE.

Example: shown below is the PIPE section (left) & INSULATION section (right) with column headers, followed by table programming lines, and the first entry (1/8 dia pipe) / (Asbestos), respectively.

Note:

The last entry in each section starts with an "*" symbol before the data. This "*" signifies the last entry in each grouping / section and is very import that it only occurs once.

Example 1:

Standard Pipe Data, "*" occurs after the last Nominal pipe size schedule (i.e Line 32, 50, 66, etc..) to signify the last schedule for each pipe size, and again at the last pipe size 36" (line 708) to signify the last entry in the section before Insulation Material.

Example 2:

Insulation Material, "*" only occurs once (line 759) to signify the last entry of insulation names before the valve data section.

Suggested procedure when adding entries:

1. Copy original SRC file to a new location and modify the filename (cannot exceed 8 characters).

2. Open new SRC file in a text editor (recommend using one with column and row info on cursor's position).

3. Move to the correct section (i.e. one the 6 different sections).

Example: Standard PIPE DATA

4. Scroll down to the first entry

Example: .0.125

5. Select the entire entry

Example: Select from line 18 - 33, to include all rows before next entry, 0.25

6. Copy the selection

7. Move cursor to the beginning of the next entry.

Example: 0.25 (line 34, col #1)

8. Paste copied selection from step 6.

9. Change from "Insert" mode to "Overwrite" mode in text editor.

10. Update copied data as required for new entry.

11. Refer to information above for details on the data entries (what does this mean?)

NOTE: be vigilant not to add extra spaces, change column alignment, use correct unit values.

12. When your modifications are completed, save the file, and close the text editor.

Example: save file name is "PIPE_new.SRC" (remember only 8 characters)

13. Copy new SRC file to following folder: C:\Bentley\AutoPIPE V8i SELECTseries3\Libraries

14. Open above folder location, double Left click on "build.exe" and the following will appear:

15. Enter name of new SRC file without the extension,

Example: PIPE_NEW

16. IF the file is correctly formatted, a new file will be created in the same folder.

Example: PIPE_NEW.LIB

17. Copy new library file to AutoPIPE folder: C:\Bentley\AutoPIPE V8i SELECTseries3

18. Start AutoPIPE, open model, change component library (Tools> Model options> General>) to new LIB file

Example: PIPE_NEW

19. Verify data is working correctly by opening respective dialogs required to check each of the 6 library sections (i.e. Pipe properties, Fluid transient, etc..), change the settings to confirm the data returned to greyed out fields are correct.

20. If any value is wrong, close AutoPIPE, open the SRC file, repair the problem, and repeat steps 12-20 again.

Appendix:

The following tables provide details of the “SRC” data location and length of space available to input values.

STANDARD PIPE DATA Section:

Tag Name	Row	Start (Colum Position)	Tag width	Units
Nominal Dia	1	4 *	6	Inch
Actual O.D.	2	4 *	6	Inch

	Table
Pipe Schedule	3 – last entry	2	3
Wall Thickness	4 – last entry	12 *	5	Inch
Special O.D.	4 – last entry	22 *	5	Inch