SAPRunner for SAP2000 is a tool specifically developed to run SAP2000 analyses in batch. It can also extract the force-displacement responses from all links in a non-linear static or dinamic analysis.
To run a SAP2000 analysis from command line use:
sapRunner.exe “full-path-to-SAP2000file” [-l ThCaseName [-r]] [-m modalCaseName]
Eg.: sapRunner.exe “C:\test.sdb”
The program accepts as input also S2K files; in this case the analysis will be performed automatically after import. In the case of SDB file, the program checks if the analysis has been already performed and it will be performed only if the results are unvailable.
IMPORTANT: Please remember to include ” in the path to the sdb of s2k file.
Extracting force-displacement response in NL-Links
SAPRunner can also extract the force-displacement response from each NL-Link in the model. The output is given in CSV format. SAPRunner includes also a viewer to analyse each Link response.
The command:
sapRunner.exe “C:\test.sdb” -l thCase
estracts all the Link responses in the file C:\test.sdb-LINKS.csv. thCase is the name of time-history analysis to extract the results from. Each series is named with the following convention: XX-LinkLabel, in which XX is:
F1 for 1st local axis
F2 for 2nd local axis
F3 for 3rd local axis
M1 for rotation around the 1st local axis
M2 for rotation around the 2nd local axis
M3 for rotation around the 3rd local axis
Finally, the flag -r removes from output all the force-displacement series in which the force is always zero (free DoFs or zero forces/moments):
sapRunner.exe “C:\test.sdb” -l thCase -r
Extracting periods
The flag -m extracts all the modal periods calculated during a modal analysis:
sapRunner.exe “C:\test.sdb” -m ModalCase
All the periods will be saved in the file C:\test.sdb-PERIODS.csv.
Compatibility
The program has been designed for SAP2000 v15 and v16 (up to version 1.3), for v18 and v19 (version 1.4) and for v20 (version 1.5). Any other release of SAP2000 is temporarly unsupported; a request can be submitted to giovanni@rinaldin.org.
IMPORTANT: if you get the error “Cannot find SAP2000 installation” or you’re continuosly prompted to enter the SAP2000 path, create a file named “sapPath.dat” in the SAPRunner folder, containing a single line with the path of SAP2000.exe, e.g. “C:\Program Files\Computers and Structures\SAP2000 18\”.
If you get other types of errors, please run “RegisterSAP2000.exe” in the SAP2000 installation folder and try again.
License & support
The usage of this program is permitted ONLY if the author of this sotware is properly cited.
The author has no responsibility for inappropriate usage and gives no warranty on the results obtained.
The trademark SAP2000 is owned by CSi (Computers and Structures, Inc.)
Please report any bug or suggestion to giovanni@rinaldin.org.
If you like this program and it is useful for you, consider donating.
Download
The program can be downloaded from the following links:
Version 1.5: for SAP2000 v20 – UPDATED 2019 05 11
Version 1.4: for SAP2000 v18 and v19 – UPDATED 2017 06 06
Version 1.3:
IMPORTANT: If the program does not work, it may depend on the fact that SAP2000 APIs are version-specific, also for minor versions (i.e. the version of this program for SAP2000 v15 has been tested with 15.2.1. If you’re using another v15 subversion, please keep reading). Then, to make your copy of SAPRunner working, you MUST copy the following files from the SAP2000 installation directory (e.g. C:\Program Files (x86)\Computers and Structures\SAP2000 15\) in the SAPRunner folder, overwriting the existing ones:
AxInterop.MSFlexGridLib.dll
CSIForm.dll
CsiGoCallbackLib.dll
CSIRibbon.dll
Interop.MSFlexGridLib.dll
Microsoft.InteropFormTools.dll
SAP2000v15.dll (or SAP2000v16.dll, for the v16 version)
Version 1.2:
Version 1.1:
Bug on closing corrected. New commands for modal periods extraction. Launch the program saprunner.exe without arguments to see help.
Version 1.0:
To run a SAP2000 analysis from command line use:
sapRunner.exe “full-path-to-SAP2000file”
The command: sapRunner.exe “C:\test.sdb” thCase
estracts all the Link responses in the file C:\test-LINKS.csv.
Finally, the flag -r removes from output all the force-displacement series in which the force is always zero (free DoFs or zero forces/moments):
sapRunner.exe “C:\test.sdb” thCase -r