manual de programación staad pro 2004

OpenSTAAD Reference Manual i

Table of Contents

Documentation for OpenSTAAD..............................................................................................1 Introduction...........................................................................................................................1 Programming Languages.......................................................................................................1 OpenSTAAD User Forum and Code Resource.....................................................................2 Application Program Interface (API) ....................................................................................3 Instantiating OpenSTAAD Library for Use ..........................................................................3 Function Return Value ..........................................................................................................4 STAAD Nomenclature..........................................................................................................5 OpenSTAAD Compatibility with STAAD.Pro ....................................................................5 OpenSTAAD Manual Organization......................................................................................6 Visual Basic Conventions .....................................................................................................6 Function List Organization....................................................................................................7

OpenSTAAD Functions – Results Object.................................................................................9 STAAD File I/O Functions ...................................................................................................9

SelectSTAADFile .............................................................................................................9 CloseSTAADFile ............................................................................................................11 AreResultsAvailable .......................................................................................................12 AnalyzeStructure.............................................................................................................14

Structure Geometry Functions ............................................................................................16 GetNodeCoordinates .......................................................................................................16 GetNodesCount ...............................................................................................................18 GetAllNodesCoordinates ................................................................................................19 GetNextNodeCoordinate.................................................................................................22 DoesNodeHaveSupport...................................................................................................25 GetNumberOfSupportedNodes .......................................................................................27 GetAllNodesThatAreSupported ......................................................................................28 RenumberNodes..............................................................................................................30 GetMemberIncidences ....................................................................................................32 GetMembersCount ..........................................................................................................34 GetAllMembersIncidences..............................................................................................35 GetNextMember..............................................................................................................37 RenumberMembers .........................................................................................................40 GetPlateIncidences ..........................................................................................................42 GetPlatesCount................................................................................................................44 GetAllPlatesIncidences ...................................................................................................44 GetPlateEdgeDistances ...................................................................................................48 GetSolidIncidences .........................................................................................................50 GetSolidsCount ...............................................................................................................52 GetAllSolidsIncidences...................................................................................................53

OpenSTAAD Reference Manual

ii WriteGeometry................................................................................................................56

Functions Related to Groups ...............................................................................................57 GetNumberOfGROUPS..................................................................................................57 GetNumberOfGROUPTypes ..........................................................................................59 GetGROUPNamesForType.............................................................................................61 GetNumberOfEntitiesInGROUP.....................................................................................63 GetAllEntitiesInGROUP.................................................................................................65

Member Specifications Functions .......................................................................................68 GetSupportCondition ......................................................................................................68 GetMemberOffsets ..........................................................................................................71 DoesMemberHaveReleases.............................................................................................73 IsStartEndReleased .........................................................................................................75 IsEndEndReleased...........................................................................................................77 GetDOFReleasedAtStartOfMember ...............................................................................79 GetDOFReleasedAtEndOfMember.................................................................................81 IsPartiallyReleasedAtStartOfMember.............................................................................83 IsPartiallyReleasedAtEndOfMember ..............................................................................85 IsSpringReleaseAtStartOfMember..................................................................................87 IsSpringReleaseAtEndOfMember...................................................................................89 GetSpringReleaseStiffnessesAtStartOfMember..............................................................91 GetSpringReleaseStiffnessesAtEndOfMember...............................................................93 GetSupportStiffnesses .....................................................................................................95 GetFullMemberReleaseInfoAtStart.................................................................................97 GetFullMemberReleaseInfoAtEnd..................................................................................99 GetMemberBetaAngle ..................................................................................................101 GetMemberSteelDesignRatio........................................................................................103 IsMemberACableMember.............................................................................................105 IsMemberACompressionMember .................................................................................107 IsMemberATensionMember .........................................................................................109 IsMemberATrussMember .............................................................................................111

Properties Functions..........................................................................................................113 GetMemberLength ........................................................................................................113 GetMemberWidthAndDepth.........................................................................................115 GetMemberProperties ...................................................................................................117 GetMemberPropsForPrismatic......................................................................................120 GetMemberDesignProperties ........................................................................................123 GetSteelTableProperties................................................................................................126 GetMemberPropertyShape ............................................................................................131 GetFinalMemberPropertyName ....................................................................................133 GetCompositeSectionParameters ..................................................................................135 GetMemberMaterialConstants ......................................................................................137 GetAreaOfPlate .............................................................................................................139 GetPlateThicknesses .....................................................................................................141

Loads Functions ................................................................................................................144

OpenSTAAD Reference Manual iii

GetLoadCombinationCaseCount...................................................................................144 GetPrimaryLoadCaseCount ..........................................................................................146 GetFirstLoadCase..........................................................................................................147 GetNextLoadCase .........................................................................................................149

Output Results Functions: Nodes ......................................................................................151 GetNodeDisplacements.................................................................................................151 GetSupportReactions.....................................................................................................154 GetModeShapeDataAtNode..........................................................................................156 GetNumberOfModes.....................................................................................................159

Output Results Functions: Beams .....................................................................................161 GetMinBendingMoment ...............................................................................................161 GetMaxBendingMoment...............................................................................................163 GetMinShearForce ........................................................................................................165 GetMaxShearForce .......................................................................................................167 GetMemberEndForces ..................................................................................................169 GetIntermediateMemberForcesAtDistance...................................................................171 GetMemberEndDisplacements......................................................................................173 GetIntermediateMemberTransDisplacements...............................................................175 GetSteelDesignResults ..................................................................................................177

Output Results Functions: Plates.......................................................................................181 GetPlateCenterVonMisesStresses .................................................................................181 GetAllPlateCenterPrincipalStressesAndAngles ............................................................183 GetAllPlateCenterMoments ..........................................................................................185 GetAllPlateCenterForces...............................................................................................187 GetPlateCenterNormalPrincipalStresses .......................................................................189 GetAllPlateCenterStressesAndMoments.......................................................................191

Output Results Functions: Solids ......................................................................................193 GetAllSolidPrincipalStresses ........................................................................................193 GetAllSolidNormalStresses ..........................................................................................195 GetAllSolidShearStresses..............................................................................................197 GetAllSolidVonMisesStresses ......................................................................................199

OpenSTAAD Functions – Application Object......................................................................201 Creating Macros within STAAD.Pro and Adding Them to the STAAD.Pro Menu .........201 Root Applications..............................................................................................................208

GetSTAADFile .............................................................................................................208 OpenSTAADFile...........................................................................................................209 CloseSTAADFile ..........................................................................................................210 GetSTAADFileFolder ...................................................................................................211 UpdateStructure.............................................................................................................212 GetInputUnitForLength.................................................................................................213 GetInputUnitForForce...................................................................................................214 SetInputUnitForLength .................................................................................................215 SetInputUnitForForce ...................................................................................................216 SetInputUnits ................................................................................................................217


iv ShowApplication...........................................................................................................218 GetProcessHandle .........................................................................................................219 GetProcessId .................................................................................................................220 GetMainWindowHandle ...............................................................................................221 NewSTAADFile............................................................................................................222 Analyze .........................................................................................................................223 GetShortJobInfo ............................................................................................................224 SetShortJobInfo.............................................................................................................225 CreateNamedView ........................................................................................................226 SaveNamedView...........................................................................................................227 ModifyNamedView.......................................................................................................228 GetBaseUnit ..................................................................................................................230 RemoveNamedView .....................................................................................................231 Quit ...............................................................................................................................232

Geometry Applications .....................................................................................................233 Geometry.GetNodeCount..............................................................................................233 Geometry.GetNodeList .................................................................................................234 Geometry.AddNode ......................................................................................................235 Geometry.CreateNode...................................................................................................236 Geometry.GetMemberCount.........................................................................................237 Geometry.GetBeamList.................................................................................................238 Geometry.AddBeam......................................................................................................239 Geometry.CreateBeam ..................................................................................................240 Geometry.SplitBeam.....................................................................................................241 Geometry.SplitBeamInEqlParts ....................................................................................242 Geometry.GetBeamLength ...........................................................................................243 Geometry.GetNodeCoordinates ....................................................................................244 Geometry.GetNodeNumber ..........................................................................................245 Geometry.GetNodeDistance .........................................................................................246 Geometry.GetPlateCount ..............................................................................................247 Geometry.GetPlateList..................................................................................................248 Geometry.AddPlate .......................................................................................................249 Geometry.CreatePlate ...................................................................................................250 Geometry.GetSolidCount..............................................................................................251 Geometry.GetSolidList .................................................................................................252 Geometry.AddSolid ......................................................................................................253 Geometry.CreateSolid ...................................................................................................254 Geometry.GetSurfaceCount ..........................................................................................256 Geometry.GetSurfaceList..............................................................................................257 Geometry.AddMultipleNodes .......................................................................................258 Geometry.AddMultipleBeams ......................................................................................259 Geometry.AddMultiplePlates........................................................................................260 Geometry.AddMultipleSolids .......................................................................................261 Geometry.DeleteNode...................................................................................................262

OpenSTAAD Reference Manual v

Geometry.DeleteBeam ..................................................................................................263 Geometry.DeletePlate ...................................................................................................264 Geometry.DeleteSolid ...................................................................................................265 Geometry.GetNoOfSelectedNodes ...............................................................................266 Geometry.GetSelectedNodes ........................................................................................267 Geometry.GetNoOfSelectedBeams...............................................................................268 Geometry.GetSelectedBeams........................................................................................269 Geometry.GetNoOfSelectedPlates ................................................................................270 Geometry.GetSelectedPlates .........................................................................................271 Geometry.GetNoOfSelectedSolids................................................................................272 Geometry.GetSelectedSolids.........................................................................................273 Geometry.GetLastNodeNo............................................................................................274 Geometry.GetLastBeamNo ...........................................................................................275 Geometry.GetLastPlateNo ............................................................................................276 Geometry.GetLastSolidNo............................................................................................277 Geometry.SelectNode ...................................................................................................278 Geometry.SelectBeam...................................................................................................279 Geometry.SelectPlate ....................................................................................................280 Geometry.SelectSolid....................................................................................................281 Geometry.SelectMultipleNodes ....................................................................................282 Geometry.SelectMultipleBeams....................................................................................283 Geometry.SelectMultiplePlates.....................................................................................284 Geometry.SelectMultipleSolids ....................................................................................285 Geometry.GetNodeIncidence ........................................................................................286 Geometry.GetMemberIncidence ...................................................................................287 Geometry.GetPlateIncidence.........................................................................................288 Geometry.GetSolidIncidence ........................................................................................289 Geometry.CreateGroup .................................................................................................290

View Applications.............................................................................................................291 View.ShowFront ...........................................................................................................291 View.ShowBack............................................................................................................292 View.ShowRight ...........................................................................................................293 View.ShowLeft .............................................................................................................294 View.ShowPlan.............................................................................................................295 View.ShowBottom........................................................................................................296 View.ShowIsometric .....................................................................................................297 View.RotateUp..............................................................................................................298 View.RotateDown.........................................................................................................299 View.RotateLeft ............................................................................................................300 View.RotateRight..........................................................................................................301 View.SpinLeft ...............................................................................................................302 View.SpinRight .............................................................................................................303 View.ZoomAll ..............................................................................................................304 View.CreateNewViewForSelections.............................................................................305


vi View.SetLabel...............................................................................................................306 View.SetSectionView ...................................................................................................308 View.SetDiagramMode.................................................................................................309 View.RefreshView........................................................................................................312 View.SetNodeAnnotationMode ....................................................................................313 View.SetReactionAnnotationMode...............................................................................315 View.GetInterfaceMode................................................................................................317 View.SetInterfaceMode.................................................................................................318 View.SetModeSectionPage ...........................................................................................320 View.SetBeamAnnotationMode ...................................................................................323 View.ShowAllMembers................................................................................................325 View.ShowMembers .....................................................................................................326 View.HideMembers ......................................................................................................327 View.ShowMember ......................................................................................................328 View.HideMember........................................................................................................329 View.HideAllMembers .................................................................................................330 View.ZoomExtentsMainView.......................................................................................331 View.SetUnits ...............................................................................................................332 View.HidePlate .............................................................................................................334 View.HideSolid.............................................................................................................335 View.HideSurface .........................................................................................................336 View.HideEntity............................................................................................................337 View.SelectMembersParallelTo....................................................................................338 View.SelectGroup .........................................................................................................339 View.SelectInverse........................................................................................................340 View.SelectByItemList .................................................................................................341 View.SelectByMissingAttribute ...................................................................................343 View.SelectEntitiesConnectedToNode .........................................................................344 View.SelectEntitiesConnectedToMember ....................................................................345 View.SelectEntitiesConnectedToPlate..........................................................................346 View.SelectEntitiesConnectedToSolid .........................................................................347

Properties Applications .....................................................................................................348 Country Codes...............................................................................................................348 Type Specification ........................................................................................................348 Additional Specifications ..............................................................................................349 Property.SetMaterialID .................................................................................................350 Property.CreateBeamPropertyFromTable.....................................................................351 Property.CreateChannelPropertyFromTable .................................................................353 Property.CreateAnglePropertyFromTable.....................................................................355 Property.CreateTubePropertyFromTable ......................................................................357 Property.CreatePipePropertyFromTable .......................................................................359 Property.CreatePrismaticRectangleProperty .................................................................361 Property.CreatePrismaticCircleProperty .......................................................................362 Property.CreatePrismaticTeeProperty...........................................................................363

OpenSTAAD Reference Manual vii

Property.CreatePrismaticTrapezoidalProperty..............................................................364 Property.CreatePrismaticGeneralProperty ....................................................................365 Property.CreateTaperedIProperty..................................................................................367 Property.CreateTaperedTubeProperty...........................................................................369 Property.CreateAssignProfileProperty ..........................................................................371 Property.CreatePlateThicknessProperty........................................................................372 Property.AssignBeamProperty......................................................................................373 Property.AssignPlateThickness.....................................................................................374 Property.AssignBetaAngle............................................................................................375 Property.CreateMemberTrussSpec................................................................................376 Property.CreateMemberInactiveSpec............................................................................377 Property.CreateMemberTensionSpec............................................................................378 Property.CreateMemberCompressionSpec ...................................................................379 Property.CreateMemberIgnoreStiffSpec .......................................................................380 Property.CreateMemberCableSpec ...............................................................................381 Property.CreateMemberOffsetSpec ..............................................................................382 Property.AssignMemberSpecToBeam..........................................................................383 Property.CreateElementPlaneStressSpec ......................................................................384 Property.CreateElementIgnoreInplaneRotnSpec...........................................................385 Property.AssignElementSpecToPlate............................................................................386 Property.CreateMemberReleaseSpec ............................................................................387 Property.CreateMemberPartialReleaseSpec..................................................................388 Property.CreateElementNodeReleaseSpec....................................................................390 Property.GetCountryTableNo .......................................................................................391 Property.GetSectionTableNo ........................................................................................392 Property.GetBeamSectionName ...................................................................................393 Property.GetBeamSectionPropertyTypeNo ..................................................................394 Property.GetBeamMaterialName ..................................................................................395 Property.GetMaterialProperty .......................................................................................396 Property.GetBeamConstants .........................................................................................397 Property.GetBeamPropertyAll ......................................................................................398 Property.GetBeamProperty ...........................................................................................399 Property.GetBetaAngle .................................................................................................400 Property.GetSectionPropertyCount...............................................................................401 Property.GetSectionPropertyName ...............................................................................402 Property.GetSectionPropertyType ................................................................................403 Property.GetSectionPropertyCountry............................................................................404 Property.GetIsotropicMaterialCount .............................................................................405 Property.GetIsotropicMaterialProperties ......................................................................406 Property.GetOrthotropic2DMaterialCount....................................................................407 Property.GetOrthotropic2DMaterialProperties .............................................................408 Property.GetOrthotropic3DMaterialCount....................................................................409 Property.GetOrthotropic3DMaterialProperties .............................................................410 Property.GetMemberGlobalOffSet ...............................................................................411


viii Property.GetMemberLocalOffSet .................................................................................412 Property.GetMemberReleaseSpec.................................................................................413

Loads Applications............................................................................................................414 Load.CreateNewPrimaryLoad.......................................................................................414 Load.SetLoadActive......................................................................................................415 Load.AddSelfWeightInXYZ .........................................................................................416 Load.AddNodalLoad.....................................................................................................417 Load.AddSupportDisplacement ....................................................................................418 Load.AddMemberUniformForce ..................................................................................419 Load.AddMemberUniformMoment ..............................................................................421 Load.AddMemberConcForce........................................................................................423 Load.AddMemberConcMoment ...................................................................................425 Load.AddMemberLinearVari........................................................................................427 Load.AddMemberTrapezoidal ......................................................................................429 Load.AddMemberAreaLoad .........................................................................................431 Load.AddMemberFloorLoad ........................................................................................432 Load.AddMemberFixedEnd..........................................................................................433 Load.AddElementPressure............................................................................................434 Load.AddElementTrapPressure ....................................................................................436 Load.AddTemperatureLoad ..........................................................................................437 Load.AddStrainLoad.....................................................................................................439 Load.GetPrimaryLoadCaseCount .................................................................................440 Load.GetLoadCombinationCaseCount .........................................................................441 Load.GetPrimaryLoadCaseNumbers ............................................................................442 Load.GetLoadCombinationCaseNumbers.....................................................................443 Load.CreateNewLoadCombination...............................................................................444 Load.AddLoadAndFactorToCombination ....................................................................445 Load.GetBeamCountAtFloor ........................................................................................446 Load.GetInfluenceArea .................................................................................................447 Load.GetActiveLoad .....................................................................................................448 Load.GetNodalLoadCount ............................................................................................449 Load.GetNodalLoads ....................................................................................................450 Load.GetUDLLoadCount..............................................................................................451 Load.GetUDLLoads......................................................................................................452 Load.GetUNIMomentCount .........................................................................................453 Load.GetUNIMoments..................................................................................................454 Load.GetTrapLoadCount ..............................................................................................455 Load.GetTrapLoads ......................................................................................................456 Load.GetConcForceCount.............................................................................................457 Load.GetConcForces.....................................................................................................458 Load.GetConcMomentCount ........................................................................................459 Load.GetConcMoments ................................................................................................460

Supports Applications .......................................................................................................461 Support.CreateSupportFixed .........................................................................................461

OpenSTAAD Reference Manual ix

Support.CreateSupportPinned .......................................................................................462 Support.CreateSupportFixedBut ...................................................................................463 Support.AssignSupportToNode ....................................................................................464 Support.GetSupportCount .............................................................................................465 Support.GetSupportNodes.............................................................................................466 Support.GetSupportType...............................................................................................467 Support.GetSupportInformation....................................................................................468

Command Applications.....................................................................................................469 Command.PerformAnalysis ..........................................................................................469 Command.PerformPDeltaAnalysisNoConverge ...........................................................470 Command.PerformPDeltaAnalysisConverge................................................................472 Command.CreateSteelDesignCommand .......................................................................474

Output Results Applications..............................................................................................475 Output.GetOutputUnitForDimension............................................................................475 Output.GetOutputUnitForSectDimension.....................................................................476 Output.GetOutputUnitForSectArea...............................................................................477 Output.GetOutputUnitForSectInertia ............................................................................478 Output.GetOutputUnitForSectModulus ........................................................................479 Output.GetOutputUnitForDensity.................................................................................480 Output.GetOutputUnitForDisplacement .......................................................................481 Output.GetOutputUnitForRotation ...............................................................................482 Output.GetOutputUnitForForce ....................................................................................483 Output.GetOutputUnitForMoment................................................................................484 Output.GetOutputUnitForDistForce..............................................................................485 Output.GetOutputUnitForDistMoment .........................................................................486 Output.GetOutputUnitForStress....................................................................................487 Output.GetNodeDisplacements.....................................................................................488 Output.GetSupportReactions.........................................................................................489 Output.GetMemberEndDisplacements..........................................................................490 Output.GetIntermediateMemberTransDisplacements ...................................................491 Output.GetMemberEndForces ......................................................................................492 Output.GetAllPlateCenterStressesAndMoments...........................................................493 Output.GetPlateCenterNormalPrincipalStresses ...........................................................494 Output.GetAllPlateCenterForces...................................................................................495 Output.GetAllPlateCenterMoments ..............................................................................496 Output.GetAllPlateCenterPrincipalStressesAndAngles ................................................497 Output.GetPlateCenterVonMisesStresses .....................................................................498 Output.GetAllSolidNormalStresses ..............................................................................499 Output.GetAllSolidShearStresses .................................................................................500 Output.GetAllSolidPrincipalStresses ............................................................................501 Output.GetAllSolidVonMisesStresses ..........................................................................502

Results Tables Applications ..............................................................................................503 Table.CreateReport .......................................................................................................503 Table.SaveReport ..........................................................................................................504


x Table.SaveReportAll .....................................................................................................505 Table.GetReportCount ..................................................................................................506 Table.AddTable.............................................................................................................507 Table.RenameTable ......................................................................................................508 Table.DeleteTable .........................................................................................................509 Table.ResizeTable.........................................................................................................510 Table.SaveTable............................................................................................................511 Table.GetTableCount ....................................................................................................512 Table.SetCellValue .......................................................................................................513 Table.GetCellValue.......................................................................................................514 Table.SetColumnHeader ...............................................................................................515 Table.SetColumnUnitString..........................................................................................516 Table.SetRowHeader ....................................................................................................517 Table.SetCellTextColor.................................................................................................518 Table.SetCellTextBold..................................................................................................520 Table.SetCellTextItalic .................................................................................................521 Table.SetCellTextUnderline..........................................................................................522 Table.SetCellTextSize...................................................................................................523 Table.SetCellTextSizeAll..............................................................................................524 Table.SetCellTextHorzAlignment.................................................................................525 Table.SetCellTextVertAlignment..................................................................................527

OpenSTAAD Functions – Troubleshooting..........................................................................529 Errors and Error Messages ................................................................................................529

List of Acronyms...................................................................................................................534 Index of Functions.................................................................................................................535

OpenSTAAD Reference Manual 1

Documentation for OpenSTAAD

Introduction OpenSTAAD is a library of exposed functions allowing engineers access to STAAD.Pro’s internal functions and routines as well as its graphical commands. With OpenSTAAD, any user can use practically any programming language (including C, C++, VB, VBA, FORTRAN, Java and Delphi) to tap into STAAD’s database and seamlessly link input and output data to third-party applications. OpenSTAAD also empowers the STAAD user to create VBA-like macros within the STAAD.Pro environment to perform such tasks as automating repetitive modeling or post-processing tasks or embedding customized design routines. Following an open architecture paradigm, OpenSTAAD was built using ATL COM and COM+ standards as specified by Microsoft, Inc. This allows OpenSTAAD to be used in any environment whether it is in a customized application written in C++ or in a macro application like Excel or AutoCAD. OpenSTAAD can also be used to link STAAD data to Web-based applications using ActiveX, HTML and ASP.

OpenSTAAD allows engineers and other users to link in-house or third-party applications with STAAD.Pro. For example, a user might create a spreadsheet in Excel to analyze and design a circular base plate using support reactions from STAAD. With OpenSTAAD, a simple macro can be written in Excel or within the STAAD environment to retrieve the appropriate STAAD data and automatically link the results. If the STAAD file changes, so will the Excel sheet! With a built-in VBA editor, macros can be written inside STAAD using VBA to create new dialog boxes or menu items which run design codes or specific structural components (like certain connections) that automatically link to STAAD’s familiar reporting tables. A cumbersome export/import link between two or three software is no longer required. OpenSTAAD is currently being designed to work on the new .NET platform as well as on PocketPCs running Windows CE.

Programming Languages Although OpenSTAAD supports all major programming languages used today, it is very difficult to document the usage of each and every function in all of these languages. Most of the example programs or code snippets for each documented OpenSTAAD function are written in VBA for Excel or AutoCAD VBA. The reason is

Section 1


2 that with OpenSTAAD 2.0 and higher, STAAD.Pro is equipped with a functional VBA editor capable of writing macros only in VBA. In future revisions of this OpenSTAAD documentation, examples in other languages such as or C++ will be added, and use of OpenSTAAD in other languages or environments like the Web will be highlighted.

REI will not provide direct support on how to write VBA macros or syntax on other programming languages. There are, however, several useful and free sites on the Web to assist a beginner on writing macros in STAAD, Excel, AutoCAD or any other VBA compliant software. It should be noted that the VBA language is the same from software to software. However, the functions, objects and core libraries will obviously vary.

The sites recommended by REI are as follows:

http://www.excel-vba.com

http://www.beyondtechnology.com/vba.shtml

http://www.afralisp.com

http://www.wrox.com

Also, it is worth noting that Excel has a nice Record Macro feature. You can run the recorder and then select any commands from Excel’s menus and toolbars. The corresponding VBA syntax will automatically be generated. Look under ‘Recording Macros’ in the Excel help for additional information.

OpenSTAAD User Forum and Code Resource Research Engineers hosts an OpenSTAAD Macro Exchange on the company’s web site at www.reiworld.com. The Macro Exchange allows you to upload and download code in any programming language. You may also join the OpenSTAAD Beta Group if you are interested in previewing new OpenSTAAD functions and providing your feedback during the development process.

Code uploaded to the Macro Exchange web page will not be posted immediately, but will be subjected to a delay of several hours to accommodate a screening process. Code submitted to the site will be tested to try to ensure that it runs without crashing and is not intended to do anything malicious. Research Engineers will not accept responsibility for any mistake, error or misrepresentation in or as a result of the usage of software code obtained from the OpenSTAAD Macro Exchange.


Application Program Interface (API) The OpenSTAAD library of functions is classified under the following general categories:

• STAAD File Input and Output (I/O) • Structure Geometry • Member Specifications • Properties • Loads • Output Results

� Nodes � Beams � Plates � Solids

• STAAD Pre-Processor • STAAD Post-Processor • Creating Dialog Boxes and Menu Items

Instantiating OpenSTAAD Library for Use The first thing necessary to access STAAD project data from within another application is to instantiate, or create an instance of OpenSTAAD within the other application. In Visual Basic for Applications (VBA), this may be done by creating an object variable and then assigning to it the OpenSTAAD object. The VBA CreateObject function may be used for this. In OpenSTAAD, there are two fundamental objects which control distinct parts of STAAD.Pro. These objects are the actual STAAD.Pro application/environment and access to STAAD.Pro results.

The object which controls the STAAD.Pro environment is referred to as StaadPro.OpenSTAAD. This object must be created in order to get access to any of the internal graphical functions within STAAD.Pro (including the creating of menu items and dialog boxes). The following VBA function can be used to instantiate or create this object:

Set objSTAADGUI = CreateObject("StaadPro.OpenSTAAD")

The object objSTAADGUI can be used to drill down into STAAD’s viewing, geometry modeling, results grid and post-processing functions.


4 The object which enables access to the results database in STAAD.Pro is referred to as OpenSTAAD.Output.1. This object must be created in order to get access to any of the results output created by STAAD.Pro for a particular model. The following VBA function can be used to instantiate or create this object:

Set objSTAADResults = CreateObject("OpenSTAAD.Output.1")

If you want to work with more than one STAAD file at a time, you can create more than one instance of an OpenSTAAD object within your application.

At the conclusion of your OpenSTAAD application, the OpenSTAAD object(s) should be terminated, to unlock the handles within the application to the OpenSTAAD functions, and to free system resources.

��

Sub How2Begin 'Create an Output variable to hold your OpenSTAAD object(s). Dim objSTAADResults Dim objSTAADResults2 Dim objSTAADGUI 'Launch OpenSTAAD Objects. Set objSTAADResults = CreateObject("OpenSTAAD.Output.1") 'If we want to work with more than one STAAD file at a time or with the GUI and 'results objects concurrently, we can instantiate a multiple instances of an 'OpenSTAAD object: Set objSTAADResults2 = CreateObject("OpenSTAAD.Output.1") Set objSTAADGUI = CreateObject("StaadPro.OpenSTAAD ") 'At the end of your application, remember to terminate the OpenSTAAD objects. Set objOpenSTAAD = Nothing Set objOpenSTAAD2 = Nothing Set objSTAADGUI = Nothing End Sub

Function Return Value


If the function return value for an OpenSTAAD function is equal to 0, it means that OpenSTAAD was unable to execute the function. Check to be sure that you have passed all required parameters to the function. Make sure that all parameters being passed are valid.

A return value of 1 indicates that OpenSTAAD successfully executed the function.

Unless specified otherwise, results returned by a function are stored in variable names passed to it for the purpose. A few of the OpenSTAAD Application functions return the results as the return value of the function. In those cases, the above comments regarding the function return value do not apply.

All values are given in units of kips and inches unless specified otherwise.

STAAD Nomenclature In STAAD documentation and in the program menus and dialog boxes, the terms “member” and “beam” are used interchangeably. Use of the term “beam” should not be taken to imply that the member cannot take an axial load.

Similarly, the terms “joint” and “node” are used interchangeably in STAAD. Both terms refer to the connections between elements.

Connections are also referred to as incidences. The terms “member incidences,” “plate incidences,” and “solid incidences” refer to the nodes that connect these elements to other elements and supports.

OpenSTAAD Compatibility with STAAD.Pro For optimum performance, OpenSTAAD should be run in STAAD.Pro 2002 or higher. The object which controls the STAAD.Pro graphical interface (StaadPro.OpenSTAAD -dialogs, modeling tools, etc.) is only available in STAAD.Pro 2003 or higher.

As software development proceeds, it is sometimes necessary to modify STAAD’s database to accommodate new features or to maximize efficiency and increase processing speed. STAAD.Pro 2002 is the first STAAD release to include OpenSTAAD. All subsequent releases of OpenSTAAD will be backward-compatible with STAAD.Pro 2002.


6 It may be possible to run at least some of OpenSTAAD’s functions in earlier releases of STAAD.Pro or STAAD-III, but the results may be unpredictable, since OpenSTAAD did not exist at that time, and therefore compatibility with OpenSTAAD was not considered during the development of these earlier STAAD versions. Research Engineers cannot provide any technical support for OpenSTAAD running in STAAD versions prior to STAAD.Pro 2002.

In terms of STAAD’s input file, STAAD.Pro is backward-compatible with all previous STAAD releases. To use OpenSTAAD on a project that was created using an earlier version of STAAD.Pro or STAAD-III, you can open your old input file in STAAD.Pro 2002 and run the analysis. This action will create a new database in a format fully compatible with OpenSTAAD.

OpenSTAAD is compatible with any version of Microsoft Excel that supports VBA macros. OpenSTAAD is also compatible with AutoCAD 2000 (or higher) VBA.

With OpenSTAAD 2.0 and higher (available with STAAD.Pro 2003 and higher), a VBA editor is embedded within the STAAD.Pro environment. The version of VBA which the editor supports is not 100% VBA compatible. There are a few functions which can be supported in the Microsoft version of VBA which are not supported in the VBA editor/compiler which comes with STAAD.Pro. Every attempt is being made to support these functions. Currently, the functions which are not supported are not yet documented in this manual.

OpenSTAAD Manual Organization The OpenSTAAD manual will document all functions by the two objects it currently supports:

1) OpenSTAAD.Output.1 – Access to the output

2) StaadPro.OpenSTAAD – Access to the STAAD.Pro application

The first object is outlined in Section 2 of this manual while the latter is outlined in Section 3. The two objects are not dependent on one another. However, the latter is only available in STAAD.Pro 2003 and higher.

Visual Basic Conventions


��

In VB or VBA, an apostrophe ( ‘ ) is used to denote a comment. Anything to the right of the apostrophe will be ignored by the program.

��

VB/VBA is flexible in the way it allows arrays to be declared. Most examples involving arrays in this reference manual will conform to the C++ zero indexing convention. In an array of 6 values, the positions in the array are referred to as 0-5. Therefore an array of 6 values would be declared as follows:

Dim pdArray(5) As Double

or

Dim pdArray(0 To 5) As Double

In VB, we could also declare a 6-value array as:

Dim pdArray(1 To 6) As Double

In doing so, however, we might find that our loops and other statements used to access the various positions in the array might not work correctly in C++.

��

A long coding statement can be written on more than one line, to make the code easier to read. The VB line continuation character consists of a space followed by an underscore at the end of the line. The line of code beneath the continuation character will be handled as though it was written on the same line as the line continuation character.

��

objOpenSTAAD.GetNodeDisplacements nNodeNo, nLC, pdDisps(0) ‘The line of code above may also be written as the line shown below: objOpenSTAAD.GetNodeDisplacements _ nNodeNo, nLC, pdDisps(0)

Function List Organization The list of functions is formatted in the following way. The name of each function appears in large bold font at the top of the page. The Visual Basic (VB) syntax for


8 the function appears next. All function syntax definitions consist of the function return value data type, the function name and then the parameters enclosed in parentheses, e.g.,

��

When actually writing the function, the parameters are not enclosed in parentheses, but they are separated/delimited by commas. The function and all its parameters are usually written on a single line, but for long lines of code, a line continuation character may be used to make the code easier to read. In VB, the line continuation character is a space followed by an underscore ( _ ).

Following the function syntax definition is a description of each parameter required by the function. Note that the names of the parameters are just example names. If the parameter is a variable name for storing results returned by the function, or if you are passing a parameter required by the function as a variable, you can give it any legal variable name.

Next comes a remarks section which describes the purpose of the function, and provides general comments, constraints and recommendations for using it. Then an example of the function is provided. In some cases, the example is just a short code snippet; in other cases a fully viable macro or program is given. All code provided will be able to work within the STAAD macro editor or an external VBA editor (like Excel).

Finally, a list of related functions will be shown under the heading, “See Also.”


OpenSTAAD Functions – Results Object

STAAD File I/O Functions

SelectSTAADFile

��

��

��

��

A string providing the file name and path of the STAAD file to be accessed by subsequent OpenSTAAD functions. This string must be enclosed in quotes.

��

The SelectSTAADFile function is used to specify the STAAD output file to be used by succeeding functions. This function must precede any functions that act upon or retrieve information from the STAAD output file. It will normally be one of the first functions you will use in your application. You can open more than one STAAD file at a time by creating a second instance of the OpenSTAAD library from within your application.

It is highly recommended that before you conclude your application, you close any STAAD files you opened with this command. The CloseSTAADFile function is provided for this purpose.

��

Dim objOpenSTAAD As Output 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open a STAAD file

Section 2


10 objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std"

�

��

��

�� !��

�


CloseSTAADFile

��

��

��

��

��

This function closes a STAAD file that was opened with the SelectSTAADFile function. This function should always be used to close the STAAD file before exiting the macro, in order to free system resources and avoid conflicts with other processes.

��

objOpenSTAAD.CloseSTAADFile

�

��

��

�� !��


12

AreResultsAvailable

��

�� !��"��#��

��

��

A string passed to the function specifying the filename and path of an existing STAAD input file.

��

An integer variable name passed to the function for the function to use in storing the results it retrieves. pnResult = 0 if no; pnResult = 1 if yes.

��

This function checks whether the analysis has been run and an analyis results file (*.ANL file) is available for an existing STAAD input file. The filename and path of an existing STAAD input file is passed to the function as the first parameter, lpszFileName. A second parameter, pnResult, specifying an integer variable name for storing the results is also passed to the function. The function then determines whether a corresponding analysis results file exists in the same directory as the specified STAAD input file. If the function determines that the results file exists, it stores a value of 1 in the pnResult integer variable. If the function determines that the results file does not exist, it stores a value of 0 in the pnResult integer variable.

��

Sub Test4Results() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function output. Dim pnResult as Integer 'Run an instance of OpenSTAAD. Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Determine whether examp01.std file exists in same directory as examp01.std 'and store the results in the pnResult integer variable. 'Note the use of the VB line continuation character, a space followed by an


' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.AreResultsAvailable _ "C:\SPRO2004\STAAD\Examp\US\examp01.std", pnResult 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

��

��


14

AnalyzeStructure

��

��"��"��

��

��

A string passed to the function specifying the country’s steel and/or concrete design code(s) to be used in the current analysis run. The possible values are:

1) “AUSTRALIAN” 13) “INDIAN” 2) “BRITISH (5400-8007)” 14) “JAPANESE” 3) “BRITISH (5950.1990-8110)” 15) “NORWAY” 4) “BRITISH (5950.2000-8110)” 19) “RUSSIAN” 5) “CANADIAN” 6) “CHINA” 20) “SINGAPORE” 7) “DANISH” 21) “SPANISH” 8) “DUTCH” 22) “SWEDISH” 9) “EUROCODE” 23) “US” 10) “FINNISH” 11) “FRENCH” 12) “GERMAN”

��

This function will run the the STAAD file loaded using the function SelectSTAADFile. The actual STAAD engine will instantiate and produce a valid set of results in the same directory as the STAAD file. If there are errors in the input file, STAAD will generate an ANL file (with the same name) listing all the various errors.

��

Sub RunEngine() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function output. Dim pnResult as Integer 'Run an instance of OpenSTAAD.


Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Determine whether the results of examp01.std file exists in same directory as examp01.std and store the results in the pnResult integer variable. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.AreResultsAvailable _ "C:\SPRO2004\STAAD\Examp\US\examp01.std", pnResult if (pnResult == 0) then ‘No results, so run the STAAD file objOpenSTAAD.AnalyzeStructure “US” end if 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

��

��

�


16

Structure Geometry Functions

GetNodeCoordinates

��

��$��#��#��!��%��!��&��

��!��'��

��

��

An integer variable corresponding to the number of the node for which the coordinates are to be retrieved by the function.

��

A double (8-byte floating-point) variable that stores the x coordinates of the supported nodes.

��

A double (8-byte floating-point) variable that stores the y coordinates of the supported nodes.

��

A double (8-byte floating-point) variable that stores the z coordinates of the supported nodes.

��

This function retrieves the xyz coordinates for a given node in the structure.

Note that the coordinates are reported in units of inches.


��

‘This code snippet retrieves the coordinates for Node 6 Dim pX as Double Dim pY as Double Dim pZ as Double objOpenSTAAD.GetNodeCoordinates 6, pX, pY, pZ

�

��

$��#��

$��#��

$��#�(�#��

��#��)��

$��#��!��* ��#��

$��#��+��

��!��#��


18

GetNodesCount

��

��$��#��#��

��

��

A long variable for storing the number of nodes retrieved by the function.

��

This function retrieves the number of nodes in the currently open STAAD file.

��

Dim pnNodes As Long objOpenSTAAD.GetNodesCount pnNodes

�

��

$��#��

$��#��

$��#�(�#��

��#��)��

$��#��!��* ��#��

$��#��+��

��!��#��


GetAllNodesCoordinates

��

��$��#��#��#��!��!��%��

��!��&��!��'��

��

��

A dynamic long array variable that stores the node numbers.

��

A dynamic double (8-byte floating-point) array variable that stores the x coordinates of the nodes.

��

A dynamic double (8-byte floating-point) array variable that stores the y coordinates of the nodes.

��

A dynamic double (8-byte floating-point) array variable that stores the z coordinates of the nodes.

��

This function retrieves the node number and xyz coordinates for all nodes in the currently open STAAD file. The node numbers and coordinates are stored in dynamic arrays, since the size of the array will vary, depending on the number of nodes in the structure. The OpenSTAAD function GetNodesCount can be used to retrieve the number of nodes in the structure. Then, the VB ‘ReDim’ function can be used to size the arrays.

Note that the coordinates are reported in units of inches.


20 ��

'This is a VB for Excel macro. Sub AllNodes() Dim objOpenSTAAD As Output Dim pnNodes As Long 'The next 4 are dynamic array variables, use empty parentheses ' right now. We will use GetNodesCount to find the size of the ' array, then we will use a VB ReDim function to size the array. Dim pnNodeNumbers() As Long Dim pX() As Double Dim pY() As Double Dim pZ() As Double ‘Create an instance of OpenSTAAD and open a STAAD file. Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std" 'Find the number of nodes in the structure objOpenSTAAD.GetNodesCount pnNodes 'Now that we know how many nodes there are, we can 'REDIMension the arrays. ReDim pnNodeNumbers(0 To pnNodes) ReDim pX(0 To pnNodes), pY(0 To pnNodes), pZ(0 To pnNodes) 'Recall that when passing array names in VB, you also need to ' specify the starting point of the arrays (in parentheses). objOpenSTAAD.GetAllNodesCoordinates pnNodeNumbers(0), pX(0), pY(0), pZ(0) ‘Now write the results in columns 7-10 of the worksheet, ‘starting on Row 20 ‘To specify the position in the arrays to write the results, use i-1. For i = 1 To pnNodes Cells(19 + i, 7).Value = pnNodeNumbers(i - 1) Cells(19 + i, 8).Value = pX(i - 1) Cells(19 + i, 9).Value = pY(i - 1) Cells(19 + i, 10).Value = pZ(i - 1) Next 'Before ending, close the STAAD file and release the link to OpenSTAAD. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��

$��#��

$��#�(�#��

��#��)��

$��#��!��* ��#��

$��#��+��


��!��#��


22

GetNextNodeCoordinate

��

��$��#�(�#��,��#��#��

��#�(�#��#��!��%��!��&��!��'��

��

��

A long variable specifying the node number which is the node prior (i.e., the antecedent, in ascending numerical order) to the node for which the number and coordinates are to be obtained. If this variable is set to a value of 0, the function will return the node number and coordinates for the node with the lowest valid node number.

��!��

A long variable in which the node number retrieved by the function will be stored.

��

A double (8-byte floating-point) variable that stores the x coordinate corresponding to pnNextNodeNo.

��

A double (8-byte floating-point) variable that stores the y coordinate corresponding to pnNextNodeNo.

��

A double (8-byte floating-point) variable that stores the z coordinate corresponding to pnNextNodeNo.

��

This function retrieves the node number and xyz coordinates for the next valid node number in ascending numerical order from a given node. This function may be useful where it is desired to obtain the node numbers and/or coordinates for a limited range of nodes. It may also be helpful when it is desired to know the next node


number in a STAAD model where not all integers within a given range have been assigned to a node.

Note that coordinates are expressed in units of inches.

��

Sub NextNode() 'This macro allows us to enter a starting node number in the worksheet. 'We also enter the number of nodes above the starting node we want the function 'to retrieve. The node numbers and coordinates are then displayed in the worksheet. Dim objOpenSTAAD As Output Dim pnPreviousNodeNo As Long Dim pnNextNodeNo As Long Dim pX As Double Dim pY As Double Dim pZ As Double 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open STAAD's Example 8 (US) objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std" 'Get the starting node number from Row 29, Column 5 of the Excel worksheet pnPreviousNodeNo = Cells(29, 5).Value 'Get from Row 29, Column 2 the number of succeeding nodes you want OpenSTAAD ' to retrieve. For i = 1 To Cells(29, 2).Value 'Now execute the function. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetNextNodeCoordinate _ pnPreviousNodeNo, pnNextNodeNo, pX, pY, pZ 'Write the results starting in Row 31, Node No. in Column 1, X coord. ' in Col. 2, etc. Cells(30 + i, 1).Value = pnNextNodeNo Cells(30 + i, 2).Value = pX Cells(30 + i, 3).Value = pY Cells(30 + i, 4).Value = pZ 'Now, to prepare to reiterate, increment the value of the previous ' node number to the node number you just wrote in the worksheet. pnPreviousNodeNo = pnNextNodeNo 'Do it again until you’ve done it the number of times you specified in the ' worksheet cell, Row 29 Column 2. Next i 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing


24 End Sub

�

��

$��#��

$��#��

$��#��

��#��)��

$��#��!��* ��#��

$��#��+��

��!��#��


DoesNodeHaveSupport

��

��#��)��#��

��

��

��

An integer corresponding to the number of the node to be checked to see whether a support for the structure exists at that node.

��

An integer variable in which the results of the DoesNodeHaveSupport function will be stored. The function result will be either 0 (No) or 1 (Yes). If no support exists at the node, the function will assign a value of 0 to pnSupported. If a support does exist at the node, the function will assign a value of 1 to the pnSupported variable.

��

This function checks a given node in the currently open STAAD file to see whether a support exists at that node.

��

Sub Supported () Dim objOpenSTAAD As Output Dim pnIsItSupported As Integer Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std" 'Parameters are node number and name for variable to store results. 'Note that the variable name for storing the results of the function can ' have any name you desire. objOpenSTAAD.DoesNodeHaveSupport 4, pnIsItSupported 'Free system resources before closing. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


26 �

��

$��#��

$��#��

$��#��

$��#�(�#��

$��#��!��* ��#��

$��#��+��

��!��#��


GetNumberOfSupportedNodes

��

��$��#��!��* ��#��#��

��

��

A long variable for storing the number of supported nodes retrieved by the function.

��

This function retrieves the number of nodes that are connected to supports for the structure. This function will normally be used prior to the GetAllNodesThatAreSupported function; it will determine the size of the arrays needed to capture the values returned by the GetAllNodesThatAreSupported function.

��

objOpenSTAAD.GetNumberOfSupportedNodes pnNodes

�

��

$��#��

$��#��

$��#��

$��#�(�#��

��#��)��

$��#��+��

��!��#��


28

GetAllNodesThatAreSupported

��

��$��#��+��#��#��!��

�%��!��&��!��'��

��

��

A dynamic long array variable that stores node numbers of the supported nodes.

��

A dynamic double (8-byte floating-point) array variable that stores the x coordinates of the supported nodes.

��

A dynamic double (8-byte floating-point) array variable that stores the y coordinates of the supported nodes.

��

A dynamic double (8-byte floating-point) array variable that stores the z coordinates of the supported nodes.

��

This function retrieves the node number and xyz coordinates for all supported nodes in the currently open STAAD file. The node numbers and coordinates are stored in dynamic arrays, since the size of the array will vary, depending on the number of supported nodes in the structure. The OpenSTAAD function GetNumberOfSupportedNodes can be used to retrieve the number of supported nodes in the structure. Then, the VB ‘ReDim’ function can be used to size the arrays.

��

Sub GetCoordOfSupportedNodes() Dim objOpenSTAAD As Output Dim pnNodes As Long


'The next 4 are dynamic array variables, use empty paren. right now. 'We will use GetNumberOfSupportedNodes to find the size of the array, ' then we will use a VB ReDim function to size the array. Dim pnNodeNo() As Long Dim pX() As Double Dim pY() As Double Dim pZ() As Double Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std" 'Find the number of supported nodes in the structure. objOpenSTAAD.GetNumberOfSupportedNodes pnNodes 'Now that we know how many supported nodes there are, we can REDIMension ' the arrays. ReDim pnNodeNo(pnNodes) ReDim pX(pnNodes), pY(pnNodes), pZ(pnNodes) 'Get the coordinates for all the supported nodes. objOpenSTAAD.GetAllNodesThatAreSupported pnNodeNo(0), pX(0), pY(0), pZ(0) 'Now write the results in columns 1-4 of the worksheet, starting on Row 20. 'Don't forget to specify the arrays' starting points, use i-1. For i = 1 To pnNodes Cells(19 + i, 1).Value = pnNodeNo(i - 1) Cells(19 + i, 2).Value = pX(i - 1) Cells(19 + i, 3).Value = pY(i - 1) Cells(19 + i, 4).Value = pZ(i - 1) Next ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��

$��#��

$��#��

$��#�(�#��

��#��)��

$��#��!��* ��#��

��!��#��


30

RenumberNodes

��

�� !��#��*�#��#��

�#�-#��#��

��

�"��

An integer variable passed to the function specifying the existing node number which is to be changed to a new number.

��#��

An integer variable passed to the function specifying the new number to be used to replace the existing node number.

��

This function assigns a new number to an existing node. The old node number and the new number are both passed to the function. The function then modifies the input file so that every reference to the old node number is changed to the new node number.

��

Sub ChangeNodeNumber() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Change the number of Node no. 1 to Node no. 100. objOpenSTAAD.RenumberNodes 1, 100 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


�

��

$��#��

$��#��

$��#��

$��#�(�#��

��#��)��

$��#��!��* ��#��

$��#��+��


32

GetMemberIncidences

��

��$��.��!��/��.��!��#��

��#��0�#��

��

�$��

A long variable greater than or equal to one which specifies the member number for which the member incidences are to be obtained.

��

A long variable for storing the starting node number retrieved by the function.

��%��

A long variable for storing the ending node number retrieved by the function.

��

This function retrieves the member incidences (starting node and ending node) for a given member. For example, in the STAAD input file, the statement ‘MEMBER INCIDENCE 5 1 8’ means that Member 5 starts at Node 1 and Ends at Node 8. Using this example, if the variable nMemberNo is given the value of 5, the GetMemberIncidences function would set pnStartNode = 1 and pnEndNode = 8. The starting node is also called member end A in STAAD; the ending node is also called member end B in STAAD.

��

'Given MEMBER INCIDENCE 5 1 8, Member 5 starts at Node 1 and Ends at Node 8. 'This code snippet retrieves the member incidences for member 5 Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.GetMemberIncidences 5, pnStartNode, pnEndNode 'pnStartNode is now set to a value of 1, pnEndNode = 8.

�

��

$��.��!��1��+�


$��.��!��

$��.��!��/��

$��#�(�.��!��

��!��.��!��


34

GetMembersCount

��

��$��.��!��.��!��

��

��$��

A long variable for storing the number of members retrieved by the function.

��

This function retrieves the number of members in the currently open STAAD file.

This function will normally be used prior to the GetAllMembersIncidences function; it will determine the size of the dynamic arrays needed to capture the values retrieved by the GetAllMembersIncidences function.

��

‘This is just a code snippet, not a complete macro. Dim nHowMany As Long Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.GetMembersCount nHowMany 'OpenSTAAD retrieves the number of members in the model and stores ' that number as a long value in the variable named nHowMany. 'Note that you can choose any legal variable name, it need not be ' called pnMembers. 'This is true in general for all variable names.

��

��

$��.��!��1��+�

$��.��!��/��

$��.��!��/��

$��#�(�.��!��

��!��.��!��


GetAllMembersIncidences

��

��$��.��!��/��.��!��#��!��

��#��#��0�#��#��

��

��$��

A dynamic long array variable used by the function to store the member numbers it retrieves.

��

A dynamic long array variable used by the function to store the starting node (a.k.a. Node A) number for each member.

��%��

A dynamic long array variable used by the function to store the ending node (a.k.a. Node B) number for each member.

��

This function retrieves the member numbers and member incidences (starting node and ending node) for all members in the currently open STAAD file. For example, in the STAAD input file, the statement ‘MEMBER INCIDENCE 5 1 8’ means that Member 5 starts at Node 1 and Ends at Node 8. Using this example, if the GetAllMembersIncidences function sets a given position in the pnMemberNumbers array to a value of 5, the function would set the corresponding position in the pnStartNodeNos array to a value of 1 and in pnEndNodeNos to a value of 8.

The starting node is sometimes referred to in STAAD as member end A; the ending node is sometimes called member end B.

The member numbers, starting node numbers and ending node numbers are stored in dynamic arrays, since the size of the array will vary, depending on the number of members in the structure. The OpenSTAAD function GetMembersCount can be used to retrieve the number of members in the structure. Then, the VB ‘ReDim’ function can be used to size the arrays.


36 ��

Sub AllIncidences() Dim objOpenSTAAD As Output Dim pnMembers As Long 'The next 3 are dynamic array variables, use empty paren. right now 'We will use GetMembersCount to find the size of the array, ' then we will use a ReDim statement to size the array. Dim pnMemberNumbers() As Long Dim pnStartNodeNos() As Long Dim pnEndNodeNos() As Long Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std" 'Find the number of members in the structure objOpenSTAAD.GetMembersCount pnMembers 'Now that we know how many members there are, we can REDIMension the arrays. ReDim pnMemberNumbers(pnMembers) ReDim pnStartNodeNos(pnMembers), pnEndNodeNos(pnMembers) 'Now we're ready to get the member numbers and incidences and write them into ' the arrays. When passing array names, also need to specify the starting ' position (in parentheses). 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetAllMembersIncidences _ pnMemberNumbers(0), pnStartNodeNos(0), pnEndNodeNos(0) 'Now write the results in columns 1-4 of the worksheet, starting on Row 50. For i = 1 To pnMembers 'Don't forget to specify the arrays' starting points, use i-1. Cells(49 + i, 1).Value = pnMemberNumbers(i - 1) Cells(49 + i, 2).Value = pnStartNodeNos(i - 1) Cells(49 + i, 3).Value = pnEndNodeNos(i - 1) Next i 'Close the STAAD file and release the OpenSTAAD object. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��1��+�

$��.��!��/��

$��.��!��

$��#�(�.��!��

��!��.��!��


GetNextMember

��

��$��#�(�.��!��,��.��!��#��

��#�(�.��!��#��#��#��0�#��#��

��

�� $��

A long variable specifying the member number corresponding to the member prior (i.e., the antecedent, in ascending numerical order) to the member for which the member number and incidences are to be obtained. If this variable is set to a value of 0, the function will return the member number and incidences for the member with the lowest valid member number.

��!�$��

A long variable for the function to use in storing the member number it retrieves from STAAD.Pro.

��

A long variable in which the function will store the node number for the starting node (end A) of the member.

��%��

A long variable in which the function will store the node number for the ending node (end B) of the member.

��

This function retrieves the member number and member incidences (starting and ending node numbers) for the next valid member number in ascending numerical order from a given member. This function may be useful where it is desired to obtain the member numbers and/or incidences for a limited range of members. It may also be helpful when it is desired to know the next member number in a STAAD model where not all integers within a given range have been assigned to a member.


38 To obtain the member number and incidences for the member with the lowest valid member number, set the value of nPreviousMemberNo to 0.

��

Sub NextMemb() 'This macro allows us to enter a starting member number in an Excel worksheet. 'We also enter the number of nodes above the starting node we want the function ' to retrieve. 'The node numbers and coordinates are then displayed in the worksheet. Dim objOpenSTAAD As Output Dim nPreviousMemberNo As Long Dim nHowMany As Long Dim pnNextMemberNo As Long Dim pnStartNodeNo As Long Dim pnEndNodeNo As Long 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open STAAD's Example 8 (US) objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std" 'Get the starting member number from Row 48, Column 10 of the Excel worksheet nPreviousMemberNo = Cells(48, 10).Value 'Get from Row 48, Column 6 the number of succeeding members you want ' OpenSTAAD to retrieve. 'Note that we could have said 'For i = 1 To Cells(48,6).Value' but doing it ' the following way is more efficient. We only retrieve the value once, ' instead of doing it each time we iterate through the loop. nHowMany = Cells(48, 6).Value For i = 1 To nHowMany 'Now execute the function. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetNextMember _ nPreviousMemberNo, pnNextMemberNo, pnStartNodeNo, pnEndNodeNo 'Write the results starting in Row 50, Member No. in Column 6, starting ' node in column 7, etc. Cells(49 + i, 6).Value = pnNextMemberNo Cells(49 + i, 7).Value = pnStartNodeNo Cells(49 + i, 8).Value = pnEndNodeNo 'Now, to prepare to reiterate, increment the value of the previous ' node number. The next node number now becomes the previous node number for ' the next iteration. nPreviousMemberNo = pnNextMemberNo 'Do it again until you've done it the number of times you specified in the ' worksheet cell, Row 48 Column 6. Next 'Close the STAAD file and release the handles to the OpenSTAAD library.


objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��/��

$��.��!��

$��.��!��/��

��!��.��!��


40

RenumberMembers

��

�� !��.��!��*�.��!#��

�#�-.��!#��

��

�"��$��

An integer variable passed to the function specifying the existing member number which is to be changed to a new number.

��#$��

An integer variable passed to the function specifying the new number to be used to replace the existing member number.

��

This function assigns a new number to an existing member. The old member number and the new number are both passed to the function. The function then modifies the input file so that every reference to the old member number is changed to the new member number.

��

Sub ChangeBeamNumber() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Change the number of Beam no. 1 to Beam no. 100. objOpenSTAAD.RenumberMembers 1, 100 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�


��

$��.��!��/��

$��.��!��

$��.��!��/��

$��#�(�.��!��

��


42

GetPlateIncidences

��

��$��,��/��,��#��#��

��#��2��#��#��

��

��

A long value greater than 0 specifying the plate in the model for which the incidences are to be retrieved.

��

A long variable for storing the first plate incidence node number (Node A) retrieved by the function.

��&

A long variable for storing the second plate incidence node number (Node B) retrieved by the function.

��

A long variable for storing the third plate incidence node number (Node C) retrieved by the function.

��

A long variable for storing the fourth plate incidence node number (Node D) retrieved by the function. If the plate specified by the nPlateNo parameter is a 3-noded plate (triangular), the function will store a value of 0 in the pnNodeD variable.

��

This function retrieves the plate incidences for a given plate in the currently open STAAD model and stores the node numbers in four integer variables passed to the function as parameters. STAAD plate elements may be either 3-noded (triangular) or 4-noded (quadrilateral). If the plate incidences retrieved by the function are for a 3-noded plate (triangular), the function will store a value of 0 in the pnNodeD variable. Please note that even if all the plates in your STAAD model are triangular,


you must still pass a name for the pnNodeD variable to the function, because this function expects 5 parameters.

��

Sub PlateIncid() Dim objOpenSTAAD As Output Dim pnNodeA As Long Dim pnNodeB As Long Dim pnNodeC As Long Dim pnNodeD As Long 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open STAAD's Example 10 (US). objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp10.std" 'Retrieve the plate incidences for Plate No. 8. objOpenSTAAD.GetPlateIncidences 8, pnNodeA, pnNodeB, pnNodeC, pnNodeD 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��

$��,��/��

$��,��0��


44

GetPlatesCount

��

��$��,��,��

��

��

A long variable used by the function to store the number of plates.

��

This function retrieves the number of plates in the currently open STAAD model, and stores that number in an integer variable.

��

Sub HowManyPlates() Dim objOpenSTAAD As Output Dim pnPlates As Long 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open STAAD's Example 10 (US). objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp10.std" 'Retrieve the number of plates in the examp10.std model. objOpenSTAAD.GetPlatesCount pnPlates 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��/��

$��,��/��

$��,��0��

GetAllPlatesIncidences


��

��$��,��/��,��#��#��

��#��2��#��#��

��

��

A dynamic long array variable used by the function to store the plate numbers it retrieves.

��

A dynamic long array variable used by the function to store the number of Node A for each plate.

��&

A dynamic long array variable used by the function to store the number of Node B for each plate.

��

A dynamic long array variable used by the function to store the number of Node C for each plate.

��

A dynamic long array variable used by the function to store the number of Node D for each plate. If the plate is a 3-noded plate (triangular), the function will set this variable to a value of 0.

��

This function retrieves the plate numbers and plate incidences for all plates in the currently open STAAD file.

The plate numbers and incidences (node numbers) are stored in dynamic arrays, since the size of the array will vary, depending on the number of plates in the structure. The OpenSTAAD function GetPlatesCount can be used to retrieve the number of plates in the structure. Then, the VB ‘ReDim’ function can be used to size the arrays.


46 STAAD plate elements can be 3-noded (triangular) or 4-noded (quadrilateral). If the plate incidences retrieved by the function are for a 3-noded plate (triangular), the function will store a value of 0 in the pnNodeD variable. Please note that even if all the plates in your STAAD model are triangular, you must still pass a name for the pnNodeD variable to the function, because this function expects 5 parameters.

��

Sub AllPlatesIncid() Dim objOpenSTAAD As Output Dim pnPlates As Long 'The next 4 are dynamic array variables, use empty paren. right now. 'We will use GetPlatesCount to find out what size the arrays should be, ' then we will use a ReDim statement to size the arrays. Dim pnPlateNos() As Long Dim pnNodeA() As Long Dim pnNodeB() As Long Dim pnNodeC() As Long Dim pnNodeD() As Long 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open STAAD's Example 10 (US) objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp10.std" 'Retrieve the number of plates in the examp10.std model. objOpenSTAAD.GetPlatesCount pnPlates 'Now that we know how many plates there are, we can REDIMension the arrays. ReDim pnPlateNos(pnPlates) ReDim pnNodeA(pnPlates), pnNodeB(pnPlates), pnNodeC(pnPlates) ReDim pnNodeD(pnPlates) 'When passing array names, also need to specify the starting position ' (in parentheses) 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetAllPlatesIncidences _ pnPlateNos(0), pnNodeA(0), pnNodeB(0), pnNodeC(0), pnNodeD(0) 'Now write the results in columns 1-5 of the worksheet, starting on Row 80. For i = 1 To pnPlates 'Remember to specify the arrays' starting points, use i-1 Cells(79 + i, 1).Value = pnPlateNos(i - 1) Cells(79 + i, 2).Value = pnNodeA(i - 1) Cells(79 + i, 3).Value = pnNodeB(i - 1) Cells(79 + i, 4).Value = pnNodeC(i - 1) Cells(79 + i, 5).Value = pnNodeD(i - 1) Next 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing


End Sub

�

��

$��,��/��

$��,��

$��,��0��


48

GetPlateEdgeDistances

��

��$��,��0��,��#��!��

�1��+��

��

��

An integer variable passed to the function to specify the number of the plate for which the function is to retrieve the edge distances.

��'��(�

An array of four double values for the function to use in storing the edge distances it retrieves from STAAD.Pro.

��

This function retrieves the edge distances for a given plate in the currently open STAAD file. The number of the plate for which the function is to retrieve the edge distances, and a variable name for storing the results are passed to the function. The function then stores the edge distances in the pdLengths array variable. If the plate has four sides (i.e. a four-noded plate), the array is filled in the order AB, BC, CD, DA. If the plate has only three sides (three node plate), the array is filled in the order AB, BC, CA, and a value of 0 is assigned to the fourth position in the pdLengths array.

��

Sub PlateEdgeLengths() Dim objOpenSTAAD As Output Dim pnPlateNo As Integer Dim pdLengths(3) As Double 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open STAAD's Example 10 (US). objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp10.std" 'Retrieve the edge distances for plate no. 23. pnPlateNo = 23 objOpenSTAAD.GetPlateEdgeDistances pnPlateNo, pdLengths(0)


'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��/��

$��,��

$��,��/��


50

GetSolidIncidences

��

��$��/��#��#��#��

��

��

A long variable greater than or equal to one specifying the solid number for which the function is to retrieve the incidences.

��

An array of 8 long values which the function will use to store the solid incidences (node numbers) it retrieves from STAAD.Pro.

��

This function retrieves the incidences for a given solid in the currently open STAAD model.

STAAD solid elements consist of 8 nodes. By collapsing various nodes together, an 8-noded solid element can be degenerated into forms with 4 to 7 nodes.

��

Sub SolidIncid() 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an array of 8 integer values for storing the function results. Dim pnNodeNos(0 To 7) As Long 'Run an instance of OpenSTAAD and open Example 24 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp24.std" 'Get the incidences for Solid No. 9 and store the values in the array pnNodeNos. objOpenSTAAD.GetSolidIncidences 9, pnNodeNos(0) 'Display the values from the array pnNodeNos in the worksheet, Row 2, ' Columns 1-8. For i = 1 To 8 Cells(2, i).Value = pnNodeNos(i - 1)


Next i 'Close the STAAD file and release the handles to OpenSTAAD. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��

$��/��


52

GetSolidsCount

��

��$��

��

��

A long variable used by the function to store the number of solids it retrieves.

��

This function retrieves the number of solid elements in the currently open STAAD model.

��

Sub HowManySolids() 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an integer variable to store the function results. Dim pnSolids As Long 'Run an instance of OpenSTAAD and open Example 24 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp24.std" 'Get the number of solids and store the value in the integer variable pnSolids. objOpenSTAAD.GetSolidsCount pnSolids 'Close the STAAD file and release the handles to OpenSTAAD. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��/��

$��/��


GetAllSolidsIncidences

��

��$��/��#��#��

��#��2��#��#��#��0��#��#��$��#��)��

��

��

A dynamic long array variable used by the function to store the solid element numbers it retrieves.

��

A dynamic long array variable used by the function to store the number of Node A for each solid element.

��&

A dynamic long array variable used by the function to store the number of Node B for each solid element.

��

A dynamic long array variable used by the function to store the number of Node C for each solid element.

��

A dynamic long array variable used by the function to store the number of Node D for each solid element.

��%

A dynamic long array variable used by the function to store the number of Node E for each solid element.

��


54 A dynamic long array variable used by the function to store the number of Node F for each solid element.

��)

A dynamic long array variable used by the function to store the number of Node G for each solid element.

��*

A dynamic long array variable used by the function to store the number of Node H for each solid element.

��

This function retrieves the solid numbers and solid incidences for all solid elements in the currently open STAAD file.

The solid elements’ numbers and incidences (node numbers) are stored in dynamic arrays, since the size of the array will vary, depending on the number of solids in the structure. The OpenSTAAD function GetSolidsCount can be used to retrieve the number of solid elements in the structure. Then, the VB ‘ReDim’ function can be used to size the arrays.

��

Sub AllSolidIncid() Dim objOpenSTAAD As Output Dim pnSolids As Long 'The next 9 are dynamic array variables, use empty paren. right now. 'We will use GetSolidsCount to find what size arrays are needed, ' then we will use a ReDim statement to size the arrays. Dim pnSolidNos() As Long Dim pnNodeA() As Long Dim pnNodeB() As Long Dim pnNodeC() As Long Dim pnNodeD() As Long Dim pnNodeE() As Long Dim pnNodeF() As Long Dim pnNodeG() As Long Dim pnNodeH() As Long 'Run an instance of OpenSTAAD and open Example 24 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp24.std" 'Get the number of solids and store the value in the integer variable pnSolids. objOpenSTAAD.GetSolidsCount pnSolids 'Now that we know how many solids there are in Example 24, we can ' REDIMension the arrays


ReDim pnSolidNos(pnSolids) ReDim pnNodeA(pnSolids), pnNodeB(pnSolids) ReDim pnNodeC(pnSolids), pnNodeD(pnSolids) ReDim pnNodeE(pnSolids), pnNodeF(pnSolids) ReDim pnNodeG(pnSolids), pnNodeH(pnSolids) 'When passing array names, also need to specify the starting position ' (in parentheses). 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetAllSolidsIncidences pnSolidNos(0), _ pnNodeA(0), pnNodeB(0), pnNodeC(0), pnNodeD(0), _ pnNodeE(0), pnNodeF(0), pnNodeG(0), pnNodeH(0) 'Now write the results in columns 1-9 of the worksheet, starting on Row 10. For i = 1 To pnSolids 'Remember to specify the arrays' starting points, use i-1. Cells(9 + i, 1).Value = pnSolidNos(i - 1) Cells(9 + i, 2).Value = pnNodeA(i - 1) Cells(9 + i, 3).Value = pnNodeB(i - 1) Cells(9 + i, 4).Value = pnNodeC(i - 1) Cells(9 + i, 5).Value = pnNodeD(i - 1) Cells(9 + i, 6).Value = pnNodeE(i - 1) Cells(9 + i, 7).Value = pnNodeF(i - 1) Cells(9 + i, 8).Value = pnNodeG(i - 1) Cells(9 + i, 9).Value = pnNodeH(i - 1) Next i 'Close the STAAD file and release the handles to OpenSTAAD. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��/��

$��


56

WriteGeometry

��

��3��$��#��

��

��

A string for the function to use to create a file in which it will store the geometry for the currently open STAAD project file. This VB string should be enclosed in quotation marks. It should include the complete path to the location of an existing directory on the computer, to specify to the function the location where the file it creates is to be stored, followed by the filename and desired extension, if any. Since this function writes the file in the same format as a STAAD.Pro input file, the extension STD would be a logical choice for the filename extension.

��

This function retrieves the node coordinates, member incidences, plate incidences and solid incidences in the currently open STAAD project. A filename and path is passed to the function as a string, or in a string variable. The function creates the geometry file at the specified location and with the specified name. It then stores the node coordinates, member incidences, plate incidences and solid incidences in the geometry file in STAAD.Pro input file format.

��

Sub CreateProjectGeometryFile() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Create a file named geometryfile.std. 'Store it in the temp folder on the C drive. 'Then write the project geometry into the file. objOpenSTAAD.WriteGeometry “C:\temp\geometryfile.std” 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


Functions Related to Groups

GetNumberOfGROUPS

��

��$��#��!��* $ *4,��$��

��

��)��

An integer variable for the function to use in storing the number of groups it retrieves from STAAD.Pro.

��

This function retrieves the number of groups in the currently open STAAD file and stores the result in the pnGroups variable. This number will be the sum of all types of groups in the project, including node, beam, plate, solid and geometry groups.

VBA is not case-sensitive, however if you are writing your OpenSTAAD program in an application such as C++ which is case-sensitive, you must be sure to use upper and lower case characters in this function’s name as indicated, i.e. GetNumberOfGROUPS.

��

Sub HowManyGroups() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable name for storing the function results. Dim pnGroups As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the number of groups in examp01.std. objOpenSTAAD.GetNumberOfGROUPS pnGroups 'Close the STAAD file and release the handles to the OpenSTAAD library.


58 ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��!��* $ *4,��

$��$ *4,#��

$��#��!��* 0��/�$ *4,�

$��0��/�$ *4,�


GetNumberOfGROUPTypes

��

��$��#��!��* $ *4,��#��$��

��2��$��,��$��$��$��$��

��

��)��

An integer variable for the function to use in storing the number of node groups it retrieves from STAAD.Pro.

��&��)��

An integer variable for the function to use in storing the number of beam groups it retrieves from STAAD.Pro.

��)��

An integer variable for the function to use in storing the number of groups of plate elements it retrieves from STAAD.Pro.

��)��

An integer variable for the function to use in storing the number of groups of solid elements it retrieves from STAAD.Pro.

��)��)��

An integer variable for the function to use in storing the number of geoemetry groups it retrieves from STAAD.Pro.

��

This function retrieves the number of groups of each type in the currently open STAAD file. There are five types of groups in STAAD.Pro: node, beam, plate, solid and geometry groups. Five variable names are passed to the function, e.g., pnNodeGroups, pnBeamGroups, pnPlateGroups, pnSolidGroups and pnGeomGroups (it is not necessary to use these particular names; any allowable VBA integer variable names may be used). The function then stores the number of


60 node groups in the first variable, the number of beam groups in the second variable, the number of plate groups in the third variable, the number of solid groups in the fourth variable, and the number of geometry groups in the fifth variable.

VBA is not case-sensitive, however if you are writing your OpenSTAAD program in an application such as C++ which is case-sensitive, you must be sure to use upper and lower case characters in this function’s name as indicated, i.e. GetNumberOfGROUPTypes.

��

Sub HowManyOfEachTypeOfGroup() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare 5 integer variable names for storing the function results. Dim pnNodeGroups As Integer Dim pnBeamGroups As Integer Dim pnPlateGroups As Integer Dim pnSolidGroups As Integer Dim pnGeomGroups As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the number of each type of group in examp01.std. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetNumberOfGROUPTypes _ pnNodeGroups, pnBeamGroups, pnPlateGroups, pnSolidGroups, pnGeomGroups 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��!��* $ *4,��

$��$ *4,#��

$��#��!��* 0��/�$ *4,�

$��0��/�$ *4,�


GetGROUPNamesForType

��

��$��$ *4,#��

��$��#��

��

��+��

An integer variable passed to the function to specify the group type for which the function is to retrieve the group names. nType = 0 for node groups, 1 for beam groups, 2 for plate groups, 3 for solid groups, and 4 for geometry groups.

��)��

An integer variable for the function to use in storing the number of groups of type nType in the structure.

��

A dynamic string array variable for the function to use in storing the names of the groups of type nType in the structure.

��

This function retrieves the number of groups of a specified type and the names of those groups in the currently open STAAD file. There are five types of groups in STAAD.Pro: node, beam, plate, solid and geometry groups. The group type for which the number of groups and their names are to be retrieved is passed to the function as the first parameter nType, where nType = 0 for node groups, 1 for beam groups, 2 for plate groups, 3 for solid groups, and 4 for geometry groups. The function stores the number of groups of the type specified by nType in the integer variable pnGroupCount. The function stores the group names in a dynamic string array pstrNames. The size of the array will vary, depending on the number of groups of type nType in the structure. The OpenSTAAD function GetNumberOfGROUPTypes can be used to retrieve the number of groups of type nType in the structure. Then, the VB “ReDim” function can be used to size the pstrNames array before calling the GetGROUPNamesForType function.

VBA is not case-sensitive, however if you are writing your OpenSTAAD program in an application such as C++ which is case-sensitive, you must be sure to use upper


62 and lower case characters in this function’s name as indicated, i.e. GetGROUPNamesForType.

��

Sub NosAndNamesOfTypeGroup() 'This sample macro will demonstrate how to retrieve the number of beam groups ' and their names that exist in a dummy project we shall call myproject. 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable name for storing the number of beam groups. Dim pnGroupCount As Integer 'The next variable is a dynamic array for storing the beam group names. Use ' empty paren. right now. We will use GetNumberOfGROUPTypes to find the number ' of beam groups in the structure, then we will use a VB ReDim function to size ' the array. Dim pstrNames() As String 'Run an instance of OpenSTAAD and open a project file myproject.std. Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\Projects\MyProject.std" 'Determine the number of groups of each type in the structure. objOpenSTAAD.GetNumberOfGROUPTypes _ pnNodeGroups, pnBeamGroups, pnPlateGroups, pnSolidGroups, pnGeomGroups 'Now that we know how many beam groups there are, we can resize pstrNames array. ReDim pstrNames(1 To pnBeamGroups) 'Retrieve the number of beam groups and their names in myproject.std. objOpenSTAAD.GetGROUPNamesForType 1, pnGroupCount, pstrNames(1) 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��!��* $ *4,��

$��#��!��* $ *4,��

$��#��!��* 0��/�$ *4,�

$��0��/�$ *4,�


GetNumberOfEntitiesInGROUP

��

��$��#��!��* 0��/�$ *4,��

�"$��#��

��

��+��

An integer variable passed to the function to specify the group type for which the function is to retrieve the number of entities. nType = 0 for groups of node entities, 1 for groups of beam entities, 2 for groups of plate entities, 3 for groups of solid entities, and 4 for groups of geometry entities.

��)��

An string variable passed to the function to specify the name of the group for which the function is to retrieve the number of entities.

��

An integer variable for the function to use in storing the number of entities in the szGroupName group.

��

This function retrieves the number of entities in a specified group in the currently open STAAD file. There are five types of groups in STAAD.Pro: node, beam, plate, solid and geometry groups. The group type for which the number of groups and their names are to be retrieved is passed to the function as the first parameter nType, where nType = 0 for node groups, 1 for beam groups, 2 for plate groups, 3 for solid groups, and 4 for geometry groups. A string variable specifying the group name for which the number of entities are to be retrieve is also passed to the function. The function then returns the number of entities in the group and stores that number in the pnTotalCount variable.

VBA is not case-sensitive, however if you are writing your OpenSTAAD program in an application such as C++ which is case-sensitive, you must be sure to use upper and lower case characters in this function’s name as indicated, i.e. GetNumberOfEntitiesInGROUP.


64 ��

Sub HowManyInGroup() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable name for storing the number of entities. Dim pnTotalCount As Integer 'Run an instance of OpenSTAAD and open a project file myproject.std. Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\Projects\MyProject.std" 'Determine the number of entities in the group of beams named _Members. objOpenSTAAD.GetNumberOfEntitiesInGroup 1, “_Members”, pnTotalCount 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��!��* $ *4,��

$��#��!��* $ *4,��

$��$ *4,#��

$��0��/�$ *4,�


GetAllEntitiesInGROUP

��

��$��0��/�$ *4,��

�"$��#��1��

��

��+��

An integer variable passed to the function to specify the group type for which the function is to retrieve the number of entities in the group and the identification numbers assigned to those entities. nType = 0 for groups of node entities, 1 for groups of beam entities, 2 for groups of plate entities, 3 for groups of solid entities, and 4 for groups of geometry entities.

��)��

An string variable passed to the function to specify the name of the group for which the function is to retrieve the number of entities in the group and the identification numbers assigned to those entities.

��

An integer variable for the function to use in storing the number of entities in the szGroupName group.

��'��

A dynamic long array variable for the function to use in storing the identification numbers of the entities in the szGroupName group.

��

This function retrieves the number of entities in a specified group in the currently open STAAD file. There are five types of groups in STAAD.Pro: node, beam, plate, solid and geometry groups. The group type for which the number of entities and their identification numbers are to be retrieved is passed to the function as the first parameter nType, where nType = 0 for node groups, 1 for beam groups, 2 for plate groups, 3 for solid groups, and 4 for geometry groups. A string variable (szGroupName) specifying the group name for which the number of entities are to be retrieved is also passed to the function. The function stores the number of entities


66 in the group in the pnCount variable. The function then stores the identification numbers of the entities in the group in a dynamic long array (pnList). The size of the array will vary, depending on the number of entities in the group. The OpenSTAAD function GetNumberOfEntitiesInGroup can be used to retrieve the number of groups of type nType in the structure. Then, the VB “ReDim” function can be used to size the pnList array before calling the GetAllEntitiesInGroup function.

VBA is not case-sensitive, however if you are writing your OpenSTAAD program in an application such as C++ which is case-sensitive, you must be sure to use upper and lower case characters in this function’s name as indicated, i.e. GetAllEntitiesInGROUP.

��

Sub ListEntityNumbersInGroup() 'This sample macro will demonstrate how to retrieve the number of beams ' and their ID numbers from a group called _Members in a dummy project we ' shall call myproject. 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare integer variable names for storing the number of beams. Dim pnTotalCount As Integer Dim pnCount As Integer 'The next variable is a dynamic array for storing the beam numbers. Use ' empty paren. right now. We will use GetNumberOfEntitiesInGROUP to find the ' number of beams in the group, then we will use a VB ReDim function to size ' the array. Dim pnList() As String 'Run an instance of OpenSTAAD and open a project file myproject.std. Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\Projects\MyProject.std" 'Determine the number of entities in the group of beams named _Members. objOpenSTAAD.GetNumberOfEntitiesInGROUP 1, “_Members”, pnTotalCount 'Now that we know how many beams there are in the _Members group, we can ' resize the pnList array. ReDim pnList(1 To pnTotalCount) 'Retrieve the number of beams and their ID numbers in the _Members group of the ' structure model myproject. objOpenSTAAD.GetGROUPNamesForType 1, “_Members”, pnCount, pnList(1) 'Close the STAAD file and release the handles to the OpenSTAAD library. ObjOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


��

$��#��!��* $ *4,��

$��#��!��* $ *4,��

$��$ *4,#��

$��#��!��* 0��/�$ *4,�


68

Member Specifications Functions

GetSupportCondition

��

��$��#��#��

��

��

��

An integer value greater than 0 specifying the number of the node for which the function is to retrieve the support condition.

��

The name of an integer variable for the function to use in storing the support condition it retrieves.

0 = NoSupport 5 = InclinedPinned 1 = Fixed 6 = InclinedFixedBut 2 = Pinned 7 = Footing 3 = FixedBut 8 = ElasticMat 4 = InclinedFixed 9 = MultiLinear

��

This function retrieves the support condition at a given node in the currently open STAAD model. The support condition is stored as an integer value representing one of ten possible support conditions.

0) NoSupport No support exists at the node.

1) Fixed The joint is fixed in all 6 degrees of freedom.

2) Pinned No moments can be carried by this support.

3) FixedBut A fixed support that has been released in specified global directions (Fx for force-X


through Mz for moment Z). Spring constants may specify the support condition in a given global direction.

4) InclinedFixed The support is fixed in all 6 degrees of freedom, but is inclined with respect to the global axes.

5) InclinedPinned The support is inclined with respect to the global axes and it cannot carry any moments.

6) InclinedFixedBut The support is inclined with respect to the global axes. It is fixed but with releases specified in certain global directions.

7) Footing The support is modeled as a footing with a given influence area and sub-grade modulus (see Section 5.27.3 in the STAAD.Pro Technical Reference Manual).

8) ElasticMat The support is modeled as an elastic mat. The program calculates the influence area of the support, and then the stiffness, given the sub-grade modulus and degrees of freedom in specified global directions (see Section 5.27.3 in the STAAD.Pro Technical Reference Manual).

9) MultiLinear The support is modeled as a multi-linear spring (see Section 5.27.4 in the STAAD.Pro Technical Reference Manual).

�

��

Sub SupCond() Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnSupportCond As Integer 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Get the support condition for Node 1 and store the result in the ' pnSupportCond integer variable. objOpenSTAAD.GetSupportCondition 1, pnSupportCond 'Close the STAAD file and release the handles to OpenSTAAD. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing


70 End Sub

�

��

$��

$��


GetMemberOffsets

��

$��.��!��* ��.��!��#��0��

��$��!��!��%��!��&��!��'��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member has releases.

�%��

Specify a 0 to retrieve the member offsets for the starting end of the member (start joint number of member incidence) or a 1 to retrieve the member offsets for the end of the member (end joint number of member incidence).

��)��

An integer variable for the function to use in storing the value it returns for the coordinate axis system, either a 0 or a 1. If the member offsets are specified in the global coordinate system, the function will return a 1 and store it in the pnGlobal variable; if the member offsets are specified in the member’s local coordinate system, the function will return a 0 and store it in the pnGlobal variable.

��

A double (8-byte floating point) variable for the function to use in storing the member offset in the X direction it retrieves from STAAD.Pro.

��

A double (8-byte floating point) variable for the function to use in storing the member offset in the Y direction it retrieves from STAAD.Pro.

��

A double (8-byte floating point) variable for the function to use in storing the member offset in the Z direction it retrieves from STAAD.Pro.


72 ��

This function retrieves the member offsets for a given end of a given member. The member number and member end are passed to the function as the first two parameters. The function returns an integer variable either a 0 or a 1 to indicate whether the offset distances are specified with respect to the global coordinate system, or in the member’s local coordinate system. If the member offsets are specified in the global coordinate system, the function will return a 1 and store it in the pnGlobal variable; if the member offsets are specified in the member’s local coordinate system, the function will return a 0 and store it in the pnGlobal variable. The function then returns the member offsets in the X, Y and Z directions and stores them in the pdX, pdY and pdZ variables respectively.

All values are given in units of kips and inches.

��

Sub MembOffsets() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare variables for storing function results. Dim pnGlobal As Integer Dim pdX As Double Dim pdY As Double Dim pdZ As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 7 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp07.std" 'Determine member offsets for the starting end of member 6. objOpenSTAAD.GetMemberOffsets 6, 0, pnGlobal, pdX, pdY, pdZ 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

��.��!��)��

/��0� ��

/�0�0� ��

$��*� ��* .��!��

$��*� ��0�* .��!��


DoesMemberHaveReleases

��

��.��!��)�� .��!��#��

��0��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member has releases.

��

An integer variable name for storing the results returned by the function for the starting end (end A) of the member. A value of 0 stored in pnStart indicates that none of the degrees of freedom are released; a value of 1 indicates that one or more degrees of freedom are released.

��%��

An integer variable name for storing the results returned by the function for the ending end (end B) of the member. A value of 0 stored in pnEnd indicates that none of the degrees of freedom are released; a value of 1 indicates that one or more degrees of freedom are released.

��

This function determines whether any degrees of freedom at either end of a given member have been released. The member number is passed to the function, then the function returns either a 0 or a 1 for each end of the member and stores those values in two variable names for the starting end (end A) and the ending end (end B) values respectively. A value of 0 indicates that none of the degrees of freedom are released; a value of 1 indicates that one or more degrees of freedom are released.

Note that Starting End and Ending End is based on the Member Incidence specification.


74 ��

Sub GotReleases() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare variables for storing function results. Dim pnStart As Integer Dim pnEnd As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether Member 3 has releases at either the start or the end. objOpenSTAAD.DoesMemberHaveReleases 3, pnStart, pnEnd 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��* ��

/��0� ��

/�0�0� ��

$��*� ��* .��!��

$��*� ��0�* .��!��


IsStartEndReleased

��

��/��0� ��.��!��#��

��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the starting end is released.

��

An integer variable name for storing the results returned by the function. A value of 0 stored in pnReleased indicates that none of the degrees of freedom are released at the starting end of the member; a value of 1 indicates that one or more degrees of freedom are released.

��

This function determines whether any degrees of freedom at the starting end (end A) of a given member have been released. The member number is passed to the function, then the function returns either a 0 or a 1 and stores the value in a variable name passed to it as the second parameter. A value of 0 indicates that none of the degrees of freedom are released; a value of 1 indicates that one or more degrees of freedom are released.


��

Sub StartEndRel() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable for storing function results. Dim pnReleased As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std"


76 'Determine whether Member 3 has releases at the starting end. objOpenSTAAD.IsStartEndReleased 3, pnReleased 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��* ��

��.��!��)��

/�0�0� ��

$��*� ��* .��!��

$��*� ��0�* .��!��


IsEndEndReleased

��

��/�0�0� ��.��!��#��

��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the end is released.

��

An integer variable name for storing the results returned by the function. A value of 0 stored in pnReleased indicates that none of the degrees of freedom are released at the ending end of the member; a value of 1 indicates that one or more degrees of freedom are released.

��

This function determines whether any degrees of freedom at the ending end (end B) of a given member have been released. The member number is passed to the function, then the function returns either a 0 or a 1 and stores the value in a variable name passed to it as the second parameter. A value of 0 indicates that none of the degrees of freedom are released; a value of 1 indicates that one or more degrees of freedom are released at the ending end.


��

Sub EndRel() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare integer variable for storing function results. Dim pnReleased As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std"


78 'Determine whether Member 3 has releases at the ending end. objOpenSTAAD.IsEndEndReleased 3, pnReleased 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��* ��

��.��!��)��

/��0� ��

$��*� ��* .��!��

$��*� ��0�* .��!��


GetDOFReleasedAtStartOfMember

��

��$��*� ��* .��!��.��!��#��

��*��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the degrees of freedom at the start of the member.

��"��

An array of 6 integer values representing the 6 degrees of freedom FX, FY, FZ, MX, MY and MZ respectively at the starting end of the member. A 0 in the array indicates that the corresponding degree of freedom is fixed; a 1 indicates that the corresponding degree of freedom has been released.

��

This function determines the degrees of freedom at the starting end (end A) of a member and stores the results in an array of 6 integer values. These values represent the 6 degrees of freedom FX, FY, FZ, MX, MY and MZ respectively. A 0 in the array indicates that the corresponding degree of freedom is fixed; a 1 indicates that the corresponding degree of freedom has been released.

For example, if the function returns values of 1,1,1,0,0,0 to the array, the starting end of the member is pinned; it can resist axial forces FX, FY and FZ, but not moments MX, MY and MZ.



80 ��

Sub DOFatStart() 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an array of 6 integer values for storing the function results. Dim pnDOFs(6) As Integer 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Get the degrees of freedom for the starting end of member 5 and store ' the result in the pnDOFs integer array. objOpenSTAAD.GetDOFReleasedAtStartOfMember 5, pnDOFs(0) Cells(10, 12).Value = pnDOFs(0) Cells(11, 12).Value = pnDOFs(1) Cells(12, 12).Value = pnDOFs(2) Cells(13, 12).Value = pnDOFs(3) Cells(14, 12).Value = pnDOFs(4) Cells(15, 12).Value = pnDOFs(5) 'Close the STAAD file and release the handles to OpenSTAAD. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��* ��

��.��!��)��

/��0� ��

/�0�0� ��

$��*� ��0�* .��!��


GetDOFReleasedAtEndOfMember

��

��$��*� ��0�* .��!��.��!��#��

��*��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the degrees of freedom released at the end of the member.

��"��

An array of 6 integer values representing the 6 degrees of freedom FX, FY, FZ, MX, MY and MZ respectively at the ending end (end B) of the member. A 0 in the array indicates that the corresponding degree of freedom is fixed; a 1 indicates that the corresponding degree of freedom has been released.

��

This function determines the degrees of freedom at the ending end (end B) of a member and stores the results in an array of 6 integer values. These values represent the 6 degrees of freedom FX, FY, FZ, MX, MY and MZ respectively. A 0 in the array indicates that the corresponding degree of freedom is fixed; a 1 indicates that the corresponding degree of freedom has been released.

For example, if the function returns values of 1,1,1,0,0,0 to the array, the ending end of the member is pinned; it can resist axial forces FX, FY and FZ, but not moments MX, MY and MZ.


��

Sub DOFatEnd()


82 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an array of 6 integer values for storing the function results. Dim pnDOFs(6) As Integer 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Get the degrees of freedom for the starting end of member 5 and store ' the result in the pnDOFs integer array. objOpenSTAAD.GetDOFReleasedAtEndOfMember 5, pnDOFs(0) Cells(10, 12).Value = pnDOFs(0) Cells(11, 12).Value = pnDOFs(1) Cells(12, 12).Value = pnDOFs(2) Cells(13, 12).Value = pnDOFs(3) Cells(14, 12).Value = pnDOFs(4) Cells(15, 12).Value = pnDOFs(5) 'Close the STAAD file and release the handles to OpenSTAAD. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��* ��

��.��!��)��

/��0� ��

/�0�0� ��

$��*� ��* .��!��


IsPartiallyReleasedAtStartOfMember

��

��/�,�� * .��!��.��!��#��

��,��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member is partially released at its starting end.

��

An integer variable name passed to the function for it to use in storing its results. A value of 0 indicates that none of the rotational degrees of freedom have been partially released; a value of 1 indicates that one or more degrees of freedom have been partially released.

��

Moments at the end of a member may be released partially, to model partial fixity of connections. This function determines whether any of the 3 rotational degrees of freedom Mx, My or Mz have been partially released at the starting end (end A) of a given member. The function stores the result as either a 0 or a 1 in an integer variable name passed to it as a parameter. A value of 0 indicates that none of the rotational degrees of freedom have been partially released at the starting end; a value of 1 indicates that one or more degrees of freedom have been partially released.


��

Sub StartPartRel() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare integer variable for storing function results. Dim pnPartialRel As Integer


84 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether Member 3 has a partial release at the starting end. objOpenSTAAD.IsPartiallyReleasedAtStartOfMember 3, pnPartialRel 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�,�� 0�* .��!��


IsPartiallyReleasedAtEndOfMember

��

��/�,�� 0�* .��!��.��!��#��

��,��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member is partially released at its end.

��

An integer variable name passed to the function for it to use in storing its results. A value of 0 indicates that none of the rotational degrees of freedom have been partially released; a value of 1 indicates that one or more degrees of freedom have been partially released.

��

Moments at the end of a member may be released partially, to model partial fixity of connections. This function determines whether any of the 3 rotational degrees of freedom Mx, My or Mz have been partially released at the ending end (end B) of a given member. The first parameter passed to the function represents the member number for which the function is to determine whether the starting end is partially released. The function stores the result as either a 0 or a 1 in an integer variable name passed to it as the second parameter. A value of 0 indicates that none of the rotational degrees of freedom have been partially released at the ending end; a value of 1 indicates that one or more degrees of freedom have been partially released.



86 ��

Sub EndPartRel() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare integer variable for storing function results. Dim pnPartialRel As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether Member 3 has a partial release at the ending end. objOpenSTAAD.IsPartiallyReleasedAtEndOfMember 3, pnPartialRel 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�,�� * .��!��


IsSpringReleaseAtStartOfMember

��

��/�� * .��!��.��!��#��

��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member has a spring release at its starting end.

��

The name of an integer variable passed to the function for it to use in storing the value it returns. The function will return a value of 0 if there is no spring release. It will return a value of 1 if there is a spring release.

��

This function checks a given member in the currently open STAAD file to determine if there is a spring release at the starting end of the member. The function will return a value of 0 if there is no spring release at the starting end (end A) of the member. It will return a value of 1 if there is a spring release at the starting end.

Note that Starting End (end A) and Ending End (end B) is based on the Member Incidence specification.

��

Public Sub IsSpringRelAtStart() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnSpringRel As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether there is any spring release at the starting end of Member 3.


88 objOpenSTAAD.IsSpringReleaseAtStartOfMember 3, pnSpringRel 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�� 0�* .��!��

$�� * .��!��

$�� 0�* .��!��

�


IsSpringReleaseAtEndOfMember

��

��/�� 0�* .��!��.��!��#��

��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member has a spring release at its end.

��

The name of an integer variable passed to the function for it to use in storing the value it returns. The function will return a value of 0 if there is no spring release. It will return a value of 1 if there is a spring release.

��

This function checks a given member in the currently open STAAD file to determine if there is a spring release at the ending end (end B) of the member. The function will return a value of 0 if there is no spring release at the ending end (end B) of the member. It will return a value of 1 if there is a spring release at the ending end.


��

Public Sub IsSpringRelAtEnd() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnSpringRel As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether there is any spring release at the ending end (end B) ' of Member 3.


90 objOpenSTAAD.IsSpringReleaseAtEndOfMember 3, pnSpringRel 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�� * .��!��

$�� * .��!��

$�� 0�* .��!��


GetSpringReleaseStiffnessesAtStartOfMember

��

��$�� * .��!��

�.��!��#��!��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the spring release stiffness factors.

��,��

An array of 6 double (8-byte floating point) values for the function to use in storing the 6 stiffness factors KFX, KFY, KFZ, KMX, KMY, and KMZ.

��

This function retrieves the spring release stiffness factors KFX, KFY, KFZ, KMX, KMY, and KMZ at the starting end (end A) of a given member.

The spring release stiffness values will be stored in the pdFactors array in the following order:

��,��- ./��

��,��0 ./��

��,��1 ./��

��,��2 ./$�

��,��3 ./$�

��,��4 ./$�




92 ��

Public Sub SpringStiff() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Object 'Declare a 6-value double array for storing the function results. Dim pdFactors(0 To 5) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve spring release stiffness factors at the starting end of Member 3. objOpenSTAAD.GetSpringReleaseStiffnessesAtStartOfMember 3, pdFactors(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�� * .��!��

/�� 0�* .��!��

$�� 0�* .��!��


GetSpringReleaseStiffnessesAtEndOfMember

��

��$�� 0�* .��!��

�.��!��#��!��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the spring release stiffness factors.

��,��


��

This function retrieves the spring release stiffness factors KFX, KFY, KFZ, KMX, KMY, and KMZ at the ending end (end B) of a given member.

The spring release stiffness values will be stored in the pdFactors array in the following order:

��,��- ./��

��,��0 ./��

��,��1 ./��

��,��2 ./$�

��,��3 ./$�

��,��4 ./$�




94 ��

Public Sub SpringStiff() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Object 'Declare an array of 6 double values for storing the function results. Dim pdFactors(0 To 5) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve spring release stiffness factors at the ending end (end B) of ' Member 3. objOpenSTAAD.GetSpringReleaseStiffnessesAtEndOfMember 3, pdFactors(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�� * .��!��

/�� 0�* .��!��

$�� * .��!��


GetSupportStiffnesses

��

��$�� #��#��!��

��

��

��

An integer variable greater than 0 specifying the number of the node for which the function is to retrieve the support stiffness factors.

��55��


��

This function retrieves the stiffness factors KFX, KFY, KFZ, KMX, KMY, and KMZ at a given supported node.

The support stiffness values will be stored in the pdStiffnesses array in the following order:

��55��- ./��

��55��0 ./��

��55��1 ./��

��55��2 ./$�

��55��3 ./$�

��55��4 ./$�




96 ��

Public Sub SuppStiff() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Object 'Declare an array of 6 double values for storing the function results. Dim pdStiffnesses(0 To 5) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve stiffness factors for the support at Node 2. objOpenSTAAD.GetSupportStiffnesses 2, pdStiffnesses(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��

$��


GetFullMemberReleaseInfoAtStart

��

��$��.��!�� /� ��.��!��#��

��/� ��!�� !��

�,��.��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the release information.

��6��

An integer variable name for storing the results returned by the function. A value of 0 stored in pnIsReleased indicates that none of the degrees of freedom are released at the starting end of the member; a value of 1 indicates that one or more degrees of freedom are released.

��55��


��$��,��

An array of 3 double (8-byte floating point) values for the function to use in storing the partial moment release factors for the rotational degrees of freedom Mx, MY, and MZ respectively. The moment release factors will have a value between 0 and 1.

��

This function checks the starting end (end A) of a given member to determine if any degrees of freedom are released. It also returns the stiffness factors for the 6 degrees of freedom, and the partial moment factors for the 3 rotational degrees of freedom.



98 ��

Sub GetFullInfo() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim pnIsReleased As Integer Dim pdSpringStiffnesses(0 To 5) As Double Dim pdPartialMomRelFactors(0 To 2) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Get release information at starting end (end A) of Member 3. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetFullMemberReleaseInfoAtStart 3, _ pnIsReleased, pdSpringStiffnesses(0), pdPartialMomRelFactors(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!�� /� ��0��

� �


GetFullMemberReleaseInfoAtEnd

��

��$��.��!�� /� ��0��.��!��#��

��/� ��!�� !��

�,��.��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the release information.

��6��

An integer variable name for storing the results returned by the function. A value of 0 stored in pnIsReleased indicates that none of the degrees of freedom are released at the ending end of the member; a value of 1 indicates that one or more degrees of freedom are released.

��55��


��$��,��

An array of 3 double (8-byte floating point) values for the function to use in storing the partial moment release factors for the rotational degrees of freedom Mx, MY, and MZ respectively. The moment release factors will have a value between 0 and 1.

��

This function checks the ending end (end B) of a given member to determine if any degrees of freedom are released. It also returns the stiffness factors for the 6 degrees of freedom, and the partial moment factors for the 3 rotational degrees of freedom.



100 ��

Sub GetFullInfo() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim pnIsReleased As Integer Dim pdSpringStiffnesses(0 To 5) As Double Dim pdPartialMomRelFactors(0 To 2) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Get release information at ending end (end B) of Member 3. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetFullMemberReleaseInfoAtEnd 3, _ pnIsReleased, pdSpringStiffnesses(0), pdPartialMomRelFactors(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!�� /� ��

�

� �


GetMemberBetaAngle

��

��$��.��!��2��.��!��#��!��2��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the beta angle.

��&��

The name of a double (8-byte floating point) variable for the function to use in storing the beta angle it retrieves.

��

This function retrieves the beta angle for a given member in the currently open STAAD file. The member number and variable name for storing the results are passed to the function as parameters.

��

Public Sub BetaAngle() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare a double variable for storing the function results. Dim pdBeta As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine the beta angle of Member 3. objOpenSTAAD.GetMemberBetaAngle 3, pdBeta 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�


102 ��

$��.��!��1��+�

$��.��!��3��+��+�

$��.��!��,��

$��.��!��,��,��

$��.��!��,��+��


GetMemberSteelDesignRatio

��

��$��.��!�� .��!��#��!��

� ��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the steel design ratio.

��

The name of a double (8-byte floating point) variable for the function to use in storing the steel design ratio it retrieves.

��

This function retrieves the steel design ratio for a given member in the currently open STAAD file. The member number and variable name for storing the results are passed to the function as parameters.

��

Public Sub SteelRatio() 'This is a VB for Excel macro. 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare a double variable for storing the function results. Dim pdRatio As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve Steel Design Ratio for Member 3. objOpenSTAAD.GetMemberSteelDesignRatio 3, pdRatio 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing


104 End Sub

�

��

$��.��!��,��


IsMemberACableMember

��

/�.��!��!��.��!��.��!��#��/��!��

��!��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member is a cable member.

��6��

The name of an integer variable passed to the function for it to use in storing the value it returns. The function will return a value of 0 if the member is not a cable member. It will return a value of 1 if the member is a cable member.

��

The name of a double (8-byte floating point) variable for the function to use in storing the tension force in the member it retrieves from STAAD.Pro.

��

This function determines whether a given member in the currently open STAAD file is a cable member. The member number and variable names for storing the results are passed to the function as parameters.

If the member is a cable member, the function returns an integer value of 1 and stores it in the pnIsCable integer variable. It also retrieves the value of the tension force applied to the cable member and stores the value in the pdTension double variable.

If the member is not a cable member, the function returns a value of 0 and stores it in the pnIsCable integer variable. It also stores a value of 0 in the pdTension double variable.

All values are given in units of kips and inches


106 ��

Public Sub IsMemCable() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim pnIsCable as Integer Dim pdTension As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Detemine whether Member 3 is a cable member and return the tension force. objOpenSTAAD.IsMemberACableMember 3, pnIsCable, pdTension 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�.��!��.��!��

/�.��!��.��!��

/�.��!��.��!��

�


IsMemberACompressionMember

��

/�.��!��.��!��.��!��#��

��/��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member is a compression member.

��6��

The name of an integer variable passed to the function for it to use in storing the value it returns (either a 0 or a 1).

��

This function determines whether a given member in the currently open STAAD file is specified as a compression-only member. The member number and variable name for storing the results are passed to the function as parameters.

If the member is a compression-only member, the function returns an integer value of 1 and stores it in the pnIsCompression integer variable.

If the member is not a compression-only member, the function returns a value of 0 and stores it in the pnIsCompression integer variable.

��

Public Sub IsMemCompOnly() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnIsCompression As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether Member 3 is specified as a compression-only member.


108 objOpenSTAAD.IsMemberACompressionMember 3, pnIsCompression 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�.��!��!��.��!��

/�.��!��.��!��

/�.��!��.��!��


IsMemberATensionMember

��

/�.��!��.��!��.��!��#��

��/��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member is a tension-only member.

��6��


��

This function determines whether a given member in the currently open STAAD file is specified as a tension-only member. The member number and variable name for storing the results are passed to the function as parameters.

If the member is a tension-only member, the function returns an integer value of 1 and stores it in the pnIsTension integer variable.

If the member is not a tension-only member, the function returns a value of 0 and stores it in the pnIsTension integer variable.

��

Public Sub IsMemTensionOnly() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnIsTension As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether Member 3 is specified as a tension-only member.


110 objOpenSTAAD.IsMemberATensionMember 3, pnIsTension 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�.��!��!��.��!��

/�.��!��.��!��

/�.��!��.��!��


IsMemberATrussMember

��

/�.��!��.��!��.��!��#��/��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to determine whether the member is a truss member.

��6��


��

This function determines whether a given member in the currently open STAAD file is specified as a truss member. The member number and variable name for storing the results are passed to the function as parameters.

If the member is a truss member, the function returns an integer value of 1 and stores it in the pnIsTruss integer variable.

If the member is not a truss member, the function returns a value of 0 and stores it in the pnIsTruss integer variable.

��

Sub IsMemTruss 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnIsTruss As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Determine whether Member 3 is specified as a truss member. objOpenSTAAD.IsMemberATrussMember 3, pnIsTruss


112 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

/�.��!��!��.��!��

/�.��!��.��!��

/�.��!��.��!��


Properties Functions

GetMemberLength

��

��$��.��!��1��+��.��!��#��!��1��+��

��

�$��

An integer greater than or equal to one which specifies the member number for which the member length is to be obtained.

��'��(

A double (8-byte floating point) variable name passed to the function for it to use in storing the member length it retrieves.

��

Given the member number, this function retrieves the length of the member.


��

Sub HowLong() 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD 'Declare a double variable for storing the function results. Dim pdLength As Double 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the length for Member No. 1 and store the value in the ' pdLength variable. objOpenSTAAD.GetMemberLength 1, pdLength



�

��

$��.��!��2��

$��.��!��3��+��+�

$��.��!��,��

$��.��!��

$��.��!��.��

�


GetMemberWidthAndDepth

��

��$��.��!��3��+��+��.��!��#��!��

�3��+��!��+��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the width and depth.

��7��(

A double (8 byte floating point) variable for the function to use to store the member width.

��(

A double (8 byte floating point) variable for the function to use to store the member depth.

��

This function retrieves the width and depth for a given member in the currently open STAAD model.



116 ��

Sub WidthDepth() Dim objOpenSTAAD Dim pdWidth As Double Dim pdDepth As Double 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the width and depth for Member No. 3 and store the values in ' the pdWidth and pdDepth variables. objOpenSTAAD.GetMemberWidthAndDepth 3, pdWidth, pdDepth 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��2��

$��.��!��1��+�

$��.��!��,��

$��.��!��

$��.��!��.��


GetMemberProperties

��

��$��.��!��,��.��!��#��!��

�3��+��!��+��!��%��!��&��!��'��!��/%��!��/&��!��/'��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the properties.

��7��(


��(


��

A double (8 byte floating point) variable for the function to use to store the cross sectional area of the member.

��

A double (8 byte floating point) variable for the function to use to store the member’s effective shear area in the local y axis.

��

A double (8 byte floating point) variable for the function to use to store the member’s effective shear area in the local z axis.

��6�


118 A double (8 byte floating point) variable for the function to use to store the member’s torsional constant.

��6�

A double (8 byte floating point) variable for the function to use to store the member’s moment of inertia about the local y axis.

��6�

A double (8 byte floating point) variable for the function to use to store the member’s moment of inertia about the local z axis.

��

This function retrieves the properties of a given member in the currently open STAAD file. The member number is passed to the function, along with 8 variable names for storing the results returned by the function: member width, depth, cross sectional area, effective shear areas in the y and z axes, torsional constant and moments of inertia about the y and z axes.


��

Sub MemProps() Dim objOpenSTAAD Dim pdWidth As Double Dim pdDepth As Double Dim pdAX As Double Dim pdAY As Double Dim pdAZ As Double Dim pdIX As Double Dim pdIY As Double Dim pdIZ As Double 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the properties for Member No. 3 and store the values in the ' pdWidth, pdDepth, pdAX, pdAY, pdAZ, pdIX, pdIY, pdIZ variables. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single statement to be written ' on multiple lines. objOpenSTAAD.GetMemberProperties 3, pdWidth, pdDepth, _ pdAX, pdAY, pdAZ, pdIX, pdIY, pdIZ 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing


End Sub

�

��

$��.��!��2��

$��.��!��1��+�

$��.��!��3��+��+�

$��.��!��

$��.��!��.��

$��.��!��,��,��

$��.��!��,��+��


120

GetMemberPropsForPrismatic

��

$��.��!��,��,��.��!��#��

��+��!��&��!��'��!��&2��!��'2��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the member properties.

��(��

An integer variable name for the function to use in storing the property shape it retrieves from STAAD.Pro.

��

A double (8 byte floating point) variable for the function to use to store the value of the depth of the section parallel to the local y-axis it retrieves from STAAD.Pro.

��

A double (8 byte floating point) variable for the function to use to store the value of the depth of the section parallel to the local z-axis it retrieves from STAAD.Pro.

��&

A double (8 byte floating point) variable for the function to use to store the value of the depth of web of T-section it retrieves from STAAD.Pro.

��&

A double (8 byte floating point) variable for the function to use to store the value of the width of web of T-section or bottom width of trapezoidal section it retrieves from STAAD.Pro.


��

This function retrieves the property shape for a given prismatic member in the currently open STAAD file. The member number and variable names for storing the function results are passed to the function as parameters. The function returns an integer number between 0 and 11 corresponding to the shape of the given member and stores it in the pnShape variable.

0 Member shape is not defined 1 Shape is from steel table 2 Shape is from user-provided table 3 Rectangle shape 4 Circle shape 5 Tee shape 6 Trapezoid shape 7 General shape 8 Tube shape 9 Pipe shape 10 Tapered section 11 Shape property specified with Assign Profile option

The function also returns the depth of the section parallel to the local y-axis, the depth of the section parallel to the local z-axis, the depth of web if the shape is a T-section, and the width of web if the shape is a T-section, or the bottom width if the shape is a trapezoidal section.

��

Sub Props4Prism() 'Declare OpenSTAAD object as Output. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim pnShape As Integer Dim pdYD As Double Dim pdZD As Double Dim pdYB As Double Dim pdYB As Double 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the member properties for Member No. 3. objOpenSTAAD.GetMemberPropsForPrismatic 3, pnShape, pdYD, pdZD, pdYB, pdZB 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile


122 Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��,��+��


GetMemberDesignProperties

��

��$��.��!��,��.��!��#��

��#��!��3��+��!��+��!��%��!��&��!��'��!��/%��!��/&��!��/'��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the properties.

��,��

A string variable for the function to use in storing the member property name it retrieves from STAAD.Pro, e.g. “W10x68”.

��7��(


��(


��

A double (8 byte floating point) variable for the function to use to store the cross sectional area of the member.

��

A double (8 byte floating point) variable for the function to use to store the member’s effective shear area in the local y axis.

��


124 A double (8 byte floating point) variable for the function to use to store the member’s effective shear area in the local z axis.

��6�

A double (8 byte floating point) variable for the function to use to store the member’s torsional constant.

��6�

A double (8 byte floating point) variable for the function to use to store the member’s moment of inertia about the local y axis.

��6�

A double (8 byte floating point) variable for the function to use to store the member’s moment of inertia about the local z axis.

��

This function retrieves design properties for a given member, including:

• Width and depth • Cross sectional area • Effective shear areas in local y and z axes • Torsional constant • Moments of inertia about local y and z axes

��

Sub MemProps() Dim objOpenSTAAD Dim pdWidth As Double Dim pdDepth As Double Dim pdAX As Double Dim pdAY As Double Dim pdAZ As Double Dim pdIX As Double Dim pdIY As Double Dim pdIZ As Double Dim pstrPropName As String 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the properties for Member No. 3 and store the values in the 'pstrPropName, pdWidth, pdDepth, pdAX, pdAY, pdAZ, pdIX, pdIY, pdIZ variables. 'Note the use of the VB line continuation character, a space followed by an


' underscore in the following code, allowing a single statement to be written ' on multiple lines. objOpenSTAAD.GetMemberProperties 3, pstrPropName, pdWidth, pdDepth, _ pdAX, pdAY, pdAZ, pdIX, pdIY, pdIZ 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��

$��.��!��.��


126

GetSteelTableProperties

��

$��!��,��#��

��!��,��

��

��+

An integer variable between 1 and 17 passed to the function to specify the steel table from which the properties are to be retrieved:

1 American 10 Indian 2 Australian 11 Japanese 3 British 12 Russian 4 Canadian 13 South African 5 Chinese 14 Spanish 6 Dutch 15 Venezuelan 7 European 16 Korean 8 French 17 Aluminum 9 German

��,��

A string variable passed to the function specifying the section name for which the steel properties are to be retrieved, e.g. “W12x96”. The function will ignore spaces in the string, so, for example, you could also type “W 12 x 96”.

��,��

An integer variable name for the function to use in storing an integer value corresponding to the cross section type it retrieves from STAAD.Pro. The integer values and cross section types vary, depending on which country’s steel table is being used. The following tables identify the integers and corresponding cross section types for each country’s steel table.

American Sections 1 W Shape 2 M Shape 3 S Shape 4 HP Shape 5 B Shape 6 Channel 7 MCChannel 8 Angle 9 Tube 10 Pipe


�Australian Sections 1 UBShape 2 UCShape 3 WBShape 4 WCShape 5 Channel 6 Angle British Sections 1 UB Shape 2 UC Shape 3 UP Shape 4 JO Shape 5 Channel 6 Angle 7 Tube 8 Pipe Canadian Sections 1 W Shape 2 M Shape 3 S Shape 4 HP Shape 5 WW Shape 6 Channel 7 MC Channel 8 Angle 9 Tube 10 Pipe Chinese Sections 1 I Shape 2 Channel 3 Angle 4 Tube 5 Pipe Dutch Sections 1 HE Shape 2 IPE Shape 3 INP Shape 4 UNP Channel 5 Angle 6 Tube 7 Pipe 8 Plate Strip 9 Solid Round 10 Solid Square European Sections 1 IPE Shape 2 HE Shape 3 DIL Shape 4 IPN Shape 5 U Channel 6 UNP Channel 7 Angle 8 Tube 9 Pipe French Sections 1 IPE Shape 2 HE Shape 3 IPN Shape 4 Channel 5 Angle 6 Tube 7 Pipe


128 German Sections 1 IPE Shape 2 HE Shape 3 I Shape 4 U Channel 5 Angle 6 Tube 7 Pipe Indian Sections 1 S Shape 2 I Shape 3 M Shape 4 W Shape 5 TShape 6 Channel 7 Angle 8 Tube 9 Pipe Japanese Sections 1 H Shape 2 I Shape 3 T Shape 4 Channel 5 Angle 6 Tube 7 Pipe Russian Sections 1 B Shape 2 SH Shape 3 K Shape 4 I Shape 5 Channel 6 Angle 7 Tube 8 Pipe South African Sections 1 I Shape 2 H Shape 3 PG Shape 4 C Channel 5 Angle 6 Tube 7 Pipe Spanish Sections 1 IPE Shape 2 HE Shape 3 IPN Shape 4 Channel 5 Angle 6 Tube 7 Pipe Venezuelan Sections 1 Tube 2 Pipe Korean Sections 1 W Shape 2 WT Shape


3 Channel 4 Angle 5 Pipe Aluminum Sections 1 AA Standard I Beams 2 H Beam 3 Army Navy I Beam 4 American Standard I Beam 5 I Beam 6 AA Standard Channel 7 Channel 8 Army Navy Channel 9 Special Channel 10 American Standard Channel 11 Equal Leg Angle 12 Square End Equal Leg Angle 13 Unequal Leg Angle 14 Square End Unequal Leg Angle 15 Square Tube 16 Rectangular Tube 17 RoundTube 18 Pipe 19 Army Navy Tee 20 Tee

��

An array of 8 double (8-byte floating point) values for the function to use in storing the member properties it retrieves from the STAAD.Pro steel tables. The 8 properties that the function retrieves are the cross sectional area (AX), the effective shear area for shear force parallel to the local y-axis (AY), the effective shear area for shear force parallel to the local z-axis (AZ), the member depth, the torsional constant (IX), the moment of inertia about the y-axis (IY), the moment of inertia about the z-axis (IZ) and the member width.

��

This function returns the member type and properties of members in the steel tables. An integer value corresponding to the desired steel table is passed to the function as the first parameter. A string parameter specifying the section name for which the steel properties are to be retrieved, e.g. “W12x96”, is also passed to the function. The function then returns the cross section type and member properties and stores them in the pnCrossSection and the pdProperties variables respectively.

The member property values will be stored in the pdProperties array in the following order:

1) pdProperties (0) = AX 2) pdProperties (1) = AY 3) pdProperties (2) = AZ 4) pdProperties (3) = depth 5) pdProperties (4) = IX 6) pdProperties (5) = IY 7) pdProperties (6) = IZ 8) pdProperties (7) = width


130


��

Sub SteelTableShape() 'Declare OpenSTAAD object as Output. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim As Integer Dim pnCrossSection As Integer Dim pdProperties(0 To 7) As Double 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the member type and properties for a W12x96 section from the ' American steel table. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetSteelTableProperties 1, string “W12X96”, _ pnCrossSection, pdProperties(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��,��

$��.��!��,��+��


GetMemberPropertyShape

��

$��.��!��,��+��.��!��#��+��

��

�$��

An integer greater than or equal to one representing the member number of the member for which the property shape is to be obtained.

��(��

An integer variable name for the function to use in storing the property shape it retrieves from STAAD.Pro.

��

This function retrieves the property shape for a given member in the currently open STAAD file. The member number and variable name for storing the function results are passed to the function as parameters. The function returns an integer number between 0 and 11 corresponding to the shape of the given member.

0 Member shape is not defined 1 Shape is from steel table 2 Shape is from user-provided table 3 Rectangle shape 4 Circle shape 5 Tee shape 6 Trapezoid shape 7 General shape 8 Tube shape 9 Pipe shape 10 Tapered section 11 Shape property specified with Assign Profile option


132 ��

Sub MemPropShape() 'Declare OpenSTAAD object as Output. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnShape As Integer 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the member shape for Member No. 3. objOpenSTAAD.GetMemberPropertyShape 3, pnShape 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��,��,��

$��!��,��


GetFinalMemberPropertyName

��

$��.��!��,��#��.��!��#��

��,��#��

��

�$��

An integer greater than or equal to one representing the member number for which the final member property name is to be obtained.

��

A string variable for the function to use in storing the member property name it retrieves from STAAD.Pro, e.g. “W10x68”.

��

This function retrieves the final member property name for a given member in the currently open STAAD file. The member number is passed to the function as a parameter. The function then returns a string that represents the member selected for the final design, e.g. “W10x68”. If only an analysis or code check was performed by the STAAD analysis, this function will return the member name specified with STAAD’s Properties commands. If the analysis included member selection based on parameter value restrictions and specified code, or based on STAAD’s member optimization routine, this function will return the final member selected as a result of the member selection.

��

Sub FinalPropName() 'Declare OpenSTAAD object as Output. Dim objOpenSTAAD As Output 'Declare a string variable for storing the function results. Dim pstrPropName As String 'Run an instance of OpenSTAAD and open Example 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\Examp01.std" 'Retrieve the final member name for Member No. 3.


134 objOpenSTAAD. GetFinalMemberPropertyName 3, pstrPropName 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��,��,��

$��!��,��

$��.��!��,��

$��.��!��,��+��


GetCompositeSectionParameters

��

$��,��.��!��#��!��

��!��+��5��!��3��+��

��

�$��

A long integer greater than or equal to one representing the member number for which the composite section parameters are to be obtained.

��,

A double variable for the function to use in storing the strength of concrete.

��(�,8��

A double variable for the function to use in storing the thickness of the concrete slab.

��7��(

A double variable for the function to use in storing the width of the concrete slab.

��

This function retrieves the strength, width and thickness of the conrete slab used as a part of a composite section with a wide flange. The member number is passed to the function as a parameter. If the section is not a composite section, the strength, thickness and width of the slab will be set to zero.

��

Sub CompositeParameters() 'Declare OpenSTAAD object as Output. Dim objOpenSTAAD As Output 'Declare variables to store the composite parameters Dim Fc As Double Dim Thickness As Double Dim Width As Double 'Run an instance of OpenSTAAD and open a problem with a composite section.


136 Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\My Folder\Examp.std" 'Retrieve the final member name for Member No. 3. objOpenSTAAD. GetCompositeSectionParameters 3, Fc, Thickness, Width 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��,��,��

$��!��,��

$��.��!��,��

$��.��!��,��+��


GetMemberMaterialConstants

��

$��.��!��.��.��!��#��!��0��!��

�,��!��!��+��!��

��

�$��

An integer greater than or equal to one representing the member number for which the material constants are to be obtained.

��%

A double (8 byte floating point) variable for the function to use to store the value of the member’s coefficient of elasticity (E).

��

A double (8 byte floating point) variable for the function to use to store the value of the member’s Poisson’s Ratio.

��+

A double (8 byte floating point) variable for the function to use to store the weight density of the member.

��(�

A double (8 byte floating point) variable for the function to use to store the Alpha value of the member.

��5

A double (8 byte floating point) variable for the function to use to store the member’s damping coefficient.

��

This function retrieves a given member’s material constants including:


138 • Coefficient of Elasticity, E (a.k.a. Young’s Modulus) • Poisson’s Ratio • Density • Alpha (Coefficient of Thermal Expansion) • Damping Coefficient

�

��

Sub MatConsts() 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare 5 double variables for storing the function results. Dim pdE As Double Dim pdPoisson As Double Dim pdDensity As Double Dim pdAlpha As Double Dim pdDampingCoef As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve material constants for member no. 3 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetMemberMaterialConstants 3, _ pdE, pdPoisson, pdDensity, pdAlpha, pdDampingCoef 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��2��

$��.��!��1��+�

$��.��!��3��+��+�

$��.��!��

$��.��!��,��


GetAreaOfPlate

��

��$��* ,��,��#��!��

��

��

An integer value greater than zero specifying the number of the plate element for which the area is to be obtained.

��

A double (8-byte floating point) variable name passed to the function for it to use in storing the plate area.

��

This function retrieves the area of a given plate in the currently open STAAD file.


��

Sub PlateArea() 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare a double variable for storing the function results. Dim pdArea As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 23 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp23.std" 'Retrieve the area of plate 82 and store the value in the pdArea variable. objOpenSTAAD.GetAreaOfPlate 82, pdArea 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


140 �

��

$��,��.��

$��,��,��

$��,��

$��,��#��,��

$��,��.��

$��,��+��5��

�


GetPlateThicknesses

��

$��,��+��5��,��#��!��+��5��!��

��+��5��!��+��56��!��+��57��+��5��

��

��

An integer value greater than zero specifying the number of the plate element for which the plate thickness values are to be retrieved.

��(�,80

A double (8-byte floating point) variable for the function to use in storing the plate thickness at node 1 retrieved from STAAD.Pro.

��(�,81


��(�,82


��(�,83


��(�,8��

An integer variable for the function to use in storing the plate thickness results it retrieves from STAAD.Pro. If the plate is the same thickness at all 4 nodes, this function will return a 1 and store it in the pnSameThickness variable. If the plate is not the same thickness at all 4 nodes, this function will return a 0 and store it in the pnSameThickness variable.


142 ��

This function retrieves the thicknesses at all 4 nodes of a given plate in the currently open STAAD file. The function also returns an integer value indicating whether the thickness is the same for all 4 nodes.

The plate number and variable names for storing the function results are passed to the function as parameters. The function then returns the thickness at each of the plate’s four nodes. In addition, if the plate is the same thickness at all 4 nodes, the function will return a 1 and store it in the pnSameThickness variable. If the plate is not the same thickness at all 4 nodes, the function will return a 0 and store it in the pnSameThickness variable.


��

Sub PlateThick() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim pdThick1 As Double Dim pdThick2 As Double Dim pdThick3 As Double Dim pdThick4 As Double Dim pnSameThickness As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 10 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp10.std" 'Retrieve the plate thicknesses for plate no. 39. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetPlateThicknesses 39, pdThick1, pdThick2, _ pdThick3, pdThick4, pnSameThickness 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��.��

$��,��,��

$��,��


$��,��#��,��

$��,��.��

$��* ,��


144

Loads Functions

GetLoadCombinationCaseCount

��

��$��1��!��

��

��

An integer variable which the function will use to store the number of load combination cases.

��

This function retrieves the number of load combination cases in the currently open STAAD file. It then stores that number in an integer variable passed to it as a parameter.

��

Sub CountLCombs() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an integer variable for storing the function results. Dim pnCount As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the number of load combinations and store that number in the ' pnCount variable. objOpenSTAAD.GetLoadCombinationCaseCount pnCount 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


�

��

$��,��1��


146

GetPrimaryLoadCaseCount

��

��$��,��1��

��

��

An integer variable which the function will use to store the number of primary load cases.

��

This function retrieves the number of primary load cases in the currently open STAAD file. It then stores that number in an integer variable passed to it as a parameter.

��

Sub CountLCs() Dim objOpenSTAAD As Output Dim pnCount As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the number of primary load cases and store that number in the pnCount ' variable. objOpenSTAAD.GetPrimaryLoadCaseCount pnCount 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��1��!��


GetFirstLoadCase

��

$��1��1��1��#��

��

��'��

An integer variable for the function to use in storing the load case number it retrieves from STAAD.Pro.

��'��

A string variable for the function to use in storing the load case name it retrieves from STAAD.Pro.

��

This function retrieves the first load case number and corresponding load case name for the currently open STAAD file. The function stores the first load case number and corresponding load case name in variables passed to it as parameters. The program stores the first load case number in the pnLoad integer variable and the corresponding load case name in the pstrLoadName string variable.

This function should always be used before the GetNextLoadCase function is called to determine the first load case number (load cases are not necessarily numbered consecutively, and the first load case number may not always be number 1).

��

Sub FirstLC() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare two variables for storing the function results. Dim pnLoad As Integer Dim pstrLoadName As String 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the first load case number and name. objOpenSTAAD.GetFirstLoadCase pnLoad, pstrLoadName



�

��

$��#�(�1��


GetNextLoadCase

��

$��#�(�1��,��1��1��

��1��#��

��

�� '��

An integer value passed to the function to specify the load case number which directly precedes in numerical order the load case number and name we wish to retrieve.

��'��

An integer variable name passed to the function for it to use in storing the load case number it retrieves from STAAD.Pro.

��'��

A string variable name passed to the function for it to use in storing the load case name it retrieves from STAAD.Pro.

��

This function retrieves the next load case number and load case name when given the previous load case number. Before this function is called, the GetFirstLoadCase function should be used to obtain the load case number for the first load case. This function can then be used to obtain the load case number and name for successive load cases.

��

Sub getLCs() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim pnPriCount As Integer Dim pnCombCount As Integer Dim pnCount As Integer Dim pnLoad1 As Integer Dim pnLoad As Integer Dim nPrevLoadCase As Integer


150 Dim pstrLoadName As String 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the number of primary load cases and store that number in the ' pnPriCount variable. objOpenSTAAD.GetPrimaryLoadCaseCount pnPriCount 'Retrieve the number of load combinations and store that number in the ' pnCombCount variable. objOpenSTAAD.GetLoadCombinationCaseCount pnCombCount 'Calculate the total number of load cases. pnCount = pnPriCount + pnCombCount 'Retrieve the first load case number and name. objOpenSTAAD.GetFirstLoadCase pnLoad1, pstrLoadName 'Set the previous load case number for the GetNextLoadCase function ' equal to the first case load number. nPrevLoadCase = pnLoad1 'Iterate through the load cases and plot their load case numbers and names ' in an Excel worksheet. For i = 1 to pnCount objOpenSTAAD.GetNextLoadCase nPrevLoadCase, pnLoad, strLoadName Cells(31 + i, 11).Value = pnLoad Cells(31 + i, 12).Value = strLoadName 'Set the previous load case number equal to the load case the function ' just retrieved, so we can go on to the next load case. nPrevLoadCase = pnLoad Next i 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

��

$��1��


Output Results Functions: Nodes

GetNodeDisplacements

��

��$��#��#��#��1��

��!��

��

��

An integer value greater than 0 specifying the number of the node for which the function is to retrieve the displacement.

�'�

An integer value greater than 0 specifying the load case number for which the function is to retrieve the node displacement.

��

An array of 6 double (8-byte floating-point) values for the function to use to store the value of the node displacements it retrieves.

��

This function retrieves the node displacement for a given node and load case. It returns 6 values (X, Y, Z, rX, rY and rZ) for the translational and rotational displacement and stores them in an array variable name passed to it as a parameter.

The node displacement values will be stored in the pdDisps array in the following order:

��- .�

��0 .�


152 ��1 .�

��2 .��

��3 .��

��4 .��


��

Public Sub NodeDispl() 'This is a VBA for Excel macro. 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare variables for use in passing the Node Number and ' Load Case Number to the function. Dim nNodeNo As Integer Dim nLC As Integer 'Declare an array of 6 Double values for storing the function results. Dim pdDisps(6) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Get the Node Number and Load Case Number from the Excel worksheet. nNodeNo = Cells(30, 11).Value nLC = Cells(31, 11).Value 'Retrieve the displacement values and store them in the array. objOpenSTAAD.GetNodeDisplacements nNodeNo, nLC, pdDisps(0) 'Display the node displacement values in the worksheet. For i = 1 To 6 Cells(31 + i, 11).Value = pdDisps(i - 1) Next i 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��

$��#��


$��#�(�#��

��#��)��

$��#��!��* ��#��

$��#��+��


154

GetSupportReactions

��

��$�� #��#��1��!��

� ��

��

��

A long value greater than 0 specifying the node number of the node for which the function is to retrieve the support reactions.

�'�

An integer value greater than 0 specifying the load case number for which the function is to retrieve the support reactions.

��,��

An array of 6 double (8-byte floating-point) values which the function will use to store the support reactions it retrieves.

��

This function retrieves all six (Fx, Fy, Fz, Mx, My, Mz) support reactions for a given supported node and load case. The support reactions will be stored in the pdReactions array in the following order:

��,��- .�!

��,��0 .�+

��,��1 .��

��,��2 .$!

��,��3 .$+

��,��4 .$�



��

Public Sub SuppReac() 'This is a VBA for Excel macro. 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare variables for use in passing the Node Number and Load Case Number to ' the function. Dim nNodeNo As Long Dim nLC As Integer 'Declare an array of 6 Double values for storing the function results. Dim pdReactions(6) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Get the support's Node Number from Row 30, Column 14 and the Load Case ' Number from Row 31, Column 14 of the Excel worksheet. nNodeNo = Cells(30, 14).Value nLC = Cells(31, 14).Value 'Retrieve the support reaction values and store them in the array. objOpenSTAAD.GetSupportReactions nNodeNo, nLC, pdReactions(0) 'Display the support reactions in Column 14 of the worksheet, Rows 32-37. For i = 1 To 6 Cells(31 + i, 14).Value = pdReactions(i - 1) Next i 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��

$��


156

GetModeShapeDataAtNode

��

$��.��+��#��.��#��#��#��

��!��%��!��&��!��'��!��%��!��&��!��'��

��

�$��

An integer variable passed to the function to specify the mode number for which the function is to retrieve the mode shape data.

��

An integer variable passed to the function to specify the number of the node at which the function is to retrieve the mode shape data.

��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the node translational displacement in the X-direction retrieved from STAAD.Pro.

��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the node translational displacement in the Y-direction retrieved from STAAD.Pro.

��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the node translational displacement in the Z-direction retrieved from STAAD.Pro.

��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the node rotational displacement in the X-direction retrieved from STAAD.Pro.


��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the node rotational displacement in the Y-direction retrieved from STAAD.Pro.

��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the node rotational displacement in the Z-direction retrieved from STAAD.Pro.

��

This function retrieves the translational and rotational node displacement for a given mode number at a given node. The mode number and node number are passed to the function, along with 6 double variable names for storing the function results. The function then returns the six translational and rotational displacements for the given mode number and node number.

��

Public Sub ModeShape() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare 6 Double variables for storing the function results. Dim pdX As Double Dim pdY Double Dim pdZ Double Dim pdrX Double Dim pdrY Double Dim pdrZ Double 'Run an instance of OpenSTAAD and open STAAD Example No. 22 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp22.std" 'Retrieve the mode shape data for Mode 2, Node 11 and store the results ' in the double variables. objOpenSTAAD. GetModeShapeDataAtNode 2, 11, pdX, pdY, pdZ, pdrX, pdrY, pdrZ 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


158 �

��

$��#��!��* .��


GetNumberOfModes

��

$��#��!��* .��.��

��

��$��

An integer variable name for the function to use in storing the number of modes it retrieves from STAAD.Pro.

��

This function retrieves the number of mode shapes ultimately considered in the dynamic analysis of the currently open STAAD file.

Prior to the analysis the user may specify a maximum number of mode shapes to consider during dynamic analysis. If the user does not specify a maximum, STAAD.Pro defaults to a maximum of 6 mode shapes. However, if during convergence testing the zero through maximum frequencies are converged, the modal calculation will be completed before the maximum number of mode shapes are calculated.

��

Public Sub ModeShape() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an integer variable name for storing the function results. Dim pnModes As Integer 'Run an instance of OpenSTAAD and open STAAD Example No. 22 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp22.std" 'Retrieve the number of modes considered in the dynamic analysis of Example 22 ' and store the results in the pnModes variable. objOpenSTAAD.GetNumberOfModes pnModes 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub


160 �

��

$��.��+��#��


Output Results Functions: Beams

GetMinBendingMoment

��

��$��.��2��.��.��!��#��

��8��1��!��.��2��.��

��

�$��

An integer greater than or equal to one representing the member number for which the minimum bending moment is to be obtained.

��9�,��

A string denoting the direction in which the minimum bending moment is to be obtained. “MY” denotes bending in the y direction and “MZ” denotes bending in the z direction. The string must be enclosed in quotation marks, but it is not case-sensitive.

�'�

An integer greater than or equal to one representing the load case for which the minimum bending moment is to be obtained.

��$��&��$��

A double (8-byte floating-point) array for storing the value of the minimum bending moment retrieved by the function.

��

This function will retrieve the minimum bending moment (MY or MZ) for a given member number, direction and load case.



162 ��

Public Sub MinBendMom() 'This is a VBA for Excel macro. 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare a Double variable for storing the function results. Dim pdMinBendingMom As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the minimum bending moment for member no. 6, Z-direction, load case 1 ' and store the results in the double variable. objOpenSTAAD.GetMinBendingMoment 6, "MZ", 1, pdMinBendingMom 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.�(2��.��


GetMaxBendingMoment

��

��$��.�(2��.��.��!��#��

��8��1��!��8��

��

�$��

An integer greater than or equal to one representing the member number for which the maximum bending moment is to be obtained.

��9�,��

A string denoting the direction in which the maximum bending moment is to be obtained. “MY” denotes bending in the y direction; “MZ” denotes bending in the z direction. The string must be enclosed in quotation marks, but it is not case-sensitive.

�'�

An integer greater than or equal to one representing the load case for which the minimum bending moment is to be obtained.

��$��&��$��

A double (8-byte floating-point) array for storing the value of the maximum bending moment retrieved by the function.

��

This function will retrieve the maximum bending moment (MY or MZ) for a given member number, direction and load case.


��

Public Sub MaxBendMom() 'This is a VBA for Excel macro. 'Declare OpenSTAAD object variable As Output.


164 Dim objOpenSTAAD As Output 'Declare a double variable for storing the function results. Dim pdMaxBendingMom As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the maximum bending moment for member no. 6, Z-direction, load case 1 ' and store the results in the double variable. objOpenSTAAD.GetMaxBendingMoment 6, "MZ", 1, pdMaxBendingMom 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��2��.��


GetMinShearForce

��

��$��.��+��.��!��#��

��8��1��!��8��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the minimum shear force.

��9�,��

A string denoting the direction in which the minimum shear force is to be obtained. “Fx” denotes shear in the x direction, “Fy” denotes shear in the y direction and “Fz” denotes shear in the z direction. The string must be enclosed in quotation marks, but it is not case-sensitive.

�'�

An integer greater than 0 representing the load case for which the minimum shear force is to be obtained.

��9��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the minimum shear force it retrieves.

��

This function retrieves the minimum shear force for a given member number, direction and load case.


��

Public Sub MinShear() 'This is a VBA for Excel macro. 'Declare OpenSTAAD object variable As Output.


166 Dim objOpenSTAAD As Output 'Declare a Double variable for storing the function results. Dim pdVal As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the minimum shear force for member no. 6, Y-direction, load case 1 ' and store the results in the double variable pdVal. objOpenSTAAD.GetMinShearForce 6, "Fy", 1, pdVal 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.�(�+��


GetMaxShearForce

��

��$��.�(�+��.��!��#��

��8��1��!��8��

��

�$��

An integer variable greater than 0 specifying the number of the member for which the function is to retrieve the maximum shear force.

��9�,��

A string denoting the direction in which the maximum shear force is to be obtained. “Fx” denotes shear in the x direction, “Fy” denotes shear in the y direction and “Fz” denotes shear in the z direction. The string must be enclosed in quotation marks, but it is not case-sensitive.

�'�

An integer greater than 0 representing the load case for which the maximum shear force is to be obtained.

��9��

A double (8-byte floating point) variable name passed to the function for it to use in storing the value of the maximum shear force it retrieves.

��

This function retrieves the maximum shear force for a given member number, direction and load case.


��

Public Sub MaxShear() 'This is a VBA for Excel macro. 'Declare an OpenSTAAD object variable As Output.


168 Dim objOpenSTAAD As Output 'Declare a double variable for storing the function results. Dim pdVal As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the maximum shear force for member no. 6, Y-direction, load case 1 ' and store the results in the double variable pdVal. objOpenSTAAD.GetMaxShearForce 6, "Fy", 1, pdVal 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��+��


GetMemberEndForces

��

��$��.��!��0��.��!��#��0��

��1��!��

��

�$��

A long value greater than 0 specifying the member number for which the function is to retrieve the member end forces.

�%��

Specify a 0 to retrieve the beam end forces from the starting end of the member (starting joint number of member incidence) or a 1 to retrieve the member end forces from the end of the member (end joint number of member incidence).

�'�

An integer greater than 0 representing the load case for which the member end forces are to be obtained.

��,��

An array of 6 double (8-byte floating-point) values which the function will use to store the member end forces it retrieves.

��

This function will retrieve all six (Fx, Fy, Fz, Mx, My, Mz) member end forces for a particular end of a member for a particular load case. The end forces will be stored in the pdForces array in the following order:

��,��- .�!

��,��0 .�+

��,��1 .��

��,��2 .$!


170 ��,��3 .$+

��,��4 .$�


��

'This is a VB for Excel macro. Dim objOpenSTAAD As Output Dim MemberNumber As Long Dim EndForces(5) As Double 'Run an instance of OpenSTAAD Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open a STAAD file. objOpenSTAAD.SelectSTAADFile "C:\SPRO2002\STAAD\Examp\US\examp08.std" 'For member ends, 0 = End A (start) and 1 = End B (end), e.g. for ‘MEMBER INCIDENCE 5 1 8, Member 5 starts at Node 1 and Ends at Node 8. 'FX = 0, FY = 1.... 'Get the member number from the worksheet cell located at Row 1, Column 2 MemberNumber = Cells(1, 2).Value 'Write the member end forces for the starting end of the member, load case 1 ' into the array called EndForces objOpenSTAAD.GetMemberEndForces MemberNumber, 0, 1, EndForces(0) 'Now we can display the values of the array in cells 1,1 through 1,6 ' of our worksheet For i = 1 To 6 Cells(i, 1).Value = EndForces(i - 1) Next 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing

�

��

$��/��.��!��


GetIntermediateMemberForcesAtDistance

��

��$��/��.��!��

�.��!��#��!�� 1��!��

��

�$��

An integer value greater than 0 specifying the member number for which the function is to retrieve the member forces.

��,��

A double (8-byte floating point) value between 0 and 1 specifying the distance along the length of the member from the starting end of the member (End A) to the point at which the function is to retrieve the member forces. The distance is expressed as the ratio of the distance to the point of interest divided by the total length of the member. For example, to find the member forces at a point 5 feet from the starting end of a 20 foot member, set dDistanceRatio to a value of 0.25.

�'�

An integer greater than 0 representing the load case for which the member forces are to be obtained.

��,��

An array of 6 double (8-byte floating-point) values which the function will use to store the member forces it retrieves.

��

This function will retrieve all six (Fx, Fy, Fz, Mx, My, Mz) member forces at a given distance from the starting end (End A) of a member for a given load case. The forces will be stored in the pdForces array in the following order:

��,��- .�!

��,��0 .�+


172 ��,��1 .��

��,��2 .$!

��,��3 .$+

��,��4 .$�


��

Public Sub ForcesAtDist() 'This is a VBA for Excel macro. 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare a Double variable for storing the function results. Dim pdForces(6) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2002\STAAD\Examp\US\examp01.std" 'Retrieve the forces at the center point of member 6 for load case 1 ' and store the results in the pdForces array. objOpenSTAAD.GetIntermediateMemberForcesAtDistance 6, 0.5, 1, pdForces(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

��

$��.��!��0��


GetMemberEndDisplacements

��

��$��.��!��0��.��!��

�0��1��!��

��

�$��

An integer value greater than zero specifying the member number for which the end displacements are to be obtained.

�%��

Specify a 0 to retrieve the member end displacements from the starting end of the member (starting joint number of member incidence) or a 1 to retrieve the member end displacements from the end of the member (end joint number of member incidence).

�'�

An integer greater than or equal to one representing the load case for which the member end displacements are to be obtained.

��

An array of 6 double (8-byte floating-point) values which the function will use to store the member end displacements it retrieves from STAAD.Pro.

��

This function will retrieve all six (∆x, ∆y, ∆z, θx, θy, θz) member end displacements for a particular end of a member for a particular load case. The end displacements will be stored in the pdDispls array in the following order:

��- .∆!

��0 .∆+

��1 .∆�


174 ��2 .θ!

��3 .θ+

��4 .θ�

All values are given in units of kip and inch.

��

'This is a code snippet from a VB for Excel macro. Dim objOpenSTAAD As Output Dim MemberNumber As Integer Dim EndDispls(6) As Double 'Run an instance of OpenSTAAD. Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") 'Open a STAAD file. objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp08.std" 'Get the member number from the worksheet cell located at Row 1, Column 2. MemberNumber = Cells(1, 2).Value 'For member ends, 0 = End A (start) and 1 = End B (end), e.g. for ' MEMBER INCIDENCE 5 1 8, Member 5 starts at Node 1 and Ends at Node 8. 'End forces will be assigned positions in the array as FX = 0, FY = 1....MZ = 5. 'Write the member end displacements for the starting end of the member, ' load case 1 into the array called EndDispls. objOpenSTAAD.GetMemberEndDisplacements MemberNumber, 0, 1, EndDispls(0) 'Now we can display the values of the array in rows 1-6, Column 1 of ' our worksheet. For i = 1 To 6 Cells(i, 1).Value = EndDispls(i - 1) Next

�

��

$��/��.��!��


GetIntermediateMemberTransDisplacements

��

��$��/��.��!��

�.��!��#��!�� 1��!��

��

�$��

An integer greater than 0 representing the member number for which the displacements are to be obtained.

��,��

A double (8-byte floating point) value between 0 and 1 specifying the distance along the length of the member from the starting end of the member (End A) to the point at which the function is to retrieve the displacements. The distance is expressed as the ratio of the distance to the point of interest divided by the total length of the member. For example, to find the displacements at a point 5 feet from the starting end of a 20 foot member, set dDistanceRatio to a value of 0.25.

�'�

An integer greater than zero representing the load case for which the member end displacements are to be obtained.

��

An array of 3 double (8-byte floating-point) values which the function will use to store the member displacements it retrieves from STAAD.Pro.

��

This function will retrieve the three member translational displacements (∆x, ∆y, ∆z) at a given distance from the starting end (End A) of a member for a particular load case. The displacements will be stored in the pdDisps array in the following order:

��- .∆!

��0 .∆+


176 ��1 .∆�


��

Public Sub DisplAtDist() 'This is a VBA for Excel macro. 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an array of 3 double values for storing the function results. Dim pdDisps(0 To 2) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the displacements at the center of member 6 for load case 1, and ' store the results in the pdDisps array. objOpenSTAAD.GetIntermediateMemberTransDisplacements 6, 0.5, 1, pdDisps(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��.��!��0��


GetSteelDesignResults

��

��$�� .��!��#��

��1��!�� !��!��

��-��"��!��!��9��"��

��

�$��

An integer greater than 0 representing the member number for which the steel design results are to be obtained.

��,��'�

An integer variable passed to the function for it to use in storing the load case number of the critical load case for the member.

��

A double (8-byte floating point) variable passed to the function for it to use in storing the design ratio for the critical loading on the member.

��,��

A double (8-byte floating point) value for the function to use in storing the distance (in inches) along the length of the member from the starting end of the member (End A) to the point at which the critical loading occurs.

��#��

An array of 8 double (8-byte floating point) values for the function to use in storing the allowable stresses.

If the AISC ASD design code is used for the analysis, the allowable stresses are stored in the fAllowStress array in the following order:

1) fAllowStress(0)=Fa 2) fAllowStress(1)=Ft 3) fAllowStress(2)=Fcz


178 4) fAllowStress(3)=Fcy 5) fAllowStress(4)=Ftz 6) fAllowStress(5)=Fty 7) fAllowStress(6)=Fv 8) fAllowStress(7)=0

If the AISC LRFD design code is used for the analysis, the allowable and actual forces and moments are stored in the fAllowStress array as follows:

1) fAllowStress(0)=Pnc 2) fAllowStress(1)=pnc 3) fAllowStress(2)=Pnt 4) fAllowStress(3)=pnt 5) fAllowStress(4)=Mnz 6) fAllowStress(5)=mnz 7) fAllowStress(6)=Mny 8) fAllowStress(7)=mny

��

A string variable for the function to use to store the Section and Paragraph numbers of the governing clause in the design code.

��

An integer variable, either 0 or 1, for the function to use in storing the design code used for the analysis. The function stores a value of 0 to indicate ASD; a value of 1 indicates LRFD.

��,��

An array of 6 double double (8-byte floating point) value for the function to use in storing the forces and moments at the critical section. The values are stored in the following order:

1) pdForces(0)=Fx 2) pdForces(1)=Fy 3) pdForces(2)=Fz 4) pdForces(3)=Mx 5) pdForces(4)=My 6) pdForces(5)=Mz

��/��


A double variable passed to the function for it to use in storing the Kl/r ratio (a.k.a. “slenderness ratio”).

��

An string variable passed to the function for it to use in storing the status of the beam post analysis, either “PASS” or “FAIL.”

��

This command retrieves the steel design results for a given member in the currently open STAAD file. The member number is passed to the function along with variable names for storing the function results. The function then returns the critical load case number, the distance of the critical section from the starting end of the beam, the allowable stresses, the governing clause of the code, the design code used for the analysis (AISC, ASD or LRFD) the forces and moments at the critical section, the Kl/r ratio and the results of the analysis (Pass or Fail).


��

Public Sub ResultsOfSteelDes() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare variables for storing the function results. Dim pnCriticalLC As Integer Dim pdCritRatio As Double Dim pdCritSection As Double Dim pdAllowStresses(7) As Double Dim lpszCritCond As String Dim pnDesignCode As Integer Dim pdForces(5) As Double Dim pdKlr As Double Dim plszStatus As String 'Run an instance of OpenSTAAD and open STAAD Example No. 1 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp01.std" 'Retrieve the steel design results for Member 3. 'Note the use of the VB line continuation character, a space followed by an ' underscore in the following code, allowing a single code statement to ' be written on multiple lines. objOpenSTAAD.GetSteelDesignResults 3, pnCriticalLC, pdCritRatio, _

pdCritSection, pdAllowStresses(0), lpszCritCond, pnDesignCode, _ pdForces(0), pdKlr, plszStatus

'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing


180 End Sub

�

��

$��.��!��

�


Output Results Functions: Plates

GetPlateCenterVonMisesStresses

��

��$��,��8��.��,��#��

�1��!��8*#��!��8*#2��

��

��

An integer value greater than zero specifying the number of the plate element for which the Von Mises Stresses are to be retrieved.

�'�

An integer greater than zero representing the load case for which the Von Mises Stresses are to be retrieved.

��9"��

A double (8-byte floating-point) variable name passed to the function for it to use in storing the top Von Mises stress it retrieves from STAAD.Pro.

��9"�&

A double (8-byte floating-point) variable name passed to the function for it to use in storing the bottom Von Mises stress it retrieves from STAAD.Pro.

��

This function retrieves the top and bottom Von Mises stresses for the center of a given plate for a given load case.


182 ��

Sub VonMise() 'Declare OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare two double variables for storing the function results. Dim pdVONT As Double Dim pdVONB As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 23 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp23.std" 'Get Von Mises Stresses for center of plate 87, Load Case 1. objOpenSTAAD.GetPlateCenterVonMisesStresses 87, 1, pdVONT, pdVONB 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��.��

$��,��,��

$��,��

$��,��#��,��

$��,��.��


GetAllPlateCenterPrincipalStressesAndAngles

��

��$��,��,��

�,��#��1��!��

��

��

An integer value greater than zero specifying the number of the plate element for which the center principal stresses and angles are to be obtained.

�'�

An integer greater than zero representing the load case for which the plate center principal stresses and angles are to be obtained.

��

An array of 8 double (8-byte floating-point) values which the function will use to store the the plate center principal stresses and angles it retrieves from STAAD.Pro (SMAX, SMIN, TMAX, ANGLE: top and bottom).

��

This function retrieves the maximum and minimum principal stresses (SMAX and SMIN), the maximum shear stress (TMAX) and the principal plane angle for the top and bottom of a given plate for a given load case. The plate number and load case number are passed to the function. The function retrieves the principal stresses and angles and stores them in the pdStresses array in the following order:

��- .�$��

��0 .�$6�:��

��1 .�$��:��

��2 .��)'%��

��3 .�$��


184 ��4 .�$6��

��; .�$��

��< .��)'%��


��

Public Sub PlatePrinStres() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare a double 8-value array variable for storing the function results. Dim pdStresses(0 To 7) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 23 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp23.std" 'Get principal stresses for center of plate 87, Load Case 2. objOpenSTAAD.GetAllPlateCenterPrincipalStressesAndAngles 87, 2, pdStresses(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��8��.��

$��,��.��

$��,��

$��,��#��,��

$��,��.��


GetAllPlateCenterMoments

��

��$��,��.��,��#��1��

��!��.��:�

��

��

An integer value greater than zero specifying the number of the plate element for which the plate center moments are to be obtained.

�'�

An integer greater than zero representing the load case for which the plate center moments are to be obtained.

��$��

An array of 3 double (8-byte floating-point) values which the function will use to store the the plate center moments (MX, MY, MXY) it retrieves from STAAD.Pro.

��

This function retrieves the plate center moments MX, MY, and MXY for a given plate and load case.


��

Sub PlateCtrMom() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an array of 3 double values for storing the function results. Dim pdMoments(0 To 2) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 23 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp23.std" 'Get moments for center of plate 87, Load Case 2.


186 objOpenSTAAD.GetAllPlateCenterMoments 87, 2, pdMoments(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��8��.��

$��,��,��

$��,��

$��,��#��,��

$��,��.��


GetAllPlateCenterForces

��

��$��,��,��#��

�1��!��

��

��

An integer value greater than zero specifying the number of the plate element for which the plate center forces are to be obtained.

�'�

An integer greater than zero representing the load case for which the plate center forces are to be obtained.

��,��

An array of 5 double (8-byte floating-point) values which the function will use to store the the plate center forces (SQX, SQY, SX, SY, and SXY) it retrieves from STAAD.Pro.

��

This function retrieves the plate center forces SQX, SQY, SX, SY, and SXY for a given plate and load case.


��

Public Sub PlateCtrForces() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an array of 5 double values for storing the function results. Dim pdForces(0 To 4) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 23 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp23.std"


188 'Get forces for center of plate 87, Load Case 2. objOpenSTAAD.GetAllPlateCenterForces 87, 2, pdForces(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��8��.��

$��,��,��

$��,��.��

$��,��#��,��

$��,��.��


GetPlateCenterNormalPrincipalStresses

��

��$��,��#��,��,��#��

��1��!��.�%��!��./#��

��

��

An integer value greater than zero specifying the number of the plate element for which the center normal principal stresses are to be obtained.

�'�

An integer greater than zero representing the load case for which the plate center normal principal stresses are to be obtained.

��$��

A double (8-byte floating-point) variable name which the function will use to store the plate top center normal principal stress (SMAX) it retrieves from STAAD.Pro.

��$6�

A double (8-byte floating-point) variable name which the function will use to store the plate bottom center normal principal stress (SMIN) it retrieves from STAAD.Pro.

��

This function retrieves the plate center top and bottom normal principal stresses (SMAX and SMIN) for a given plate and load case.


��

Public Sub PlCtrNPS() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare 2 double variables for storing the function results.


190 Dim pdSMAX As Double Dim pdSMIN As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 23 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp23.std" 'Get normal principal stresses for center of plate 87, Load Case 2. objOpenSTAAD.GetPlateCenterNormalPrincipalStresses 87, 2, pdSMAX, pdSMIN 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��8��.��

$��,��,��

$��,��.��

$��,��

$��,��.��


GetAllPlateCenterStressesAndMoments

��

��$��,��.��,��#��

��1��!��

��

��

An integer value greater than zero specifying the number of the plate element for which the center stresses and moments are to be obtained.

�'�

An integer greater than zero representing the load case for which the plate center stresses and moments are to be obtained.

��

An array of 8 double (8-byte floating-point) values which the function will use to store the plate center stresses and moments (SQX, SQY, MX, MY, MXY, SX, SY, and SXY) it retrieves from STAAD.Pro.

��

This function retrieves the plate center stresses and moments SQX, SQY, MX, MY, MXY, SX, SY, and SXY for a given plate and load case.


��

Public Sub PlCtrStrMom() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an array of 8 double values for storing the function results. Dim pdStresses(0 To 7) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 23 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp23.std"


192 'Get principal stresses and moments for center of plate 87, Load Case 2. objOpenSTAAD.GetAllPlateCenterStressesAndMoments 87, 2, pdStresses(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��8��.��

$��,��,��

$��,��.��

$��,��

$��,��#��,��


Output Results Functions: Solids

GetAllSolidPrincipalStresses

��

��$��,��#��

��1��!��:�

��

��

An integer value greater than zero passed to the function to specify the number of the solid element for which the principal stresses are to be obtained.

��

An integer value greater than zero passed to the function to specify the corner (node number) of the solid element at which the principal stresses are to be obtained.

�'�

An integer greater than zero passed to the function to specify the load case number for which the principal stresses are to be obtained.

��

An array of 3 double (8-byte floating-point) values which the function will use to store the principal stresses (S1, S2, and S3) it retrieves from STAAD.Pro.

��

This function retrieves the principal stresses S1, S2, and S3 for a given corner of a solid element for a given load case.



194 ��

Public Sub SolPrinStress() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an array of 3 double values for storing the function results. Dim pdStresses(0 To 2) As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 24 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp24.std" 'Get principal stresses for Node 26 of Solid Element no. 7, Load Case no. 2. objOpenSTAAD.GetAllSolidPrincipalStresses 7, 26, 2, pdStresses(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��#��

$��+��

$��8��.��


GetAllSolidNormalStresses

��

��$��#��#��

��1��!��

��

��

An integer value greater than zero passed to the function to specify the number of the solid element for which the normal stresses are to be obtained.

��

An integer value greater than zero passed to the function to specify the corner (node number) of the solid element at which the normal stresses are to be obtained.

�'�

An integer greater than zero passed to the function to specify the load case number for which the normal stresses are to be obtained.

��

An array of 3 double (8-byte floating-point) values which the function will use to store the normal stresses (SXX, SYY, and SZZ) it retrieves from STAAD.Pro.

��

This function retrieves the principal stresses SXX, SYY, and SZZ for a given corner of a solid element for a given load case.


��

Public Sub SolNormStress() 'Declare an OpenSTAAD object variable As Output. Dim objOpenSTAAD As Output 'Declare an array of 3 double values for storing the function results. Dim pdStresses(0 To 2) As Double


196 'Run an instance of OpenSTAAD and open STAAD Example No. 24 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp24.std" 'Get normal stresses for Node 26 of Solid Element no. 7, Load Case no. 2. objOpenSTAAD.GetAllSolidNormalStresses 7, 26, 2, pdStresses(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��

$��+��

$��8��.��


GetAllSolidShearStresses

��

��$��+��#��

��1��!��

��

��

An integer value greater than zero passed to the function to specify the number of the solid element for which the shear stresses are to be obtained.

��

An integer value greater than zero passed to the function to specify the corner (node number) of the solid element at which the shear stresses are to be obtained.

�'�

An integer greater than zero passed to the function to specify the load case number for which the shear stresses are to be obtained.

��

An array of 3 double (8-byte floating-point) values which the function will use to store the shear stresses (SXY, SYZ, and SZX) it retrieves from STAAD.Pro.

��

This function retrieves the shear stresses SXY, SYZ, and SZX for a given corner of a solid element for a given load case.


��

Public Sub SolShearStress() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare an array of 3 double values for storing the function results. Dim pdStresses(0 To 2) As Double


198 'Run an instance of OpenSTAAD and open STAAD Example No. 24 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp24.std" 'Get shear stresses for Node 26 of Solid Element no. 7, Load Case no. 2. objOpenSTAAD.GetAllSolidShearStresses 7, 26, 2, pdStresses(0) 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��

$��#��

$��8��.��


GetAllSolidVonMisesStresses

��

��$��8��.��#��

��1��!��

��

��

An integer value greater than zero passed to the function to specify the number of the solid element for which the Von Mises Stress is to be obtained.

��

An integer value greater than zero passed to the function to specify the corner (node number) of the solid element at which the Von Mises Stress is to be obtained.

�'�

An integer greater than zero passed to the function to specify the load case number for which the Von Mises Stress is to be obtained.

��

A double (8-byte floating-point) variable name which the function will use to store the Von Mises Stress it retrieves from STAAD.Pro.

��

This function retrieves the Von Mises stress for a given corner of a solid element for a given load case.



200 ��

Public Sub SolVolMise() 'Declare OpenSTAAD object variable. Dim objOpenSTAAD As Output 'Declare a double variable for storing the function results. Dim pdStress As Double 'Run an instance of OpenSTAAD and open STAAD Example No. 24 (US). Set objOpenSTAAD = CreateObject("OpenSTAAD.Output.1") objOpenSTAAD.SelectSTAADFile "C:\SPRO2004\STAAD\Examp\US\examp24.std" 'Get Von Mises stress for Node 26 of Solid Element no. 7, Load Case no. 2. objOpenSTAAD.GetAllSolidVonMisesStresses 7, 26, 2, pdStress 'Close the STAAD file and release the handles to the OpenSTAAD library. objOpenSTAAD.CloseSTAADFile Set objOpenSTAAD = Nothing End Sub

�

��

$��,��

$��#��

$��+��


OpenSTAAD Functions – Application Object

Creating Macros within STAAD.Pro and Adding Them to the STAAD.Pro Menu

The following sub-section describes how to start the VBA editor and create a new macro or load an existing one within the STAAD.Pro environment. It also describes how to run the macros you have created in the STAAD.Pro macro editor by adding a simple menu item.

The icons to run and insert macros are shown below.

To create or load an existing macro, click on the Macro icon . The following dialog box will pop up in which a new macro can be created or an existing macro can be imported for launching.

Section 3


202

If one of the existing “Macro Names” is selected, the Edit, Delete and Run buttons will be enabled as shown in the following figure. A description to help identify or classify the macro can be provided if a new macro is being created.

Under the Tools menu, the Configure User Tools option can be used to directly link a macro to a customized menu item. Once the macro is linked, it can be accessed

either from the icon or from Tools | User Tools option under the main menu.


If the Configure Tools option is selected, a dialog box will prompt for information about the macro. Click on the New Tool icon to create a new macro link. Please note that the Configure Tools option is only meant to be used for exisiting macros and not for creating new ones. Once a name has been entered, type in the name (including path) of the macro to be linked in the Command box. If there are any additional parameters that are associated with the macro, they can be supplied in the Arguments box.


204

Depending upon how the tools are configured (using the dialog interface above), the

macros can now be accessed directly from the icon or from Tools | User Tools option under the main menu.

Creating macros is very easy within STAAD.Pro. To create a new macro, go to Edit

| Create New Macro from the main menu or click on the icon and select New. The following dialog box will then prompt for the name of the macro file (to be saved under) and the type of macro file. A VBS macro file is a standard macro file whose contents (code) can be viewed by other users. A VBZ macro file is a protected macro whose contents cannot be viewed even in an external editor like Notepad. This is useful when the user wants to sell the macro or protect its contents.


Once the New button has been clicked, the STAAD VBA Editor will be launched The contents of the macro can be programmed in this editor. Use the functions listed in Sections 2 and 3 to create a customized macro. The STAAD VBA Editor is designed to not only compile a macro, but help debug it as well. A synopsis of the icons in the VBA editor is listed below.


206 Icon Function

Runs or plays a macro. Once the macro has been properly created, it can be executed by clicking on this icon. The macro can also be run from Edit | Edit Existing Macro.

Toggle breakpoint. This icon is used to set a breakpoint within a macro. This can be used to debug a macro when the contents of individual variables are required during runtime. The macro will physically stop at the line of code within the macro where the breakpoint(s) has/have been set.

Watch. Place your mouse over any variable or constant in the macro. Click on the Watch icon to add the variable to the Watch list so its contents can be observed throughout the macro.

Step Into. This function allows for the user to step into a function or subroutine within a macro for futher investigation. Place a breakpoint at the line where you want to Step Into. It can also be used to step line by line through the macro.

Step Over. When the user does not want to investigate a certain function or routine but instead wants to continue debugging the next line(s), the Step Over function can be used.

Step Out. Used to step out of the current function or subroutine and back into the main part of the code.

Edit Dialog. To create a new dialog box, click on this icon. It will insert a dialog box at the present point in


the code. To edit an existing dialog box, simply place the mouse within the dialog box code in the macro and then click on the Edit Dialog icon.

Once the macro has been completed, it can be exceuted by either clicking on the

icon or clicking on the icon and selecting Run.


208

Root Applications

GetSTAADFile

��

$��#��2��/��,��+��

��

��

A string variable that will hold the name of the currently open STD file (without the path name).

6�,��(

A Boolean variable which if true, will write the entire path name of the STD file in the variable FileName.

��

This function retrieves the name of the current STD file.

��

Dim objOpenSTAAD As Object Dim strFileName As String Dim bIncludePath As Boolean 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Retrieve the entire path bIncludePath = true objOpenSTAAD.GetSTAADFile strFileName, bIncludePath


OpenSTAADFile

��

*��#��

��

��

A string variable that will hold the name of the STD file, which needs to be open.

��

This function will open the specified STD file.

��

Dim objOpenSTAAD As Object Dim strFileName As String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Open the file objOpenSTAAD.OpenSTAADFile strFileName


210

CloseSTAADFile

��

��

��

This function closes the currently open STD file.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Close current STAAD file objOpenSTAAD.CloseSTAADFile


GetSTAADFileFolder

��

$��

��

��

A string variable that will hold the path name of folder where the currently open STD file resides. It will not write the name of the STD file into the variable.

��

This function retrieves only the path of the current STD file.

��

Dim objOpenSTAAD As Object Dim strFileFolder As String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get the file folder objOpenSTAAD.GetSTAADFileFolder strFileFolder


212

UpdateStructure

��

4��

��

This function updates the current structure.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Update structure objOpenSTAAD.UpdateStructure


GetInputUnitForLength

��

$��/��4��1��+��/��4��1��+��

��

6��=��'��(

A string variable that will hold the input unit for length of the currently open STD file. Later the value will be internally converted to an integer ranging from 0 to 7 (0- Inch, 1- Feet, 2- Feet, 3- CentiMeter, 4- Meter, 5- MilliMeter, 6 - DeciMeter, 7 – KiloMeter).

��

This function retrieves the input unit of length of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim strInputUnitForLength As String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get Length Unit objOpenSTAAD.GetInputUnitForLength strInputUnitForLength


214

GetInputUnitForForce

��

$��/��4��/��4��

��

6��=��,�

A string variable that will hold the input unit for force of the currently open STD file. Later the value will be internally converted to an integer ranging from 0 to 7 (0- Kilopound, 1- Pound, 2- Kilogram, 3-Metric Ton, 4- Newton, 5-Kilo Newton, 6- Mega Newton, 7- DecaNewton).

��

This function retrieves the input unit of force of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim strInputUnitForForce As String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Force Unit objOpenSTAAD.GetInputUnitForForce strInputUnitForForce


SetInputUnitForLength

��

��/��4��1��+��/��/��4��1��+��

��

6��=��'��(

An integer variable that will hold the input unit to be assigned for length of the currently open STD file. Value may vary from 0 to 7 (0- Inch, 1- Feet, 2- Feet, 3- CentiMeter, 4- Meter, 5- MilliMeter, 6 - DeciMeter, 7 – KiloMeter).

��

This function sets the input unit of length of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim intInputUnitForLength As Integer 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Set Length Unit objOpenSTAAD.SetInputUnitForLength intInputUnitForLength


216

SetInputUnitForForce

��

��/��4��/��/��4��

��

6��=��,�

An integer variable that will hold the input unit to be assigned for force of the currently open STD file. Value may vary from 0 to 7 (0- Kilopound, 1- Pound, 2- Kilogram, 3-Metric Ton, 4- Newton, 5-Kilo Newton, 6- Mega Newton, 7- DecaNewton).

��

This function sets the input unit of force of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim intInputUnitForForce As Integer 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Set Force Unit objOpenSTAAD.SetInputUnitForForce intInputUnitForForce


SetInputUnits

��

��/��4��/��/��4��1��+��/��

/��4��

��

6��=��'��(

An integer variable that will hold the input unit to be assigned for length of the currently open STD file. Value may vary from 0 to 7 (0- Inch, 1- Feet, 2- Feet, 3- CentiMeter, 4- Meter, 5- MilliMeter, 6 - DeciMeter, 7 – KiloMeter).

6��=��,�

An integer variable that will hold the input unit to be assigned for force of the currently open STD file. Value may vary from 0 to 7 (0- Kilopound, 1- Pound, 2- Kilogram, 3-Metric Ton, 4- Newton, 5-Kilo Newton, 6- Mega Newton, 7- DecaNewton).

��

This function sets the input units of length and force of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim intInputUnitForLength As Integer Dim intInputUnitForForce As Integer 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Set Input Units objOpenSTAAD.SetInputUnits intInputUnitForLength, intInputUnitForForce


218

ShowApplication

��

�+�-��

��

:��:

��

This function makes the STAAD.Pro application window active.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Show Application Window objOpenSTAAD.ShowApplication


GetProcessHandle

��

$��,��)��

��

This function retrives the current STAAD.Pro process handle.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Process Handle objOpenSTAAD.GetProcessHandle


220

GetProcessId

��

$��,��/��

��

This function retrives the current STAAD.Pro process ID.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Process ID objOpenSTAAD.GetProcessId


GetMainWindowHandle

��

$��.��3��-)��

��

This function retrives the main STAAD.Pro window handle.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Main Window Handle objOpenSTAAD.GetMainWindowHandle


222

NewSTAADFile

��

#�-��#��/��/��4��1��+��

/��/��4��

��

��

A string variable that will hold the name of the STD file, which needs to be created.

6��=��'��(

An integer variable that will hold the input unit to be assigned for length of the new STD file. Value may vary from 0 to 7 (0- Inch, 1- Feet, 2- Feet, 3- CentiMeter, 4- Meter, 5- MilliMeter, 6 - DeciMeter, 7 – KiloMeter).

6��=��,�

An integer variable that will hold the input unit to be assigned for force of the new STD file. Value may vary from 0 to 7 (0- Kilopound, 1- Pound, 2- Kilogram, 3-Metric Ton, 4- Newton, 5-Kilo Newton, 6- Mega Newton, 7- DecaNewton).

��

This function creates a STD file with specified length and force units.

��

Dim objOpenSTAAD As Object Dim strFileName As String Dim intInputUnitForLength As Integer Dim intInputUnitForForce As Integer 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Create New File objOpenSTAAD.NewSTAADFile strFileName, intInputUnitForLength, intInputUnitForForce


Analyze

��

��"��

��

:��:

��

This function anlyzes the current STD file.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Run Analysis objOpenSTAAD.Analyze


224

GetShortJobInfo

��

$��+��;�!/� ��;�!#��;�!��

0��#��

��

>��

A string variable that will hold the Job Name for the current STD file.

>��

A string variable that will hold the Job Client for the current STD file.

%��

A string variable that will hold the Engineer’s Name for the current STD file.

��

This function retrieves the short job information of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim strJobName as String Dim strJobClient as String Dim strEnggName as String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get Job Info objOpenSTAAD.GetShortJobInfo strJobName, strJobClient, strEnggName


SetShortJobInfo

��

��+��;�!/� ��;�!#��;�!��

0��#��

��

>��

A string variable that will hold the Job Name for the current STD file.

>��

A string variable that will hold the Job Client for the current STD file.

%��

A string variable that will hold the Engineer’s Name for the current STD file.

��

This function sets the short job information of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim strJobName as String Dim strJobClient as String Dim strEnggName as String 'Set the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") objOpenSTAAD.SetShortJobInfo strJobName, strJobClient, strEnggName


226

CreateNamedView

��

��#��8��-��8��-#��1��8��1��0��8��

��

9��#��

A string variable that will hold the name of the view to be created.

��9��

A long variable that will hold the flag value depending upon which the view will be created.

%��9��

A long variable that will hold the error number if the view cannot be created.

��

This function creates a view with the specified name.

��

Dim objOpenSTAAD As Object Dim strViewName As String Dim lFlagVal as Long Dim lErrorVal as Long 'Set the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") objOpenSTAAD.CreateNamedView strViewName, lFlagVal, lErrorVal


SaveNamedView

��

��#��8��-��8��-#��1��0��8��

��

9��#��

A string variable that will hold the name of the view to be saved.

%��9��

A long variable that will hold the error number if the view cannot be saved.

��

This function saves the current view with the specified name.

��

Dim strViewName As String Dim lErrorVal as Long 'Set the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") objOpenSTAAD.SaveNamedView strViewName, lErrorVal


228

ModifyNamedView

��

.�� #��8��-��8��-#��/��0��

0��1��<�� 1��.�� 1��0��8��

��

9��#��

A string variable that will hold the name of the view to be modified.

%��

An long variable that will hold number of entities.

%��+��+

An long that will hold entity number.

��+?��5��

A integer variable that will hold entity qualifier value. Value may vary from 0 to 4( 0 - Node, 1 - Beam, 2 - Plate, 3 - Solid, 4 – Surface)

$��5+��

A long variable that will hold the flag value depending upon which the view will be modified.

%��9��

A long variable that will hold the error number if the view cannot be modified.

��

This function modifies the named views of the currently open STD file.

��

Dim objOpenSTAAD As Object Dim strViewName As String Dim intEntities As Integer Dim lEntityNo as Long Dim lEntityQualifier as Long Dim lFlagVal as Long


Dim lErrorVal as Long 'Set the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") objOpenSTAAD. ModifyNamedView strViewName, intEntities, lEntityNo, lEntityQualifier, lFlagVal, lErrorVal


230

GetBaseUnit

��

$��2��4��

��

:��:

��

This function retrives the base unit for the currently open STD file. Value will return 1 for English and 2 for Metric system.

��

Dim objOpenSTAAD As Object 'Set the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") objOpenSTAAD.GetBaseUnit


RemoveNamedView

��

��#��8��-��8��-#��1��0��8��

��

9��#��

A string variable that will hold the name of the view to be removed.

%��9��

A long variable that will hold the error number if the view cannot be removed.

��

This function removes the current view with the specified name.

��

Dim objOpenSTAAD As Object Dim strViewName As String Dim nErrorVal as Long 'Application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") objOpenSTAAD.RemoveNamedView strViewName, nErrorVal


232

Quit

��

<��

��

:��:

��

This function quits STAAD.Pro application environment.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Quit Application environment objOpenSTAAD.Quit


Geometry Applications

Geometry.GetNodeCount

��

$��=$��#��

��

:��:

��

This function returns the number of nodes in the currently open STAAD file.

��

Dim objOpenSTAAD As Object Dim lNodeCount as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get Nodes Count lNodeCount = objOpenSTAAD.GetNodeCount


234

Geometry.GetNodeList

��

��$��=$��#��1��1��#��#��!��

��

��+

Long Array variable in which the node numbers are returned.

��

This function returns the node list of the current STAAD file.

��

Dim objOpenSTAAD As Object Dim lNodeCnt as Long Dim NodeNumberArray() As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Node Numbers lNodeCnt = objOpenSTAAD.GetNodeCount ReDim NodeNumberArray(0 to (lNodeCnt-1)) As Long 'Get node list objOpenSTAAD.Geometry.GetNodeList (NodeNumberArray)


Geometry.AddNode

��

$��=�#��!��%��!��&��!��

��'��

��

��@��@��

Double variables providing the nodal coordinates X, Y and Z of the NodeNo.

��

This function adds a node in the structure.

��

Dim objOpenSTAAD As Object Dim CoordX As Double Dim CoordY As Double Dim CoordZ As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") CoordX = 3.0 CoordY = 2.0 CoordZ = 3.0 'Add a node (3.0, 2.0, 3.0) objOpenSTAAD.Geometry.AddNode CoordX, CoordY, CoordZ


236

Geometry.CreateNode

��

$��=��#��#��#��!��%��!��

��&��!��'��

��

��

A long variable containing the number to assign the newly created node.

��@��@��

Double variables providing the nodal coordinates X, Y and Z of the nNodeNo.

��

This function adds a node in the structure with the number specified in nNodeNo. The difference between CreateNode and AddNode is the former has an option to label the node with any user-defined number.

��

Dim objOpenSTAAD As Object Dim CoordX As Double Dim CoordY As Double Dim CoordZ As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") CoordX = 3.0 CoordY = 2.0 CoordZ = 3.0 'Add a node (3.0, 2.0, 3.0) and call it Node # 45 objOpenSTAAD.Geometry.CreateNode 45, CoordX, CoordY, CoordZ


Geometry.GetMemberCount

��

$��=$��.��!��

��

:��:

��

This function returns the number of members in the currently open STAAD file.

��

Dim objOpenSTAAD As Object Dim lMemberCount As Long 'Get the application object -- Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get Member Numbers lMemberCount = objOpenSTAAD.GetMemberCount


238

Geometry.GetBeamList

��

��$��=$��2��1��1��2��#��!��

��

&��+

Long Array variable in which the beam numbers are returned.

��

This function returns the member list of the current STAAD file.

��

Dim objOpenSTAAD As Object Dim lBeamCnt as Long Dim BeamNumberArray() As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Beam Numbers lBeamCnt = objOpenSTAAD.GetMemberCount ReDim BeamNumberArray(0 to (lBeamCnt-1)) As Long 'Get Beam list objOpenSTAAD.Geometry.GetBeamList (BeamNumberArray)


Geometry.AddBeam

��

$��=�2��#��#��2��

��

��@��&

Long variables, provide member connectivity.

��

This function adds a beam between two specified existing nodes.

��

Dim objOpenSTAAD As Object Dim NodeA As Long Dim NodeB As Long 'Get the application object -- Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Add a beam connected between nodes 2 and 4 NodeA = 2 NodeB = 4 objOpenSTAAD.Geometry.AddBeam NodeA, NodeB


240

Geometry.CreateBeam

��

$��=��2��2��#��#��#��2��

��

�&��

A long variable containing the number to assign the newly created beam.

��@��&

Long variables, provide member connectivity.

��

This function adds a beam in the structure between nodes NodeA and NodeB with the number specified in nBeamNo. The difference between CreateBeam and AddBeam is the former has an option to label the beam with any user-defined number.

��

Dim objOpenSTAAD As Object Dim NodeA As Long Dim NodeB As Long 'Get the application object -- Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Add a beam connected between nodes 2 and 4. Call it beam # 77 NodeA = 2 NodeB = 4 objOpenSTAAD.Geometry.CreateBeam 77, NodeA, NodeB


Geometry.SplitBeam

��

$��=��2��2��#��#��!��

��#��

��

&��

A long variable providing the beam member number to split.

��

A long variable providing the number of nodes to be inserted in the beam.

��+

Double array variable containing the distance in length to the nodes.

��

This function splits a beam.

��

Dim objOpenSTAAD As Object Dim BeamNo As Long Dim Nodes As Long Dim DistToNode(4) As Double 'Get the application object -- Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Split Beam no 10 (length 5m say) into three unequal parts BeamNo = 10 Nodes = 2 DistToNode(0) = 1.0 DistToNode(1) = 4.0 objOpenSTAAD.Geometry.SplitBeam BeamNo, Nodes, DistToNode


242

Geometry.SplitBeamInEqlParts

��

$��=��2��/�0>�,��2��#��,��

��

&��

A long variable providing the beam member number to split.

��

Long variable providing the number of parts into which the beam is to be split.

��

This function splits a beam into equal parts.

��

Dim objOpenSTAAD As Object Dim BeamNo As Long Dim Parts As Long 'Get the application object -- Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Split Beam no 10 (length 5m say) into three equal parts BeamNo = 10 Parts = 3 objOpenSTAAD.Geometry.SplitBeamInEqlParts BeamNo, Parts


Geometry.GetBeamLength

��

��!��$��=$��2��1��+��2��#��

��

A double variable containing the length of the beam.

��

&��

A lfong variable providing the beam member number for which the length is to be retrieved.

��

Returns the length of the beam

��

Dim objOpenSTAAD As Object Dim BeamNo As Long Dim BeamLen As Long 'Get the application object -- Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get length of the beam 10 BeamNo = 10 BeamLen = objOpenSTAAD.Geometry.GetBeamLength BeamNo


244

Geometry.GetNodeCoordinates

��

$��=$��#��#��#��!��%��

��!��&��!��'��

��

��

A long variable providing the node number.

��@��@��

Double variables in which the nodal coordinates X, Y and Z of the NodeNo are returned.

��

Returns the coordinates of the specified node.

��

Dim objOpenSTAAD As Object Dim NodeNo As Long Dim CoordX As Double Dim CoordY As Double Dim CoordZ As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get a node NodeNo = 10 objOpenSTAAD.Geometry.GetNodeCoordinates NodeNo, CoordX, CoordY, CoordZ


Geometry.GetNodeNumber

��

��$��=$��#��#��!��!��%��!��&��

��!��'��

��

��@��@��


��

Returns the node number at specified coordinates

��

Dim objOpenSTAAD As Object Dim NodeNo As Long Dim CoordX As Double Dim CoordY As Double Dim CoordZ As Double 'Get the application object 'Get a node NodeNo = objOpenSTAAD.Geometry.GetNodeNumber CoordX, CoordY, CoordZ


246

Geometry.GetNodeDistance

��

��!��$��=$��#��#��#��#��#�2��

��

The distance between the nodes.

��

��@��&

Long variables providing the node numbers.

��

Returns the distance between the nodes.

��

Dim objOpenSTAAD As Object Dim NodeNoA As Long Dim NodeNoB As Long Dim NodeDistance As Double 'Get the application object 'Get the distance between node 10 and 11 NodeNoA = 10 NodeNoB = 11 NodeDistance = objOpenSTAAD.Geometry.GetNodeDistance NodeNoA, NodeNoB


Geometry.GetPlateCount

��

$��=$��,��

��

:��:

��

This function returns the number of plates in the currently open STAAD file.

��

Dim objOpenSTAAD As Object Dim lPlateCount as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get Plates Count lPlateCount = objOpenSTAAD. GetPlateCount


248

Geometry.GetPlateList

��

��$��=$��,��1��1��,��#��!��

��

��+

Long Array variable in which the plate numbers are returned.

��

This function returns the plate list of the current STAAD file.

��

Dim objOpenSTAAD As Object Dim lPlateCnt as Long Dim PlateNumberArray() As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Plate Numbers lPlateCnt = objOpenSTAAD.GetPlateCount ReDim PlateNumberArray(0 to (lPlateCnt-1)) As Long 'Get Plate list objOpenSTAAD.Geometry.GetPlateList (PlateNumberArray)


Geometry.AddPlate

��

$��=�,��#��#��2��#��

#��

$��=�,��#��#��2��#��

��

��@��&@��@��

Long variables, provide element connectivity.

��

This function adds a plate element between existing nodes.

��

Dim objOpenSTAAD As Object Dim NodeA As Long Dim NodeB As Long Dim NodeC As Long Dim NodeD As Long 'Get the application object -- 'Add a plate connected between nodes 2, 4, 5 and 6 NodeA = 2 NodeB = 4 NodeC = 5 NodeD = 6 objOpenSTAAD.Geometry.AddPlate NodeA, NodeB, NodeC, NodeD


250

Geometry.CreatePlate

��

$��=��,��,��#��#��#��2��

��#��#��

$��=��,��,��#��#��#��2��

��#��

��

��

A long variable containing the number to assign the newly created plate.

��@��&@��@��

Long variables, provide element connectivity. NodeD is not used for triangular (3-noded) elements.

��

This function adds a plate in the structure between exisiting nodes. The difference between CreatePlate and AddPlate is the former has an option to label the plate with any user-defined number.

��

Dim objOpenSTAAD As Object Dim NodeA As Long Dim NodeB As Long Dim NodeC As Long Dim NodeD As Long 'Get the application object -- 'Add a plate connected between nodes 2, 4, 5 and 6, Call it Plate # 22 NodeA = 2 NodeB = 4 NodeC = 5 NodeD = 6 objOpenSTAAD.Geometry.CreatePlate 22, NodeA, NodeB, NodeC, NodeD


Geometry.GetSolidCount

��

$��=$��

��

:��:

��

This function returns the number of solids in the currently open STAAD file.

��

Dim objOpenSTAAD As Object Dim lSolidCount as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get Solids Count lSolidCount = objOpenSTAAD.GetSolidCount


252

Geometry.GetSolidList

��

��$��=$��1��1��#��!��

��

��+

Long Array variable in which the solid numbers are returned.

��

This function returns the solid list of the current STAAD file.

��

Dim objOpenSTAAD As Object Dim lSolidCnt as Long Dim SolidNumberArray() As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Solid Numbers lSolidCnt = objOpenSTAAD.GetSolidCount ReDim SolidNumberArray(0 to (lSolidCnt-1)) As Long 'Get Solid list objOpenSTAAD.Geometry.GetSolidList (SolidNumberArray)


Geometry.AddSolid

��

$��=��#��#��2��#��

#��#��0��#��#��$��#��)��

$��=��#��#��2��#��

#��#��0��#��

��

��@��&@��@��@��%@��@��)@��*

Long variables, provide solid element connectivity.

��

This function adds a solid element between existing nodes.

��

Dim objOpenSTAAD As Object Dim NodeA As Long Dim NodeB As Long Dim NodeC As Long Dim NodeD As Long Dim NodeE As Long Dim NodeF As Long Dim NodeG As Long Dim NodeH As Long 'Get the application object -- 'Add a solid connected between nodes 2, 4, 5, 6 and 9, 10, 11, 12 NodeA = 2 NodeB = 4 NodeC = 5 NodeD = 6 NodeE = 9 NodeF = 10 NodeG = 11 NodeH = 12 objOpenSTAAD.Geometry.AddSolid NodeA, NodeB, NodeC, NodeD _ NodeE, NodeF, NodeG, NodeH


254

Geometry.CreateSolid

��

$��=��#��#��#��2��

��#��#��#��0��#��#��$��#��)��

$��=��#��#��#��2��

��#��#��#��0��#��

��

��

A long variable containing the number to assign the newly created solid.

��@��&@��@��@��%@��@��)@��*

Long variables, provide solid element connectivity.

��

This function adds a plate in the structure between exisiting nodes. The difference between CreateSolid and AddSolid is the former has an option to label the solid with any user-defined number.

��

Dim objOpenSTAAD As Object Dim NodeA As Long Dim NodeB As Long Dim NodeC As Long Dim NodeD As Long Dim NodeE As Long Dim NodeF As Long Dim NodeG As Long Dim NodeH As Long 'Get the application object -- 'Add a solid connected between nodes 2, 4, 5, 6 and 9, 10, 11, 12. Call it Solid '# 99 NodeA = 2 NodeB = 4 NodeC = 5 NodeD = 6 NodeE = 9 NodeF = 10 NodeG = 11 NodeH = 12


objOpenSTAAD.Geometry.CreateSolid 99, NodeA, NodeB, NodeC, NodeD _ NodeE, NodeF, NodeG, NodeH


256

Geometry.GetSurfaceCount

��

$��=$��

��

:��:

��

This function returns the number of surfaces in the currently open STAAD file.

��

Dim objOpenSTAAD As Object Dim lSurfaceCount as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get Surfaces Count lSurfaceCount = objOpenSTAAD.GetSurfaceCount


Geometry.GetSurfaceList

��

��$��=$�� 1��1�� #��!��

��

��5�,��+

Long Array variable in which the surface numbers are returned.

��

This function returns the surface list of the current STAAD file.

��

Dim objOpenSTAAD As Object Dim lSurfaceCnt as Long Dim SurfaceNumberArray() As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘Get Surface Numbers lSurfaceCnt = objOpenSTAAD.GetSurfaceCount ReDim SurfaceNumberArray(0 to (lSurfaceCnt-1)) As Long 'Get Surface list objOpenSTAAD.Geometry.GetSurfaceList (SurfaceNumberArray)


258

Geometry.AddMultipleNodes

��

$��=�.��#��!��

��

5��

Double array of m x 3 dimension containing X, Y and Z coordinates of nodes.

��

This function adds multiple nodes in the structure.

��

Dim objOpenSTAAD As Object Dim Coordinates(6,2) As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") For I = 0 To 6 Coordinates(I, 0) = … 'X coordinate Coordinates(I, 1) = … 'Y coordinate Coordinates(I, 2) = … 'Z coordinate Next I 'Add multiple nodes objOpenSTAAD.Geometry.AddMultipleNodes Coordinates


Geometry.AddMultipleBeams

��

$��=�.��2��/��

��

��6�,��,��

Long array of m x 2 dimension containing member connectivity.

��

This function adds multiple beams.

��

Dim objOpenSTAAD As Object Dim Incidences(6, 1) As Long 'Get the application object -- For I = 0 To 6 Incidences (I, 0) = … 'ith node Incidences (I, 1) = … 'jth node Next I 'Add multiple beams objOpenSTAAD.Geometry.AddMultipleBeams Incidences


260

Geometry.AddMultiplePlates

��

$��=�.��,��/��

��

��6�,��,��

Long array of m x 4 dimension containing plate element connectivity.

��

This function adds multiple plate elements.

��

Dim objOpenSTAAD As Object Dim Incidences(6, 3) As Long 'Get the application object -- For I = 0 To 6 Incidences (I, 0) = … 'ith node Incidences (I, 1) = … 'jth node Incidences (I, 2) = … 'kth node Incidences (I, 3) = … 'lth node Next I 'Add multiple plates objOpenSTAAD.Geometry.AddMultiplePlates Incidences


Geometry.AddMultipleSolids

��

$��=�.��/��

��

��6�,��,��

Long array of m x 8 dimension containing solid element connectivity.

��

This function adds multiple solid elements.

��

Dim objOpenSTAAD As Object Dim Incidences(6, 7) As Long 'Get the application object -- For I = 0 To 6 'Front face Incidences (I, 0) = … 'ith node Incidences (I, 1) = … 'jth node Incidences (I, 2) = … 'kth node Incidences (I, 3) = … 'lth node 'Back face Incidences (I, 4) = … 'mth node Incidences (I, 5) = … 'nth node Incidences (I, 6) = … 'oth node Incidences (I, 7) = … 'pth node Next I 'Add multiple solids objOpenSTAAD.Geometry.AddMultipleSolids Incidences


262

Geometry.DeleteNode

��

$��=��#��#��#��

��

��

A Long variable containing the node number to be deleted from the structure.

��

Deletes a node specified by NodeNo.

��

Dim objOpenSTAAD As Object Dim NodeNo As Long 'Get the application object -- 'Delete node number 25 NodeNo = 25 objOpenSTAAD.Geometry.DeleteNode NodeNo


Geometry.DeleteBeam

��

$��=��2��2��#��

��

&��

A Long variable containing the beam number to be deleted from the structure.

��

Deletes a beam specified by BeamNo.

��

Dim objOpenSTAAD As Object Dim BeamNo As Long 'Get the application object -- 'Delete beam number 25 BeamNo = 25 objOpenSTAAD.Geometry.DeleteBeam BeamNo


264

Geometry.DeletePlate

��

$��=��,��,��#��

��

��

A long variable containing the plate number to be deleted from the structure.

��

Deletes a plate specified by PlateNo.

��

Dim objOpenSTAAD As Object Dim PlateNo As Long 'Get the application object -- 'Delete plate number 25 PlateNo = 25 objOpenSTAAD.Geometry.DeletePlate PlateNo


Geometry.DeleteSolid

��

$��=��#��

��

��

A long variable containing the solid number to be deleted from the structure.

��

Deletes a solid specified by SolidNo.

��

Dim objOpenSTAAD As Object Dim SolidNo As Long 'Get the application object -- 'Delete solid number 25 SolidNo = 25 objOpenSTAAD.Geometry.DeleteSolid SolidNo


266

Geometry.GetNoOfSelectedNodes

��

��$��=$��#�* ��#��

��

A Long variable containing the number of nodes selected.

��

Returns the number of selected nodes.

��

Dim objOpenSTAAD As Object Dim SelNodesNo As Long 'Get the application object -- 'Get no. of selected nodes SelNodesNo = objOpenSTAAD.Geometry.GetNoOfSelectedNodes


Geometry.GetSelectedNodes

��

$��=$��#��#��

��

��+

An Long array variable to receive the selected node numbers.

��

Integer variable: 1 = return the selections in sorted order, 0 = to return in the order of selection.

��

Returns the node numbers selected in SelNodeArray variable. Call this function after GetNoOfSelectedNodes.

��

Dim objOpenSTAAD As Object Dim SelNodesNo As Long Dim SelNodes() As Long 'Get the application object -- 'Get no. of selected nodes SelNodesNo = objOpenSTAAD.Geometry.GetNoOfSelectedNodes 'Reallocate ReDim SelNodes (SelNodesNo - 1) As Long objOpenSTAAD.Geometry.GetSelectedNodes SelNodes 1


268

Geometry.GetNoOfSelectedBeams

��

��$��=$��#�* ��2��

��

A Long variable containing the number of beams selected.

��

Returns the number of selected beams.

��

Dim objOpenSTAAD As Object Dim SelBeamsNo As Long 'Get the application object -- 'Get no. of selected beams SelBeamsNo = objOpenSTAAD.Geometry.GetNoOfSelectedBeams


Geometry.GetSelectedBeams

��

$��=$��2��2��

��

��&��+

A Long array variable to receive the selected beam numbers.

��


��

Returns the beam numbers selected in SelBeamArray variable. Call this function after GetNoOfSelectedBeams.

��

Dim objOpenSTAAD As Object Dim SelBeamsNo As Long Dim SelBeams() As Long 'Get the application object -- 'Get no. of selected beams SelBeamsNo = objOpenSTAAD.Geometry.GetNoOfSelectedBeams 'Reallocate ReDim SelBeams(SelBeamsNo-1) As Long objOpenSTAAD.Geometry.GetSelectedBeams SelBeams 1


270

Geometry.GetNoOfSelectedPlates

��

��$��=$��#�* ��,��

��

A Long variable containing the number of plates selected.

��

Returns the number of selected plates.

��

Dim objOpenSTAAD As Object Dim SelPlatesNo As Long 'Get the application object -- 'Get no. of selected plates SelPlatesNo = objOpenSTAAD.Geometry.GetNoOfSelectedPlates


Geometry.GetSelectedPlates

��

$��=$��,��,��

��

��+

A Long array variable to receive the selected plate numbers.

��


��

Returns the plate numbers selected in SelPlateArray variable. Call this function after GetNoOfSelectedPlates.

��

Dim objOpenSTAAD As Object Dim SelPlatesNo As Long Dim SelPlates() As Long 'Get the application object -- 'Get no. of selected plates SelPlatesNo = objOpenSTAAD.Geometry.GetNoOfSelectedPlates 'Reallocate ReDim SelPlates(SelPlatesNo-1) As Long objOpenSTAAD.Geometry.GetSelectedPlates SelPlates 1


272

Geometry.GetNoOfSelectedSolids

��

��$��=$��#�* ��

��

A Long variable containing the number of solids selected.

��

Returns the number of selected solids.

��

Dim objOpenSTAAD As Object Dim SelSolidsNo As Long 'Get the application object -- 'Get no. of selected solids SelSolidsNo = objOpenSTAAD.Geometry.GetNoOfSelectedSolids


Geometry.GetSelectedSolids

��

$��=$��

��

��+

A Long array variable to receive the selected solid numbers.

��


��

Returns the solid numbers selected in SelSolidArray variable. Call this function after GetNoOfSelectedSolids.

��

Dim objOpenSTAAD As Object Dim SelSolidsNo As Long Dim SelSolids() As Long 'Get the application object -- 'Get no. of selected solids SelSolidsNo = objOpenSTAAD.Geometry.GetNoOfSelectedSolids 'Reallocate ReDim SelSolids(SelSolidsNo-1) As Long objOpenSTAAD.Geometry.GetSelectedSolids SelSolids 1


274

Geometry.GetLastNodeNo

��

��$��=$��1��#��#��

��

A Long variable containing the last node number.

��

Returns the last node number.

��

Dim objOpenSTAAD As Object Dim LastNodeNo As Long 'Get the application object -- 'Get last node no. LastNodeNo = objOpenSTAAD.Geometry.GetLastNodeNo


Geometry.GetLastBeamNo

��

��$��=$��1��2��#��

��

A Long variable containing the last beam element number.

��

Returns the last beam element number.

��

Dim objOpenSTAAD As Object Dim LastBeamNo As Long 'Get the application object -- 'Get last beam no. LastBeamNo = objOpenSTAAD.Geometry.GetLastBeamNo


276

Geometry.GetLastPlateNo

��

��$��=$��1��,��#��

��

A Long variable containing the last plate element number.

��

Returns the last plate element number.

��

Dim objOpenSTAAD As Object Dim LastPlateNo As Long 'Get the application object -- 'Get last plate no. LastPlateNo = objOpenSTAAD.Geometry.GetLastPlateNo


Geometry.GetLastSolidNo

��

��$��=$��1��#��

��

A Long variable containing the last solid element number.

��

Returns the last solid element number.

��

Dim objOpenSTAAD As Object Dim LastSolidNo As Long 'Get the application object -- 'Get last solid no. LastSolidNo = objOpenSTAAD.Geometry.GetLastSolidNo


278

Geometry.SelectNode

��

$��=��#��#��#��

��

��

Long variable providing the node number to be selected.

��

This function selects a node in the structure.

��

Dim objOpenSTAAD As Object Dim NodeNo As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select node no 2 NodeNo = 2 objOpenSTAAD.Geometry.SelectNode(NodeNo)


Geometry.SelectBeam

��

$��=��2��2��#��

��

&��

Long variable providing the beam number to be selected.

��

This function selects a beam in the structure.

��

Dim objOpenSTAAD As Object Dim BeamNo As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select beam no 2 BeamNo = 2 objOpenSTAAD.Geometry.SelectBeam(BeamNo)


280

Geometry.SelectPlate

��

$��=��,��,��#��

��

��

Long variable providing the plate number to be selected.

��

This function selects a plate in the structure.

��

Dim objOpenSTAAD As Object Dim PlateNo As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select plate no 2 PlateNo = 2 objOpenSTAAD.Geometry.SelectPlate(PlateNo)


Geometry.SelectSolid

��

$��=��#��

��

��

Long variable providing the solid number to be selected.

��

This function selects a solid in the structure.

��

Dim objOpenSTAAD As Object Dim SolidNo As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select solid no 2 SolidNo = 2 objOpenSTAAD.Geometry.SelectSolid(SolidNo)


282

Geometry.SelectMultipleNodes

��

$��=��.��#��#��#��

��

��

Long array variable providing the node numbers to be selected.

��

This function selects multiple nodes in the structure.

��

Dim objOpenSTAAD As Object Dim NodeNos(6) As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select nodes no 1 to 7 For I = 0 To 6 NodeNos(I) = I+1 Next I objOpenSTAAD.Geometry.SelectMultipleNodes(NodeNos)


Geometry.SelectMultipleBeams

��

$��=��.��2��2��#��

��

�&��

Long array variable providing the beam numbers to be selected.

��

This function selects multiple beams in the structure.

��

Dim objOpenSTAAD As Object Dim BeamNos(6) As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select beams no 1 to 7 For I = 0 To 6 BeamNos(I) = I+1 Next I objOpenSTAAD.Geometry.SelectMultipleBeams(BeamNos)


284

Geometry.SelectMultiplePlates

��

$��=��.��,��,��#��

��

��

Long array variable providing the plate numbers to be selected.

��

This function selects multiple plates in the structure.

��

Dim objOpenSTAAD As Object Dim PlateNos(6) As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select Plates no 1 to 7 For I = 0 To 6 PlateNos(I) = I+1 Next I objOpenSTAAD.Geometry.SelectMultiplePlates(PlateNos)


Geometry.SelectMultipleSolids

��

$��=��.��#��

��

��

Long array variable providing the solid numbers to be selected.

��

This function selects multiple solids in the structure.

��

Dim objOpenSTAAD As Object Dim SolidNos(6) As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select Solids no 1 to 7 For I = 0 To 6 SolidNos(I) = I+1 Next I objOpenSTAAD.Geometry.SelectMultipleSolids(SolidNos)


286

Geometry.GetNodeIncidence

��

$��=$��#��/��#��#��!��%��!��

��&��!��'��

��

��

A long variable providing the node number.

��@��@��


��

Returns the coordinates of the specified node.

��

Dim objOpenSTAAD As Object Dim NodeNo As Long Dim CoordX As Double Dim CoordY As Double Dim CoordZ As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get a node NodeNo = 10 objOpenSTAAD.Geometry.GetNodeIncidence NodeNo, CoordX, CoordY, CoordZ


Geometry.GetMemberIncidence

��

$��=$��.��!��/��.��!��#��!��#��

��!��#��2��

��

$��

A long variable providing the member number.

��

Double variable in which the starting node number of the member is returned.

��&

Double variable in which the ending node number of the member is returned.

��

Returns the connecting joints of the specified member.

��

Dim objOpenSTAAD As Object Dim MemberNo As Long Dim NodeA As Double Dim NodeB As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get a Member MemberNo = 5 objOpenSTAAD.Geometry.GetMemberIncidence MemberNo, NodeA, NodeB


288

Geometry.GetPlateIncidence

��

$��=$��,��/��,��#��!��#��!��

#��2��!��#��!��#��

��

��

A long variable providing the plate number.

��@��&@��@��

Double variables in which all the node numbers for the plate element are returned.

��

Returns the connecting joints of the specified plate.

��

Dim objOpenSTAAD As Object Dim PlateNo As Long Dim NodeA As Double Dim NodeB As Double Dim NodeC As Double Dim NodeD As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get a Plate PlateNo = 5 objOpenSTAAD.Geometry.GetPlateIncidence PlateNo, NodeA, NodeB, NodeC, NodeD


Geometry.GetSolidIncidence

��

$��=$��/��#��!��#��!��

#��2��!��#��!��#��!��#��0��!��#��!��#��$��!��#��)��

��

��

A long variable providing the solid number.

��@��&@��@��@��%@��@��)@��*

Double variables in which all the node numbers for the solid element are returned.

��

Returns the connecting joints of the specified solid.

��

Dim objOpenSTAAD As Object Dim SolidNo As Long Dim NodeA As Double Dim NodeB As Double Dim NodeC As Double Dim NodeD As Double Dim NodeE As Double Dim NodeF As Double Dim NodeG As Double Dim NodeH As Double 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Get a Solid PlateNo = 5 objOpenSTAAD.Geometry.GetSolidIncidence SolidNo, NodeA, NodeB, NodeC, NodeD, NodeE, NodeF, NodeG, NodeH


290

Geometry.CreateGroup

��

$��=��$��$��$��#��

��

)��+��

A long variable providing the group type.

1 = Nodes

2 = Beams/Members

3 = Plates

4 = Solids

5 = Geometry (Beams, Plates and Solids)

6 = Floor (Floor beams)

)��

A string variable providing the group name.

��

Creates a group with specified name for the specified type.

��

Dim objOpenSTAAD As Object Dim lGruopType As Long Dim strGruopName As String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Create a Group objOpenSTAAD.Geometry.CreateGroup lGruopType, strGruopName


View Applications

View.ShowFront

��

8��-=�+�-��

��

This function displays the front view of the structure.

��

'Get the application object -- objOpenSTAAD.View.ShowFront


292

View.ShowBack

��

8��-=�+�-2��5��

��

This function displays the back view of the structure.

��

'Get the application object -- objOpenSTAAD.View.ShowBack


View.ShowRight

��

8��-=�+�- ��+��

��

This function displays the right view of the structure.

��

'Get the application object -- objOpenSTAAD.View.ShowRight


294

View.ShowLeft

��

8��-=�+�-1� ��

��

This function displays the left view of the structure.

��

'Get the application object -- objOpenSTAAD.View.ShowLeft


View.ShowPlan

��

8��-=�+�-,��

��

This function displays the top (i.e. plan) view of the structure.

��

'Get the application object -- objOpenSTAAD.View.ShowPlan


296

View.ShowBottom

��

8��-=�+�-2��

��

This function displays the bottom view of the structure.

��

'Get the application object -- objOpenSTAAD.View.ShowBottom


View.ShowIsometric

��

8��-=�+�-/��

��

This function displays the isometric view of the structure.

��

'Get the application object -- objOpenSTAAD.View.ShowIsometric


298

View.RotateUp

��

8��-= ��4��!��

��

��

Double variable providing the degree of rotation.

��

Rotates the structure through Degrees about the Global X-Axis.

��

'Get the application object -- 'Rotate the structure about X Axis through 30 degrees objOpenSTAAD.View.RotateUp 30.0


View.RotateDown

��

8��-= ��-��!��

��

��


��

Rotates the structure through Degrees about the Global X-Axis.

��

'Get the application object -- 'Rotate the structure about X Axis through 30 degrees objOpenSTAAD.View.RotateDown 30.0


300

View.RotateLeft

��

8��-= ��1� ��!��

��

��


��

Rotates the structure through Degrees about the Global Y-Axis.

��

'Get the application object -- 'Rotate the structure about Y Axis through 30 degrees objOpenSTAAD.View.RotateLeft 30.0


View.RotateRight

��

8��-= �� +��!��

��

��


��

Rotates the structure through Degrees about the Global Y-Axis.

��

'Get the application object -- 'Rotate the structure about Y Axis through 30 degrees objOpenSTAAD.View.RotateRight 30.0


302

View.SpinLeft

��

8��-=��1� ��!��

��

��


��

Rotates the structure through Degrees about the Global Z-Axis.

��

'Get the application object -- 'Rotate the structure about Z Axis through 30 degrees objOpenSTAAD.View.SpinLeft 30.0


View.SpinRight

��

8��-=�� +��!��

��

��


��

Rotates the structure through Degrees about the Global Z-Axis.

��

'Get the application object -- 'Rotate the structure about Z Axis through 30 degrees objOpenSTAAD.View.SpinRight 30.0


304

View.ZoomAll

��

8��-='��

��

Display the whole structure.

��

'Get the application object -- 'Display the whole structure objOpenSTAAD.View.ZoomAll


View.CreateNewViewForSelections

��

8��-=��#�-8��-��

��

Display a new view for the selected objects.

��

'Get the application object -- 'Display a new view for selected objects objOpenSTAAD.View.CreateNewViewForSelections


306

View.SetLabel

��

8��-=��1�!��1�!��/��!��+�-��

��

'��6�

Integer variable identifying the label type. It may be one of the following values:

0: Node number label

1: Member number label

2: Member property reference label

3: Material property reference label

4: Support label

5: Member release label

6: Member orientation label

7: Member section label

8: Load value label

9: Axes label

10: Node position label

11: Member specification label

12: Member ends

13: Plate element number label

14: Plate element orientation label


15: Solid element number label

16: Dimension label

17: Floor load label

18: Floor load distribution diagram label

19: Wind load label

20: Wind load influence area diagram label

21: Diagram Info

�(�#��

Boolean variable to set label mode on (True) or off (False).

��

Sets the label on the structure diagram on or off.

��

'Get the application object -- 'Label the member numbers objOpenSTAAD.View.SetLabel(1,True)


308

View.SetSectionView

��

8��-=��8��-��,�� 8�� (8��

��

��

Integer variable identifying the section plane. It may be one of the following values:

0: XY Plane

1: YZ Plane

2: XZ Plane

��9��

Minimum range of the cutting plane.

��!9��

Maximum range of the cutting plane.

��

Creates a section view of the structure.

��

The following call will create a section view in the YZ plane between values X = 0.4 and X = 0.6 in the current view units:

Dim fmin As Double Dim fmax As Double Dim Plane As Integer 'Get the application object -- 'Label the member numbers Plane = 1 ‘YZ Plane fmin = 0.4 fmax = 0.6 objOpenSTAAD.View.SetLabel(plane,fmin,fmax)


View.SetDiagramMode

��

8��-=��.��/��!��+�-��

��

��6�

Integer variable identifying the diagram type. It may be one of the following values:

0: Load

1: Displacement

2: MY

3: MZ

4: FY

5: FZ

6: AX

7: TR

8: Structure

9: Full Section

10: Section Outline

11: Stress

12: Shrink

13: Perspective

14: Hide Structure


310 15: Fill Plates & Solids

16: Hide Plates & Solids

18: Hide Piping

19: Sort Geometry

20: Sort Nodes

21: Plate Stress

22: Solid Stress

23: Mode Shape

24: Stress Animation

25: Plate Reinforcement

26: Deck Influence Diagram*

27: Deck Carriageways*

28: Deck Triangulation*

29: Deck Loads*

30: Deck Vehicles*

*Need the STAAD.beava component

�(�#��

Boolean variable to set label mode on (True) or off (False).

��

Sets the label on the structure diagram on or off.

��

'Get the application object -- ' Turn on the MZ diagram


objOpenSTAAD.View.SetDiagramMode 1, True


312

View.RefreshView

��

8��-= � ��+8��-��

��

��

��

Refreshes the viewing window.

��

'Get the application object -- 'Refresh viewing area of STAAD.Pro Window objOpenSTAAD.View.RefreshView()


View.SetNodeAnnotationMode

��

8��-=��#��.��.��!��

! � ��+��

��

��$��

Integer variable controlling the annotation type. It may be one of the following values:

1 = X Displacement

2 = Y Displacement

3 = Z Displacement

4 = Resultant Displacement

��5��(

Boolean variable (True or False). If True, STAAD.Pro viewing windows refresh with the current annotation mode.

��

Sets the node displacement annotation mode. This function works only in the post-processing mode of STAAD.Pro.

��

Dim bRefresh As Boolean Dim dLabel As Long Dim bRet As Boolean 'Get the application object -- 'Annotate the view with X displacement labels ' Make sure that Staad.Pro is in Postprocessing mode bRet = staad.View.SetInterfaceMode 1 If bRet Then bRefresh = True


314 dLabel = 1 ' disp x staad.View.SetNodeAnotationMode(dLabel, bRefresh) End If


View.SetReactionAnnotationMode

��

8��-=�� .��.��

!��! � ��+��

��

��$��


1 = X Reaction

2 = Y Reaction

3 = Z Reaction

4 = X Rotation

5 = Y Rotation

6 = Z Rotation

7 = Reaction Value Only

��5��(


��

Sets the node displacement annotation mode. This function works only in the post-processing mode of STAAD.Pro.

��

Dim bRefresh As Boolean Dim dLabel As Long Dim bRet As Boolean 'Get the application object --


316 'Annotate the view with X displacement labels ' Make sure that Staad.Pro is in Postprocessing mode bRet = staad.View.SetInterfaceMode (1) If bRet Then bRefresh = True dLabel = 1 ' X Reaction staad.View.SetReactionAnotationMode(dLabel, bRefresh) End If


View.GetInterfaceMode

��

��8��-=$��/�� .��

��

��

��

Returns integer value as per the following:

0: Pre-processor or modeling mode

1: Post-processing mode

2: Interactive design mode for STAAD.etc interoperability

4: Piping mode

5: Beava mode

��

This function returns the current visual mode in the STAAD.Pro environment.

��

Dim bMode As Integer 'Get the application object -- bMode = staad.View.GetInterfaceMode()


318

View.SetInterfaceMode

��

!��8��-=��/�� .��

��

��

An integer variable to set the current visual mode in STAAD.Pro environment. Followings are the valid values for mode:




4: Piping mode

5: Beava mode

��

Returns true or false value, signifying the success or failure of the call.

��

This function sets the current visual mode in the STAAD.Pro environment.

��

Dim bRefresh As Boolean Dim dLabel As Integer Dim bRet As Boolean 'Get the application object -- ' Make sure that Staad.Pro is in Postprocessing mode bRet = staad.View.SetInterfaceMode 1 'Annotate the view with X displacement labels If bRet Then bRefresh = True


dLabel = 2 ' Y Reaction staad.View.SetReactionAnotationMode dLabel bRefresh End If


320

View.SetModeSectionPage

��

!��8��-=��.��,��

��.��,��!,��

��

��,��

An integer variable to set the current visual mode in the STAAD.Pro environment. Valid values for modeSection are the following:




4: Piping mode

5: Beava mode

��$��

An integer variable to set the current main page (the tabs on the left-hand side of the screen) in the STAAD.Pro environment. The following are valid values for modeMainPage:

0: Setup page

1:Geometry page

2:General page

5:Node Results page

6:Beam Result page

7:Plate Results page


8:Solid Results page

��

An integer variable to set the current sub page (within a particular main page - the tabs on the left-hand side of the screen) in the STAAD.Pro environment. The following are valid values for modeSubPage:

0: Job Info page

1: Beam page

4: Plate page

5: Solid page

6: Property page

7: Constant page

8: Material page

9: Support page

10: Member Specifications page

11: Load page

17: Reaction page

18: Displacement page

19: Failure page

20: Forces page

21: Beam Stress page

22: Plate Stress page


322 23: Solid Stress page

��

Returns true or false value, signifying the success or failure of the call.

��

This function sets the current page mode in the STAAD.Pro environment.

��

Sub Main() Dim bRet As Boolean Dim bRefresh As Boolean Dim staad As Object Set staad = GetObject(,"StaadPro.OpenSTAAD") ' Test pre-processing modes bRet = staad.View.SetInterfaceMode(1) If bRet Then staad.View.SetModeSectionPage(1,6,20) staad.View.SetBeamAnnotationMode(2,1,False) End If staad.View.RefreshView() End Sub


View.SetBeamAnnotationMode

��

8��-=��#��.��

��!��! � ��+��

��

��+��


0: Axial Diagram

1: Torsion Diagram

2: Moment Diagram

3: Shear Diagram

4: Stress Diagram

5: Displacement Diagram

��

Integer variable controlling what values are to be shown for the annotationType. It may be one of the following values:

1: End Values

2: Max Absolute Values

4: Mid-span Values

��5��(



324 �

��

Annotates the requested values for beam results in the appropriate view. This function works only in the post-processing mode of STAAD.Pro.

��

Dim bRefresh As Boolean Dim dLabel As Long Dim dValueLoc As Long Dim bRet As Boolean 'Get the application object -- 'Annotate the view with values of Moments at the end of beams for the active beam moment diagrams ' Make sure that Staad.Pro is in Postprocessing mode bRet = staad.View.SetInterfaceMode(spNATypeDX) If bRet Then bRefresh = True dLabel = 2 ' Moment diagram dValueLoc = 1 ' End values staad.View.SetBeamAnotationMode(dLabel, dValueLoc , bRefresh) End If


View.ShowAllMembers

��

8��-=�+�-��.��!��

��

Display all members of the current structure.

��

'Get the application object -- 'Display the whole structure objOpenSTAAD.View.ShowAllMembers


326

View.ShowMembers

��

8��-=�+�-.��!��.��!��#��!��.��!��#��

��

$��

A long variable that holds number of members to show.

$��+

Long array variable holds the member nos, which need to be shown.

��

Show the specified members.

��

Dim objOpenSTAAD As Object Dim lMemberNumber as Long Dim MemberNoArray() As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lMemberNumber = 5 ReDim MemberNoArray(0 to 4) As Long MemberNoArray(0) = 1 MemberNoArray(1) = 2 MemberNoArray(2) = 5 MemberNoArray(3) = 7 MemberNoArray(4) = 10 'Show Member objOpenSTAAD.View.ShowMembers (lMemberNumber, MemberNoArray)


View.HideMembers

��

8��-=)��.��!��.��!��#��!��.��!��#��

��

$��

A long variable that holds number of members to hide.

$��+

Long array variable holds the member nos, which need to be hidden.

��

Hide the specified members.

��

Dim objOpenSTAAD As Object Dim lMemberNumber as Long Dim MemberNoArray() As Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lMemberNumber = 5 ReDim MemberNoArray(0 to 4) As Long MemberNoArray(0) = 1 MemberNoArray(1) = 2 MemberNoArray(2) = 5 MemberNoArray(3) = 7 MemberNoArray(4) = 10 'Hide Member objOpenSTAAD.View.HideMembers (lMemberNumber, MemberNoArray)


328

View.ShowMember

��

8��-=�+�-.��!��1��.��!��#��

��

$��

A long variable that holds member number to be shown.

��

Show the specified member.

��

Dim objOpenSTAAD As Object Dim lMemberNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lMemberNo = 5 'Show Member objOpenSTAAD.View.ShowMember (lMemberNo)


View.HideMember

��

8��-=)��.��!��1��.��!��#��

��

$��

A long variable that holds member number to be hidden.

��

Hide the specified member.

��

Dim objOpenSTAAD As Object Dim lMemberNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lMemberNo = 5 'Hide Member objOpenSTAAD.View.HideMember (lMemberNo)


330

View.HideAllMembers

��

8��-=)��.��!��

��

Hide all the members in the current structure.

��

Dim objOpenSTAAD As Object 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Hide Member objOpenSTAAD.View.HideAllMembers


View.ZoomExtentsMainView

��

8��-='��0(��.��8��-��

��

Adjust viewing scale to zoom main view to the extents.

��

'Get the application object -- 'Display the whole structure objOpenSTAAD.View.ZoomExtentsMainView


332

View.SetUnits

��

8��-=��4��4��4��/��

��

=��+��

An integer variable that holds unit type. Values are as follows:

0 = Dimension

1 = Displacement (Translational Degrees of Freedom)

2 = Sectional Dimension

3 = Sectional Area

4 = Moment of Inertia

5 = Force

6 = Moment

7 = Distributed Force

8 = Distributed Moment

9 = Material Density

10 = Acceleration

11 = Spring Constants (Translational Degrees of Freedom)

12 = Spring Constants (Rotational Degrees of Freedom)

13 = Material Modulus

14 = Stress


15 = Alpha (Coefficient of Thermal Expansion)

16 = Temperature

17 = Mass

18 = Sectional Modulus

19 = Displacement (Rotational Degrees of Freedom)

20 = Soil Subgrade Modulus

-1 = No Unit

=��6�

A string variable that holds the unit for the specified type. Like “cm”, “kns”, “feet”, “kn/cm” etc.

��

Set viewing unit for the active view.

��

Dim intUnitType as Integer Dim strUnitForIt as String 'Get the application object -- 'Set View Unit objOpenSTAAD.View.SetUnits (intUnitType, strUnitForIt)


334

View.HidePlate

��

8��-=)��,��1��,��#��

��

��

A long variable that holds plate number to be hidden.

��

Hide the specified plate.

��

Dim objOpenSTAAD As Object Dim lPlateNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lPlateNo = 102 'Hide Plate objOpenSTAAD.View.HidePlate (lPlateNo)


View.HideSolid

��

8��-=)��1��#��

��

��

A long variable that holds solid number to be hidden.

��

Hide the specified solid.

��

Dim objOpenSTAAD As Object Dim lSolidNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lSolidNo = 35 'Hide Solid objOpenSTAAD.View.HideSolid (lSolidNo)


336

View.HideSurface

��

8��-=)�� 1�� #��

��

��5�,��

A long variable that holds surface number to be hidden.

��

Hide the specified surface.

��

Dim objOpenSTAAD As Object Dim lSurfaceNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lSurfaceNo = 1005 'Hide Surface objOpenSTAAD.View.HideSurface (lSurfaceNo)


View.HideEntity

��

8��-=)��0��1��0��#��

��

%��+��

A long variable that holds entity (ie. Member, Plates etc.) number to be hidden.

��

Hide the specified entity. Entity may be any of Beam, Plate, Solid or Suface.

��

Dim objOpenSTAAD As Object Dim lEntityNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ‘ Variables lEntityNo = 12 'Hide Member objOpenSTAAD.View.HideEntity (lEntityNo)


338

View.SelectMembersParallelTo

��

8��-=��.��!��,��(��/��

��

�!��6�

A string variable that holds the Axis ID. It may have three values:

X = X-Axis

Y = Y-Axis

Z = Z-Axis

��

Select members parallel to the specified axis.

��

Dim objOpenSTAAD As Object Dim strAxis as String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") strAxis = “X” 'Select Members objOpenSTAAD.View.SelectMembersParallelTo (strAxis)


View.SelectGroup

��

8��-=��$��$��#��

��

)��

A string variable that holds the group name.

��

Select the relevant entities of the specified group.

��

Dim objOpenSTAAD As Object Dim strGroupName as String 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select Group objOpenSTAAD.View.SelectGroup (strGroupName)


340

View.SelectInverse

��

8��-=��/��0��

��

%��+�+��

An integer variable that holds entity type. Values may be as follows:

1 = Node

2 = Beam

3 = Plate

4 = Solid

5 = Suface

��

Inverse geometry selection for the specified entity.

��

Dim objOpenSTAAD As Object Dim intEntityType as Integer 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Inverse Selection objOpenSTAAD.View.SelectInverse (intEntityType)


View.SelectByItemList

��

8��-=��2/��1��0��1��/��#��!��

1��/��1��

��

%��+�+��


1 = Node

2 = Beam

3 = Plate

4 = Solid

5 = Suface

6��

A long variable that holds total number of entities needs to be selected.

6��'��+

Long array variable holds the entity nos, which need to be selected.

��

Select entities as specified.

��

Dim objOpenSTAAD As Object Dim intEntityType as Integer Dim lItemNumber as Long Dim lItemListArray() as Array 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") ’Variables lItemNumber = 3


342 ReDim lItemListArray(0 to 2) As Long lItemListArray(0) = 1 lItemListArray(1) = 2 lItemListArray(2) = 5 'Select by list objOpenSTAAD.View.SelectByItemList (intEntityType, lItemNumber, lItemListArray)


View.SelectByMissingAttribute

��

8��-=��2.��!��!��

��

��

An integer variable that holds attribute type. Values may be as follows:

1 = Missing Property

2 = Missing Modulus of Elasticity

3 = Missing Density of Material

4 = Missing Alpha (Coefficient of Thermal Expansion)

5 = Missing Poisson Ratio

��

Select entity list for which specified entity is missing.

��

Dim objOpenSTAAD As Object Dim intAttributeCode as Integer 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Select by Missing Attribute objOpenSTAAD.View.SelectByMissingAttribute (intAttributeCode)


344

View.SelectEntitiesConnectedToNode

��

8��-=��0��#��0��

#��#��

��

%��+�+��


1 = Node

2 = Beam

3 = Plate

4 = Solid

5 = Suface

��

A long variable that holds node numbers with which connected entities needs to be selected.

��

Select entities as specified in type and connected with the specified node.

��

Dim objOpenSTAAD As Object Dim intEntityType as Integer Dim lNodeNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Entities Connected to the Node objOpenSTAAD.View.SelectEntitiesConnectedToNode (intEntityType, lNodeNo)


View.SelectEntitiesConnectedToMember

��

8��-=��0��.��!��0��

.��!��#��

��

%��+�+��


1 = Member

2 = Beam

3 = Plate

4 = Solid

5 = Suface

$��

A long variable that holds Member numbers with which connected entities needs to be selected.

��

Select entities as specified in type and connected with the specified Member.

��

Dim objOpenSTAAD As Object Dim intEntityType as Integer Dim lMemberNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Entities Connected to the Member objOpenSTAAD.View.SelectEntitiesConnectedToMember (intEntityType, lMemberNo)


346

View.SelectEntitiesConnectedToPlate

��

8��-=��0��,��0��

,��#��

��

%��+�+��


1 = Plate

2 = Beam

3 = Plate

4 = Solid

5 = Suface

��

A long variable that holds Plate numbers with which connected entities needs to be selected.

��

Select entities as specified in type and connected with the specified Plate.

��

Dim objOpenSTAAD As Object Dim intEntityType as Integer Dim lPlateNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Entities Connected to the Plate objOpenSTAAD.View.SelectEntitiesConnectedToPlate (intEntityType, lPlateNo)


View.SelectEntitiesConnectedToSolid

��

8��-=��0��0��

��#��

��

%��+�+��


1 = Solid

2 = Beam

3 = Plate

4 = Solid

5 = Suface

��

A long variable that holds Solid numbers with which connected entities needs to be selected.

��

Select entities as specified in type and connected with the specified Solid.

��

Dim objOpenSTAAD As Object Dim intEntityType as Integer Dim lSolidNo as Long 'Get the application object Set objOpenSTAAD = GetObject( , "StaadPro.OpenSTAAD") 'Entities Connected to the Solid objOpenSTAAD.View.SelectEntitiesConnectedToSolid (intEntityType, lSolidNo)


348

Properties Applications

Country Codes

American = 1 Australian = 2

British = 3 Canadian = 4

Chinese = 5 Dutch = 6

European = 7 French = 8

German = 9 Indian = 10

Japanese = 11 Russian = 12

South African = 13 Spanish = 14

Venezuelan = 15 Korean = 16

Aluminum = 17 USColdformed = 18

ISColdformed = 19

Type Specification

ST = 0 RA = 1

D = 2 LD = 3

SD = 4 T = 5

CM = 6 TC = 7

BC = 8 TB = 9

BA = 10 FR = 11

User Defined = -1


Additional Specifications

AddSpec_1 AddSpec_2 AddSpec_3 Used with Type Specification

WP TH TC, BC and TB

CT FC CM

SP D, BA and FR

SP LD and SD

TH WT DT Tube Define

OD ID Pipe Define

Note: Additional specifications should be given in current units.


350

Property.SetMaterialID

��

,��=��.��/��.��/��

��

$��6�

A Long variable providing the material ID ( 0 = Steel, 1 = Concrete, and 2 = Aluminum).

��

Sets the material for the member property.

��

'Get the application object -- 'Set material objOpenSTAAD.Table.SetMaterialID 0


Property.CreateBeamPropertyFromTable

��

��,��=��2��,��!��

��#��!��?��!��?��

��

A reference number of the property created to be used to access the same.

��

��+

A Long variable providing the country code. Refer to the list of Country Codes at the beginning of this section.

��,��

String variable containing the name of the section.

�+��,

A Long variable providing the type specification. Refer to the list of Type Specifications at the beginning of this section.

��,A0@��,A1

Double variables providing additional information. Refer to the list of

Additional Specifications at the beginning of this section.

��

Creates beam property from database.


352

��

'Get the application object -- 'Create property ISMB600 from Indian database PropertyNo = objOpenSTAAD.Property.CreateBeamPropertyFromTable _ 10, "ISMB600", 0, 0.0, 0.0 '0 = ST, no additional specification required


Property.CreateChannelPropertyFromTable

��

��,��=��+��,��!��

��#��!��?��

��


��

��+

A Long variable providing the country code. Refer to the list of Country Codes provided at the beginning of this section.

��,��


�+��,

A Long variable providing the type specification. Refer to the list of

Type Specifications at the beginning of this section.

��,A0

Double variable providing additional information. Refer to the list of

Additional Specifications at the beginning of this section.

��

Creates channel property from database.

��

'Get the application object -- 'Create property ISMC600 from Indian database PropertyNo = objOpenSTAAD.Property.CreateChannelPropertyFromTable _ 10, "ISMC200", 0, 0.0


354 '0 = ST, no additional specification required


Property.CreateAnglePropertyFromTable

��

��,��=��,��!��

��#��!��?��

��


��

��+

A Long variable providing the country code. Refer to the list of Country Codes at the beginning of this section.

��,��


�+��,


Type Specifications found at the beginning of this section.

��,A0

Double variable providing additional information. Refer to the list of

Additional Specifications found at the beginning of this section.

��

Creates angle property from database.

��

'Get the application object -- 'Create property ISA100X100X10 from Indian database PropertyNo = objOpenSTAAD.Property.CreateAnglePropertyFromTable _ 10, "ISA100X100X10", 0, 0.0


356 '0 = ST, no additional specification required


Property.CreateTubePropertyFromTable

��

��,��=��!�,��!��

��#��!��?��!��?��!��?6��

��


��

��+

A Long variable providing the country code. Refer to the list of Country Codes found at the beginning of this section.

��,��


�+��,



��,A0@��,A1@��,A2



��

Creates tube property from database.

��

'Get the application object -- 'Create property TUB30302.6 from Indian database PropertyNo = objOpenSTAAD.Property.CreateTubePropertyFromTable _


358 10, " TUB30302.6", 0, 0.0, 0.0, 0.0 '0 = ST, no additional specification required 'Create user defined tube of 300mm x 200mm x 8mm PropertyNo = objOpenSTAAD.Property.CreateTubePropertyFromTable _ 10, " ", -1, 0.008, 0.3, 0.2 '-1 = User defined


Property.CreatePipePropertyFromTable

��

��,��=��,��,��!��

��#��!��?��!��?��

��


��

��+

A Long variable providing the country code. Refer to the list of Country Codes found at the beginning of this section.

��,��


�+��,



��,A0@��,A1



��

Creates pipe property from database.

��

'Get the application object -- 'Create property PIP1270.0M from Indian database PropertyNo = objOpenSTAAD.Property.CreatePipePropertyFromTable _


360 10, " PIP1270.0M", 0, 0.0, 0.0 '0 = ST, no additional specification required 'Create user defined tube of OD 300mm and ID 280mm PropertyNo = objOpenSTAAD.Property.CreatePipePropertyFromTable _ 10, " ", -1, 0.3, 0.28 '-1 = User defined


Property.CreatePrismaticRectangleProperty

��

��,��=��,�� ,��!��&��

��!��'��

��


��

��

A Double variable providing the depth along the local Y-axis.

��

A Double variable providing the width along the local Z-axis.

��

Creates prismatic rectangle property.

��

'Get the application object -- 'Create rectangle property of 250x500mm PropertyNo = objOpenSTAAD.Property.CreatePrismaticRectangleProperty 0.5, 0.25


362

Property.CreatePrismaticCircleProperty

��

��,��=��,��,��!��&��

��


��

��

A Double variable providing the circle diameter.

��

Creates prismatic circle property.

��

'Get the application object -- 'Create circle property of 250mm diameter PropertyNo = objOpenSTAAD.Property.CreatePrismaticCircleProperty 0.25


Property.CreatePrismaticTeeProperty

��

��,��=��,��,��!��&��!��'��

��!��&2��!��'2��

��


��

��

A Double variable providing the overall depth along the local Y-axis.

��

A Double variable providing the overall width along the local Z-axis.

�&

A Double variable providing the depth of the web along the local Y-axis.

�&

A Double variable providing the width of the web along the local Z-axis.

��

Creates prismatic tee property.

��

'Get the application object -- 'Create tee property of 250x500mm PropertyNo = objOpenSTAAD.Property.CreatePrismaticTeeProperty _ 0.5, 0.25, 0.4, 0.1


364

Property.CreatePrismaticTrapezoidalProperty

��

��,��=��,��"��,��!��&��

��!��'��!��'2��

��


��

��

A Double variable providing the depth along the local Y-axis.

��

A Double variable providing the top width along the local Z-axis.

�&

A Double variable providing the bottom width along the local Z-axis.

��

Creates prismatic trapezoidal property.

��

'Get the application object -- 'Create trapezoidal property PropertyNo = objOpenSTAAD.Property.CreatePrismaticTeeProperty 0.5, 0.25, 0.2


Property.CreatePrismaticGeneralProperty

��

��,��=��,��$��,��!��

,��

��


��

��+��+

A Double array variable providing the property values as follows:

Array Index Property Type

0 AX 1 AY 2 AZ 3 IX 4 IY 5 IZ 6 YD 7 ZD 8 YB 9 ZB

For additional information, please refer to the STAAD.Pro Technical Reference manual.

��

Creates prismatic general section property

��

Dim PropArray(0 To 9) As Double 'Get the application object -- 'Create general section property


366 'fill PropArray here PropArray(0) = PropArray(1) = PropArray(2) = PropArray(3) = PropArray(4) = PropArray(5) = PropArray(6) = PropArray(7) = PropArray(8) = PropArray(9) = PropertyNo = objOpenSTAAD.Property.CreatePrismaticGeneralProperty PropArray


Property.CreateTaperedIProperty

��

��,��=��/,��!��,��

��


��

��+��+

A Double array variable providing the property values as follows:

Array Index Property Type

0 F1 1 F2 2 F3 3 F4 4 F5 5 F6 6 F7


��

Creates tapered I property

��

Dim PropArray(0 To 6) As Double 'Get the application object -- 'Create tapered I section property 'fill PropArray here PropArray(0) = PropArray(1) = PropArray(2) = PropArray(3) = PropArray(4) = PropArray(5) =


368 PropArray(6) = PropertyNo = objOpenSTAAD.Property.CreateTaperedIProperty PropArray


Property.CreateTaperedTubeProperty

��

��,��=��!�,��* ��!��

��!��!��!��+��

��


��

�+��"5��

Integer variable providing the tube type as follows:

Type Of Tube Value

Round 0 HexDecagonal 1 Dodecagonal 2

Octagonal 3 Hexagonal 4

Square 5


�0@�1

Double variables providing the depth of tube at start and end nodes.

�(

Double variable providing the thickness of tube.

��

Creates tapered tube property.


370 ��

'Get the application object -- 'Create tapered tube section property PropertyNo = objOpenSTAAD.Property.CreateTaperedTubeProperty 0.5, 0.4, 0.01


Property.CreateAssignProfileProperty

��

��,��=��,�� ,��* ,��

��


��

�+��"5��5��

Integer variable providing the profile type as follows:

Type Of Profile Value

Angle 0 Double Angle 1

Beam 2 Column 3 Channel 4


��

Creates "Assign Profile" property.

��

'Get the application object -- 'Create Assign Profile property PropertyNo = objOpenSTAAD.Property.CreateAssignProfileProperty 2


372

Property.CreatePlateThicknessProperty

��

��,��=��,��+��5��,��!��

�+��5��

��,��=��,��+��5��,��!��+��5��

��


��

�(�,8��+

Double array variable providing different plate thickness at all nodes.

�(�,8��

Double variable providing single plate thickness for all nodes.

��

Creates plate thickness property.

��

'Get the application object -- 'Create plate thickness property PropertyNo = objOpenSTAAD.Property.CreatePlateThicknessProperty 0.2


Property.AssignBeamProperty

��

!��,��=��2��,��2��#��

,��#��

!��,��=��2��,��2��#��

,��#��

��

TRUE if successful, else FALSE.

��

&��

Integer variable providing the beam number.

&��+

Integer variable array providing the beam numbers.

��+��

Integer variable providing the property reference number.

��

Assigns property to beam or beams.

��

'Get the application object -- 'assign property no 1 to beam no 3 bResult = objOpenSTAAD.Property.AssignBeamProperty 3, 1


374

Property.AssignPlateThickness

��

!��,��=��,��+��5��,��#��

,��#��

��


��

��

Integer variable providing the plate number.

��+��

Integer variable providing the property reference number.

��

Assigns thickness to plate.

��

'Get the application object -- 'assign property no 1 to plate no 3 bResult = objOpenSTAAD.Property.AssignPlateThickness 3, 1


Property.AssignBetaAngle

��

!��,��=��2��2��#��!��

2��

!��,��=��2��2��#��!��

2��

��


��

&��


&��+


&��

Double variable providing the beta angle in degrees.

��

Assigns Beta Angle to beam or beams.

��

'Get the application object -- 'assign beta angle 90.0 to beam no 3 bResult = objOpenSTAAD.Property.AssignBetaAngle 3, 90.0


376

Property.CreateMemberTrussSpec

��

��,��=��.��!��

��

A reference number of the specification created to be used to access the same.

��

Creates MEMBER TRUSS specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberTrussSpec


Property.CreateMemberInactiveSpec

��

long Property.CreateMemberInactiveSpec ( )

��


��

Creates MEMBER INACTIVE specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberInactiveSpec


378

Property.CreateMemberTensionSpec

��

��,��=��.��!��

��


��

Creates MEMBER TENSION specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberTensionSpec


Property.CreateMemberCompressionSpec

��

��,��=��.��!��

��


��

Creates MEMBER COMPRESSION specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberCompressionSpec


380

Property.CreateMemberIgnoreStiffSpec

��

��,��=��.��!��/��

��


��

Creates MEMBER IGNORE specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberIgnoreStiffSpec


Property.CreateMemberCableSpec

��

��,��=��.��!��!��!��/� ��

��!��8��

��


��

��6�5�

Integer variable specifying additional information about the cable:

0 = Initial TENSION of Value in the cable to be considered

1 = Unstressed LENGTH of Value to be considered

9��

Double variable providing Initial TENSION or Unstressed LENGTH.

��

Creates MEMBER CABLE specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberCableSpec 0, 4.5


382

Property.CreateMemberOffsetSpec

��

��,��=��.��!��* ��*�0��

��1��*�$��!��!��* ��%��!��* ��&��!��* ��'��

��


��

��"�%��

Integer variable specifying whether offsets are at START (= 0) or END (= 1) of the member.

'�,��"�)��

Integer variable specifying whether the offsets are given with respect to Local (= 1) axis or Global axis (= 0).

"55��@"55��@"55��

Double variables providing the X, Y and Z offsets in current units.

��

Creates MEMBER OFFSET specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberOffsetSpec 0, 0, 0.5, 0.0, 0.0


Property.AssignMemberSpecToBeam

��

!��,��=��.��!��2��2��#��

��#��

!��,��=��.��!��2��2��#��

��#��

��


��

&��


&��+


��,��

Integer variable providing the member specification reference number.

��

Assigns specifications to beam or beams.

��

'Get the application object -- 'assign specification no 1 to beam no 3 bResult = objOpenSTAAD.Property.AssignMemberSpecToBeam 3, 1


384

Property.CreateElementPlaneStressSpec

��

��,��=��0��,��

��


��

Creates ELEMENT PLANE STRESS specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateElementPlaneStressSpec


Property.CreateElementIgnoreInplaneRotnSpec

��

��,��=��0��/��/��

��


��

Creates ELEMENT IGNORE INPLANE ROTATION specification.

��

'Get the application object -- 'create specification lSpecNo = objOpenSTAAD.Property.CreateElementIgnoreInplaneRotnSpec


386

Property.AssignElementSpecToPlate

��

!��,��=��0��,��,��#��

��#��

!��0��,��,��#��

��#��

��


��

��


��+

Integer variable array providing the plate numbers.

��,��

Integer variable providing the element specification reference number.

��

Assigns specifications to plate or plates.

��

'Get the application object -- 'assign specification no 1 to Plate no 3 bResult = objOpenSTAAD.Property.AssignElementSpecToPlate (3, 1)


Property.CreateMemberReleaseSpec

��

��,��=��.��!�� *�0��

/��*� ��!��

��


��

��"�%��


�"��+

Integer variable array of size 6 providing releases in different degrees of freedom (0 = No Release, 1 = Release) FX, FY, FZ, MX, MY and MZ.

��+

Double variable array of size 6 providing the spring constants KFX, KFY, KFZ, KMX, KMY and KMZ.

��

Creates MEMBER RELEASE specification.

��

Dim DOFRelease(0 To 5) As Integer Dim SpringConst (0 To 5) As Double 'Get the application object -- 'set the flags for releases 'set spring constants if any 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberReleaseSpec _ 0, DOFRelease, SpringConst


388

Property.CreateMemberPartialReleaseSpec

��

��,��=��.��!��,��

��*�0��,�� !��

��.��!��,�� *�0��

,�� !��

��


��

��"�%��


��

Integer variable to set the flag for MP (0 = No Release, 1 = Release).

��+

Integer variable array of size 3 providing releases in different degrees of freedom (0 = No Release, 1 = Release) MPX, MPY and MPZ.

��,��

Double variable providing the partial moment release factor to be applied uniformly to all three DOF’s.

��,��+

Double variable array of size 3 providing the partial moment release factors in respective DOF’s.

��

Creates MEMBER RELEASE specification.


��

Dim DOFRelease(0 To 2) As Integer Dim MPFactor (0 To 2) As Double 'Get the application object -- 'set the flags for releases 'set moment release factors if any 'create specification lSpecNo = objOpenSTAAD.Property.CreateMemberPartialReleaseSpec _ 0, DOFRelease, MPFactor


390

Property.CreateElementNodeReleaseSpec

��

��,��=��0��#�� #��

��*� ��

��


��

��

Integer variable specifying node (1, 2, 3 or 4) of the element to be released.

�"��+

Integer variable array of size 6 providing releases in different degrees of freedom (0 = No Release, 1 = Release) FX, FY, FZ, MX, MY and MZ.

��

Creates ELEMENT RELEASE specification.

��

Dim DOFRelease(0 To 5) As Integer 'Get the application object -- 'set the flags for releases 'create specification lSpecNo = objOpenSTAAD.Property.CreateElementNodeReleaseSpec 1, DOFRelease


Property.GetCountryTableNo

��

,��=$��!��#��2��#��

��

&��

Long variable holds the beam no.

��

Returns country table no for the specified member.

��

Dim lCountryTableNo As Long Dim lBeamNo as Long 'Get the application object – 'Get Property lCountryTableNo = objOpenSTAAD.Property.GetCountryTableNo (lBeamNo)


392

Property.GetSectionTableNo

��

,��=$��!��#��2��#��

��

&��


��

Returns section table no for the specified member.

��

Dim lSectionTableNo As Long Dim lBeamNo as Long 'Get the application object – 'Get Property lSectionTableNo = objOpenSTAAD.Property.GetSectionTableNo (lBeamNo)


Property.GetBeamSectionName

��

,��=$��2��#��2��#��

��

&��


��

Returns beam section name for the specified member.

��

Dim lBeamSectionName As Long Dim lBeamNo as Long 'Get the application object – 'Get Property lBeamSectionName = objOpenSTAAD.Property.GetBeamSectionName (lBeamNo)


394

Property.GetBeamSectionPropertyTypeNo

��

,��=$��2��,��#��2��#��

��

&��


��

Returns beam section property type no for the specified member.

��

Dim lBSPropertyTypeNo As Long Dim lBeamNo as Long 'Get the application object – 'Get Property lBSPropertyTypeNo = objOpenSTAAD.Property.GetBeamSectionPropertyTypeNo (lBeamNo)


Property.GetBeamMaterialName

��

,��=$��2��.��#��2��#��

��

&��


��

Returns beam material name for the specified member.

��

Dim lBeamMaterialName As Long Dim lBeamNo as Long 'Get the application object – 'Get Property lBeamMaterialName = objOpenSTAAD.Property.GetBeamMaterialName (lBeamNo)


396

Property.GetMaterialProperty

��

,��=$��.��,��.��#��!��

0��!��,��!��!��+��!��

��

$��

String holds the material name.

%��,��+@��@��+@��(�@��

Double variables return material properties.

��

Retrives material properties of the specified material.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetMaterialProperty (strMaterialName, dElasticity, dPoisson, dDensity, dAlpha, dDamp)


Property.GetBeamConstants

��

,��=$��2��2��#��!��0��

��!��,��!��!��+��!��

��

&��

Long variable holds the beam number.

%��,��+@��@��+@��(�@��

Double variables return material properties.

��

Retrives material properties of the specified beam member.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetBeamConstants (lBeamNo, dElasticity, dPoisson, dDensity, dAlpha, dDamp)


398

Property.GetBeamPropertyAll

��

,��=$��2��,��2��#��!��3��+��!��

��+��!��(��!��!��"��!��/(��!��/��!��/"��!�� !��-��

��

&��


7��(@��(@�!@�+@��@6!@6+@6�@�5@�#

Double variables return all member properties.

��

Retrives long member properties of the specified beam member.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetBeamPropertyAll (lBeamNo, dWidth, dDepth, dAx, dAy, dAz, dIx, dIy, dIz, dTf, dTw)


Property.GetBeamProperty

��

,��=$��2��,��2��#��!��3��+��!��

��+��!��(��!��!��"��!��/(��!��/��!��/"��

��

&��


7��(@��(@�!@�+@��@6!@6+@6�

Double variables return only sectional member properties.

��

Retrives short member properties of the specified beam member.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetBeamProperty (lBeamNo, dWidth, dDepth, dAx, dAy, dAz, dIx, dIy, dIz)


400

Property.GetBetaAngle

��

,��=$��2��2��#��

��

&��


��

Retrives beta angle of the specified beam member.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetBetaAngle (lBeamNo)


Property.GetSectionPropertyCount

��

,��=$��,��

��

Returns total number of different sectional properties exist in the current STAAD file.

��

Dim lSectionPropertyCount as Long 'Get the application object -- 'Get Property lSectionPropertyCount = objOpenSTAAD.Property.GetSectionPropertyCount


402

Property.GetSectionPropertyName

��

,��=$��,��#�� #��

,��#��

��

��,��5��

Long variable holds the section property reference number.

��+��

String variable returns the property name.

��

Returns the property name for the specified section property reference number.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetSectionPropertyName (lSecRefNo, strPropertyName)


Property.GetSectionPropertyType

��

,��=$��,�� #��

��

��,��5��


��

Returns the section property type for the specified section property reference number.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetSectionPropertyType (lSecRefNo)


404

Property.GetSectionPropertyCountry

��

,��=$��,�� #��

��

��,��5��


��

Returns the country reference number for the section property reference number specified.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetSectionPropertyCountry (lSecRefNo)


Property.GetIsotropicMaterialCount

��

,��=$��/��.��

��

Returns number of isotropic material present in the current structure.

��

Dim lIsotropicMaterialCount as Long 'Get the application object -- 'Get Property lIsotropicMaterialCount = objOpenSTAAD.Property.GetIsotropicMaterialCount


406

Property.GetIsotropicMaterialProperties

��

,��=$��/��.��,��.��#��!��0��

��!��,��!��$��!��!��+��!��

��

$��

Long variable holds the material reference number.

%@��@)@��+@��(�@��

Double variables return isotropic material properties.

��

Returns the properties for the specified isotropic material number.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetIsotropicMaterialProperties (lMatNo, dE, dPoisson, dG, dDensity, dAlpha, dCrDamp)


Property.GetOrthotropic2DMaterialCount

��

,��=$��*��+��.��

��

Returns number of 2D orthotropic material present in the current structure.

��

Dim lOrthotropic2DMaterialCount as Long 'Get the application object -- 'Get Property lOrthotropic2DMaterialCount = objOpenSTAAD.Property.GetOrthotropic2DMaterialCount


408

Property.GetOrthotropic2DMaterialProperties

��

,��=$��*��+��.��,��.��#��!��

0��!��,��!��$��!��!��+��!��

��

$��


%@��@)@��+@��(�@��

Double array (dimension 2) variables return 2D orthotropic material properties.

��


��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetOrthotropic2DMaterialProperties (lMatNo, dEArray, dPoissonArray, dGArray, dDensityArray, dAlphaArray, dCrDampArray)


Property.GetOrthotropic3DMaterialCount

��

,��=$��*��+��6�.��

��

Returns number of 3D orthotropic material present in the current structure.

��

Dim lOrthotropic3DMaterialCount as Long 'Get the application object -- 'Get Property lOrthotropic3DMaterialCount = objOpenSTAAD.Property.GetOrthotropic3DMaterialCount


410

Property.GetOrthotropic3DMaterialProperties

��

,��=$��*��+��6�.��,��.��#��!��

0��!��,��!��$��!��!��+��!��

��

$��


%@��@)@��+@��(�@��

Double array (dimension 3) variables return 3D orthotropic material properties.

��


��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetOrthotropic3DMaterialProperties (lMatNo, dEArray, dPoissonArray, dGArray, dDensityArray, dAlphaArray, dCrDampArray)


Property.GetMemberGlobalOffSet

��

,��=$��.��!��$��!��* ��2��#��0��

��!��(* ��!��* ��!��"* ��

��

&��

Long variable holds the member reference number.

%��

Integer value specifies the end of the member.

0 = Start

1 = End

!"55��@+"55��@�"55��

Double variables return offset value of the specified member in all direction at the specified end.

��

Returns beam end offsets in all three global directions.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetMemberGlobalOffSet (lBeamNo, iEnd, dxOffSet, dyOffSet, dzOffSet)


412

Property.GetMemberLocalOffSet

��

,��=$��.��!��1��* ��2��#��0��

��!��(* ��!��* ��!��"* ��

��

&��


%��


0 = Start

1 = End

!"55��@+"55��@�"55��

Double variables return offset value of the specified member in all three local directions at the specified end.

��

Returns beam end offsets in all three local directions.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetMemberLocalOffSet (lBeamNo, iEnd, dxOffSet, dyOffSet, dzOffSet)


Property.GetMemberReleaseSpec

��

,��=$��.��!�� 2��#��0��

��

��

&��


%��


0 = Start

1 = End

��+@��+

Long array returns translational and rotational releases.

��

Returns releases for the specified member at the specified end.

��

'Get the application object -- 'Get Property objOpenSTAAD.Property.GetMemberReleaseSpec (lBeamNo, iEnd, lReleaseArray, lSpringConstArray


414

Loads Applications

Load.CreateNewPrimaryLoad

��

��1��=��#�-,��1��#�-,��1��

��

Long integer containing the load number created.

��

��#��+'��

String variable providing the title of the load case.

��

Creates new PRIMARY load case.

��

'Get the application object -- 'Create new load objOpenSTAAD.Load.CreateNewPrimaryLoad "My Load"


Load.SetLoadActive

��

!��1��=��1��1��#��

��


��

'��

Integer variable providing the load number which will be made active.

��

Make the specified load number active.

��

'Get the application object -- 'make load case 1 active objOpenSTAAD.Load.SetLoadActive 1


416

Load.AddSelfWeightInXYZ

��

!��1��=�� 3��+�/�%&'��!��

1��

��

TRUE if successful else FALSE.

��

��,��

Integer variable giving the direction of selfweight: X direction = 1, Y direction = 2, Z direction = 3.

'��,��

Double variable providing the multiplying factor for selfweight.

��

Adds SELFWEIGHT of the structure in X or Y or Z direction to the active load case.

��

'Get the application object -- 'Add selfweight in negative Y direction objOpenSTAAD.Load.AddSelfWeightInXYZ 2, -1.0


Load.AddNodalLoad

��

!��1��=�#��1��#��#��!��%��!��

��&��!��'��!��.��%��!��.��&��!��.��'��

!��1��=�#��1��#��#��!��%��

��!��&��!��'��!��.��%��!��.��&��!��.��'��

��


��

��

Integer variable providing the node number.

��+

Integer variable array providing the node numbers.

��,��@��,��@��,��@$��@$��@$��

Double variables providing the load values in individual directions.

��

Adds JOINT LOAD to the specified node number or numbers.

��

'Get the application object -- 'Add joint load of 2units in X direction at node number 2 objOpenSTAAD.Load.AddNodalLoad 2, 2.0, 0.0, 0.0, 0.0, 0.0, 0.0


418

Load.AddSupportDisplacement

��

!��1��=��#��#��

��!��

!��1��=��#��#��

��!��

��


��

��

Integer variable providing the node number.

��+

Integer variable array providing the node numbers.

��,��

Integer variable giving the direction of displacement: X direction = 1, Y direction = 2, Z direction = 3.

��,��

Double variable providing the magnitude of the support displacement in current units.

��

Adds SUPPORT DISPLACEMENT to node or nodes.

��

'Get the application object -- 'Add joint load of 2mm displacement to node 2 in global X objOpenSTAAD.Load.AddSupportDisplacement 2, 1, 2.0


Load.AddMemberUniformForce

��

!��1��=�.��!��4�� 2��#��

��!��8��!��8��!��8��!��68��

!��1��=�.��!��4�� 2��#��

��!��8��!��8��!��8��!��68��

��


��

&��


&��+


��,��

Integer variable giving the direction of load: X direction = 1, Y direction = 2, Z direction = 3, GX direction = 4, GY direction = 5, GZ direction = 6, PX direction = 7, PY direction = 7, PZ direction = 8.

��,�9��

Double variable providing the magnitude of the uniform force in current units.

�09��@�19��@�29��

Double variable providing the value of d1, d2, d3 in current units. For additional information, please refer to the STAAD.Pro Technical Reference manual.


420 ��

Adds UNIFORM FORCE to beam or beams.

��

'Get the application object -- 'Add member uniform load of 2 units to member 2 in GY direction objOpenSTAAD.Load.AddMemberUniformForce 2, 5, 2.0, 0.0, 0.0, 0.0


Load.AddMemberUniformMoment

��

!��1��=�.��!��4�� .��2��#��

��!��.��8��!��8��!��8��!��68��

!��1��=�.��!��4�� .��2��#��

��!��.��8��!��8��!��8��!��68��

��


��

&��


&��+


��,��


$��9��

Double variable providing themagnitude of the uniform moment in current units.

�09��@�19��@�29��

Double variable providing value of d1, d2, d3 in current units. For additional information, please refer to the STAAD.Pro Technical Reference manual.


422 ��

Adds UNIFORM MOMENT to beam or beams.

��

'Get the application object -- 'Add member uniform moment of 2 units to member 2 in GY direction objOpenSTAAD.Load.AddMemberUniformMoment 2, 5, 2.0, 0.0, 0.0, 0.0


Load.AddMemberConcForce

��

!��1��=�.��!��2��#��

��!��8��!��8��!��8��

!��1��=�.��!��2��#��

��!��8��!��8��!��8��

��


��

&��


&��+


��,��


��,�9��

Double variable providing the magnitude of the concentrated force in current units.

�09��@�19��

Double variables providing values of d1, d2 in current units. For additional information, please refer to the STAAD.Pro Technical Reference manual.

��

Adds CONCENTRATED FORCE to beam or beams.


424 ��

'Get the application object -- 'Add member concentrated load of 2 units to member 2 in GY direction objOpenSTAAD.Load.AddMemberConcForce 2, 5, 2.0, 0.0, 0.0, 0.0


Load.AddMemberConcMoment

��

!��1��=�.��!��.��2��#��

��!��.��8��!��8��!��8��

!��1��=�.��!��.��2��#��

��!��.��8��!��8��!��8��

��


��

&��


&��+


��,��


$��9��

Double variable providing the magnitude of the concentrated moment in current units.

�09��@�19��

Double variable providing value of d1, d2 in current units. For additional information, please refer to the STAAD.Pro Technical Reference manual.


426 ��

Adds CONCENTRATED MOMENT to beam or beams.

��

'Get the application object -- 'Add member concentrated moment of 2 units to member 2 in GY direction objOpenSTAAD.Load.AddMemberConcMoment 2, 5, 2.0, 0.0, 0.0, 0.0


Load.AddMemberLinearVari

��

!��1��=�.��!��1��8��2��#��

��!��1��!��0�1��!��1��

!��1��=�.��!��1��8��2��#��

��!��1��!��0�1��!��1��

��


��

&��


&��+


��,��

Integer variable giving the direction of load: X direction = 1, Y direction = 2, Z direction = 3.

��'��@%��'��

Double variable providing the load value at the start and end of the member respectively.

��'��

Double variable providing the magnitude of the load value for triangular load. If it has a value other than 0, the load is regarded as a triangular load irrespective of values in StartLoad and EndLoad.

��

Adds LINEARLY VARYING load to beam or beams.


428 ��

'Get the application object -- 'Add member linearly varying to member 2 in GY direction objOpenSTAAD.Load.AddMemberLinearVari 2, 2, 2.0, 0.0, 0.0


Load.AddMemberTrapezoidal

��

!��1��=�.��!��"��2��#��

��!��1��!��0�1��!��!��1��1��+��

!��1��=�.��!��"��2��#��

��!��1��!��0�1��!��!��0��

��

TRUE if successful else FALSE

��

&��


&��+


��,��


��'��@%��'��

Double variable providing the load value at the start and end of the member respectively.

��,�@%��,�

Double variable providing the start and end distance of the load.


430 ��

Adds trapezoidal linearly varying load to beam or beams.

��

'Get the application object -- 'Add member linearly varying to member 2 in GY direction objOpenSTAAD.Load.AddMemberLinearVari 2, 2, 2.0, 0.0, 0.0


Load.AddMemberAreaLoad

��

!��1��=�.��!��1��2��#��!��

��1��

!��1��=�.��!��1��2��#��!��

��1��

��


��

&��


&��+


��'��

Double variable providing the magnitude of the load value.

��

Adds AREA LOAD to beam or beams.

��

'Get the application object -- 'Add area load to member 2 objOpenSTAAD.Load.AddMemberAreaLoad 2, 2.0


432

Load.AddMemberFloorLoad

��

1��=�.��!��1��!��,��!��&./#��!��

&.�%��!��'./#��!��'.�%��!��%./#��!��%.�%��

��

��

A double value to indicate the pressure intensity to be applied as a floor load.

�$6�@�$��@�$6�@�$��@�$6�@�$��

Double values to indicate what the boundary of the floor is. The XMIN, XMAX and ZMIN and ZMAX values must lie on the same XZ plane.

��

Automatically finds enclosed panels in the given boundary and adds a FLOOR LOAD command in the format:

YRANGE ymin ymax FLOAD pressure XRANGE xmin xmax ZRANGE zmin zmax

��

'Get the application object -- 'Add a floor load with intensity of -5 objOpenSTAAD.Load.AddMemberFloorLoad -5, 2.9, 3.1, 0, 80, 0, 200


Load.AddMemberFixedEnd

��

!��1��=�.��!��(�0��2��#��!��

1��!��1��0��

!��1��=�.��!��(�0��2��#��!��

1��!��1��0��

��


��

&��


&��+


'��+@'��%��+

Double variable arrays of dimension 6 providing the fixed end load values at member start and end. The indices are as follows: 0 = Fx1, 1 = Fy1, 2 = Fz1, 3 = Mx1, 4 = My1, 5 = Mz1 for start and 0 = Fx2, 1 = Fy2, 2 = Fz2, 3 = Mx2, 4 = My2, 5 = Mz2 for end.

��

Adds FIXED END LOAD to beam or beams.

��

Dim start(0 To 5) As Double Dim end(0 To 5) As Double 'Get the application object -- 'Fill up the array accordingly 'Add fixed end load to member 2 objOpenSTAAD.Load.AddMemberFixedEnd 2, start, end


434

Load.AddElementPressure

��

!��1��=�0��,��,��#��

��!��,��!��%��!��&��!��%��!��&��

!��1��=�0��,��,��#��

��!��,��!��%��!��&��!��%��!��&��

��


��

��


��+


��,��

Integer variable giving the direction of pressure: Local Z direction = 0, GX direction = 1, GY direction = 2, GZ direction = 3.

��

Double variable providing the magnitude of the pressure over the element.

�0@�0@�1@�1

Double variable providing the top left coordinate and bottom right coordinate of concentrated load.

��

Adds pressure load to plate elements.


��

'Get the application object -- 'Add element pressure objOpenSTAAD.Load.AddElementPressure 2, 1, 2.0


436

Load.AddElementTrapPressure

��

!��1��=�0��,��,��#��

��!��,��!��0�,��

!��1��=�0��,��,��#��

��!��,��!��0�,��

��


��

��


��+


��,��

Integer variable giving the direction of pressure: Local X direction = 1, Local Y direction = 2.

��@%��

Double variable providing the pressure at start and end.

��

Adds trapezoidal pressure loading to plate elements.

��

'Get the application object -- 'Add element pressure objOpenSTAAD.Load.AddElementTrapPressure 2, 1, 2.0, 3.0


Load.AddTemperatureLoad

��

!��1��=��1��0��#��!��

�(��0��!�� 2��!��

!��1��=��1��0��#��!��

�(��0��!�� 2��!��

��


��

%��

Integer variable providing the member/element number.

%��+

Integer variable array providing the member/element numbers.

�!��%��

Double variable providing the temperature causing axial elongation.

��55��&��

Double variable providing the differential temperature between top and bottom surface.

��55��

Double variable providing the differential temperature from side to side.

��

Adds TEMPERATURE LOAD to beam or plate elements.


438 ��

'Get the application object -- 'Add temperature load objOpenSTAAD.Load.AddTemperatureLoad 2, 10.0, 20.0, 30.0


Load.AddStrainLoad

��

!��1��=��1��0��#��!��(��

!��1��=��1��0��#��!��

�(��

��


��

%��

Integer variable providing the member/element number.

%��+

Integer variable array providing the member/element numbers.

�!��

Double variable providing the strain value due to misfit.

��

Adds STRAIN LOAD to beam or plate elements.

��

'Get the application object -- 'Add strain load objOpenSTAAD.Load.AddStrainLoad 2, 0.01


440

Load.GetPrimaryLoadCaseCount

��

1��=$��,��1��

��

Gets total number of primary load case(s) present in the current structure.

��

Dim lGetPrimaryLoadCaseCount as Long 'Get the application object -- 'Get Primary Load Case Count lGetPrimaryLoadCaseCount = objOpenSTAAD.Load.GetPrimaryLoadCaseCount


Load.GetLoadCombinationCaseCount

��

1��=$��1��!��

��

Gets total number of combination load case(s) present in the current structure.

��

Dim lGetLoadCombinationCaseCount as Long 'Get the application object -- 'Get Combination Load Case Count lGetLoadCombinationCaseCount = objOpenSTAAD.Load.GetLoadCombinationCaseCount


442

Load.GetPrimaryLoadCaseNumbers

��

1��=$��,��1��#��!��

,��1��#��!��

��

��+'��+

A long array wich stores the load case numbers for all the primary load cases present in the current structure.

��

Gets all primary load case number(s).

��

Dim lGetPrimaryLoadCaseCount as Long Dim lPrimaryLoadCaseNumbersArray() as Long 'Get the application object -- 'Get Primary Load Case Numbers lGetPrimaryLoadCaseCount = objOpenSTAAD.Load.GetPrimaryLoadCaseCount for I = 0 to (lGetPrimaryLoadCaseCount-1) lPrimaryLoadCaseNumbersArray (I) = objOpenSTAAD.Load. GetPrimaryLoadCaseNumbers next I


Load.GetLoadCombinationCaseNumbers

��

1��=$��1��!��#��!��

��!��1��#��!��

��

��'��+

A long array wich stores the load case numbers for all the primary load cases present in the current structure.

��

Gets all primary load case number(s).

��

Dim lGetLoadCombinationCaseCount as Long Dim lLoadCombinationCaseNumbersArray() as Long 'Get the application object -- 'Get Combination Load Case Numbers lGetLoadCombinationCaseCount = objOpenSTAAD.Load.GetLoadCombinationCaseCount for I = 0 to (lGetLoadCombinationCaseCount-1) lLoadCombinationCaseNumbersArray (I) = objOpenSTAAD.Load.GetLoadCombinationCaseNumbers next I


444

Load.CreateNewLoadCombination

��

1��=��#�-1��!��1��!��

1��!#��

��

'��

A string variable, which defines tittle for new load combination.

'��

A long variable, which defines number for new load combination.

��

Creates new load combination with the number and title defined.

��

Dim strLoadCombTitle as String Dim lLoadCombNo as Long 'Get the application object -- 'Create New Load Combination objOpenSTAAD.Load.CreateNewLoadCombination strLoadCombTitle, lLoadCombNo


Load.AddLoadAndFactorToCombination

��

1��=�1��!��1��!#��

1��#�� 1��

��

'��

An integer variable holds the load combination number.

'��

A long variable holds the primary load case number.

'��,��

Multiplication factor for the specified primary load case.

��

Adds a primary load case with specified multiplication factor to an existing load combination.

��

'Get the application object -- Dim intLoadCombNo as Integer Dim lLoadNo as Long Dim fFactor as Float 'Add Load to Load Combination objOpenSTAAD.Load.AddLoadAndFactorToCombination intLoadCombNo, lLoadNo, fFactor


446

Load.GetBeamCountAtFloor

��

1��=$��2�� .��%�� .�(%�� .��&��

��.�(&�� .��'�� .�('��

��

$��@$�!�@$��@$�!�@$��@$�!�

Float variables indicate what the boundary of the floor pane.

��,��

Integer variable provide the direction.

1 = X-axis

2 = Y-axis

3 = Z-axis

��

Get total no of beams within the specified boundary.

��

Dim fMinX as Float Dim fMaxX as Float Dim fMinY as Float Dim fMaxY as Float Dim fMinZ as Float Dim fMaxZ as Float Dim intDirection as Integer 'Get the application object -- 'Get beam count at floor objOpenSTAAD.Load.GetBeamCountAtFloor fMinX, fMaxX, fMinY, fMaxY, fMinZ, fMaxZ, intDirection


Load.GetInfluenceArea

��

1��=$��/� �� .��%�� .�(%�� .��&��

.�(&�� .��'�� .�('��2��#��!��

��

$��@$�!�@$��@$�!�@$��@$�!�

Float variables indicate what the boundary of the floor pane.

��,��

Integer variable provide the direction.

1 = X-axis

2 = Y-axis

3 = Z-axis

&��+

Long array returns all the beam nos under consideration.

��+

Double array returns all the influence areas for the beams returned in the lastparameter.

��

Returns beam nos and corresponding influence areas within the specified boundary.

��

'Get the application object -- 'Get Influence Area objOpenSTAAD.Load.GetInfluenceArea (fMinX, fMaxX, fMinY, fMaxY, fMinZ, fMaxZ, iDirection, lBeamNosArray, dAreasArray)


448

Load.GetActiveLoad

��

1��=$��1��

��

Returns the current load case number.

��

Dim lActiveLoad as Long 'Get the application object -- 'Get active load lActiveLoad = objOpenSTAAD.GetActiveLoad


Load.GetNodalLoadCount

��

1��=$��#��1��#��#��

��

��

Long variable provides the node number.

��

Get number of nodal loads present for the specified node.

��

Dim iNodalLoadCount as Integer Dim lNodeNo as Long 'Get the application object -- 'Get Nodal Load Count iNodalLoadCount = objOpenSTAAD.Load.GetNodalLoadCount ( lNodeNo )


450

Load.GetNodalLoads

��

1��=$��#��1��#��#��!��%��!��

�&��!��'��!��.%��!��.&��!��.'��

��

��

Integer variable holds the node number for which nodal loads needs to be retrieved.

��+@��+@��+@$��+@$��+@$��+

Double variables return the load array for all the load cases and all directions.

��

Retruns the array of load values for the specified node. Array will be formed and dimensioned as per defined load counts.

��

'Get the application object -- 'Get Nodal Loads objOpenSTAAD.Load.GetNodalLoads (iNodeNo, dFXArray, dFYArray, dFZArray, dMXArray, dMYArray, dMZArray)


Load.GetUDLLoadCount

��

1��=$��4�11��2��#��

��

&��

Long variable provides the beam number.

��

Get number of uniformly distributed loads present for the specified beam.

��

'Get the application object -- 'Get UDL count objOpenSTAAD.Load.GetUDLLoadCount (lBeamNo)


452

Load.GetUDLLoads

��

1��=$��4�11��2��#��!��

��!��!��!��6��

��

&��

Long variable providing the member number.

��,��+@��,��+@�0��+@�1��+@�2��+

Returns the force value, direction alongwith d1, d2 & d3 parameter for beam UDL.

��

Returns the UDL with all the parameters for the specified member.

��

'Get the application object -- 'Get UDL value objOpenSTAAD.Load.GetUDLLoads (lBeamNo, lDirectionArray, dForceArray, dD1Array, dD2Array, dD3Array)


Load.GetUNIMomentCount

��

1��=$��4#/.��2��#��

��

&��


��

Gets the count of uniformly distributed moment for the specified member.

��

'Get the application object -- 'Get UMOM count objOpenSTAAD.Load.GetUNIMomentCount (lBeamNo)


454

Load.GetUNIMoments

��

1��=$��4#/.��2��#��!��

��!��!��!��6��

��

&��


��,��+@��,��+@�0��+@�1��+@�2��+

Returns the value, direction alongwith d1, d2 & d3 parameter for beam uniformly distributed moments.

��

Returns the uni moments with all the parameters for the specified member.

��

'Get the application object -- 'Get UMOM value objOpenSTAAD.Load.GetUNIMoments (lBeamNo, lDirectionArray, dForceArray, dD1Array, dD2Array, dD3Array)


Load.GetTrapLoadCount

��

1��=$��1��2��#��

��

&��


��

Get number of trapezoidal loads present for the specified beam.

��

'Get the application object -- 'Get Trapezoidal Load count objOpenSTAAD.Load.GetTrapLoadCount (lBeamNo)


456

Load.GetTrapLoads

��

1��=$��1��2��#��!��

3��!��3��!��!��

��

&��


��,��+@70��+@71��+@�0��+@�1��+

Returns the force value, direction alongwith w1, w2, d1 & d2 parameters for beam trapezoidal load(s).

��

Returns the trapezoidal load(s) with all the parameters for the specified member.

��

'Get the application object -- 'Get Trapezoidal Load values objOpenSTAAD.Load.GetTrapLoads (lBeamNo, lDirectionArray, dW1Array, dW2Array, dD1Array, dD2Array)


Load.GetConcForceCount

��

1��=$��2��#��

��

&��


��

Get number of concentrated loads present for the specified beam.

��

'Get the application object -- 'Get Concentrated Load count objOpenSTAAD.Load.GetConcForceCount (lBeamNo)


458

Load.GetConcForces

��

1��=$��2��#��!��

��!��!��

��

&��


��,��+@��,��+@�0��+@�1��+

Returns the force value, direction alongwith d1 & d2 parameters for beam trapezoidal load(s).

��

Returns the concentrated forces with all the parameters for the specified member.

��

'Get the application object -- 'Get Concentrated Load values objOpenSTAAD.Load.GetConcForces (lBeamNo, lDirectionArray, dForceArray, dD1Array, dD2Array)


Load.GetConcMomentCount

��

1��=$��.��2��#��

��

&��


��

Get number of concentrated moment present for the specified beam.

��

'Get the application object -- 'Get Conc Moment Count objOpenSTAAD.Load.GetConcMomentCount (lBeamNo)


460

Load.GetConcMoments

��

1��=$��.��2��#��!��

.��!��!��

��

&��


��,��+@$��+@�0��+@�1��+

Returns the moment value, direction alongwith d1 & d2 parameters for beam concentrated moment(s).

��

Returns the beam concentrated moment(s) with all the parameters for the specified member.

��

'Get the application object -- 'Get Conc Moment Value objOpenSTAAD.Load.GetConcMoments (lBeamNo, lDirectionArray, dMomentArray, dD1Array, dD2Array)


Supports Applications

Support.CreateSupportFixed

��

��=��(��

��

Long integer containing the reference number to the support created.

��

Creates FIXED support.

��

'Get the application object -- 'Create fixed support objOpenSTAAD.Support.CreateSupportFixed


462

Support.CreateSupportPinned

��

��=��,��

��


��

Creates PINNED support.

��

'Get the application object -- 'Create pinned support objOpenSTAAD.Support.CreateSupportPinned


Support.CreateSupportFixedBut

��

��=��(�2��!��

��!��

��


��

��+

Double array of 6 elements specifying releases in FX, FY, FZ, MX, MY, MZ directions. Each element should have a value equal to 0.0 (Fixed) or 1.0 (Released).

��+

Double array of 6 elements specifying spring constants in FX, FY, FZ, MX, MY, MZ directions.

Values should be in the current unit system.

��

Creates FIXED support with releases in specified directions or SPRING supports with spring constants in specified directions.

��

'Get the application object -- 'Create fixed support with release in Y direction release (0) = 0.0 'FX release (1) = 1.0 'FY release (2) = 0.0 'FZ release (3) = 0.0 'MX release (4) = 0.0 'MY release (5) = 0.0 'MZ suppno = staad.support.CreateSupportFixedBut release


464

Support.AssignSupportToNode

��

!��=��#��#��#��

��#��

!��=��#��#��#��

��#��

��

TRUE if successful, else FALSE..

��

��

Long variable providing the node number.

��+

Long variable array providing the node numbers.

��

Long variable providing the reference number of the support

��

Assigns the specified support to node or nodes.

��

'Get the application object -- 'assign support 2 to node 1 bResult = objOpenSTAAD.Support.AssignSupportToNode 1, 2


Support.GetSupportCount

��

��=$��

��

Returns total number of supported nodes exist in the current structure.

��

'Get the application object -- 'Get Support Count objOpenSTAAD.Support.GetSupportCount


466

Support.GetSupportNodes

��

��=$��#��#��

��

��+

A long Array stores the numbers of the nodes, which are supported in the current structure.

��

Returns all supported nodes in an array.

��

Dim Dim lSupportNodesArray() as Long Dim iSupportCount as Integer 'Get the application object -- iSupportCount = Support.GetSupportCount ReDim lSupportNodesArray(0 to (iSupportCount-1)) as Long 'Get Support Nodes objOpenSTAAD.Support.GetSupportNodes(lSupportNodesArray)


Support.GetSupportType

��

��=$��#��

��

��

Long variable providing the supported node number.

��

Returns back the support type for the specified node (1 = Pinned, 2 = Fixed, 3 = Fixed But).

��

'Get the application object -- 'Get Support Type objOpenSTAAD.Support.GetSupportType (lSupportNode)


468

Support.GetSupportInformation

��

��=$��/� ��#��#��

��!��

��

��

Long variable providing the node number.

��,��+

Integer array of dimension 6 retrives. (0 = Released, 1 = Not Released).

��,��+

Integer array of dimension 6 retrives for the spring stiffness of each dof.

��

Returns support information for the specified node.

��

'Get the application object -- 'Get Support Information objOpenSTAAD.Support. Support.GetSupportInformation (lNodeNo, iReleaseSpecArray, dSpringSpecArray)


Command Applications

Command.PerformAnalysis

��

��=,�� ,��*��

��

��"��

An integer variable, which specify the user’s choice of print command with Performa Analysis command. The values may vary as:

0 = No Print,

1 = Print Load Data

2 = Print Statics Check

3 = Print Statics Load

4 = Print Mode Shapes

5 = Print Both

6 = Print All

��

Perform first order elastic analysis of the current structure and produce output with specified print option.

��

Dim intPrintOption as Integer 'Get the application object -- 'Perform Analysis objOpenSTAAD.Command.PerformAnalysis intPrintOption


470

Command.PerformPDeltaAnalysisNoConverge

��

��=,�� ,��#��

#��!��* /��,��*��

��

��"56��

An integer variable, which specify the no of iteration to be performed.

��"��

An integer variable, which specify the user’s choice of print command with P-Delta analysis command. The values may vary as:

0 = No Print,

1 = Print Load Data




5 = Print Both

6 = Print All

��

Perform second order P-Delta analysis of the current structure and produce output with specified print option. Here the program will perform the specified number of iterations whether or not the solution converges.

��

Dim intNumberOfIteration as Integer Dim intPrintOption as Integer 'Get the application object --


'P-Delta Analysis no Converge objOpenSTAAD.Command.PerformPDeltaAnalysisNoConverge intNumberOfIteration, intPrintOption


472

Command.PerformPDeltaAnalysisConverge

��

��=,�� ,��

#��!��* /��,��*��

��

��"56��

An integer variable, which specify the no of iteration to be performed.

��"��

An integer variable, which specify the user’s choice of print command with P-Delta Analysis command. The values may vary as:

0 = No Print,

1 = Print Load Data




5 = Print Both

6 = Print All

��

Perform second order P-Delta analysis of the current structure and produce output with specified print option. Here the program checks whether the solution is converging as successive iterations are performed. If the successive iterations result in divergent values of displacements for a particular load case, then the iterations are discontinued for the specific load case.

��

Dim intNumberOfIteration as Integer


Dim intPrintOption as Integer 'Get the application object -- ' P-Delta Analysis with Converge objOpenSTAAD.Command.PerformPDeltaAnalysisNoConverge intNumberOfIteration, intPrintOption


474

Command.CreateSteelDesignCommand

��

��=��

��#��/��8�� 8��8��1��

��

Create steel design command.


Output Results Applications

Output.GetOutputUnitForDimension

��

*��=$��*��4��4��

��

=��

A string containing the output unit for dimension.

��

Returns output unit for dimension.

��

Dim strOutputUnitForDimension as String 'Get the application object -- 'Get Output Unit For Dimension strOutputUnitForDimension = objOpenSTAAD.Output.GetOutputUnitForDimension


476

Output.GetOutputUnitForSectDimension

��

*��=$��*��4��4��

��

=��

A string containing the output unit for sectional diemension(s).

��

Returns output unit for cross sectional diemension(s).

��

Dim strOutputUnitForSectDimension as String 'Get the application object -- 'Get Output Unit For Sectional Dimension strOutputUnitForSectDimension = objOpenSTAAD.Output.GetOutputUnitForSectDimension


Output.GetOutputUnitForSectArea

��

*��=$��*��4��4��

��

=��

A string containing the output unit for cross sectional area.

��

Returns output unit for cross sectional area.

��

Dim strOutputUnitForSectArea as String 'Get the application object -- 'Get Output Unit For Sectional Area strOutputUnitForSectArea = objOpenSTAAD.Output.GetOutputUnitForSectArea


478

Output.GetOutputUnitForSectInertia

��

*��=$��*��4��/��4��

��

=��

A string containing the output unit for sectional inertia.

��

Returns output unit for sectional intertia.

��

Dim strOutputUnitForSectInertia as String 'Get the application object -- 'Get Output Unit For Sectional Inertia strOutputUnitForSectInertia = objOpenSTAAD.Output.GetOutputUnitForSectInertia


Output.GetOutputUnitForSectModulus

��

*��=$��*��4��.��4��

��

=��

A string containing the output unit for sectional modulus.

��

Returns output unit for sectional modulus.

��

Dim strOutputUnitForSectModulus as String 'Get the application object -- 'Get Output Unit For Sectional Modulus strOutputUnitForSectModulus = objOpenSTAAD.Output.GetOutputUnitForSectModulus


480

Output.GetOutputUnitForDensity

��

*��=$��*��4��4��

��

=��

A string containing the output unit for material density.

��

Returns output unit for material density.

��

Dim strOutputUnitForDensity as String 'Get the application object -- 'Get Output Unit For Material Density strOutputUnitForDensity = objOpenSTAAD.Output.GetOutputUnitForDensity


Output.GetOutputUnitForDisplacement

��

*��=$��*��4��4��

��

=��

A string containing the output unit for translational displacements.

��

Returns output unit for translational displacements..

��

Dim strOutputUnitForDisplacement as String 'Get the application object -- 'Get Output Unit For Displacement strOutputUnitForDisplacement = objOpenSTAAD.Output.GetOutputUnitForDisplacement


482

Output.GetOutputUnitForRotation

��

*��=$��*��4�� 4��

��

=��

A string containing the output unit for rotational displacement.

��

Returns output unit for rotational displacement.

��

Dim strOutputUnitForRotation as String 'Get the application object -- 'Get Output Unit For Rotation strOutputUnitForRotation = objOpenSTAAD.Output.GetOutputUnitForRotation


Output.GetOutputUnitForForce

��

*��=$��*��4��4��

��

=��

A string containing the output unit for forces (FX, FY, FZ).

��

Returns output unit for forces (FX, FY, FZ).

��

Dim strOutputUnitForForce as String 'Get the application object -- 'Get Output Unit For Force strOutputUnitForForce = objOpenSTAAD.Output.GetOutputUnitForForce


484

Output.GetOutputUnitForMoment

��

*��=$��*��4��.��4��

��

=��

A string containing the output unit for moments (MX, MY, FZ).

��

Returns output unit for moments (MX, MY, MZ).

��

Dim strOutputUnitForMoment as String 'Get the application object -- 'Get Output Unit For Moment strOutputUnitForMoment = objOpenSTAAD.Output.GetOutputUnitForMoment


Output.GetOutputUnitForDistForce

��

*��=$��*��4��4��

��

=��

A string containing the output unit for distributed forces.

��

Returns output unit for distributed forces.

��

Dim strOutputUnitForDistForce as String 'Get the application object -- 'Get Output Unit For Distributed Force strOutputUnitForDistForce = objOpenSTAAD.Output.GetOutputUnitForDistForce


486

Output.GetOutputUnitForDistMoment

��

*��=$��*��4��.��4��

��

=��

A string containing the output unit for distributed moments.

��

Returns output unit for distributed moments.

��

Dim strOutputUnitForDistMoment as String 'Get the application object -- 'Get Output Unit For Distributed Moment strOutputUnitForDistMoment = objOpenSTAAD.Output.GetOutputUnitForDistMoment


Output.GetOutputUnitForStress

��

*��=$��*��4��4��

��

=��

A string containing the output unit for stress.

��

Returns output unit for stress.

��

Dim strOutputUnitForStress as String 'Get the application object -- 'Get Output Unit For Stress strOutputUnitForStress = objOpenSTAAD.Output.GetOutputUnitForStress


488

Output.GetNodeDisplacements

��

*��=$��#��#��#��1��

��

��

��

Long variable contains the node number.

'��

Long variable contains the load case number.

��,��+

A long array of dimension 6, which returns nodal displacements.

��

Returns nodal displacements for the node number and load case specified.

��

'Get the application object -- 'Get Nodal Displacement objOpenSTAAD.Output.GetNodeDisplacements (lNodeNo, lLoadCase, lDisplacementArray)


Output.GetSupportReactions

��

*��=$�� #��#��1��

��

��

��

Long variable contains the node number, which is supported.

'��


��,��+

A long array of dimension 6, which returns support reactions.

��

Returns support reactions for the node number and load case specified.

��

'Get the application object -- 'Get Support Reaction objOpenSTAAD.Output.GetSupportReactions (lNodeNo, lLoadCase, lReactionArray)


490

Output.GetMemberEndDisplacements

��

*��=$��.��!��0��.��!��#��0��

��1��

��

$��

Long variable contains the member number.

%��

Long variable contains member end.

0 = Start

1 = End

'��


��,��+

A long array of dimension 6, which returns member end displacements.

��

Returns member end displacements for specified member number, member end and load case.

��

'Get the application object -- 'Get Member End Displacements objOpenSTAAD.Output.GetMemberEndDisplacements (lMemberNo, lEnd, lLoadCase, lDisplacementArray)


Output.GetIntermediateMemberTransDisplacements

��

*��=$��/��.��!��

.��!��#��!��1��

��

$��


��,�

Double variable contains distance from starting end in terms of member length.

'��


��,��+

A long array of dimension 6, which returns member sectional displacements.

��

Returns sectional displacements for specified member number, distance and load case.

��

'Get the application object -- 'Get Member Intermediate Displacements objOpenSTAAD.Output.GetIntermediateMemberTransDisplacements (lMemberNo, dDistance, lLoadCase, lDisplacementArray)


492

Output.GetMemberEndForces

��

*��=$��.��!��0��.��!��#��0��

1��

��

$��


%��

Long variable contains member end.

0 = Start

1 = End

'��


��,��+

A long array of dimension 6, which returns member end forces.

��

Returns member end forces for specified member number, member end and load case.

��

'Get the application object -- 'Get Member End Forces objOpenSTAAD.Output.GetMemberEndForces (lMemberNo, lEnd, lLoadCase, lForceArray)


Output.GetAllPlateCenterStressesAndMoments

��

*��=$��,��.��,��#��

1��

��

��

A long variable contains plate element no.

'��

A long variable contains load case no.

��+

A long array of dimension 8, which returns plate center stresses and moments.

��

Returns plate center stresses and moments for the specified plate for specified load case.

��

'Get the application object -- 'Get All Plate Center Stresses And Moments objOpenSTAAD.Output.GetAllPlateCenterStressesAndMoments (lPlateNo, lLoadCase, lCenterStressesArray)


494

Output.GetPlateCenterNormalPrincipalStresses

��

*��=$��,��#��,��,��#��

1��!��.�%��!��./#��!��.�%2��!��./#2��

��

��


'��


�$��@�$6��@�$��&��@�$6�&��

Double variables, which return the corresponding values for the center of the specified plate.

��

Returns Smax and Smin for Top and Bottom of the specified plate.

��

'Get the application object -- 'Get Plate Center Normal Principal Stresses objOpenSTAAD.Output.GetPlateCenterNormalPrincipalStresses (lPlateNo, lLoadCase, dSMAXTop, dSMINTop, dSMAXBottom, dSMINBottom)


Output.GetAllPlateCenterForces

��

*��=$��,��,��#��1��

��

��

��


'��


��,��+

A long array of dimension 5, which returns plate center forces.

��

Returns plate center forces for the specified plate and load case.

��

'Get the application object -- 'Get Plate Center Forces objOpenSTAAD.Output.GetAllPlateCenterForces (lPlateNo, lLoadCase, lCenterForcesArray)


496

Output.GetAllPlateCenterMoments

��

*��=$��,��.��,��#��1��

��.��

��

��


'��


��$��+

A long array of dimension 3, which returns plate center moments.

��

Returns plate center moments for the specified plate and load case.

��

'Get the application object -- 'Get Plate Center Moments objOpenSTAAD.Output.GetAllPlateCenterMoments (lPlateNo, lLoadCase, lCenterMomentsArray)


Output.GetAllPlateCenterPrincipalStressesAndAngles

��

*��=$��,��,��,��#��

��1��

��

��


'��


��+

A long array of dimension 8, which returns plate center stresses and angles.

��

Returns plate center stresses and angles for the specified plate and load case.

��

'Get the application object -- 'Get Plate Center Principal Stresses and Angles objOpenSTAAD.Output.GetAllPlateCenterPrincipalStressesAndAngles (lPlateNo, lLoadCase, lStressesAndAnglesArray)


498

Output.GetPlateCenterVonMisesStresses

��

*��=$��,��8��.��,��#��

1��!��8*#��!��8*#2��

��

��


'��


9"��@9"�&

Double variables return the value of Von-Mises Top and Bottom for the specified plate center point.

��

Returns plate center Von-Mises Top and Bottom for the specified plate and load case.

��

'Get the application object -- 'Get Plate Center Center Von-Mises Stresses objOpenSTAAD.Output.GetPlateCenterVonMisesStresses (lPlateNo, lLoadCase, dVONT, dVONB)


Output.GetAllSolidNormalStresses

��

*��=$��#��#��

1��

��

��

A long variable contains solid element no.

��

A long variable specifies the corner of that solid element.

'��


��+

A long array of dimension 3, which returns solid corner stresses.

��

Returns normal stresses for the specified solid element at the specified corner.

��

'Get the application object -- 'Get Solid Corner Normal Stresses objOpenSTAAD.Output.GetAllSolidNormalStresses (lSolidNo, lCorner, lLoadCase, lStressesArray)


500

Output.GetAllSolidShearStresses

��

*��=$��+��#��

1��+��

��

��


��

A long variable specifies the corner of that solid element. (-1 = Center, 1 to 8 all corner nodes).

'��


�(��+

A long array of dimension 3, which returns solid corner shear stresses.

��

Returns shear stresses for the specified solid element at the specified corner.

��

'Get the application object -- 'Get Solid Corner Shear Stresses objOpenSTAAD.Output.GetAllSolidShearStresses (lSolidNo, lCorner, lLoadCase, lShearStressesArray)


Output.GetAllSolidPrincipalStresses

��

*��=$��,��#��

��1��,��

��

��


��


'��


��,��+

A long array of dimension 3, which returns solid corner principal stresses.

��

Returns principal stresses for the specified solid element at the specified corner.

��

'Get the application object -- 'Get Solid Corner Principal Stresses objOpenSTAAD.Output.GetAllSolidPrincipalStresses (lSolidNo, lCorner, lLoadCase, lPrincipalStressesArray)


502

Output.GetAllSolidVonMisesStresses

��

*��=$��8��.��#��

��1��8��.��

��

��


��


'��


9��$��+

A long array of dimension 3, which returns solid corner Von mises stresses.

��

Returns normal stresses for the specified solid element at the specified corner.

��

'Get the application object -- 'Get Solid Corner Von Stresses objOpenSTAAD.Output.GetAllSolidVonMisesStresses (lSolidNo, lCorner, lLoadCase, lVonMisesStressesArray)


Results Tables Applications

Table.CreateReport

��

��!��=�� " ��

��

A reference number for the report created to be used to access the report.

��

��

A null terminated string containing the title of the report.

��

Creates a report with the specified title.

��

'Get the application object -- 'Create report ReportNo = objOpenSTAAD.Table.CreateReport "My Report"


504

Table.SaveReport

��

��!��=�� #��

��

��

A long variable providing the report number identifying the STAAD report which is to be saved.

��

Saves the specified report along with all its tables.

��

'Get the application object -- 'Save report objOpenSTAAD.Table.SaveReport ReportNo


Table.SaveReportAll

��

��!��=��

��

Saves all the reports created.

��

'Get the application object -- 'Save all reports objOpenSTAAD.Table.SaveReportAll


506

Table.GetReportCount

��

��!��=$��

��

Number of reports created.

��

Returns the number of reports created.

��

'Get the application object -- 'get number of reports ReportNos = objOpenSTAAD.Table.GetReportCount


Table.AddTable

��

��!��=��!�� #��"��!��#��

#�� -��#��

��

A reference number for the table created to be used to access the table.

��

��

Long variable containing the report number to which this table will be added.

��

A null terminated string containing the name of the table.

��#�@��

Long variables providing the number of rows and columns of the table.

��

Adds a table to the specified ReportNo.

��

'Get the application object -- 'Add table to report no 1 with 10 rows and 5 columns NumRows = 10 NumCols = 5 TableNo = objOpenSTAAD.Table.AddTable 1, "My Table", NumRows, NumCols


508

Table.RenameTable

��

��!��= ��!�� #��!��#��

�"#�-��!��#��

��

��

Long variable containing the report number whose table will be renamed.

��

Long variable containing the table number to be renamed.

��#��

A null terminated string containing the new name for the table.

��

Renames a table in a report specified by TableNo.

��

'Get the application object -- 'Rename Table objOpenSTAAD.Table.RenameTable ReportNo, TableNo, "My New Table"


Table.DeleteTable

��

��!��=��!�� #��!��#��

��

��

Long variable containing the report number from which a table is to be deleted.

��

Long variable containing the table number to be deleted.

��

Deletes a table specified by TableNo in a report specified by ReportNo.

��

'Get the application object -- 'Delete Table objOpenSTAAD.Table.DeleteTable ReportNo, TableNo


510

Table.ResizeTable

��

��!��= ��"��!�� #��!��#��#�� -��

��#��

��

��

Long variable containing the report number whose table will be resized.

��

Long variable containing the table number to be resized.

��#�@��

Long variables providing the new number of rows and columns of the table.

��

Resizes a table specified by TableNo in a report specified by ReportNo.

��

'Get the application object -- 'Resize Table NumRows = 10 NumCols = 5 objOpenSTAAD.Table.ResizeTable ReportNo, TableNo, NumRows, NumCols


Table.SaveTable

��

��!��=��!�� #��!��#��

��

��

Long variable containing the report number whose table will be saved.

��

Long variable containing the table number to be saved.

��

Saves a table in a report specified by TableNo.

��

'Get the application object -- 'Save Table objOpenSTAAD.Table.SaveTable ReportNo, TableNo


512

Table.GetTableCount

��

��!��=$��!�� #��

��

Number of tables in the report.

��

��

Long variable containing the report number.

��

Returns the number of tables created.

��

'Get the application object -- 'get number of reports TableNos = objOpenSTAAD.Table.GetTableCount ReportNo


Table.SetCellValue

��

��!��=��8�� #��!��#�� -#��

��#��?��8��

��

��


��

Long variable containing the table number.

��#��@��

Long variables containing the row and column number of the cell.

9��

A variable of Data_Type (Integer, Long, Double, String) containing the value to be inserted in the cell.

��

Puts a value into the cell of table at the specified row and column in a report.

��

'Get the application object -- 'Set value to cell RowNo = 2 ColNo = 5 Value = 5.25 'declared as Double objOpenSTAAD.Table.SetCellValue ReportNo, TableNo, Rowno, ColNo, Value


514

Table.GetCellValue

��

��!��=$��8�� #��!��#�� -#��

��#��"8��

��

Copies the data in the specified cell into the string provided.

��

��


��


��#��@��

Long variables containing the row and column number of the cell.

��9��

String variable in which the value in the cell will be copied .

��

Gets a value in the cell of table at the specified row and column in a report.

��

Dim szValue As String 'Get the application object -- 'Set value to cell RowNo = 2 ColNo = 5 objOpenSTAAD.Table.GetCellValue ReportNo, TableNo, Rowno, ColNo, szValue


Table.SetColumnHeader

��

��!��=��)�� #��!��#��#��

��")��

��

��


��


��

Long variable containing the column number.

��*��

String variable providing the column header.

��

Sets the heading of a column.

��

'Get the application object -- 'Set header for the column Header = "Column 5" ColNo = 5 objOpenSTAAD.Table.SetColumnHeader ReportNo, TableNo, ColNo, szHeader


516

Table.SetColumnUnitString

��

��!��=��4�� #��!��#��

��#��"4��

��

��


��


��


��=��

String variable providing the column unit string.

��

Sets the unit string of a column.

��

'Get the application object -- 'Set unit for the column szUnit = "kN/m^2" ColNo = 5 objOpenSTAAD.Table.SetColumnUnitString ReportNo, TableNo, ColNo, szUnit


Table.SetRowHeader

��

��!��=�� -)�� #��!��#�� -#��

��")��

��

��


��


��#��

Long variable containing the row number.

��*��

String variable providing the row header.

��

Sets the heading of a row.

��

'Get the application object -- 'Set header for the row Header = "Row 5" RowNo = 5 objOpenSTAAD.Table.SetRowHeader ReportNo, TableNo, RowNo, szHeader


518

Table.SetCellTextColor

��

��!��=��(�� #��!��#�� -#��

��#�� 8��$��8��2��8��

��

��


��


��#��


��


��9��@)��9��@&��9��

An integer between 0 and 255 that represents the intensity of red, green or blue in the color for the text. A value of 0 for a particualr color indicates that no shade of that color will be mixed into the final color. To have the text written in yellow, the values would be RedVal = 255, GreenVal = 255 and BlueVal = 0.

��

Sets the color of the text to be displayed in a particular cell. By default, the color is always set to black.

��

'Get the application object -- Dim RedVal As Integer Dim GreenVal As Integer Dim BlueVal As Integer ‘Set the text to yellow


RedVal = 255 GreenVal = 255 BlueVal = 0 objOpenSTAAD.Table.SetCellTextColor ReportNo, TableNo, RowNo, ColNo, RedVal, GreenVal, BlueVal


520

Table.SetCellTextBold

��

��!��=��(�2�� #��!��#�� -#��

��#��

��

��


��


��#��


��


��

Sets the text in a given row and column to bold.

��

'Get the application object -- ‘Set the text in row 9 and column 4 to bold objOpenSTAAD.Table.SetCellTextBold ReportNo, TableNo, 9, 4


Table.SetCellTextItalic

��

��!��=��(�/�� #��!��#�� -#��

��#��

��

��


��


��#��


��


��

Italicizes the text in a given row and column.

��

'Get the application object -- ‘Italicize the text in row 9 and column 4 objOpenSTAAD.Table.SetCellTextItalic ReportNo, TableNo, 9, 4


522

Table.SetCellTextUnderline

��

��!��=��(�4�� #��!��#��

�-#��#��

��

��


��


��#��


��


��

Underlines the text in a given row and column.

��

'Get the application object -- ‘Underline the text in row 9 and column 4 objOpenSTAAD.Table.SetCellTextUnderline ReportNo, TableNo, 9, 4


Table.SetCellTextSize

��

��!��=��(��"�� #��!��#�� -#��

��#��!��"��

��

��


��


��#��


��


��

Double variable containing the size of the font to set the text to.

��

Sets the text in a particular row and column to a certain font size. The font sizes are equivalent to the ones used in Microsoft Word.

��

'Get the application object -- ‘Set the font size for the text in row 10 and column 6 to 18 pt objOpenSTAAD.Table.SetCellTextSize ReportNo, TableNo, 10, 6, 16.0


524

Table.SetCellTextSizeAll

��

��!��=��(��"�� #��!��#��!��

��"��

��

��


��


��

Double variable containing the size of the font to set the entire table to.

��

Sets the text in the entire table to FontSize. The font sizes are equivalent to the ones used in Microsoft Word.

��

'Get the application object -- ‘Set the font size for the text in the table to 16 pt objOpenSTAAD.Table.SetCellTextSizeAll ReportNo, TableNo, 16.0


Table.SetCellTextHorzAlignment

��

��!��=��(�)��"�� #��!��#��

�� -#��#��

��

��


��


��#��


��


��

An integer variable containing the type of horizontal alignment to apply. The possible values are:

0 = left

1 = center

2 = right

��

Sets the text in a particular row and column to a specified horizontal alignment. By default, all the text is right justified.


526 ��

'Get the application object -- ‘Set the horizontal alignment for the text in row 10 and column 6 to center- ‘ justified. objOpenSTAAD.Table.SetCellTextHorzAlignment ReportNo, TableNo, 10, 6, 1


Table.SetCellTextVertAlignment

��

��!��=��(�8�� #��!��#��

�� -#��#��

��

��


��


��#��


��


��

An integer variable containing the type of vertical alignment to apply. The possible values are:

0 = top

4 = center

8 = bottom

��

Sets the text in a particular row and column to a specified vertical alignment. By default, all the text is top justified.


528 ��

'Get the application object -- ‘Set the horizontal alignment for the text in row 10 and column 6 to center- ‘ justified.


OpenSTAAD Functions – Troubleshooting

Errors and Error Messages

Error message: “Method ‘OpenSTAADFunctionName’ of object IOutput failed.”, where OpenSTAADFunctionName is the name of an OpenSTAAD function, e.g., “Method ‘GetMemberBetaAngle’ of object IOutput failed.”

Check to be sure that you are passing all parameters required by the function. If a parameter is missing, or if the parameter being passed is not valid, the ‘Method …of object IOutput failed’ message may appear. For example, the message may appear if a member number is passed to the function, but that member number does not exist in the currently open STAAD file.

You may also receive similar messages if your version of STAAD.Pro is not compatible with OpenSTAAD. OpenSTAAD is compatible with STAAD.Pro 2001 Build 1006.US.REL and higher. You will need to reanalyze your model in that build. This is because we switched the way the data is recorded in Build 1006 to save more space. Build 1006 US.REL was released in November 2001.

UK Builds prior to STAAD.Pro 2002 are not compatible with OpenSTAAD.

Function is not retrieving correct values.

Check to be sure that you have saved the STAAD file after making changes to the input before you run any OpenSTAAD functions that retrieve input information. If you are running STAAD functions that retrieve analysis results, check to be sure that you have saved the STAAD file and re-run the analysis after making any changes to the input.

Error message: “Type mismatch”

Section 4


530 Check to make sure that you have declared all variables using the DIM statement at the beginning of your program or macro, e.g.:

Dim pnIsReleased As Integer

Dim pdSpringStiffnesses(0 To 5) As Double

Dim pdPartialMomRelFactors(0 To 2) As Double

Confirm that when you pass array variables to the function, you have specified the starting position in the array for the function to use in filling up the array, e.g.:

objOpenSTAAD.GetFullMemberReleaseInfoAtStar 3, pnIsReleased, _ pdSpringStiffnesses(0), pdPartialMomRelFactors(0)

Error message: “Object doesn’t support this property or method”

Check to make sure you have typed the function name correctly.

Error message: "ActiveX component can't create object" when attempting to run an OpenSTAAD macro in Microsoft Excel.

1. Make sure that you have a directory called "OpenSTAAD" inside of your Spro2004 folder (i.e. C:\Spro2004\ OpenSTAAD).

2. In that folder, make sure you have the files openstaad.dll, staadread.tbl, staadread.dll and steeltable.dll. If not, please go to http://www.reiworld.com/Product/Pro/OpenSTAAD.asp and click on the "OpenSTAAD Setup Program" link near the bottom of the page. This will reinstall the OpenSTAAD component.

3. When you open the Excel file, is it asking you to Enable Macros? If so, make sure you press Yes. If not, you need to change the security settings in Excel. Go to Tools->Macro->Security... from the Excel menu. Make sure the Security Level is set to Medium. Close Excel down (completely, not just the file) and reopen the file again. This time it should ask you if you want your Macros enabled or disabled. Choose Enabled.

4. When you run your macro, if it still gives you the error ("ActiveX component can't create object"), it might be because the OpenSTAAD library was not registered properly when the program was installed. To register the


OpenSTAAD dll, close down Excel, go to your Windows Start menu and select the Run command. Type in:

regsvr32 c:\spro2004\openstaad\openstaad.dll

and click the OK button. (Please note that the path to the openstaad.dll file may be different on your computer if you did not use the default installation path provided by the STAAD.Pro Setup program when you installed your software – if so, you should modify the above command to correspond to the actual location on your computer.) A dialog box should display the message, “DllRegisterServer in c:\spro2004\openstaad\openstaad.dll succeeded.” If the registration did not succeed, please contact our technical support staff for further instructions.

5. Try opening and running the Excel beam example file provided with your STAAD.Pro software (C:\Spro2004\OpenSTAAD\Rectangle-beam .xls).

Error message: "User Defined type not defined"

This message "User Defined type not defined" may appear on the line which declares the OpenSTAAD object variable if the variable is declared “As Output”, e.g. “Dim objOpenSTAAD As Output”. The message may be appearing because the OpenSTAAD library references have not been included. The VBA compiler therefore does not know which functions are associated with the OpenSTAAD object.

There are two ways to eliminate this error message:

1. Declare the OpenSTAAD object As Object, instead of As Output, e.g.

Dim objOpenSTAAD As Object

2. Include the OpenSTAAD library reference in your VBA editor. This second option has the added benefit that once you do it, the compiler will now recognize the OpenSTAAD object and will pop up a list of functions whenever you refer to the object in your VBA editor.

To include the OpenSTAAD library reference, pull down the Tools menu in your VBA editor and select the References command. A dialog box with title “References – Normal” will open. You will see a scroll box inside the dialog box labeled “Available References.” Scroll down through the list of references until you


532 find one called “OpenSTAAD 1.0 Type Library”. Toggle on the corresponding check box, then click the OK button.

Now re-run your macro to see if the problem with the “User Defined type not defined” error message has been solved.

Error message: "One or more results files are not compatible with the current model and cannot be loaded..."

You need to have a successful analysis before you can run any OpenSTAAD macro, including such simple macros as one that only asks for the number of nodes in the model. The program is not smart enough to know which commands will work and which will not when no results are present. It first checks to see if valid results are available. If they are not, it displays the error message and terminates.

You can use the OpenSTAAD command AreResultsAvailable in your macro to check to see if results are available. In some cases, this function also will result in the error message "One or more results files are not compatible with the current model and cannot be loaded...". That means that even though the STAAD results file with an ANL extension has been created, the file contains only error messages and no meaningful results.

You can also try inserting a FINISH command in your input file preceding the location in the input that is causing the analysis errors. Depending on whether the errors take place before any analysis is performed, you might get rid of the original error message, but in its place you may see the message, "No Results Available." However, the best way to eliminate this problem is to modify your input file so that you obtain a successful analyis before you try to run your OpenSTAAD macro.

Under certain conditions, you might get this “…results files are not compatible…” error message, even though the analysis runs successfully. OpenSTAAD currently will not work with the Moving Load Generator. The reason is that the results from the Moving Load Generator are not kept in the same database as the other STAAD results. Therefore, when OpenSTAAD tries to read the Output File, it is not able to find those missing load results, so it displays an error message and stops processing the macro. This same situation is in effect for any other loads that you are unable to see until you perform the analysis, like UBC loads, for example. If the loads are defined in the input file, OpenSTAAD will work fine, but not with loads that are only generated when the analysis is run, because these results are not kept in a location where OpenSTAAD can find them.


If you remove your moving load generation command from your input file, and run the analysis, you should then be able to run your OpenSTAAD macro.

The capability to handle projects with program-generated loads such as Moving Loads and UBC Loads will be added to a future release of OpenSTAAD.


534

List of Acronyms

API Application Program Interface

ATL Active Template Library

COM Component Object Model

FTP File Transfer Protocol

GUI Graphical User Interface

HTTP Hypertext Transfer Protocol

IDE Integrated Development Environment

I/O Input/Output

URL Uniform Resource Locator

VB Visual Basic

VBA Visual Basic for Applications


Index of Functions Analyze....................................................................................................226 AnalyzeStructure .......................................................................................14 AreResultsAvailable ..................................................................................12 CloseSTAADFile...............................................................................11, 213 Command.CreateSteelDesignCommand .................................................478 Command.PerformAnalysis.....................................................................472 Command.PerformPDeltaAnalysisConverge ..........................................476 Command.PerformPDeltaAnalysisNoConverge .....................................474 CreateNamedView...................................................................................229 DoesMemberHaveReleases .......................................................................76 DoesNodeHaveSupport .............................................................................25 Geometry.AddBeam................................................................................242 Geometry.AddMultipleBeams.................................................................262 Geometry.AddMultipleNodes .................................................................261 Geometry.AddMultiplePlates ..................................................................263 Geometry.AddMultipleSolids..................................................................264 Geometry.AddNode.................................................................................238 Geometry.AddPlate .................................................................................252 Geometry.AddSolid .................................................................................256 Geometry.CreateBeam ............................................................................243 Geometry.CreateGroup............................................................................293 Geometry.CreateNode .............................................................................239 Geometry.CreatePlate..............................................................................253 Geometry.CreateSolid .............................................................................257 Geometry.DeleteBeam ............................................................................266 Geometry.DeleteNode .............................................................................265 Geometry.DeletePlate..............................................................................267 Geometry.DeleteSolid .............................................................................268 Geometry.GetBeamLength......................................................................246 Geometry.GetBeamList ...........................................................................241 Geometry.GetLastBeamNo .....................................................................278 Geometry.GetLastNodeNo ......................................................................277 Geometry.GetLastPlateNo.......................................................................279 Geometry.GetLastSolidNo ......................................................................280 Geometry.GetMemberCount ...................................................................240 Geometry.GetMemberIncidence .............................................................290 Geometry.GetNodeCoordinates...............................................................247 Geometry.GetNodeCount ........................................................................236 Geometry.GetNodeDistance....................................................................249 Geometry.GetNodeIncidence ..................................................................289 Geometry.GetNodeList............................................................................237 Geometry.GetNodeNumber.....................................................................248


536 Geometry.GetNoOfSelectedBeams .........................................................271 Geometry.GetNoOfSelectedNodes..........................................................269 Geometry.GetNoOfSelectedPlates ..........................................................273 Geometry.GetNoOfSelectedSolids ..........................................................275 Geometry.GetPlateCount.........................................................................250 Geometry.GetPlateIncidence ...................................................................291 Geometry.GetPlateList ............................................................................251 Geometry.GetSelectedBeams ..................................................................272 Geometry.GetSelectedNodes...................................................................270 Geometry.GetSelectedPlates ...................................................................274 Geometry.GetSelectedSolids ...................................................................276 Geometry.GetSolidCount ........................................................................254 Geometry.GetSolidIncidence...................................................................292 Geometry.GetSolidList............................................................................255 Geometry.GetSurfaceCount.....................................................................259 Geometry.GetSurfaceList ........................................................................260 Geometry.SelectBeam .............................................................................282 Geometry.SelectMultipleBeams ..............................................................286 Geometry.SelectMultipleNodes...............................................................285 Geometry.SelectMultiplePlates ...............................................................287 Geometry.SelectMultipleSolids...............................................................288 Geometry.SelectNode..............................................................................281 Geometry.SelectPlate ..............................................................................283 Geometry.SelectSolid ..............................................................................284 Geometry.SplitBeam ...............................................................................244 Geometry.SplitBeamInEqlParts...............................................................245 GetAllEntitiesInGROUP ...........................................................................67 GetAllMembersIncidences ........................................................................35 GetAllNodesCoordinates...........................................................................19 GetAllNodesThatAreSupported ................................................................28 GetAllPlateCenterForces .........................................................................190 GetAllPlateCenterMoments.....................................................................188 GetAllPlateCenterPrincipalStressesAndAngles ......................................186 GetAllPlateCenterStressesAndMoments .................................................194 GetAllPlatesIncidences..............................................................................46 GetAllSolidNormalStresses.....................................................................198 GetAllSolidPrincipalStresses...................................................................196 GetAllSolidShearStresses ........................................................................200 GetAllSolidsIncidences .............................................................................54 GetAllSolidVonMisesStresses.................................................................202 GetAreaOfPlate .......................................................................................142 GetBaseUnit ............................................................................................233 GetCompositeSectionParameters ............................................................138 GetDOFReleasedAtEndOfMember ...........................................................84


GetDOFReleasedAtStartOfMember..........................................................82 GetFinalMemberPropertyName ..............................................................136 GetFirstLoadCase ....................................................................................150 GetFullMemberReleaseInfoAtEnd ..........................................................102 GetFullMemberReleaseInfoAtStart .........................................................100 GetGROUPNamesForType .......................................................................63 GetInputUnitForForce .............................................................................217 GetInputUnitForLength ...........................................................................216 GetIntermediateMemberForcesAtDistance .............................................174 GetIntermediateMemberTransDisplacements .........................................178 GetLoadCombinationCaseCount .............................................................147 GetMainWindowHandle..........................................................................224 GetMaxBendingMoment .........................................................................166 GetMaxShearForce..................................................................................170 GetMemberBetaAngle.............................................................................104 GetMemberDesignProperties ..................................................................126 GetMemberEndDisplacements ................................................................176 GetMemberEndForces.............................................................................172 GetMemberIncidences...............................................................................32 GetMemberLength...................................................................................116 GetMemberMaterialConstants.................................................................140 GetMemberOffsets ....................................................................................73 GetMemberProperties..............................................................................120 GetMemberPropertyShape ......................................................................134 GetMemberPropsForPrismatic ................................................................123 GetMembersCount.....................................................................................34 GetMemberSteelDesignRatio ..................................................................106 GetMemberWidthAndDepth ...................................................................118 GetMinBendingMoment..........................................................................164 GetMinShearForce...................................................................................168 GetModeShapeDataAtNode ....................................................................159 GetNextLoadCase....................................................................................152 GetNextMember ........................................................................................38 GetNextNodeCoordinate ...........................................................................22 GetNodeCoordinates .................................................................................16 GetNodeDisplacements ...........................................................................154 GetNodesCount .........................................................................................18 GetNumberOfEntitiesInGROUP ...............................................................65 GetNumberOfGROUPS ............................................................................59 GetNumberOfGROUPTypes.....................................................................61 GetNumberOfModes ...............................................................................162 GetNumberOfSupportedNodes..................................................................27 GetPlateCenterNormalPrincipalStresses .................................................192 GetPlateCenterVonMisesStresses............................................................184


538 GetPlateEdgeDistances..............................................................................49 GetPlateIncidences ....................................................................................43 GetPlatesCount ..........................................................................................45 GetPlateThicknesses ................................................................................144 GetPrimaryLoadCaseCount.....................................................................149 GetProcessHandle....................................................................................222 GetProcessId............................................................................................223 GetShortJobInfo ......................................................................................227 GetSolidIncidences....................................................................................51 GetSolidsCount..........................................................................................53 GetSpringReleaseStiffnessesAtEndOfMember .........................................96 GetSpringReleaseStiffnessesAtStartOfMember ........................................94 GetSTAADFile........................................................................................211 GetSTAADFileFolder .............................................................................214 GetSteelDesignResults ............................................................................180 GetSteelTableProperties ..........................................................................129 GetSupportCondition.................................................................................70 GetSupportReactions ...............................................................................157 GetSupportStiffnesses ...............................................................................98 IsEndEndReleased .....................................................................................80 IsMemberACableMember .......................................................................108 IsMemberACompressionMember ...........................................................110 IsMemberATensionMember....................................................................112 IsMemberATrussMember........................................................................114 IsPartiallyReleasedAtEndOfMember ........................................................88 IsPartiallyReleasedAtStartOfMember .......................................................86 IsSpringReleaseAtEndOfMember .............................................................92 IsSpringReleaseAtStartOfMember ............................................................90 IsStartEndReleased....................................................................................78 Load.AddElementPressure ......................................................................437 Load.AddElementTrapPressure...............................................................439 Load.AddLoadAndFactorToCombination...............................................448 Load.AddMemberAreaLoad....................................................................434 Load.AddMemberConcForce ..................................................................426 Load.AddMemberConcMoment..............................................................428 Load.AddMemberFixedEnd ....................................................................436 Load.AddMemberFloorLoad...................................................................435 Load.AddMemberLinearVari ..................................................................430 Load.AddMemberTrapezoidal.................................................................432 Load.AddMemberUniformForce.............................................................422 Load.AddMemberUniformMoment ........................................................424 Load.AddNodalLoad ...............................................................................420 Load.AddSelfWeightInXYZ ...................................................................419 Load.AddStrainLoad ...............................................................................442


Load.AddSupportDisplacement...............................................................421 Load.AddTemperatureLoad.....................................................................440 Load.CreateNewLoadCombination .........................................................447 Load.CreateNewPrimaryLoad .................................................................417 Load.GetActiveLoad ...............................................................................451 Load.GetBeamCountAtFloor...................................................................449 Load.GetConcForceCount .......................................................................460 Load.GetConcForces ...............................................................................461 Load.GetConcMomentCount...................................................................462 Load.GetConcMoments...........................................................................463 Load.GetInfluenceArea ...........................................................................450 Load.GetLoadCombinationCaseCount....................................................444 Load.GetLoadCombinationCaseNumbers ...............................................446 Load.GetNodalLoadCount.......................................................................452 Load.GetNodalLoads...............................................................................453 Load.GetPrimaryLoadCaseCount............................................................443 Load.GetPrimaryLoadCaseNumbers.......................................................445 Load.GetTrapLoadCount.........................................................................458 Load.GetTrapLoads.................................................................................459 Load.GetUDLLoadCount ........................................................................454 Load.GetUDLLoads ................................................................................455 Load.GetUNIMomentCount ....................................................................456 Load.GetUNIMoments ............................................................................457 Load.SetLoadActive ................................................................................418 ModifyNamedView.................................................................................231 NewSTAADFile ......................................................................................225 OpenSTAADFile .....................................................................................212 Output.GetAllPlateCenterForces .............................................................499 Output.GetAllPlateCenterMoments.........................................................500 Output.GetAllPlateCenterPrincipalStressesAndAngles ..........................501 Output.GetAllPlateCenterStressesAndMoments .....................................497 Output.GetAllSolidNormalStresses.........................................................503 Output.GetAllSolidPrincipalStresses.......................................................505 Output.GetAllSolidShearStresses ............................................................504 Output.GetAllSolidVonMisesStresses.....................................................506 Output.GetIntermediateMemberTransDisplacements .............................495 Output.GetMemberEndDisplacements ....................................................494 Output.GetMemberEndForces.................................................................496 Output.GetNodeDisplacements ...............................................................492 Output.GetOutputUnitForDensity ...........................................................484 Output.GetOutputUnitForDimension ......................................................479 Output.GetOutputUnitForDisplacement..................................................485 Output.GetOutputUnitForDistForce ........................................................489 Output.GetOutputUnitForDistMoment....................................................490


540 Output.GetOutputUnitForForce...............................................................487 Output.GetOutputUnitForMoment ..........................................................488 Output.GetOutputUnitForRotation..........................................................486 Output.GetOutputUnitForSectArea .........................................................481 Output.GetOutputUnitForSectDimension ...............................................480 Output.GetOutputUnitForSectInertia ......................................................482 Output.GetOutputUnitForSectModulus...................................................483 Output.GetOutputUnitForStress ..............................................................491 Output.GetPlateCenterNormalPrincipalStresses .....................................498 Output.GetPlateCenterVonMisesStresses................................................502 Output.GetSupportReactions ...................................................................493 Property.AssignBeamProperty ................................................................376 Property.AssignBetaAngle ......................................................................378 Property.AssignElementSpecToPlate ......................................................389 Property.AssignMemberSpecToBeam ....................................................386 Property.AssignPlateThickness ...............................................................377 Property.CreateAnglePropertyFromTable...............................................358 Property.CreateAssignProfileProperty ....................................................374 Property.CreateBeamPropertyFromTable ...............................................354 Property.CreateChannelPropertyFromTable ...........................................356 Property.CreateElementIgnoreInplaneRotnSpec .....................................388 Property.CreateElementNodeReleaseSpec ..............................................393 Property.CreateElementPlaneStressSpec.................................................387 Property.CreateMemberCableSpec..........................................................384 Property.CreateMemberCompressionSpec..............................................382 Property.CreateMemberIgnoreStiffSpec .................................................383 Property.CreateMemberInactiveSpec ......................................................380 Property.CreateMemberOffsetSpec.........................................................385 Property.CreateMemberPartialReleaseSpec ............................................391 Property.CreateMemberReleaseSpec ......................................................390 Property.CreateMemberTensionSpec ......................................................381 Property.CreateMemberTrussSpec ..........................................................379 Property.CreatePipePropertyFromTable..................................................362 Property.CreatePlateThicknessProperty ..................................................375 Property.CreatePrismaticCircleProperty..................................................365 Property.CreatePrismaticGeneralProperty...............................................368 Property.CreatePrismaticRectangleProperty ...........................................364 Property.CreatePrismaticTeeProperty .....................................................366 Property.CreatePrismaticTrapezoidalProperty ........................................367 Property.CreateTaperedIProperty ............................................................370 Property.CreateTaperedTubeProperty .....................................................372 Property.CreateTubePropertyFromTable ................................................360 Property.GetBeamConstants....................................................................400 Property.GetBeamMaterialName ............................................................398


Property.GetBeamProperty......................................................................402 Property.GetBeamPropertyAll.................................................................401 Property.GetBeamSectionName..............................................................396 Property.GetBeamSectionPropertyTypeNo.............................................397 Property.GetBetaAngle............................................................................403 Property.GetCountryTableNo..................................................................394 Property.GetIsotropicMaterialCount .......................................................408 Property.GetIsotropicMaterialProperties.................................................409 Property.GetMaterialProperty .................................................................399 Property.GetMemberGlobalOffSet..........................................................414 Property.GetMemberLocalOffSet............................................................415 Property.GetMemberReleaseSpec ...........................................................416 Property.GetOrthotropic2DMaterialCount ..............................................410 Property.GetOrthotropic2DMaterialProperties........................................411 Property.GetOrthotropic3DMaterialCount ..............................................412 Property.GetOrthotropic3DMaterialProperties........................................413 Property.GetSectionPropertyCount .........................................................404 Property.GetSectionPropertyCountry ......................................................407 Property.GetSectionPropertyName..........................................................405 Property.GetSectionPropertyType...........................................................406 Property.GetSectionTableNo...................................................................395 Property.SetMaterialID............................................................................353 Quit ..........................................................................................................235 RemoveNamedView................................................................................234 RenumberMembers ...................................................................................41 RenumberNodes ........................................................................................30 SaveNamedView .....................................................................................230 SelectSTAADFile ........................................................................................9 SetInputUnitForForce..............................................................................219 SetInputUnitForLength............................................................................218 SetInputUnits ...........................................................................................220 SetShortJobInfo .......................................................................................228 ShowApplication .....................................................................................221 Support.AssignSupportToNode...............................................................467 Support.CreateSupportFixed ...................................................................464 Support.CreateSupportFixedBut..............................................................466 Support.CreateSupportPinned .................................................................465 Support.GetSupportCount .......................................................................468 Support.GetSupportInformation ..............................................................471 Support.GetSupportNodes .......................................................................469 Support.GetSupportType .........................................................................470 Table.AddTable .......................................................................................511 Table.CreateReport..................................................................................507 Table.DeleteTable....................................................................................513


542 Table.GetCellValue .................................................................................518 Table.GetReportCount.............................................................................510 Table.GetTableCount ..............................................................................516 Table.RenameTable.................................................................................512 Table.ResizeTable ...................................................................................514 Table.SaveReport ....................................................................................508 Table.SaveReportAll ...............................................................................509 Table.SaveTable ......................................................................................515 Table.SetCellTextBold ............................................................................524 Table.SetCellTextColor ...........................................................................522 Table.SetCellTextHorzAlignment ...........................................................529 Table.SetCellTextItalic............................................................................525 Table.SetCellTextSize .............................................................................527 Table.SetCellTextSizeAll ........................................................................528 Table.SetCellTextUnderline ....................................................................526 Table.SetCellTextVertAlignment ............................................................531 Table.SetCellValue..................................................................................517 Table.SetColumnHeader..........................................................................519 Table.SetColumnUnitString ....................................................................520 Table.SetRowHeader ...............................................................................521 UpdateStructure .......................................................................................215 View.CreateNewViewForSelections .......................................................308 View.GetInterfaceMode ..........................................................................320 View.HideAllMembers............................................................................333 View.HideEntity ......................................................................................340 View.HideMember ..................................................................................332 View.HideMembers.................................................................................330 View.HidePlate........................................................................................337 View.HideSolid .......................................................................................338 View.HideSurface....................................................................................339 View.RefreshView ..................................................................................315 View.RotateDown ...................................................................................302 View.RotateLeft ......................................................................................303 View.RotateRight ....................................................................................304 View.RotateUp ........................................................................................301 View.SelectByItemList............................................................................344 View.SelectByMissingAttribute ..............................................................346 View.SelectEntitiesConnectedToMember...............................................348 View.SelectEntitiesConnectedToNode....................................................347 View.SelectEntitiesConnectedToPlate ....................................................349 View.SelectEntitiesConnectedToSolid....................................................350 View.SelectGroup....................................................................................342 View.SelectInverse ..................................................................................343 View.SelectMembersParallelTo ..............................................................341


View.SetBeamAnnotationMode..............................................................326 View.SetDiagramMode ...........................................................................312 View.SetInterfaceMode...........................................................................321 View.SetLabel .........................................................................................309 View.SetModeSectionPage .....................................................................323 View.SetNodeAnnotationMode...............................................................316 View.SetReactionAnnotationMode .........................................................318 View.SetSectionView..............................................................................311 View.SetUnits..........................................................................................335 View.ShowAllMembers ..........................................................................328 View.ShowBack ......................................................................................295 View.ShowBottom ..................................................................................299 View.ShowFront......................................................................................294 View.ShowIsometric ...............................................................................300 View.ShowLeft........................................................................................297 View.ShowMember .................................................................................331 View.ShowMembers ...............................................................................329 View.ShowPlan .......................................................................................298 View.ShowRight......................................................................................296 View.SpinLeft .........................................................................................305 View.SpinRight .......................................................................................306 View.ZoomAll.........................................................................................307 View.ZoomExtentsMainView.................................................................334 WriteGeometry ..........................................................................................57

manual de programación staad pro 2004

Documents

openstaad compatibility

openstaad manual organization

openstaad user forum

staad file io functions

staad nomenclature

structure geometry functions

function list organization

function return value