You are on page 1of 82

Executive

RELEASE 5
USERS MANUAL

ENGINEERING DYNAMICS, INC.


2113 38TH STREET
KENNER, LOUISIANA 70065
U.S.A.

No part of this document may be


reproduced in any form, in an
electronic retrieval system or
otherwise, without the prior
written permission of the publisher.

Copyright

2001 by

ENGINEERING DYNAMICS, INC.


Printed in U.S.A.

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive

1.0 INTRODUCTION .......................................................................................................................


1.1 GENERAL INFORMATION ...............................................................................................
1.2 PROGRAM OVERVIEW ....................................................................................................
1.2.1 Program Features .........................................................................................................
1.2.2 Program Requirements ................................................................................................
1.2.3 Security Key ................................................................................................................

1-1
1-1
1-1
1-1
1-1
1-1

2.0 GETTING STARTED .................................................................................................................


2.1 MAIN SCREEN....................................................................................................................
2.1.1 Menu Bar .....................................................................................................................
2.1.2 Tool Bar .......................................................................................................................
2.1.3 Status Bar ....................................................................................................................
2.1.4 Icon Bar .......................................................................................................................
2.1.5 File Explorer ................................................................................................................
2.1.6 Runfile Wizard ............................................................................................................
2.1.6.1 Analysis Tabs .....................................................................................................
2.1.6.1.1 Static Tab ..................................................................................................
2.1.6.1.2 Dynamic Tab ............................................................................................
2.1.6.1.3 Post Processing Tab ..................................................................................
2.1.6.1.4 Load Tab ...................................................................................................
2.1.6.1.5 Miscellaneous Tab ....................................................................................
2.1.6.1.6 Utilities Tab ..............................................................................................
2.1.6.2 Run file Wizard Tree .........................................................................................
2.1.7 Worksheet ....................................................................................................................
2.1.8 Command Interpreter ..................................................................................................
2.1.9 Error Log .....................................................................................................................
2.2 CONFIGURING THE SACS EXECUTIVE ........................................................................
2.2.1 Editor ...........................................................................................................................
2.2.2 HTML File Browser ....................................................................................................
2.2.3 Hard code SACS System path in runfile .....................................................................
2.2.4 Load Worksheet File at Startup ...................................................................................
2.2.5 Use Sound....................................................................................................................
2.2.6 Concatenate Output Files ............................................................................................
2.2.7 Load Worksheet file at start-up ...................................................................................
2.2.8 Show file names on worksheet ....................................................................................
2.2.9 Execution Option .........................................................................................................
2.3 CONFIGURING THE SACS SYSTEM ..............................................................................
2.3.1 Key Server ...................................................................................................................
2.3.2 Default Section Library ...............................................................................................
2.3.3 Units ............................................................................................................................
2.3.4 Sort Model Data ..........................................................................................................
2.3.5 Joint Coordinates .........................................................................................................
2.3.6 Create Backup Model ..................................................................................................
2.3.7 Zoom Factor ................................................................................................................
2.3.8 Colors ..........................................................................................................................
2.3.9 Plot Configuration Setup .............................................................................................

2-1
2-1
2-1
2-1
2-2
2-2
2-2
2-3
2-3
2-4
2-4
2-4
2-5
2-5
2-5
2-5
2-7
2-7
2-7
2-8
2-8
2-8
2-9
2-9
2-9
2-9
2-9
2-9
2-9
2-10
2-10
2-10
2-10
2-10
2-10
2-11
2-11
2-11
2-11

Release 5: Revision 4

Executive

2.4 USING PROJECTS ..............................................................................................................


2.4.1 Project Details .............................................................................................................
2.4.1.1 Creating a New Project ......................................................................................
2.4.1.2 Selecting an Existing Project .............................................................................
2.4.2 Project Analysis Tasks ................................................................................................
2.4.2.1 Creating a New Analysis Task ...........................................................................
2.4.2.2 Selecting an Existing Analysis Task ..................................................................
2.4.3 File Naming .................................................................................................................
2.5 FILE NAME CONVENTION OPTIONS ............................................................................
2.5.1 Overview .....................................................................................................................
2.5.2 Selecting File Name Convention .................................................................................
2.5.3 Selecting File Identifier ...............................................................................................
2.5.4 Program and File Type Labels ....................................................................................
2.6 LAUNCHING INTERACTIVE PROGRAMS ....................................................................
2.7 CREATING A RUN (EXECUTION) FILE .........................................................................
2.8 EXECUTING AN ANALYSIS ............................................................................................

2-12
2-14
2-14
2-14
2-15
2-15
2-15
2-15
2-15
2-15
2-16
2-16
2-16
2-16
2-17
2-17

3.0 FILE FEATURES .......................................................................................................................


3.1 NEW .....................................................................................................................................
3.1.1 Text File ......................................................................................................................
3.1.2 Worksheet ....................................................................................................................
3.1.3 Project ..........................................................................................................................
3.1.4 Directory ......................................................................................................................
3.2 OPEN ....................................................................................................................................
3.2.1 Text File ......................................................................................................................
3.2.2 Worksheet ....................................................................................................................
3.3 BROWSE ..............................................................................................................................
3.4 COPY ....................................................................................................................................
3.5 CONVERT ............................................................................................................................
3.6 DELETE ...............................................................................................................................
3.7 RUN ......................................................................................................................................
3.8 RUN MULTIPLE .................................................................................................................
3.9 RUN SACS DEMO ..............................................................................................................
3.10 MAKE DIRECTORY .........................................................................................................
3.11 PRINT .................................................................................................................................
3.11.1 Text File ....................................................................................................................
3.11.2 Worksheet ..................................................................................................................
3.12 PRINTER SETUP ...............................................................................................................
3.13 PRINTER FONT ................................................................................................................
3.14 EXIT ...................................................................................................................................

3-1
3-1
3-1
3-1
3-1
3-1
3-1
3-1
3-1
3-1
3-1
3-1
3-2
3-2
3-2
3-3
3-3
3-4
3-4
3-4
3-4
3-4
3-5

4.0 PROJECT/TASK FEATURES ...................................................................................................


4.1 SET CURRENT PROJECT/TASK ......................................................................................
4.2 PROJECT PROPERTIES .....................................................................................................
4.3 ADD PROJECT ....................................................................................................................
4.4 DELETE PROJECT ..............................................................................................................
4.5 TASK PROPERTIES ............................................................................................................

4-1
4-1
4-1
4-1
4-1
4-1

ii

Release 5: Revision 4

Executive

4.6 ADD TASK ..........................................................................................................................


4.7 DELETE TASK ....................................................................................................................
4.8 SUB-TASK PROPERTIES ..................................................................................................
4.9 ADD SUB-TASK .................................................................................................................
4.10 DELETE SUB-TASK .........................................................................................................
4.11 IMPORT SAMPLE PROBLEM PROJECT .......................................................................

4-2
4-2
4-2
4-2
4-2
4-2

5.0 SETTINGS FEATURES .............................................................................................................


5.1 EXECUTIVE SETTINGS ....................................................................................................
5.2 FILE NAMING .....................................................................................................................
5.3 SACS SYSTEM CONFIGURATION ..................................................................................
5.4 SHOW CUE CARDS ...........................................................................................................
5.5 SHOW RELEASE 4 INTERFACE ......................................................................................
5.6 SAVE SETTINGS ON EXIT ...............................................................................................

5-1
5-1
5-1
5-1
5-1
5-2
5-3

6.0 MODELING FEATURES ...........................................................................................................


6.1 PRECEDE .............................................................................................................................
6.2 DATAGEN ...........................................................................................................................
6.3 FEMGV .................................................................................................................................

6-1
6-1
6-1
6-1

7.0 CHECK/REDESIGN FEATURES .............................................................................................


7.1 POSTVUE .............................................................................................................................
7.2 COLLAPSE VIEW ...............................................................................................................
7.3 INTERACTIVE FATIGUE ..................................................................................................

7-1
7-1
7-1
7-1

8.0 UTILITIES FEATURES .............................................................................................................


8.1 PREVUE ...............................................................................................................................
8.2 DISPLAY KEY ....................................................................................................................
8.3 EDIT KEY ............................................................................................................................

8-1
8-1
8-1
8-2

9.0 HISTORY FEATURES ...............................................................................................................

9-1

10.0 HELP FEATURES ....................................................................................................................


10.1 SACS PROGRAM MANUAL ...........................................................................................
10.2 EDI WEB PAGE .................................................................................................................
10.3 SEND MAIL TO EDI .........................................................................................................
10.4 ABOUT ...............................................................................................................................

10-1
10-1
10-1
10-1
10-2

A.0 USING PROJECTS ....................................................................................................................


A.1 OVERVIEW ........................................................................................................................
A.1.1 Project Layout ............................................................................................................
A.1.2 Project Data Files .......................................................................................................
A.2 CREATING A NEW PROJECT ..........................................................................................
A.2.1 Creating a Project Task ..............................................................................................
A.3 PROJECT FILE REGISTRY ...............................................................................................
A.3.1 Adding a File to the Project Registry .........................................................................
A.3.2 Modifying Properties of a File ...................................................................................
A.3.3 Removing a File from the Project Registry ................................................................

A-1
A-1
A-1
A-1
A-3
A-3
A-3
A-3
A-4
A-4

iii

Release 5: Revision 4

Executive

A.4 ACTIVATING A PROJECT ...............................................................................................


A.4.1 Selecting the Current Task .........................................................................................
A.5 DELETING A PROJECT, TASK OR SUB-TASK .............................................................
A.6 COPYING A PROJECT ......................................................................................................
A.7 SAMPLE PROJECT ............................................................................................................
A.7.1 Importing the Sample Project Manually .....................................................................
A.7.2 Using the Sample Project ...........................................................................................

A-4
A-4
A-5
A-5
A-5
A-5
A-6

B.0 INDEX ........................................................................................................................................

B-1

iv

Release 5: Revision 4

Executive

SECTION 1

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive

The SACS Executive program has been designed to provide the user with an easy to use
and efficient front end utility for the SACS system. It controls and connects all elements
of the SACS system by providing access to all SACS interactive programs, utilities and
system settings. The Executive also provides access to run file program module execution
in addition to user defined program utilities.

The SACS Executive program may be used to control the entire SACS system. The user
may execute any SACS program or utility in addition to system utilities directly from the
SACS Executive.
The following are some of the features available in the SACS Executive program:
1. Ability to launch any SACS interactive graphics program.
2. Create run or execution file for SACS run file program modules.
3. Determines input files required for analysis execution and prompts for each input
file or can determine required file automatically.
4. Ability to determine SACS output options automatically for run file executions.
5. Includes extended power buttons for the most common tasks on the main screen.
6. Provides command line help when the mouse passes over any power button.
7. Allows access to all SACS system and Executive settings.
8. Allows user specification of file editor and browser to be used by the Executive.
9. Ability to execute any run file or executable file with out leaving the Executive.
10. Complete on-line help facility.

The Executive requires a SACS configuration file (normally named configg.sac)


defined by the environment variable SACGCFG. If a configuration file is not found or
if the file does not exist, the program will exit with a configuration file not found error
message.

The Executive requires a SACS 5 hardware security key supplied by Engineering


Dynamics, Inc. to run. The key must be attached either to the local machine or to a
network server of which the machine is a client. If the Executive does not find the
security key, a key error will be reported.

1-1

Release 5: Revision 4

Executive

If the key is attached to a network server, the

1-2

name must be entered.

Release 5: Revision 4

Executive

SECTION 2

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive
The SACS Executive is launched by selecting the SACS Executive icon from the
menu in Windows .

After launching the Executive, the SACS Executive main screen is displayed.

The SACS Executive main screen consists of a Menu Bar, Tool Bar, Desktop Area, Run
File Wizard, File Explorer, Worksheet and the Status Bar.

The menu bar at the top of the screen allows selection of menu items. Each of the Menu
Bar features is described in detail in Sections 3 thru 8 that follow.

The toolbar contain icons representing shortcuts to menu items. Brief description of each
icon, tool-tips, are displayed by positioning the mouse pointer on the tool bar icon.

2-1

Release 5: Revision 4

Executive
The status bar at the bottom of the screen shows the project, task, file naming convention,
file identifier, and default data file directory of the data files. Any of these items may be
changed by clicking directly on these areas on the status bar.

The Icon Bar contains icons for the SACS interactive programs and other commonly used
features of the SACS system. It is divided into separate tabs containing icons relating to
certain topics. The Interactive bar contains all interactive programs, the Analysis bar
contains icons pertaining to running an analysis, and the Key Utilities bar contains all key
related icons.

The icons in the Desktop Area correspond to menu items as follows:

Model

Modeling/Precede

Data File

Modeling/Datagen

View Results

Check-Redesign/Postvue

View Plot

Utilities/Prevue

View Collapse

Check-Redesign/Collapse View

View Fatigue

Check-Redesign/Interactive Fatigue

Edit File

File/Open/Text File

FE Model

Modeling/FemGV

This area lists the files registered to the current project. If no project is active, all files in
gives file management capabilities
the current directory are shown. The
including, directory navigation, ability to drag and drop files, rename, delete or open
files. These features are available by right selecting the file or directory with the mouse.

2-2

Release 5: Revision 4

Executive

This area contains the tabs corresponding to each analysis group and the
.

Select the desired tab then select the desired analysis type from the drop down list box.

Analysis options may be selected in the


dialogue box. Analysis options
that are part of the OPTIONS and LDOPT input lines may be overridden. These override
features facilitate rerunning of a single analysis type with different analysis options
without requiring the user to edit the model files to change options. The available
,
and
override features for the OPTIONS input line are selected on the
tabs.

The available overrides for the LDOPT input line are selected on the

2-3

tab.

Release 5: Revision 4

Executive

The
button located at the top of the
will reset all analysis options
tree. The
button will launch and save the
as well as the entire
currently defined analysis(run file). The
button will save the currently defined run
file for later execution. To execute a previously saved run file(s), see Section 3.7(3.8).
2.1.6.1.1 Static Tab
This tab contains all static analysis features including:
-Linear Static Analysis
-Gap Element
-Large Deflection
-Static with Pile Soil Interaction
-Full Plastic Collapse
-Plastic Collapse Restart
-Gap Element Restart
2.1.6.1.2 Dynamic Tab
This tab contains all dynamic analysis features including:
-Dynamic Characteristics
-Modal Restart
-Earthquake
-Forced Response
-Engine Vibration
-Ice Vibration
-Wave Response
-Spectral Wind
2.1.6.1.3 Post Processing Tab
This tab contains all post processing features including:
-Element Stress/Code Check

2-4

Release 5: Revision 4

Executive
-Generate Postvue Database
-Joint Can
-Fatigue
-Generate Body/Structure Section Load Data
-Generate Femsys Results View File
2.1.6.1.4 Load Tab
This tab contains all the load generation features including:
-Seastate Environmental Loads
-Tow/Transportation
-SACS to Wamit Converter
-Wamit
-Wamit to SACS Converter
-Crane Superelement
-SACS to Mora Converter
-Mora
2.1.6.1.5 Miscellaneous Tab
This tab contains miscellaneous features including:
-Single Pile Analysis
-Material Take-off
-Flotation and Upending
-Launch
-Post Launch
-Plot Soil Data
-Rigid Body
-Free Body
2.1.6.1.6 Utilities Tab
This tab contains utility feature including:
-Combine Solution File
-Modify Solution File
-Format Solution File
-Unformat Formatted File
-Create Superelement
-Merge Superelement
-Expand Superelement
-User Defined Superelement

The Run file Wizard Tree displays all input files, output files, program modules to be run
and the analysis options selected. The tree is broken into four Group nodes, Input Files,
Output Files, Programs and Options. Each Group node may have several Category nodes
depending on the Analysis Options selected.

2-5

Release 5: Revision 4

Executive

To expand or collapse a Group node double click the Group node or right select the
. To expand all Group nodes, right select any Group
Group node and select
from the pop down menu.
node and select
Expand All

To expand or collapse a Category node double click the Category node name, single click
.
the to the left of the node or right select the Category node and select
To expand all Category nodes, right select any Category node and select
from
the pop down menu.
Expand All

2-6

Release 5: Revision 4

Executive
Expanded Category nodes will display the Item, which is often either an input or output
file and also the relative path of the item.
Right selecting on any input file Item allows the user to rename, replace or open the input
file Item with the associated program. Output files prior to executing the run file, only
flag options. After executing the run file,
have the rename, replace and the
option becomes available.
where applicable, an
By default, the
flag for output files is set on (checked). To remove the flag,
right select the Item and select
(X placed next to the filename). All output
will be available after executing the run file.
files with the

The Worksheet provides work space where notes may be typed. All run file analysis
messages are written to the worksheet area.

The Command Interpreter provides space where commands may be typed and executed.
Most of the common DOS and Unix commands are supported.
To execute a command, type the command using the appropriate syntax then press the
Enter key. Multiple commands may be executed by highlighting more then one line then
pressing the Enter key.
Type help to get a list of the commands supported. Type help
[command] to get help on a specific command.

The Error Log provides space where errors are recorded during an analysis. The list
contains the File/Module the error occurred in, a description of the error if available, the
type of error, the line of occurance, and a message about the error if applicable.

2-7

Release 5: Revision 4

Executive

The SACS Executive settings may be specified by selecting


under the
Settings Menu. After selecting the menu item, the SACS Executive Settings dialogue
appears. This dialog contains several tabs organizing the settings data into logical groups.

Selecting File/Open opens an ASCII file for editing. The editor to be used by the
Executive may be designated by the user.
SACSPFE

DOS

EDIT
path

The HTML File Browser is used to view all HTML files. The system installs its own
default HTML browser which can be replaced with any browser of the users choice.
path

2-8

Release 5: Revision 4

Executive
This option provides the ability to always insert the SACS system path in the runfile
preceding all batch module names.

The
checkbox will open the last saved worksheet on the
startup of the Executive. With checkbox deselected, a blank worksheet will be loaded on
startup.

This option causes a WAV file to played in a loop as long as an Analysis is begin
executed. This is used to alert the user that there is activity regarding the executing
analysis as well as alert him when it is completed.

When creating a execution run file, the output listing generated by all of the program
modules executed will be put in the same file if this box is checked. Otherwise, each
program module executed will create a separate output listing file.

The
checkbox will open the last saved worksheet on the
startup of the Executive. With checkbox deselected, a blank worksheet will be loaded on
startup.

The Show file names on worksheet checkbox will display the names, as well as, the paths
of the input and output files used whenever a SACS analysis is executed.

The Execution Option on the Execute Tab tells SACS where to run an analysis. An
analysis can be run on your local machine as well as on a Remote server machine.
Remote execution allows you to assemble the analysis as you normally would. The SACS
System then transfers all pertinent input files to the server machine in the directory
specified by the dedicated analysis directory and initiates a remote execution. When the
analysis is complete, the output files are transferred back to your local machine as though
you ran the analysis locally.

2-9

Release 5: Revision 4

Executive
The default SACS System settings may be specified by selecting
under the Settings menu. After selecting the menu item, the SACS System
Configuration dialogue is displayed.

The name of the security key server is specified in the

field.

The default section library is designated from the Section Library combo box by selecting
the appropriate library from the combo box. If a user defined library is to be used, select
from the combo box then enter the user defined library filename including
full path in the User Defined Library field.

The default system units are designated by selecting the appropriate radio button.

The model data is sorted by Precede when this button is selected.

Joint coordinates can be stored in the SACS model file as decimal feet(meters) or as
feet(meters) and inches(centimeters). To store joint coordinates as feet(meters) only select

2-10

Release 5: Revision 4

Executive
the
coordinates are input.

checkbox. This checkbox does not affect how joint

Check this button if you want to backup the model file each time a new change is made.
This results in the creation of a copy of the file before the last save was done.

This value controls the magnification step that interactive programs will use when the
Zoom-in or Zoom-out features are invoked.

Selecting the
tab displays the current color assignments. To change a color
. The
assignment double click an item or select it from the combo box and select
colors designated are used by all interactive programs.

The default plot configuration to be used by interactive programs is designated by


tab from the SACS System Configuration dialogue.
selecting
To create color plots select the
checkbox. To have Prevue generate
gray scale plots from color Neutral Picture Files (NPF) select the checkbox labeled
. The default print margins may also be changed.

2-11

Release 5: Revision 4

Executive

inches.

The Executive allows the user to set up projects using the Projects dialogue. Each project
is defined by a name of up to eighteen characters. All project data, by default, is stored in
the project directory defined by the user.
A project may consist of various project tasks. For example, an analysis type such as
inplace, lift or fatigue may be classified as a task. Each task has a default directory
defined as a sub-directory of the project directory where all task data is stored.
Files used for a project task are registered to the project file registry so that they may be
accessed automatically by the Executive. All registered files appear in the
area which shows the filename, task to which it is assigned, the file description and the
last time modified.
More detailed instructions on using Projects and Tasks are given in Appendix A.

2-12

Release 5: Revision 4

Executive

Whenever a file is used to generate a run file or is created by an analysis execution, it is


registered to the project database for the current task. Files may be manually registered
by the user using the add button in the File Explorer section of the executive.
To register a file, click on the Add button. Select the filename and specify the program to
which the file applies, the file type, the task to which it applies and specify a description.
as the project task.
If the file is to apply to all tasks within a project, select

2-13

Release 5: Revision 4

Executive
Files may be removed from the project file registry or file details may be modified using
the
or
buttons, respectively. See Section 4.0 for additional Project and
Analysis Task details.
The Executive allows the user to set up projects using the Projects dialogue. Each project
is defined by a name of up to eighteen characters. All project data, by default, is stored in
the project directory defined by the user.

The
checkbox when selected will display in the
the worksheet associated with the selected project.

The
checkbox will set the current directory to the Analysis
Task directory. All new analyses performed will be written to this analysis tasks
directory.

To add a new project select the


button and enter the name of the new project. Select
or enter the directory location of the project. To place the project in new directory, append
the name of the new directory in the Project Directory field by manually keying in the
name of the directory to be created. Enter a description of the project.

All defined Projects are shown by selecting the drop down button of the
box. Select one of the existing projects.

2-14

combo

Release 5: Revision 4

Executive
Projects may be copied from one machine to another by simply copying all associated
directories and files then adding a new project specifying the appropriate project
directory. All tasks and task sub-directories will then be available to the new project.

To add a new Project Analysis Task, select the


button and enter the name of the new
analysis task. Enter the subdirectory location and name of the analysis task. In this
subdirectory, the Executive will place all files that deal with this new analysis. By default
field will be created under the
a directory name that is entered in the
project directory. To place the analysis task subdirectory outside the Project directory,
select/enter the complete path to the desired directory location.

All defined analysis tasks for the current project are shown by selecting the drop down
combo box. Select one of the existing analysis tasks.
button of the

The SACS file naming convention is defined on the


tab. See Section 2.5 for
a detailed discussion on the SACS file naming convention features. The file ID, and file
naming convention may be selected.

Default file names created by SACS interactive program modules are determined by the
file naming convention designated on the File Name Convention tab of the Settings/File
Naming dialogue. In addition, the SACS Executive has the ability to determine the input
filenames required automatically when creating an execution run file based on the default
naming convention selected.

The SACS system may be setup to use one of the two file naming conventions,
or
, or no naming convention.
represents an
represents a label of the file
abbreviation of the program to which the file applies,
is the file identifier.
type and

When using the naming convention designated as


, the first characters of
the default filename represent the applicable program module and the next characters
represent the file type. The file extension is set to the project version identifier. For
example, the default file name for an output listing file created by PSI for file identifier
is
, where
is the label for the PSI module, represents an output listing
file type and
is the file identifier.

2-15

Release 5: Revision 4

Executive
When using the naming convention designated as
, the first characters of
the default filename are the file identifier. The next characters are the label of the
applicable program module. The file extension is set to the file type abbreviation. For
example, the default file name for an output listing file created by PSI for file identifier
is
, where
is the label for the PSI module, represents an output listing
file type and
is the file identifier.

The default file naming convention is designated on the File Name tab of the
Setting/Project Settings dialogue. If no file name convention is to be used, select

The file ID is selected by picking one of the available IDs on the


dialogue box.

tab in the

The label for each of the program modules or file types used for default filenames, may
be displayed by selecting the File Name tab of the Setting/Project Settings dialogue.

Any of the interactive programs may be launched directly from the Executive by double
clicking the appropriate Icon within the Desktop Area. After double clicking the Icon, a

2-16

Release 5: Revision 4

Executive
dialogue will prompt the user to either Create, Edit or open the last filename or database
name to be used by the program module is selected from the filename dialogue.
Create
New

Run files may be created for any type of analysis by selecting the appropriate tab,
button.
analysis type, and the
The Executive will prompt the user for the input file required by the analysis using the
SACS Input file dialogue.

Once the initial requested file is selected, the Executive program determines which
program options are applicable and prompts the user to select the desired options.
After the required input files are specified and analysis and post processing options are
selected.
Select
Files

The input files, output files, programs, and options are listed in the
any of the filenames may be changed.
The analysis may be executed immediately by selecting the
.

, where

button on the

File/Run

To execute a run file currently defined by the


, select the
button at the
. After the run file has been launched, an Analysis Progress
bottom of the
indicator will display the status of the execution.
The progress indicator shows which module is currently running, machine status and
elapsed time. The machine status is represented by the series of dots. If the Since an
analysis may execute several SACS modules, the progress indicator shows the elapsed

2-17

Release 5: Revision 4

Executive
run time for the current module as well as the total time elapse for the entire execution.
To cancel an analysis execution, press the
button.

2-18

Release 5: Revision 4

Executive

SECTION 3

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive

Opens a new text file for editing using the editor specified on the Executive Setup
dialogue.

Opens a new worksheet in the Worksheet Area, see Section 2.1.7. If the open worksheet
has any unsaved changes, Executive will prompt to save or discard the changes.
The worksheet displays Module run start and stop times, Module run status, system errors
and key errors. The messages on the worksheet may be annotated by the user. All edit
commands are available from the mouse and are accessible by positioning the mouse
over the worksheet and right clicking the mouse. A quick menu will appear and menu
items can be selected using the left mouse button.

Opens a new project; refer to Section 4.0 for a description of the Project feature.

Creates a new folder in the currently selected folder.

Opens an existing file for editing using the editor whose execution command is specified
on the Executive Setup dialogue.

Opens an existing worksheet; if applicable, Executive will prompt to save or discard


changes.

Opens an ASCII file for viewing (no editing) using the browser defined in the Executive
Settings dialogue, Section 5.1, utility included with the SACS system.

This feature will copy an existing file to a new filename. This feature is functionally the
same as the Edit/Copy/Paste feature of the Windows Explorer.

This feature will bi-directionally convert ASCII files from UNIX format to DOS format.
SACS can also convert an existing output listing file into HTML format for easier

3-1

Release 5: Revision 4

Executive
navigation. This file is created with a table of contents hot-linked to the corresponding
text area in the document.

Deletes the file selected with the filename dialog.

A previously created execution run file may be selected for immediate execution using
this feature.
Batch files from previous versions of SACS require a minor modification in order to run
in SACS release 5.0. In the batch file, execution of a program module requires the Run
keyword. For example, the execution of a program module in a batch file from a previous
release would appear as:
SACWPRE

< sacinp.gap >> gaplst.mkg

To convert this line for SACS release 5.0, change the line as follows:
run SACWPRE

< sacinp.gap >> gaplst.mkg

Allows selection of multiple run files to be executed sequentially. This feature requires
that the run files exist.

3-2

Release 5: Revision 4

Executive

This feature allows execution of SACS demo/verification analyses. To execute a demo,


select the demo of interest, select the analyses tasks to run, select the location of the demo
. If the demo files are not in the specified location, the Executive
files, and select
will report a file not found error.

None.

Make Directory allows a new directory to be created. The


when selected will make the created directory default directory.

3-3

checkbox

Release 5: Revision 4

Executive

ASCII text files may be printed from within the Executive using this feature. The user
will be prompted to select which file to be printed.

This feature will print the contents of the open worksheet.

The Print Setup option controls the printing of ASCII files from within the Executive.
The user is able to select which printer will used for printing. For complete
documentation of this feature refer to the documentation that came with your computer or
ask your system administrator.

The printer font selected will be used for all printing of ASCII files from within the
Executive, such as Worksheets.

3-4

Release 5: Revision 4

Executive

The Executive program is exited either by selecting this feature, or by pressing X in the
upper right hand corner of the window. Executive will prompt to save or discard changes
to the worksheet.

3-5

Release 5: Revision 4

Executive

3-6

Release 5: Revision 4

Executive

SECTION 4

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive
Please see Appendix A for a much fuller description of using projects and tasks.

Set the current project and/or task to another existing project or task. By default the
SACS system starts in the last project that was used. A new project can be selected by
combo box located on the status bar or from the
picking the project from the
task menu item under the
main menu.

Select the project name <None> if the project facilities are not to be used.

Modify the properties of a project, such as Project description, worksheet filename and
file naming convention.

Add a new project.


The user must input the project name and the
location (or directory name) for the project
data. By default all files, run files and output
files created for the project will be located in
the directory specified or one of its tasks subdirectories.
Project description, worksheet filename and
file naming convention may be optionally
specified.

Delete a project.

Modify the properties of a task, such as Task description, worksheet filename and file
naming convention.

4-1

Release 5: Revision 4

Executive
Add a new task.

Delete a task.

Modify the properties of a sub-task, such as Sub-Task description, worksheet filename


and file naming convention.

Add a new sub-task.

Delete a sub-task.

There is a sample project called <SACS Samples> on the installation CD and it can
optionally be installed as part of the SACS installation.
This option allows the manual importation of the sample project if it was not done so at
initial installation.
To import, copy the SACS Samples directory
from the installation CD to the desired
location.
Next select the
menu item under the
main menu. Designate the directory to which
the samples were copied as well as the
worksheet filename.

4-2

Release 5: Revision 4

Executive

SECTION 5

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive

This opens the Executive Setup dialogue box which allows the user to change various
Executive program settings. See Section 2.2 Configuring the SACS Executive for a
detailed discussion of the setup parameters.

The SACS file naming convention is defined on the


tab. See Section 2.5 for
a detailed discussion on the SACS file naming convention features. The file ID, and file
naming convention may be selected.

This feature allows specification of the SACS System Configuration. See Section 2.3 for
a detailed discussion on the system setup options.

This toggle will display or hide the help cue cards. Cue Cards provide information about
the capabilities provided by the window or dialogue box currently active. Select the item
or window to obtain Cue Card help. For example the Cue Card for the
option of the
tab is shown below.

To obtain additional information about optional features select the


button.

5-1

Release 5: Revision 4

Executive

This toggle will display or hide the Release 4 legacy interface. The Release 4 interface
allows the user to optionally work using the same interface provided with Release 4.
Each button corresponds to a feature on the main screen of the Executive. Place the
mouse over the desired button to display the icon or feature to which it corresponds on
the help line at the bottom of the screen.
Buttons for interactive programs (caption in upper case) correspond to icons in the
. Buttons for creating runfiles correspond to options in the
Seastate
Seastate Environ. Loads
Wizard

5-2

Load

Runfile

Release 5: Revision 4

Executive

Settings/SACS System Configuration

This toggle when selected will set the Executive to save all settings when the program
exits.

5-3

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive

SECTION 6

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive
The features under the Modeling menu allow for the creation of SACS model and loading
data.

The
icon or the Precede menu item launches the Precede program. Upon selection
of this option, the user is queried for the Precede start option. When selecting
from the message box, Precede is launched without an input file. The user
may also select the SACS ASCII input file to launch the program with the input file
designated. For the latter option, the open file dialogue is used to specify the SACS input
file to use.

The
icon or the
menu item launches the Datagen program. Datagen
may be used to begin a new SACS input file or to edit an existing SACS input file. Upon
selecting the Datagen icon or menu item, the user should select either the
, or
startup mode from the message box.
If edit file mode is selected, the file name must be designated in the open file dialogue.

Launches the Finite Element Modeler and Results Viewer. The Finite Element Modeler
FemSys must be installed in order to have use of this feature.

6-1

Release 5: Revision 4

Executive

6-2

Release 5: Revision 4

Executive

SECTION 7

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive
The features under the Check/Redesign menu allow for the reviewing of SACS model
and loading results.

The
icon or the
menu item launches the Postvue program. The
database to be used is specified on the directory dialogue prompt.

The
icon or the
menu item launches the Collvue program.
Collapse View is used to interactively check results of a non-linear collapse analysis may
be executed by selecting this feature. The Collapse restart file to be read must be
designated on the ensuing file open dialog.

The
icon or the
menu item launches the Interactive
Fatigue program. Interactive Fatigue is used to check fatigue damage on joints may be
launched by picking this menu item/icon. The fatigue extract file containing the damage
details is selected on the ensuing file open dialog.

7-1

Release 5: Revision 4

Executive

7-2

Release 5: Revision 4

Executive

SECTION 8

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive

The
icon or the
menu item launches the Prevue program. Prevue is used
to view, edit and plot NPFs. The NPF to be read must be designated on the ensuing file
open dialogue.

The Display Key program is used to display the security key information, and is executed
from this menu item.

8-1

Release 5: Revision 4

Executive

The Edit Key program is used to update the security information on the key.
must be exercised when using this feature. Incorrect use of, or tampering
with Edit Key will result in disabling the entire SACS Software Suite. Do
use this
feature unless explicitly directed to by Engineering Dynamics, Inc.

8-2

Release 5: Revision 4

Executive

8-3

Release 5: Revision 4

Executive

8-4

Release 5: Revision 4

Executive

SECTION 9

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive
The History Menu displays a history of all recent executions since the opening of the
Executive program. This feature allows the user a quick pick method.

9-1

Release 5: Revision 4

Executive

9-2

Release 5: Revision 4

Executive

SECTION 10

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive
Selecting the Help menu activates the help file browse facility. The user may browse
through the menu items or the list of keywords and terms that are provided. The
appropriate menu item is referenced for keywords and terms listed.

This feature opens a dialogue, which lists the available program documentation for
viewing and/or printing. From the list a document may be selected for viewing. The
document may be printed from within the viewing application. The documents are in
Acrobat PDF format and requires Acrobat v3.01 or higher and the SACS plug-in for
Acrobat Reader installed to view the documents.

Cue card help is also available; refer to Section 5.4 for details.

This opens the main EDI web page using the default web browser.

This allows the user to send an email to EDI.

10-1

Release 5: Revision 4

Executive

This shows the current Executive version number, the EDI key number that is being used,
and the number of accesses left on that key if the software is leased. Clicking on the
button shows details and version numbers of all SACS programs and
dynamic linked libraries (DLLs).

10-2

Release 5: Revision 4

Executive

APPENDIX A

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive

The SACS System allows the user to organize data into projects. The project facility
saves project data such as data files, options, analysis output and task relationships used
over the course of the project so that the user and the SACS system can quickly identify
the information automatically.

All project data, i.e. files, options, output, etc. is stored


under the project directory designated by the user when
the project is created. Other project information such as
description, file naming convention and worksheet
filename may also be defined.
The project facility allows the project data to be
partitioned such that data is segregated or organized into
tasks. Each task has a default directory defined as a subdirectory of the project directory where all task data is
stored. Tasks information can be defined in three levels;
main task, sub task or minor task.
The main task is the highest level task and may contain
various sub tasks which in turn may contain minor
tasks. Task information such as name, sub-directory,
description and file identifier are defined for each level
of task. The relationship between project, main task,
sub-task and minor task is illustrated in the project/task
hierarchy figure.

Data files used in a project may be registered to the project by the user or automatically
by the SACS system. Files registered to the project registry appear in the
area which shows the filename, owner task or task to which it is assigned, the file
description and the last time modified and may be accessed automatically by the SACS
system.
By default the
only shows files defined in the project file registry. The
allows files to be filtered based on the current or active task by selecting one of
filters as follows:
the
All Files in Project

Shows all files defined in the project registry.

Files Available to Task

Shows all files assigned to the current task, files


assigned to a parent task of the current task as
well as files assigned to the project (i.e. All
Tasks).

A-1

Release 5: Revision 4

Executive
Files Assigned to Task

Shows only those files assigned to the current


task.

All Files under Task

Shows all files assigned to either the current task


or to those tasks underneath the current task (i.e.
child tasks).

Files in Current Directory

Shows all file in the directory of the current task


or project.

Files may be registered to the project in one of four levels, project level, main task level,
sub task level or minor task level as follows:
Project Level:

Files owned by the project are available to any


main task, sub task or minor task (i.e. child task)
of the project.

Main Task Level:

Files owned by a main task are by default


available when that main task or any sub task or
minor task under that main task is active.

Sub Task Level:

Files owned by a sub-task are by default


available when that sub task or a minor task
under that sub task is active.

Minor Task Level:

Files owned by a minor task are by default


available when that minor task is active.

When the SACS system requires a data file, it firsts checks for a file of that type assigned
to the active task. If a file of the requested type is registered to the active task, it is used
by default. If no file is found registered to the current task, then the registry for the owner
of the task is checked. The registry is checked looking up the project/task hierarchy of the
project until the requested file is found.

A-2

Release 5: Revision 4

Executive
For example, if soil data is required by the system and a minor task is active, the system
will first check for a file registered to that minor task. If no soil file is found, then the
sub-task to which the minor task belongs is checked. If a soil file is still not found, the
main task is then checked followed by the project if required.

Projects are created using the


menu item under the
main menu.
The user must input the project name and the
location (or directory name) for the project
data. By default all files, run files and output
files created for the project will be located in
the directory specified or one of its tasks subdirectories.
Project description, worksheet filename and
file naming convention may be optionally
specified.

To add a new
,
menu.

, select the
or the

menu item under the

main

Enter the name of the task as well as the subdirectory location. All files for this task will
be placed in this subdirectory.
By default a directory name that is entered in the Sub-directory field will be created
under the project directory. To place the analysis task subdirectory outside the Project
directory, select/enter the complete path to the desired directory location.

The project file registry contains information such as filename, location, file type,
program and task ownership for each of the files used in the project. Whenever a file is
created by an interactive program module, used in the generation of a run file or is
created by an analysis execution, it is registered to the project registry with the current
task set as the owner.

Files may be manually registered by the user


using the add button in the
section of the executive or by right clicking on
the file and selecting the Add to Registry drop
down menu.
To add a file to the registry, specify the
program to which the file applies and the file
type.

A-3

Release 5: Revision 4

Executive
Next designate the task ownership of the file by assigning the applicable main task, sub
task and minor task to the file. A description of the file must be specified.

Files details may be modified in the project file registry by selecting the file then clicking
button or right clicking and selecting the
drop down menu
the
item.

Files may be removed from the project file registry by selecting the file then clicking the
button or right clicking and selecting the
drop down menu
item.

By default the SACS system starts in the last project that was used. A new project can be
combo box located on the status bar or
selected by picking the project from the
task menu item under the
main menu.
from the

The current task may be set by expanding the


tree view and double clicking on the
desired main task, sub task or minor task.
The active task can also be set from the Set
Current Project task menu item under the
main menu.

A-4

Release 5: Revision 4

Executive

Projects and/or tasks and/or sub-tasks can be deleted using the


or
menu items under the
main menu.

The project directory typically contains all of the data files, run files and results of the
project. This data may be organized into tasks which are typically in subdirectories under
the project directory. The project information for the projects files including filename,
usage, owner and description as well as information for all of the tasks including task
name, description, sub directory and file identifier are stored in the project directory.
Therefore, when the project directory is copied along with the sub-directories, all of the
project information is copied as well.
In order to copy a project to another directory of to another machine, simply copy the
project directory to the desired destination directory. Then create a new project using the
menu item under the
main menu. Specify the destination
directory as the project location along with the appropriate description. When this new
project is activated, all project tasks and project data files should then be available.

The sample project named <SACS Samples> is included on the installation CD and can
be optionally imported as part of the SACS system installation. This sample project
contains numerous tasks and sub-tasks that allow the user to follow the sample project.

The sample project can be imported manually


if it was not imported as part of the
installation.
To import, copy the SACS Samples directory
from the installation CD to the desired
location.
Next select the
menu item under the
main menu. Designate the directory to which
the samples were copied as well as the
worksheet filename.

A-5

Release 5: Revision 4

Executive

To activate the sample project, select <SACS


Samples> from the project combo box on the
status bar of the SACS system.
Select the desired task or sub-task by double
tree. Use the
clicking on the task in the
filter on the
to view the
files assigned to the current task or sub-task.

A-6

Release 5: Revision 4

Executive

APPENDIX B

Release 5: Revision 4

Executive

Release 5: Revision 4

Executive
Executive Settings, 5-1
Exit, 3-5
Add Project, 4-1
Add Sub-Task, 4-2
Add Task, 4-2
Area

Features, 1-1
FemGV, 6-1
file

Command Interpreter, 2-7


Error Log, 2-7
File explorer, 2-2
Runfile wizard, 2-3
Worksheet, 2-7

Copy, 3-1

File
Browse, 3-1
Delete, 3-2
New, 3-1
Print, 3-4
Run, 3-2
Run multiple, 3-2

Backup Model Creation, 2-11


Bar

File explorer, 2-2


File label, 2-16
file name conventions, 2-15
File Naming, 5-1
File type conversion, 3-1
Font

Menu, 2-1
Status, 2-2
Tool, 2-1

Print, 3-4

Check/redesign, 7-1
Collapse View, 7-1
Color, 2-11
Command Interpreter, 2-7
Configuration, 1-1, 2-8, 2-10
Configure

General information, 1-1


Getting started, 2-1

Plot, 2-11

Convention
File name, 2-15

Hard code system path, 2-9


Help, 10-1

Convert
File type, 3-1

Cue cards, 5-1

copy

History, 9-1
HTML File Browser, 2-8
HTML File Viewer, 2-8

File, 3-1

Creating a run file, 2-17


Cue Cards, 5-1

Icon Bar, 2-2


Import Sample Problem Project, 4-2
Interactive Fatigue, 7-1
Interactive programs

Data Generator, 6-1


Default Section libary, 2-10
Delete
File, 3-2

Launching, 2-17

Delete Project, 4-1


Delete Sub-Task, 4-2
Delete Task, 4-2
demo, 3-3
Directory

interface
SACS 4.2, 5-2

Introduction, 1-1

New, 3-1

Display Key, 8-1


Dynamic analysis, 2-4

Joint coordinates, 2-11

Key Server, 2-10

Edit Key, 8-2


Editor selection, 2-8
Error Log, 2-7
Execution Option, 2-9
Executive configuration, 2-8

Label
File, 2-16

B-1

Release 5: Revision 4

Executive
Program, 2-16

Run file, 3-2

Launching interactive programs, 2-17


Load generation, 2-5
Load Worksheet File at Startup, 2-9

Runfile wizard, 2-3

SACS 4.2 Interface, 5-2


SACS Program Manual, 10-1
SACS Samples, 4-2
Save settings, 5-3
Security Key, 2-10
Set Current Project/Task, 4-1
Settings, 5-1

Main Screen, 2-1


Make directory, 3-3
Menus, 2-1
Modeling, 6-1

Executive, 5-1
File Naming, 5-1

Show cue cards, 5-1


Show file names, 2-9
Sort Model Data, 2-10
Sorting, 2-10
Static analysis, 2-4
Status bar, 2-2
Sub-Task Properties, 4-2
System configuration, 1-1, 2-10

New
Directory, 3-1
Project, 3-1
Text file, 3-1
Worksheet, 3-1

Online Manual, 10-1


Open
Documentation, 10-1
Program manual, 10-1
Text file, 3-1
Worksheet, 3-1

Task Properties, 4-1


Text file
New, 3-1
Open, 3-1
Print, 3-4

Output files, 2-9


Overview, 1-1

Tool bar, 2-1


Plot configuration, 2-11
Post Processing, 2-4
Postvue, 7-1
Precede, 6-1
Prevue, 8-1
Print

Units, 2-10
Use Sound, 2-9
Utilities, 2-5, 8-1

Font, 3-4
Setup, 3-4
Text file, 3-4
Worksheet, 3-4

View
File, 3-1

Program label, 2-16


Program overview, 1-1
Project

Wizard

New, 3-1

Runfile, 2-3

Project Properties, 4-1


PROJECT/TASK, 4-1
Projects, 2-12

Worksheet, 2-7, 2-9


New, 3-1
Open, 3-1
Print, 3-4

Reference manual
Open, 10-1

Zoom factor, 2-11

Run
File, 3-2

Run multiple

B-2

Release 5: Revision 4

You might also like