PRIMER 22.1

CONTROL: Defining Analysis Control Cards

CONTROL: Defining Analysis Control Cards


The *CONTROL keyword in Ansys LS-DYNA refers to the unique keywords which control the main parameters of an analysis.

Each control card occurs either once or not at all, and none are labelled, therefore the PRIMER control and editing panels are slightly non-standard. Merging control cards presents some special problems - see the notes on this below.

Note for users of PRIMER prior to release 8.2: The layout of the control card editor has been totally revised, since the increasing number of control cards (44 in LS960) made the original panel unwieldy. In addition the distinction between "create", "modify" and "copy" modes has been removed and replaced by a single panel that performs all these functions.

The main CONTROL panel

Since each control card can only exist once or not at all in a model the concept of separate "create", "modify", "copy", etc modes has been removed.

MODIFY Maps the control card editing panel, in which cards can be created, modified, deleted and copied from other models.
CHECK Runs the standard check routines on control cards.
CALC DT2MS Calculate relationship between %age added mass and timestep
CONVERT TO IMPLICIT Make modifications to the model to convert it to an implicit analyses.

As with all PRIMER MODIFY functions edits and other changes only take place on a "scratch" definition, which is only made permanent when explicitly UPDATEd.

CONTROL_CHECK_SHELL (CHECK SHELL) and CONTROL_MPP_DECOMPOSITION_TRANSFORMATION (MPP DECOMP) are open ended cards with their own edit panels which can be accessed directly or via MODIFY

CALC DT2MS is only active if DT2MS on the *CONTROL_TIMESTEP is set to 0 or less (see below)


MODIFY: Creating, editing, deleting and copying control card definitions

The single panel shown below is used to carry out all these operations.

For ease of selection, Control card are now grouped into 6 categories.

ALL available Control options will be displayed (but not activated) by pressing ALL and all the active ones by pressing ACTIVE

All changes in this panel are performed on a "scratch" definition, and changes only become permanent in the database when UPDATE is pressed.


Selecting which control cards are displayed

The scrolling menu on the left lists all control cards of current category (in this case STANDARD), using the following colour convention:

White on Blue Control card is present (active) in model
Black on Grey Control card is not defined in the model (inactive)

To select a card (active or inactive) for display toggle it on/off using its row in this menu. Note: Selection makes the card active, whereas deselection just removes the card from the display panel. Thus deactivation of a card must be done explicitly.

You may also select:

ALL All control cards, both active and inactive, are displayed
ACTIVE All active cards are displayed
DONE Return to card categories

Whenever a card is displayed and active its data fields can be updated by the normal text entry method. In addition all pre-defined lists of integers have popup menus giving the legal list of entries.

Making individual control cards active and inactive
Individual (visible) rows are toggled between active and inactive by clicking on their "name" button.

In this example:

ENERGY Has been made active
OUTPUT Has been made inactive

It can be seen that the (in)active status is also reflected in the selection menu on the left.

Note that inactive cards are "greyed out", and that entries cannot be made to them unless they are made active again.

Inactive cards will not be saved in the database following an UPDATE even if they contain (greyed out) values as here.

SET... (re)setting values for a control card

The data fields in a card may be (re)set back using the popup menu to:

Original values The values in the current database, prior to any edits
LS-DYNA defaults The default values quoted in the Ansys LS-DYNA keyword manual
All zero values All fields are set to zero

Note that the local SET... option only affects this card. To reset all cards back to their original, unedited values use the RESET_ALL button at the top of the panel.

COPY... Copy data into a control card from another model

If one or more other models are present which also contain this control card then the COPY... button will be made live. This will give a list of possible models from which to copy this card's data. If no other models containing a definition for this card exist then the button will be greyed out.

Data copied in from another model supersedes the current data.

The COPY... option only affects this card. To copy data in from all cards in another model use the COPY_ALL... button at the top of the panel.

RESET_ALL: Restoring all control cards to their initial values

RESET_ALL cancels the effect of all edit, copy, set and (in)activate operations by restoring all cards to their initial state as in the database.

UPDATE: Making control card edits permanent

All changes above are carried out on a "scratch" definition. Changes are only saved permanently in the database when UPDATE is pressed.

To exit leaving the control cards unchanged use ABORT.

CHECK Running the standard checking function on control cards

The CHECK_CTRL command runs the standard syntax and context checker. Most errors checking for control cards is based on detecting "out of range" parameters, but some interactions with data defined elsewhere in the model are also checked.

COPY_ALL: Copying all control cards from another model

COPY_ALL copies in all cards from another model, superseding any such definitions in this model.

Cards that are not active in the origin (copied from) model are not changed in the current model.

Setting model title and memory size.

In addition to editing the contents of the control cards:

  • A MODEL TITLE of up to 80 characters can be specified within this panel.
  • The MEMORY SIZE can also be set here. (This is optional, it is expressed in words of memory.)

CALC_DT2MS Calculates relationship of timestep to %age added mass

If DT2MS on the *CONTROL_TIMESTEP cards is set to less than zero, timestep added mass is active.

The CALC DT2MS function will report the %age added mass for the current model timestep (expressed as DT2MS x TSSFAC).

Model timestep may be input directly or determined

  • by specifying %age added mass
  • by specifying target mass, which is the sum of structural mass and timestep added mass.

SET DT2MS and SET DT2MSF will update the values on the timestep control card.

Note: TSSFAC is used for element timestep calculation and should never exceed 0.9. CALC DT2MS will never change TSSFAC.



Ansys LS-DYNA has a special method of adding mass to spotweld elements using the setting DT on the MAT100 card.

For beam spotwelds this added mass is included in the normal total and will appear in the %age added mass box.

For solid spotwelds, Ansys LS-DYNA calculates the added mass differently and reports it separately. This added mass will appear in the MAT100<DT> Hex mass % box (it is also included in %age added mass given).

See note in Appendix Q for more details.

CONVERT TO IMPLICIT

The convert to implicit panel is a simple method of converting an explicit analysis to an implicit analysis by creating appropriate control cards (if not already present) and assigning default values. Also, element formulations are set to recomended defaults.

Original hourglass cards and materials cards are not modified if you select to change these. PRIMER will create duplicate cards with the relevant data copied from the original cards, and with the required changes for implicit analyses. The offset specified on this panel is applied to the original label to create the new cards. This offset must be higher than the highest material and hourglass label in the model.

Notes on Control Cards and the model MERGE operation

In common with other "static" (occurring either once or not at all) data in PRIMER, control cards may conflict when models are merged. The model merger allows you to select globally from source model #A or #B when cards exist in both models, but this may be too unselective for some cases.

It is recommended that you review the control cards in the destination model generated by a merge operation, and make selective use of the COPY function above where required.

Notes on Control Cards and the include selection operation

As in other editing panels, * CONTROL cards can be moved to a chosen include file using the include selection buttons at the top of the panel. All * CONTROL cards will be moved when this operation is carried out. When the * CONTROL cards are in more than one inlcude file, the include display within the editing panel will tell the user this is the case. Positioning the mouse over the include display area will print hover text to the screen listing all the include files the control cards are in.

The include file for each individual control card is displayed along side the control card information.

The include file can be modified by clicking on the folder button next to where the include name is displayed. Note the control card is only moved into the newly selected include file when Update is pressed on the top of the control card panel.