Sections Object

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.

Adding a new section

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

Properties

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.

Methods

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.