ASSIGN

I/O Options and Subcase Information Entry

ASSIGN – Input Definition

Description

The ASSIGN command can be used in the I/O Options section to identify external files and their contents.

Format

ASSIGN, type, option1, option2

Type

Option1

Option2

Description

AKUSMOD

filename

N/A

Identifies an external file from which to read the AKUSMOD fluid-structure coupling matrix.

If this is not defined, it is presumed that the AKUSMOD coupling matrix is to be found in the same directory as the solver input file and is given the file name, ftn.70.

Use of the AKUSMOD fluid-structure coupling matrix requires the presence of PARAM,AKUSMOD,YES.

ENGINE

SUBCASE ID

filename

Identifies an external file from which to read modification commands to be applied on the intermediate RADIOSS Engine file translated in the EXPDYN solution.

SUBCASE ID=0 means EXPDYN subcases.

See comment 1.

EXCINP

SUBCASE ID

filename

Identifies an external file from which to read the modal participation factors calculated by AVL/EXCITE for both transient and FRF residual runs.

While running an AVL/EXCITE analysis, an .INP4 file is generated that contains the modal participation factors. The .INP4 file can be used along with the original flex h3d file to recover stresses, strains, displacements, velocities, and accelerations from a dynamic analysis run. The SUBCASE ID is used to specify which SUBCASE the modal participation factors should be used for.

GETDISP

Filename

N/A

Identifies an external file from which the results of the selected subcase are recovered. An actual file with the name “Filename” should exist for GETDISP to work. This entry should be added to the corresponding subcase(s) whose results are to be restored. The solution process for the corresponding subcase will be skipped. This entry can be added to more than one subcase, wherein, the results for each such subcase will be restored from the corresponding files. The set of grids in the restart file can only be either the same as or a subset of the grids in the input deck. Results for any grid which does not have corresponding data in the restart file will be automatically set to zero.

Note

1.	The subcase results can be saved in a restart file using the ASSIGN,SAVEDISP command.

2.	This is currently only supported for Linear Static Analysis.

3.	See the Save and Restart section of the Global-Local Modeling in the User's Guide.

4.	Global subcase still needs to be present in the input file even if the restart is performed with GETDISP. In this case, the solution of global subcase will be skipped and the solution will directly be read from restart file.

H3DDMIG

matrixname

filename

Identifies an external nodal flexh3d file from which to read DMIG matrices. Provides a prefix (matrixname) for the matrices contained therein, and the path to and the name of the flexh3d file. All of the matrices in the h3d file are used in the analysis by default. If only some of the matrices are to be used, use the K2GG, M2GG, K42GG, and B2GG data to specify which matrices are to be used. The unreferenced matrices will not be used in this case.

H3DCDS

matrixname

filename

Identifies an external file from which to read complex dynamic matrices for a CDS residual run. Provides a prefix (matrixname) for the matrices contained therein and the path to and the name of the filename_CDS.h3d file. All of the matrices in the filename_CDS.h3d file are used in the analysis.

H3DMBD

Flex Body ID

filename

This option can be used in two ways, to identify flex body for result recovery or in further OS-MBD analysis in the PFBODY Bulk Data Entry.

1.	Identifies an external nodal flexh3d file which contains the analysis recovery information for displacements, velocities, accelerations, stresses and strains. Provides a Flex Body ID for the information therein, and the path to the name of the flexh3d file.

The identified flexh3d file can also be used as a flex body in OS-MBD analysis. This can be activated by referencing the Flex Body ID on the BID field of the PFBODY Bulk Data Entry. In such cases, the included flex body (ASSIGN, H3DMBD, Flex Body ID) is used in the analysis and the PFBODY information for flex body generation is not used.

MBDINP

SUBCASE ID

filename

Identifies an external file from which to read the modal participation factors calculated by MotionSolve for transient analysis.

While running MotionSolve, an .mrf file is generated that contains the modal participation factors. The .mrf file can be used along with the original flex h3d file to recover stresses, strains, displacements, velocities, and accelerations during a transient analysis run. The SUBCASE ID is used to specify which SUBCASE the modal participation factors should be used for.

MMO

Model Name

filename

Identifies an external file to be included in a Multi-Model Optimization (MMO) run. “Model Name” is a user-defined label for the model, which can be used to qualify model-specific responses referenced on the DRESPM continuation lines of the DRESP2 and DRESP3 entries.

PUNCH

filename

N/A

Identifies an external file as the location to write DMIG data in PUNCH format.

SAVEDISP

Filename

N/a

Identifies an external file to which the analysis results of the selected subcase are written. This entry should be added to the corresponding subcase(s) whose results are to be saved. This entry can be added to more than one subcase, wherein, the results for each such subcase will be saved in a separate file. For optimization runs, the results during the subsequent iteration will overwrite results of the preceding iteration.

Note

1.	The stored subcase results via ASSIGN,SAVEDISP can be restored using the ASSIGN,GETDISP command.

2.	This is currently only supported for Linear Static Analysis.

3.	See the Save and Restart section of the Global-Local Modeling in the User's Guide.

STARTER

SUBCASE ID

filename

Identifies an external file from which to read modification commands to be applied on the intermediate RADIOSS Starter file translated in the EXPDYN solution.

SUBCASE ID=0 means EXPDYN subcases.

See comment 1.

SIMPINP

SUBCASE

filename

Identifies an external .unv file generated while running a multi-body dynamic analysis in SIMPACK. The resulting CMS flexbody modal participation factors in the .unv file can be used by OptiStruct to recover the dynamic displacements, velocities, accelerations, stresses and strains.

The SUBCASE ID is used to specify which SUBCASE the modal participation factors should be used for.

UPDATE

filename

N/A

Identifies an external file from which to read the updated cards after an optimization run. The external file can have any file extension, as long as it is an ASCII file that contains relevant data.

Currently, the following cards are supported:

GRID

MAT1, MAT2, MAT3, MAT4, MAT5, MAT8, MAT9, MAT10

PSHELL, PSOLID, PBAR, PBEAM, PELAS, PVISC, PDAMP, PBARL, PBEAML, PMASS, PROD, PBUSH, PBUSH1D, PAABSF, PWELD, PCOMPP, PSHEAR, PTUBE

CTRIA3, CQUAD4, CTRIA6, CQUAD8

CONM2

Note:

ASSIGN, UPDATE is intended for optimization output. It allows you to modify physical values which may typically be changed during optimization (for example, GRID point locations, material parameters, and so on), however it does not allow changes to the actual model setup (for example, Material ID on the Property entry, or coordinate system ID on the GRID entry cannot be changed).

Multiple ASSIGN, UPDATE commands can be used to reference multiple files to be included in the model. However, data common to these multiple files will be overwritten. Exercise caution where multiple ASSIGN, UPDATE commands are specified. OptiStruct will print a WARNING message to the .out file, if data is overwritten.

3.	The MID field of the PSOLID entry can be updated using ASSIGN,UPDATE. All other fields, except FCTN, are skipped. Assigning improper material type may result in an error.

ASSIGN, PUNCH, C:\CMS\h3ddmig.pch

ASSIGN, H3DDMIG, AX, C:\CMS\h3ddmig.h3d

Comments

1.	For geometric nonlinear subcases, two types of modification commands are available in the external file defined with ASSIGN,STARTER/ENGINE: insert and replace.

insert
Usage:	Inserts content between keywords /INSERT and /ENDINS to the intermediate RADIOSS Block deck at line number LINENUM.
Syntax:	/INSERT,LINENUM Content to be inserted /ENDINS

replace
Usage:	Uses content between keywords /REPLACE and /ENDREP to replace the content in the intermediate RADIOSS Block deck between line numbers LINENUM1 and LINENUM2.
Syntax:	/REPLACE,LINENUM1, LIMENUM2 Content as replacement /ENDREP

2.	The SEINTPNT subcase information entry can only be used to convert interior super element grid points in .h3d files referenced by ASSIGN, H3DDMIG.

Limitations:

•	Each subcase can only be defined with a maximum of one ASSIGN,STARTER entry and one ASSIGN,ENGINE entry.

•	In the external file, the line numbers (LINENUM after /INSERT, and LINENUM1 after /REPLACE) should be input in increasing order.

•	For subcases in the same load sequence (defined by CNTNLSUB), ASSIGN,STARTER settings should be identical.