The Section object stores the data describing a single section within the sections library. Most of the properties in this object provide access to all of the geometric properties of the section that are used for analysis and design. Other properties store the sections name, its shape and details of it symmetry. The properties of the Section object are listed in the four tables shown below. The first two tables lists all the properties and method of the Section object that do not directly access the section properties of the section. The next table lists properties of the Section object that reference the dimensions of the section while the final table lists the properties for accessing the derived section properties of the section such as it’s area and moments of area.
|
Property |
Type |
Description |
|
Application |
Application |
Read Only. Returns a reference to the parent application. |
|
Index |
Long |
Read Only. Returns the index of the section in its parent group. |
|
Name |
String |
Gets/Sets the name of the section. |
|
Number |
Long |
Read Only. Same as Index. |
|
SectionGroup |
SectionGroup |
Read Only. Returns a reference to the parent group object. |
|
SectionsLibrary |
SectionsLibrary |
Read Only. Returns a reference to the parent sections library object. |
|
Shape |
mfSectionShape |
Read Only. Returns the shape of the section. |
|
SymmetricXX |
Boolean |
Read Only. Returns true if the section is symmetric about the x axis. |
|
SymmetricYY |
Boolean |
Read Only. Returns true if the section is symmetric about the y axis. |
|
Method |
Returns |
Description |
|
Compute |
|
Computes the properties of the section from its dimensions. |
|
Delete |
|
Deletes the section from the library. |
|
GetProperty |
Double |
Gets a section property. |
|
SetProperty |
|
Sets a section property. |
|
Property |
Description |
Enumerated Constant |
|
B |
Width |
MfSectionPropB |
|
b1 |
Secondary width |
MfSectionPropB1 |
|
b2 |
Tertiary width |
MfSectionPropB2 |
|
D |
Depth |
MfSectionPropD |
|
d1 |
Secondary depth |
MfSectionPropD1 |
|
d2 |
Tertiary depth |
MfSectionPropD2 |
|
r1 |
Primary Radius |
mfSectionPropR1 |
|
r2 |
Secondary Radius |
mfSectionPropR2 |
|
taper |
Taper angle |
mfSectionPropTaper |
|
tf |
Flange thickness |
mfSectionPropTf |
|
tw |
Web thickness |
mfSectionPropTw |
|
t1 |
Additional thickness |
MfSectionPropT1 |
|
t2 |
Additional thickness |
MfSectionPropT2 |
|
Property |
Description |
Enumerated Constant |
|
Area |
Gross area |
mfSectionPropArea |
|
Asx |
Shear area in x-plane |
MfSectionPropAsx |
|
Asy |
Shear area in y-plane |
MfSectionPropAsy |
|
C |
Torsion Modulus |
mfSectionPropC |
|
E |
Young’s Modulus |
mfSectionPropE |
|
G |
Shear Modulus |
mfSectionPropG |
|
H |
LRFD Polar property |
mfSectionPropH |
|
Iu |
Moment of inertia about major principle axis |
MfSectionPropIu |
|
Iv |
Moment of inertia about minor principle axis |
mfSectionPropIv |
|
Ix |
Moment of inertia about major axis |
mfSectionPropIx |
|
Ixy |
Product of inertia |
mfSectionPropIxy |
|
Iy |
Moment of inertia about minor axis |
mfSectionPropIy |
|
J |
Polar moment of Inertia |
MfSectionPropJ |
|
Mass |
Nominal Mass |
mfSectionPropMass |
|
Perimeter |
Length of perimeter |
mfSectionPropPerimeter |
|
ru |
Radius of gyration about major principle axis |
mfSectionPropRu |
|
rv |
Radius of gyration about minor principle axis |
mfSectionPropRv |
|
rx |
Radius of gyration about major axis |
mfSectionPropRx |
|
ry |
Radius of gyration about minor axis |
mfSectionPropRy |
|
R0 |
Polar radius of inertia about shear centre |
MfSectionPropR0 |
|
Sx |
Plastic Modulus about xx axis |
mfSectionPropSy |
|
Sy |
Plastic Modulus about yy axis |
mfSectionPropSy |
|
Su |
Plastic Modulus about major axis |
mfSectionPropSu |
|
Sv |
Plastic Modulus about minor axis |
mfSectionPropSv |
|
TanTheta |
Tangent of angle between principle axes and section axes |
mfSectionPropTanTheta |
|
Theta |
Angle between principle axes and section axes |
mfSectionPropTheta |
|
User1 |
User specified value |
MfSectionPropUser1 |
|
User2 |
User specified value |
MfSectionPropUser2 |
|
User3 |
User specified value |
MfSectionPropUser3 |
|
User4 |
User specified value |
MfSectionPropUser4 |
|
User5 |
User specified value |
MfSectionPropUser5 |
|
xc |
Position of centroid |
mfSectionPropXc |
|
xp |
Position of plastic axis |
mfSectionPropXp |
|
xs |
Position of shear centre |
mfSectionPropXs |
|
yc |
Position of centroid |
mfSectionPropYc |
|
yp |
Position of plastic axis |
mfSectionPropYp |
|
ys |
Position of shear centre |
mfSectionPropYs |
|
Zu1 |
Elastic modulus about the major principle axis for portion of the section in the positive v direction |
MfSectionPropZu1 |
|
Zu2 |
Elastic modulus about the major principle axis for portion of the section in the negative v direction |
MfSectionPropZu2 |
|
Zv1 |
Elastic modulus about the minor principle axis for portion of the section in the positive u direction |
MfSectionPropZv1 |
|
Zv2 |
Elastic modulus about the minor principle axis for portion of the section in the negative u direction |
MfSectionPropZv2 |
|
Zxb |
Elastic modulus about the major axis for the bottom portion of the section |
MfSectionPropZxb |
|
Zxt |
Elastic modulus about the major axis for the top portion of the section |
MfSectionPropZxt |
|
Zyl |
Elastic modulus about the minor axis for the left hand portion of the section |
MfSectionPropZyl |
|
Zyr |
Elastic modulus about the minor axis for the right hand portion of the section |
MfSectionPropZyr |
Note that the naming convention for the elastic and plastic section modulii do not follow the naming convention generally adopted in the United States. In the Multiframe automation interface, the elastic plastic modulus is denoted using a Z while the plastic section modulus is denoted using an S.
A new section may be added to a group using the AddSection method of the Sections collection. This method takes up to ten parameters that specify the shape, name and dimensions of the sections. The last four parameters are optional and specify additional dimensions of the section that are only required by the more complicated section shapes. An example of adding a new I section to the Frame group of the sections library is demonstrated in the following code.
Dim mySection as Multiframe.Section
Dim Name as String
’Add new I section, 600 deep and 300 wide
With mfApp.SectionsLibrary.Groups(“Frame”).Sections
Set mySection =.AddSection(mfSectionI,”600x300I”,600,300,10,10)
End With
A number of sections may also be added to a group within the section library using a single call to the AddSections method. This method takes the same parameters as the AddSection method except that the name and dimensions parameters may be arrays of values with each entry in the array corresponding to a new section to be created. If only a single value is specified for one of the parameters, this value will be adopted for all of the sections to be created. The AddSections method returns a SectionList object containing each of the new sections that have been added to the sections library.
Dim mySectList as Multiframe.SectionList
Dim Names(1 to 5) as string
Dim Widths(1 to 5) as double
Dim I as long
’ Generate names and width for sections
For I=1 to 5
Widths(I) = (I+1)*100.0
Names = “900x” & Str(Widths(I))
& ”I”
Next
’Add new I sections to Frame group
With mfApp.SectionsLibrary.Groups(“Frame”).Sections
Set mySectList =.AddSections(mfSectionI, Names,900, Widths,8,12)
End With
The name of the section is referenced via the Name property of the Section object. This property is a string that can be up to 31 characters long. The name of the section can also be accessed via the hidden Label property of the SectionGroup object
The Shape property is an enumerated value of type mfSectionShape that identifies the shape of the section. This enumerated type has values corresponding to each of the standard section shapes supported within Multiframe.
The SymmetricXX and SymmetricYY are Boolean properties of the Section object and return a value of true if the section is symmetric about the x or y axes respectively. These properties are derived from the shape of the section but if the shape is non-standard, the symmetry of the section will be determined from its section properties.
The SectionGroup, SectionsLibrary and Application objects return the parent objects containing the Section object.
The section properties of the section can also be accessed via the GetProperty method of the Section object. This method accepts a single parameter of type mfSectionProp that identifies the property of the section to be returned. The values of the properties may also be set using the SetProperty method. This method takes two parameters; the first identifies that section property and the second the new value of the section property.
The Compute method of the Section object calculates the section properties of the section from its shape and dimensions. This method will generally be called after adding a new section to the sections library. The example shown above for adding sections to the Frame group would generally be extended to compute the properties of the section as listed below.
Dim section as Multiframe.Section
Dim mySectList as Multiframe.SectionList
Dim Names(1 to 5) as string
Dim Widths(1 to 5) as double
Dim I as long
’Generate names and width for sections
For I=1 to 5
Widths(I) = (I+1)*100.0
Names = “900x” & Str(Widths(I))
& ”I”
Next
’Add new I sections to Frame group
With mfApp.SectionsLibrary.Groups(“Frame”).Sections
Set mySectList =.AddSections(mfSectionI, Names,900, Widths,8,12)
End With
’Compute properties of new sections
With each section in mySectList
.Compute()
End With
Locked Groups
A sections group may be set as locked in which case the properties of the group and the sections it contains cannot be modified. This prevents the user from inadvertently modifying data within groups containing standard sections.