Download as pdf or txt
Download as pdf or txt
You are on page 1of 10

AutoPIPE Material Library Explained

685 Stockton Drive Exton, PA 19341


Tel: (610) 458-5000, www.Bentley.com

SNIP-97: LIB and SRC files

Date:02/20/2012
Page 1 of 10
Created by:
Mike Dattilio

AutoPIPEs material libraries can be viewed and modified to include custom materials or update existing 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 SNIP-97.LIB and SNIP-97.SRC 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 AutoPIPEs 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 AutoPIPEs 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.
If you would like your material added to a future version of AutoPIPE, please send your SRC file with PDFs 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: SNIP-97.LIB
new name: Snip_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. When installing the application all default files are installed/overwritten. In an
effort to save your modifications and to ensure youre using the correct material values, use a copied
file of the original with a personalized filename whos values have been modified to your satisfaction
2. The moment any 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 data in the Press / Temp. dialog

Verification of relevant data on the Pipe Properties dialog.

AutoPIPEs SNIP material library is one file with data in 2 sections: Material & Specification.
MATERIAL Section
This section contains general information about the material (i.e. Composition Code, Density, Poisson Ratio) and
tabulated data (i.e. Temp vs Thermal Expansion vs Youngs Modulus) 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

Date:02/20/2012
Page 2 of 10

AutoPIPE Material Library Explained

Created by:
Mike Dattilio

SNIP-97: LIB and SRC files

685 Stockton Drive Exton, PA 19341


Tel: (610) 458-5000, www.Bentley.com

2. AutoPIPE Viewer appears with the SNIP-97.lib Material section, excerpt shown below:

Note: The above document is only the Material part of the SRC file. Here you can review the
Material Group values programmed, units used, and column headings.
3. The SNIP-97.SRC file can be opened with any text editor. The STANDARD MATERIAL PROPERTIES starts on line
38 (or perform a search MATL) and then scroll down below the table programming lines to see the Material
entries. Excerpt from the SNIP-97 SRC file (line 184) is shown below with explanations of each value:
Material Group:

Total # of rows

# of columns
Density

Max = 74

# of rows used

Poissons Ratio

Description:

Composition code

Mechanical

Temperature:

Youngs (hot) Modulus


Thermal Expansion

Only relevant to SPC & TBK5-6


codes.
Default = 1
0 = Other
1 = Carbon
2 = Austenitic SS
3 = High Nickel Alloy
4 = Martensitic SS
5 = low Alloy Steel
6 = nickel-Copper

Note: The SRC values may be rounded off when compared to the LIB or application values.

AutoPIPE Material Library Explained


685 Stockton Drive Exton, PA 19341
Tel: (610) 458-5000, www.Bentley.com

SNIP-97: LIB and SRC files

Date:02/20/2012
Page 3 of 10
Created by:
Mike Dattilio

SPECIFICATION Section
This section contains information about the specific material (i.e. Material, Yield Strength, Ultimate Strength, & Dia
restrictions) with tabulated data (i.e. Temp vs Yield Strength) 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 SNIP-97 .lib Specs section, excerpt shown below:

Note: The above document is only the Spec part of the SRC file. Here you can review the
Material Group values programmed, units used, and column headings.

AutoPIPE Material Library Explained

Created by:
Mike Dattilio

SNIP-97: LIB and SRC files

685 Stockton Drive Exton, PA 19341


Tel: (610) 458-5000, www.Bentley.com

Date:02/20/2012
Page 4 of 10

3. The SNIP-97.SRC file can be opened with any text editor. The ANSI XXXX SPECIFICATIONS starts on line 211 of
the original file or perform a search for SPEC, and then scroll down below the table programming lines to see
the Specific code material entries.
The following is an example of a CODE dependant material entry (SPEC) for B31.1 (SNIP-97.SRC) library with
explanations of each value:
Total # of rows
Material ID

Material
Group

# of columns

Description

Yield Strength
Ultimate Strength

# of rows
used

Not used
Allowable
Wall Thickness

Minimum Dia.
Maximum Dia.

Temperature

Note:
1. The Specification data is connected to the Material data by Material Group name, the name must be
exactly as shown on the MATL table for the link to work.
2. If your material has different values based upon Wall thickness (i.e. 10_D153), add additional lines of data to
the specification section for the program to consider when populating the dialog screens. Example, material
has different data for <6.0 mm:

AutoPIPE Material Library Explained


685 Stockton Drive Exton, PA 19341
Tel: (610) 458-5000, www.Bentley.com

SNIP-97: LIB and SRC files

Date:02/20/2012
Page 5 of 10
Created by:
Mike Dattilio

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.
Again, SNIP-97 library is broken into 2 sections: Material & Specification. Each of these sections starts with lines of table
programming information, followed by detailed data on individual materials available when selecting this library in
AutoPIPE.
Example: shown below is the Material section (left) & Specification section (right) with column headers,
followed by table programming lines, and the first material (CS) /specification (St2sp), respectively.

Note:
1. The last entry in each section starts with an * symbol before the material name. This * signifies the last
entry in each section and is very import that it only occurs once. In the original SRC file, this occurs on lines:
178 for CS and 4843 for 15GS.

AutoPIPE Material Library Explained


685 Stockton Drive Exton, PA 19341
Tel: (610) 458-5000, www.Bentley.com

SNIP-97: LIB and SRC files

Date:02/20/2012
Page 6 of 10
Created by:
Mike Dattilio

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 cursors position).
3. Move to the correct section (i.e. Material or Specification).
Example: Material
4. Scroll down to the first entry
Example: CS
5. Select the entire entry
Example: Select from lines 178 - 220, include all rows before next entry or in this case before SPEC.
6. Copy the selection
7. Move cursor to the beginning of the next entry.
Example: Spec (line 221, 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. (Remember to remove * from line 178)
11. Refer to information above for details on lines of data (what does this value mean?)
NOTE: be vigilant not to add extra spaces, change column alignment, use correct unit values, verify group
material name entry in Spec table match that in the MATL table, and confirm row count.
12. When your modifications are completed, save the file, and close the text editor.
Example: save file name is B311_new.SRC
13. Copy new SRC file to following folder: C:\Bentley\AutoPIPE V8i SELECTseries\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: SNIP_NEW
16. IF the file is correctly formatted, a new file will be created in the same folder.
Example: SNIP_NEW.LIB
17. Copy new library file to AutoPIPE folder: C:\Bentley\AutoPIPE V8i SELECTseries
18. Start AutoPIPE, open model, change material library (Tools> model options> General>) to new LIB file
Example: SNIP_NEW
19. Open the Pipe properties tab on the input grid, select the new material that was added and verify the values
returned are correct as entered in the new LIB file.
20. Open PRESS/TEMP/PipeID tab on the input grid; verify values returned are correct as entered in the new LIB
file. Change Temperature to confirm values are correctly updated as expected.
21. If any value is wrong, close AutoPIPE, open the SRC file, repair the problem, and repeat steps 12-21 again.

AutoPIPE Material Library Explained


685 Stockton Drive Exton, PA 19341
Tel: (610) 458-5000, www.Bentley.com

SNIP-97: LIB and SRC files

Date:02/20/2012
Page 7 of 10
Created by:
Mike Dattilio

AutoPIPE Dialog Screenshots Pipe Properties and Press/Temp/PipeID input grid


Verify your new LIB file by specifying the Product Group, Source, Pipe Material, & Lifetime Hrs and confirming the
values as shown below (suggest using multiple temperatures to thoroughly review the results) :

Material ID
Youngs Modulus
Calculated

Yield Strength

Density
Ultimate Strength
Poissons Ratio

Material ID

Thermal Expansion
Temperature

Note: The dialog values correspond to Matl & Spec library data.

Youngs Modulus

Date:02/20/2012
Page 8 of 10

AutoPIPE Material Library Explained

Created by:
Mike Dattilio

SNIP-97: LIB and SRC files

685 Stockton Drive Exton, PA 19341


Tel: (610) 458-5000, www.Bentley.com
Appendix:

This table provides details of the SRC data location and length of space available to input values.
Material Section:
Tag Name
Material Group
Description
# of Rows used
Total # of rows
# of columns
Composition code
Density
Poissons ratio

Temperature
Thermal expansion
Youngs Modulus

Row
1
2
2
2
2
2
2
2
Table
4 last entry
4 last entry
4 last entry

Start
(Colum Position)
2
2
22
25
29
32
38 *
43 *

6*
10 *
22*

Tag width
12
18
2
2
2
1
6
6

Units

kg/m3

5
8
9

Deg C
mm/m
E3 MPa

Tag width

Units

12
12
20
2
2
2
2
6
6
6

MPa
MPa
Mm

* Decimal located at column position


Note: Row 1 ends in col. 13
Row 2 ends in col. 48
Row 3 ends in col. 6
Row 4 to last ends in col. 24
Specifications:
Tag Name

Row

Material Id
Material Group
Description
# of Rows used
Total # of rows
# of columns
Not Used
Yield Strength
Ultimate Strength
Min Pipe Diameter

1
2
2
2
2
2
2
2
2
2

Start
(Col Position)
2
2
16
38
42
47
51
57 *
64 *
72 *

Date:02/20/2012
Page 9 of 10

AutoPIPE Material Library Explained

Tag Name

Row

Max Pipe diameter


Blank line
Wall Thickness

2
3
4

Temperature
Yield Strength

Created by:
Mike Dattilio

SNIP-97: LIB and SRC files

685 Stockton Drive Exton, PA 19341


Tel: (610) 458-5000, www.Bentley.com

Table
5 last entry
5 last entry

Start
(Col Position)
79 *

Tag width

Units

mm

6 **

mm

6*
12*

5
6

Deg C
MPa

* Decimal located at column position


** Decimal located at column position. However, this row indicates the wall thickness for the specified
material. You can have different tabulated values based on wall thickness. Each new table is
proceeded with the wall thickness row, with the last wall thickness row starting with an *. See
example above.
Note: Row 1 ends in col. 13
Row 2 ends in col. 81
Row 3 ends in col. 1
Row 4 ends in col. 8
Row 5 - last ends in col. 15

Important
Because of constant updates to the program (i.e. format changes, updated values, etc..), default or customized
SRC library files should only be used with a specific version of AutoPIPE. The default SRC files in the Libraries
folder ( C:\ Bentley \AutoPIPE V8i SELECTseries \Libraries) can be used with that specific version. Please log a
Bentley Service Request if you require other SRC files. Be sure to mention what version of AutoPIPE the
customized library is to be used for (help> About > 8 digit number).
Example:
Do not use a customized library (*.LIB) created from AutoPIPE V8i 09.06.01.11 SRC file in
AutoPIPE XM 08.06.00.12.

AutoPIPE Material Library Explained


685 Stockton Drive Exton, PA 19341
Tel: (610) 458-5000, www.Bentley.com

SNIP-97: LIB and SRC files

Date:02/20/2012
Page 10 of 10
Created by:
Mike Dattilio

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 material at a time; verify the compiled library in AutoPIPE before adding more entries. Another word,
get the format and process down before mass producing.
3. Ensure only the last entry starts in each section starts with an * mark.
4. Verify your # of rows used and Total # of rows have the correct values.
5. When hesitant, start with a fresh copy of the SRC file and try again.
6. Updating / Editing the MATL and SPEC 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.
7. 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 module, Bentley cannot be held responsible for the inaccuracy of the new library
content. It is your responsibility to verify the following information:
a. Verification of data in the SRC file
b. Verification of data in the Press / Temp. dialog
c. Verification of relevant data in the Pipe Properties dialog

You might also like