User Tools

Site Tools


getting_started

This is an old revision of the document!


Getting Started

This topic is a quick outline of how the user can create model or import a model in Submodeler. The topic will also tell the user the capabilities of the user interface tools that he/she will be using during the model input into Submodeler.

Creating a Model From Scratch

  1. Define the nodes for the structure, starting from the bottom. See the N command.
  2. Set the boundary conditions using the D command
  3. Define the groups and elements using the GROUP and E commands
  4. Check the elements by opening a Model Plot window by using the Plot > Model > Element menu or the Model
  5. Define the materials, soil layers, and beam properties using the M, L, and R command
  6. Assign materials and properties to the elements using the MSET and RSET command
  7. Check the assigned materials and properties in the Model Plot window by showing the elements in their material / property color and comparing their color with the material / property color shown when selecting the Options > Colors menu or the Color Command.
  8. Set the element integration order for SOLID elements using the EINT command.
  9. Define the nodal masses (MT and MR Commands) and set the mass units option (MUNITS Command)
  10. Check the masses by displaying them in the Plot>Model>Nodes which opens the node plot window
  11. Set the model options by selecting the Options > Model Menu
  12. Define the analysis frequency set (FREQ Command)
  13. Define the analysis options by selecting the Options / Analysis menu command
  14. Run the AFWRITE command to write the analysis files for the selected modules
  15. Run the desired modules for the simulation

Loading and Saving Models

The way models are loaded and save has changed in Submodeler. In earlier versions ACS-SASSI the user must create a database in Main then create a new empty model in Prep and and add it to the existing database before any work on a model can begin. The Submodeler allows the user to work on a model without require the user to specify a place to save a model until a later time. The Submodeler has a database that will be described later; unfortunately this database and model data is not compatible with the database in Main/Prep

Using the Database

The Submodeler has a single two level database structure for the users computer. The single database replaces the multiple user-defined databases in the Main Prep work-flow. The single database is in a location cached by the system so the user will never have to search the directory structure to find old databases that have not been used in some time. The 2 level structure will allow the user to organize all of the models on a computer account by project much similar to how the multiple database model in the Main/Prep work-flow was intended. Finally, the database is now considered to be a convenience feature and is no longer required to use any functionality in the Submodeler.

Database Window

When the user attempts to open a model for the first time in the Submodeler the Load Model Window tree structure will be empty. At this time the user must add a group. All models must reside within a group. If the user attempts to define a model without a group the model will not be saved in the database structure. After the user defines a group the user must select the group he/she wants to add the model to in the tree window. One the group is selected the user can press the add model button and provide the model information as they would in Prep. Once the user clicks OK the Tree will update with the added model. Then the user can select the model and open it if desired. If the user has a model selected and attempts to add a new model that model will be added to the group in which the selected model resides.

When the user opens the model there may be errors about files not existing, this is to be expected when creating a new model. The Database expects the model to exist and attempt to load the model when the open button is pressed. The database is setup to allow user to reorganize the models on there system and to add models to the database that have been created without the database in previous Submodeler execution. For this reason, the database no longer creates the files that the model loading code is trying to load before the loading sequence which causes the error messages.

Without the Database

As stated earlier, the database is no longer required in the use of the Submodeler. If the user is only going to use a model for a single analysis the database will only add additional steps to the process. For that reason the user can directly use the prep file Input (INP command or the File>Input menu) or one of the converters to load a model into the Submodeler. If the user uses this method to input the SAVE, RESUME & AFWRITE commands will not work because the Input file does not specify the model name and model path. (These command may actually run but there is no way to tell where the models will be written) If the user wishes to use any of this functionality There is a new command MDL which specifies the model name and path. Once the MDL command is used on a model the Save, Resume and Afwrite commands will work properly. The MDL command can be issued before or after the model input without problems.

The Input in Prep Echos all of the commands entered to the screen. This take a large amount of time and for any useful model that is not for validation the output overwhelms screen and will eliminate any chance of the user finding an error in the .pre file. Due to this fact is was decided that only comments, warning, error and the model information text will be echoed to the screen. This change in sped input of a .Pre file from 25-30 minutes using Prep to under 1 minute for the submodeler on the same computer.

If the user has create and saved the model in a previous Submodeler run the user use the MDL to specify the model and then use the resume command to load the model. The internal storage format that the save and resume commands use is not compatible with ACS-SASS Prep the user cannot specify the location of a model save using Prep and load it using resume in the Submodeler

The save and resume and Afwrite commands work in the same way as they work in ACS-SASSI Prep. These command do not update the database. If the user wants to add a saved model to the database the user can use the Model Open popup window to modify the database and add the loacation of the saved model.

Transferring Files between Prep and Submodeler

The *.Pre file is a command batch in both ACS-SASSI Prep and the Submodeler. The use of the WRITE and input commands is the recommended way of transferring file between Prep and the Submodeler.

The Write command in both programs should produce the same data with the only difference being the header comments at the top of the file specifying which program produced the file. All of the commands that the system creates when using Write are equivalent between both systems. However, since the *.Pre file is a command batch it is expected that the user will create and use additional *.Pre to modify or add to a model outside of the Write command. These user created *.Pre file are not guaranteed to be transferable between the two interfaces.

The Prep and the Submodeler command structures are not the same. There have been many new commands in the Submodeler that are not recognized by Prep and will give the user and error if prep attempts to execute them. Also, the Submodeler supports most of the Prep command, but the Submodeler is not fully backward compatible with Prep. A command not recognized error will be posted to the screen for the commands that are not backward compatible; this should not effect the execution of other commands in the file. It is suggested that the user review the chart of Prep command supported by the Submodeler before writing a .pre file that is intended for use in both programs.

File Window, Command Entry and Command History

The original Prep had a window to open ASCII formatted files for view. This functionality was limited because a user could not edit a file that was being viewed inside of this window or copy this file with a different name or to a different location. This window has been replaced in Submodeler with a text editor window that allow the user to view, edit and save files inside of the Submodeler. This window behaves much like a simple text editor application but a user can connect the window to the command entry box Using the Input > Connect to Command Entry menu option. When the user selects this option all commands that do not cause an entry error will be recorded to this window as long as the text window remains open and no other windows are connected to the Command Entry.

File Window

The Command entry bar is similar to the original Prep instruction line however not the user can select previously entered commands by pressing the up and down arrows while the text cursor is blinking in the Command Entry bar

A user can now copy data from the Command History window and paste that data into another location. Information and waring text types have been added to the Output each one of these type has its own distinct user selectable color. Finally users can filter the output of the Command history if they desire by using the options in the View Menu.

getting_started.1371826969.txt.gz · Last modified: 2013/06/21 11:02 by phil