HyperWorks Solvers

SET_GSE_ALGEBRAIC_EQN

SET_GSE_ALGEBRAIC_EQN

Previous topic Next topic No expanding text in this topic  

SET_GSE_ALGEBRAIC_EQN

Previous topic Next topic JavaScript is required for expanding text JavaScript is required for the print function  

Subroutine Type

Setup utility subroutine for GSE.

Definition

The SET_GSE_ ALGEBRAIC_EQN subroutine is used with GSESUB to specify the implicit, algebraic equation.

Use

Fortran

SET_GSE_ALGEBRAIC_EQN (gse_id, eqn_idx, errflag)

 

C/C++

c_set_gse_algebraic_eqn (gse_id, eqn_idx, errflag);

 

Python

py_set_gse_algebraic_eqn(gse_id, eqn_idx, errflag)

Input Arguments

gse_id

Type = integer.

The identifier of the GSE element.

 

eqn_idx

Type = integer.

The equation index of the algebraic equations.

Output Values

errflag

Type = integer.

Returns information about the call status.

A non-zero value indicates failure.

Comments

1.All indices are 1-based.  That is, the index starts from 1, not 0.
2.SET_GSE_ALGEBRAIC_EQN should only be called when iflag=1.
3.In most cases, GSE are in the following form:

set_gse_alg_fig1

However, in some cases, the state equations may involve both differential and algebraic equations.  For example:

set_gse_alg_fig2

When this occurs, it is necessary to tell MotionSolve the equation indices of the algebraic equations associated with the algebraic state X2, using SET_GSE_ ALGEBRAIC_EQN.  For example, call: SET_GSE_ALGEBRAIC_EQN (gse_id, 2, errflag)

4.A common use case for SET_GSE_ ALGEBRAIC_EQN is to convert the implicit form of state equations:

set_gse_alg_fig3

into the explicit form that can be solved in MotionSolve.  For example, define:

set_gse_alg_fig4

The implicit form can be converted to the following differential algebraic equations:

set_gse_alg_fig5

This is in the same DAE form shown in the previous remark.

See Also:

SET_GSE_NONZERO_ENTRY

Data Access Subroutines