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, (see Program Data Path \Libraries). Unfortunately, v.11.0 and lower requires the user to file a Bentley Case mentioning this WIKI and request an a given .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.

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:

0. Close all instances of AutoPIPE

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. Open AutoPIPE's installation folder and search for program called: "build.exe", copy this program into the same folder where the modified SRC file is located.

14. Run the program "build.exe" (ex. double click the file, from the CMD line, etc..) 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's Program Data Path

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.

1. STANDARD PIPE DATA Section:

* Decimal located at column position

Note: Row 1 ends in col. 8

Row 2 ends in col. 8

Row 4 to last ends in col. 26

1. INSULATION MATERIALS Section:

* Decimal located at column position

Note: Row 1 ends in col. 3

Row 2 ends in col. 34

1. STANDARD VALVE/TYPE DATA Section:

* Decimal located at column position

Note: Row 1 ends in col. 10

Row 2 ends in col. 8

Row 3 to last ends in col. 54

1. STANDARD FLANGE/TYPE DATA Section:

* Decimal located at column position

Note: Row 1 ends in col. 10

Row 2 ends in col. 8

Row 3 to last ends in col. 45

1. LARGE DIA FLANGE SERIES B Section:

* Decimal located at column position

Note: Row 1 ends in col. 10

Row 2 ends in col. 8

Row 4 to last ends in col. 45

1. FLUID PROPERTIES - BULK MODULUS AND SP. GR. Section:

* Decimal located at column position

Note: Row 1 ends in col. 12

Row 2 ends in col. 21

Trouble shooting notes:

1. The most common problems are due to format. As suggested above, move to the correct section in the SRC file, select & copy the first entry, and insert/paste directly below it. Change the text editor to overstrike mode, move to the different locations (keyboard arrows or mouse) and update the data as required. This will overwrite the original data with new information preserving the format. Try to maintain column alignment.
2. Add one component at a time; verify the compiled library in AutoPIPE before adding more entries. Another words, get the format and process down before mass producing.
3. Ensure only the last entry starts in each section starts with an “*” mark.
4. When hesitant, start with a fresh copy of the SRC file and try again.
5. Updating / Editing the libraries can only be done in English units. AutoPIPE makes the conversion to metric units base on the units file. Euro code is completely different and can only be updated with metric units.
6. If you cannot get your file to work correctly, please send the SRC file and LIB to Bentley TSG for review. Be sure to include specific details on what is not functioning correctly.

Remember, being a custom library, Bentley cannot be held responsible for the inaccuracy of the new library content. It is your responsibility to verify the following information:

1. 1.  Verification of data in the SRC file

   2.  Verification of data in the Press / Temp. dialog

   3.  Verification of relevant data in the Pipe Properties dialog

See Also

Libraries - AutoPIPE

Bentley AutoPIPE