spmwrite

Mapdl.spmwrite(method='', nmode='', inputs='', inputlabels='', outputs='', outputlabels='', nic='', velacckey='', fileformat='', **kwargs)

Calculates the state-space matrices and writes them to the SPM file.

APDL Command: SPMWRITE

Parameters:

method

Reduction method for the calculation of the state-space matrices.

MODAL - Method based on modal analysis results from LANB, LANPCG, SNODE, or SUBSP

eigensolver (default).

nmode

Number of modes to be used. Defaults to all modes.

inputs

Definition of the inputs. Defaults to all load vectors on the MODE file.

inputlabels

Definition of the input labels. Defaults to the load vector numbers or input definition (node and degree of freedom array parameter), depending on the Inputs specification.

outputs

Definition of the outputs. Defaults to the inputs.

outputlabels

Definition of the output labels. Defaults to the output definition (node and degree of freedom) if used, else defaults to the InputLabels.

nic

Load vector on the MODE file used for the calculation of the initial conditions. Defaults to no initial condition.

velacckey

Output velocities and accelerations key.

OFF - Output displacements only (default).

ON - Output displacements, velocities and accelerations.

fileformat

The format of the SPM file.

0 - Dense format.

1 - Matrix Market Exchange format (non-zero terms only).

2 - Simplorer SML format without reference (default).

3 - Simplorer SML format with common reference.

4 - Simplorer SML format with independent references.

Notes

The SPMWRITE generates the file Jobname.SPM containing the state-space matrices and other information.

The following applies to the SML formats (FileFormat = 2, 3, and 4):

For conservative systems where the outputs are equal to the inputs (Outputs is left blank):

The labels for the inputs (InputLabels) are required.

The Inputs must use the array parameter option so that the input degrees of freedom (DOFs) are known.

For non-conservative systems where the outputs are not equal to the inputs:

The labels for the outputs (OutputLabels) are required.

The file formats with references (FileFormat = 3 and 4) do not apply.

Velocity and acceleration results are not included in the state-space matrices calculation (VelAccKey = OFF)

File format with common reference (FileFormat = 3) does not apply if the inputs are based on DOFs of a different nature. All input DOFs must be either all rotational or all translational and not a mix of the two.

A graphics file (Jobname_SPM.PNG) is generated. It contains an element plot of the model.

For more details about the reduction method and the generation of the state-space matrices, see Reduced-Order Modeling for State-Space Matrices Export in the Mechanical APDL Theory Reference.

For examples of the command usage, see State-Space Matrices Export.