`bdf` Module

digraph inheritance4178fd21b7 { bgcolor=transparent; rankdir=LR; size=""; "pyNastran.bdf.bdf.BDF" [URL="#pyNastran.bdf.bdf.BDF",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="NASTRAN BDF Reader/Writer/Editor class."]; "pyNastran.bdf.bdf.BDF_" -> "pyNastran.bdf.bdf.BDF" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf.BDF_" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="Base class for the BDF Reader/Writer/Editor class that's used by the"]; "pyNastran.bdf.bdf_methods.BDFMethods" -> "pyNastran.bdf.bdf.BDF_" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.get_card.GetCard" -> "pyNastran.bdf.bdf.BDF_" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddCards" -> "pyNastran.bdf.bdf.BDF_" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.write_mesh_file.WriteMeshs" -> "pyNastran.bdf.bdf.BDF_" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.uncross_reference.UnXrefMesh" -> "pyNastran.bdf.bdf.BDF_" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.Add0dElements" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.Add0dElements",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.Add1dElements" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.Add1dElements",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.Add2dElements" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.Add2dElements",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.Add3dElements" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.Add3dElements",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddAcoustic" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddAcoustic",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddAero" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddAero",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddBolts" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddBolts",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddCards" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="defines the add_cardname functions that use the object inits"]; "pyNastran.bdf.bdf_interface.add_card.AddCoords" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddContact" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddBolts" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.Add0dElements" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.Add1dElements" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.Add2dElements" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.Add3dElements" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddRigidElements" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddMaterial" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddAero" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddThermal" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddAcoustic" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddOptimization" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddSuperelements" -> "pyNastran.bdf.bdf_interface.add_card.AddCards" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.add_card.AddContact" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddContact",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddCoords" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddCoords",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddMaterial" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddMaterial",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddOptimization" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddOptimization",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddRigidElements" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddRigidElements",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddSuperelements" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddSuperelements",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.add_card.AddThermal" [URL="bdf_interface/pyNastran.bdf.bdf_interface.add_card.html#pyNastran.bdf.bdf_interface.add_card.AddThermal",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "pyNastran.bdf.bdf_interface.attributes.BDFAttributes" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="defines attributes of the BDF"]; "pyNastran.bdf.bdf_interface.cross_reference.XrefMesh" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="Links up the various cards in the BDF."]; "pyNastran.bdf.bdf_interface.attributes.BDFAttributes" -> "pyNastran.bdf.bdf_interface.cross_reference.XrefMesh" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.get_card.GetCard" [URL="bdf_interface/pyNastran.bdf.bdf_interface.get_card.html#pyNastran.bdf.bdf_interface.get_card.GetCard",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="defines various methods to access high level BDF data"]; "pyNastran.bdf.bdf_interface.get_methods.GetMethods" -> "pyNastran.bdf.bdf_interface.get_card.GetCard" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.get_methods.GetMethods" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="defines various methods to access low level BDF data"]; "pyNastran.bdf.bdf_interface.attributes.BDFAttributes" -> "pyNastran.bdf.bdf_interface.get_methods.GetMethods" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.safe_cross_reference.SafeXrefMesh" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="Links up the various cards in the BDF."]; "pyNastran.bdf.bdf_interface.cross_reference.XrefMesh" -> "pyNastran.bdf.bdf_interface.safe_cross_reference.SafeXrefMesh" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.uncross_reference.UnXrefMesh" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="Unlinks up the various cards in the BDF."]; "pyNastran.bdf.bdf_interface.safe_cross_reference.SafeXrefMesh" -> "pyNastran.bdf.bdf_interface.uncross_reference.UnXrefMesh" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.write_mesh.WriteMesh" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="Defines methods for writing cards"]; "pyNastran.bdf.bdf_interface.attributes.BDFAttributes" -> "pyNastran.bdf.bdf_interface.write_mesh.WriteMesh" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_interface.write_mesh_file.WriteMeshs" [URL="bdf_interface/pyNastran.bdf.bdf_interface.write_mesh_files.html#pyNastran.bdf.bdf_interface.write_mesh_file.WriteMeshs",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Defines methods for writing cards"]; "pyNastran.bdf.bdf_interface.write_mesh.WriteMesh" -> "pyNastran.bdf.bdf_interface.write_mesh_file.WriteMeshs" [arrowsize=0.5,style="setlinewidth(0.5)"]; "pyNastran.bdf.bdf_methods.BDFMethods" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="Has the following methods:"]; "pyNastran.bdf.bdf_interface.attributes.BDFAttributes" -> "pyNastran.bdf.bdf_methods.BDFMethods" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

Main BDF class. Defines:

BDF

class pyNastran.bdf.bdf.BDF(debug: bool | None = True, log: Any = None, mode: str = 'msc')[source]

Bases: BDF_

NASTRAN BDF Reader/Writer/Editor class.

Initializes the BDF object

Parameters:

debugbool/None; default=True

used to set the logger if no logger is passed in: True: logs debug/info/warning/error messages False: logs info/warning/error messages None: logs warning/error messages

loglogging module object / None

if log is set, debug is ignored and uses the settings the logging object has

modestr; default=’msc’

the type of Nastran valid_modes = {‘msc’, ‘nx’, ‘nasa95’, ‘mystran’, ‘zona’}

AEFact(aefact: int, msg: str = '') → AEFACT: gets an AEFACT

AELIST(aid: int, msg: str = '') → AELIST: gets an AELIST

AELink(link_id: int, msg: str = '') → AELINK: gets an AELINK

AEList(aelist: int, msg: str = '') → AELIST: gets an AELIST

AEParam(aeparm_name: str, msg: str = '') → AEPARM: gets an AEPARM

AEParam_int(aid: int, msg: str = '') → AEPARM: gets an AEPARM

AEStat(aestat_name: str, msg: str = '') → AESTAT: gets an AESTAT

AEStat_int(aid: int, msg: str = '') → AESTAT: gets an AESTAT

AESurf(aesurf_name: str, msg: str = '') → AESURF: gets an AESURF

AESurf_int(aesurf_id: int, msg: str = '') → AESURF: gets an AESURF

Acsid(msg: str = '') → Coord: gets the aerodynamic coordinate system

Aero(msg: str = '') → AERO: gets the AERO

Aeros(msg: str = '') → AEROS: gets the AEROS

CAero(eid: int, msg: str = '') → CAEROs: gets an CAEROx

CMethod(sid: int, msg: str = '') → EIGC: gets a METHOD (EIGC)

Coord(cid: int, msg: str = '') → Coord: gets an COORDx

DAREA(darea_id: int, msg: str = '') → DAREA: gets a DAREA

DConstr(oid: int, msg: str = '') → list[DCONSTR | DCONADD]: gets a DCONSTR

DDVal(oid: int, msg: str = '') → DDVAL: gets a DDVAL

DELAY(delay_id: int, msg: str = '') → DELAY: gets a DELAY

DEQATN(equation_id: int, msg: str = '') → DEQATN: gets a DEQATN

DLoad(sid: int, consider_dload_combinations: bool = True, msg: str = '') → DLOAD: Gets a DLOAD, TLOAD1, TLOAD2, etc. associated with the Case Control DLOAD entry

DMIG(dname: str, msg: str = '') → DMIG: gets a DMIG

DPHASE(dphase_id: int, msg: str = '') → DPHASE: gets a DPHASE

DResp(dresp_id: int, msg: str = '') → DRESP1 | DRESP2 | DRESP3: gets a DRESPx

DVcrel(dv_id: int, msg: str = '') → DVCREL1 | DVCREL2: gets a DVCREL1/DVCREL2

DVmrel(dv_id: int, msg: str = '') → DVMREL1 | DVMREL2: gets a DVMREL1/DVMREL2

DVprel(dv_id: int, msg: str = '') → DVPREL1 | DVPREL2: gets a DVPREL1/DVPREL2

Desvar(desvar_id: int, msg: int = '') → DESVAR: gets a DESVAR

Element(eid: int, msg: str = '') → Any

Gets an element

Doesn’t get rigid (RROD, RBAR, RBE2, RBE3, RBAR, RBAR1, RSPLINE, RSSCON) or mass (CMASS1, CONM2)

Elements(eids: list[int], msg: str = '') → list[Any]

Gets an series of elements

Doesn’t get rigid (RROD, RBAR, RBE2, RBE3, RBAR, RBAR1, RSPLINE, RSSCON) or mass (CMASS1, CONM2)

EmptyNode(nid: int, msg: str = '') → GRID | SPOINT | EPOINT | None

Gets a GRID/SPOINT/EPOINT object, but allows for empty nodes (i.e., the CTETRA10 supports empty nodes, but the CTETRA4 does not).

Parameters:

nidint / None: the node id 0, None : indicate blank
msgstr; default=’’: a debugging message

EmptyNodes(nids: list[int], msg: str = '') → list[GRID | SPOINT | EPOINT | None]: Returns a series of node objects given a list of IDs

FLFACT(sid: int, msg: str = '') → FLFACT: gets an FLFACT

Flutter(fid: int, msg: str = '') → FLUTTER: gets a FLUTTER

Gust(sid: int, msg: str = '') → GUST: gets a GUST

HyperelasticMaterial(mid: int, msg: str = '') → MATHE | MATHP: gets a hyperelastic material

Gets an LOAD or FORCE/PLOAD4/etc.

Parameters:

sidint: the LOAD id
consider_load_combinationsbool; default=True: LOADs should not be considered when referenced from an LOAD card from a case control, True should be used.
msgstr: additional message to print when failing

MPC(mpc_id: int, consider_mpcadd: bool = True, msg: str = '') → MPC | MPCADD

Gets an MPCADD or MPC

Parameters:

mpc_idint: the MPC id
consider_mpcaddbool; default=True: MPCADDs should not be considered when referenced from an MPCADD from a case control, True should be used.
msgstr: additional message to print when failing

Mass(eid: int, msg: str = '') → CMASS1 | CMASS2 | CMASS3 | CMASS4 | CONM1 | CONM2: gets a mass element (CMASS1, CONM2)

Material(mid: int, msg: str = '') → Material | ThermalMaterial: gets a structural or thermal material

Materials(mids, msg='') → list[Material]: gets one or more Materials

Method(sid: int, msg: str = '') → EIGR | EIGRL: gets a METHOD (EIGR, EIGRL)

NLParm(nlparm_id: int, msg: str = '') → NLPARM: gets an NLPARM

NSM(nsm_id: int, consider_nsmadd: bool = True, msg: str = '') → NSM | NSM1 | NSML | NSML1 | NSMADD

Gets an LOAD or FORCE/PLOAD4/etc.

Parameters:

nsm_idint: the LOAD id
consider_nsmaddbool; default=True: NSMADDs should not be considered when referenced from an NSM card from a case control, True should be used.
msgstr: additional message to print when failing

Node(nid: int, msg: str = '') → GRID | SPOINT | EPOINT

Gets a GRID/SPOINT/EPOINT object. This method does not allow for empty nodes (i.e., the CTETRA10 supports empty nodes, but the CTETRA4 does not).

Parameters:

nidint: the node id
msgstr; default=’’: a debugging message

Nodes(nids: list[int], msg: str = '') → list[GRID | SPOINT | EPOINT]: Returns a series of node objects given a list of IDs

PAero(pid: int, msg: str = '') → PAEROs: gets a PAEROx

Phbdy(pid: int, msg: str = '') → PHBDY: gets a PHBDY

Point(nid: int, msg: str = '') → POINT: Returns a POINT card

Points(nids: list[int], msg: str = '') → list[POINT]: Returns a series of POINT objects given a list of IDs

Properties(pids: list[int], msg: str = '') → list[Any]: gets one or more elemental property (e.g. PSOLID, PLSOLID, PCOMP, PSHELL, PSHEAR); not mass property (PMASS)

Property(pid: int, msg: str = '') → Property: gets an elemental property (e.g. PSOLID, PLSOLID, PCOMP, PSHELL, PSHEAR); not mass property (PMASS)

PropertyMass(pid: int, msg: str = '') → PMASS: gets a mass property (PMASS)

RandomTable(table_id: int, msg: str = '') → TABRND1 | TABRNDG: gets a TABRND1 / TABRNDG

RigidElement(eid: int, msg: str = '') → RigidElement: gets a rigid element (RBAR, RBE1, RBE2, RBE3, RBAR, RBAR1, RROD, RSPLINE, RSSCON)

SET1(set_id: int, msg: str = '') → SET1: gets a SET1

SPC(spc_id: int, consider_spcadd: bool = True, msg: str = '') → SPC | SPC1 | SPCADD

Gets an SPCADD or SPC

Parameters:

spc_idint: the SPC id
consider_spcaddbool; default=True: SPCADDs should not be considered when referenced from an SPCADD from a case control, True should be used.
msgstr: additional message to print when failing

Set(sid: int, msg: str = '') → SET1 | SET3: gets a SET, SET1, SET2, or SET3 card

Spline(eid: int, msg: str = '') → SPLINEs: gets a SPLINEx

StructuralMaterial(mid, msg='') → Material: gets a structural material

Table(tid, msg='') → TABLES1 | TABLEST | TABLEH1 | TABLEHT: gets a TABLES1, TABLEST, TABLEH1, TABLEHT

TableD(tid: int, msg: str = '') → TABLED1 | TABLED2 | TABLED3 | TABLED4: gets a TABLEDx (TABLED1, TABLED2, TABLED3, TABLED4)

TableM(table_id: int, msg: str = '') → TABLEM1 | TABLEM2 | TABLEM3 | TABLEM4: gets a TABLEx (TABLEM1, TABLEM2, TABLEM3, TABLEM4)

ThermalMaterial(mid: int, msg: str = '') → MAT4 | MAT5: gets a thermal material

Trim(trim_id: int, msg: str = '') → TRIM: gets an TRIM

add_accel(sid, N, direction, locs, vals, cid=0, comment='') → ACCEL

Creates an ACCEL card

Parameters:

sidint: load id
N(3, ) float ndarray: the acceleration vector in the cid frame
directionstr: Component direction of acceleration variation {X, Y, Z}
locslist[float]: Location along direction DIR in coordinate system CID for specification of a load scale factor.
valslist[float]: The load scale factor associated with location LOCi
cidint; default=0: the coordinate system for the load
commentstr; default=’’: a comment for the card

add_accel1(sid, scale, N, nodes, cid=0, comment='') → ACCEL1

Creates an ACCEL1 card

Parameters:

sidint: load id
scalefloat: scale factor for load
N(3, ) float ndarray: the acceleration vector in the cid frame
directionstr: Component direction of acceleration variation {X, Y, Z}
nodeslist[int]: the nodes to apply acceleration to
cidint; default=0: the coordinate system for the load
commentstr; default=’’: a comment for the card

add_acmodl(infor, fset, sset, normal=0.5, olvpang=60.0, search_unit='REL', intol=0.2, area_op=0, ctype='STRONG', method='BW', sk_neps=0.5, dsk_neps=0.75, all_set='NO', inter='DIFF', nastran_version='nx', comment: str = '') → ACMODL

add_acplnw(sid: int, form: str, scale: float, real: int | float, imag: int | float, cid1: int, xyz: list[float], cid2: int, nxyz: list[float], comment: str = '') → None

add_acsrce(sid, excite_id, rho, b, delay=0, dphase=0, power=0, comment='') → ACSRCE

Creates an ACSRCE card

Parameters:

sidint

load set id number (referenced by DLOAD)

excite_idint

Identification number of a DAREA or SLOAD entry that lists each degree of freedom to apply the excitation and the corresponding scale factor, A, for the excitation

rhofloat

Density of the fluid

bfloat

Bulk modulus of the fluid

delayint; default=0

Time delay, τ.

dphaseint / float; default=0

the dphase; if it’s 0/blank there is no phase lag float : delay in units of time int : delay id

powerint; default=0

Power as a function of frequency, P(f). float : value of P(f) used over all frequencies for all

degrees of freedom in EXCITEID entry.

intTABLEDi entry that defines P(f) for all degrees of: freedom in EXCITEID entry.

commentstr; default=’’

a comment for the card

add_aecomp(name: str, list_type: list[str], lists: list[int], comment: str = '') → AECOMP

Creates an AECOMP card

Parameters:

namestr: the name of the component
list_typestr: One of CAERO, AELIST or CMPID for aerodynamic components and SET1 for structural components. Aerodynamic components are defined on the aerodynamic ks-set mesh while the structural components are defined on the g-set mesh.
listslist[int, int, …]; int: The identification number of either SET1, AELIST or CAEROi entries that define the set of grid points that comprise the component
commentstr; default=’’: a comment for the card

add_aecompl(name: str, labels: list[str], comment: str = '') → AECOMPL

Creates an AECOMPL card

Parameters:

namestr: the name of the component
labelslist[str, str, …]; str: A string of 8 characters referring to the names of other components defined by either AECOMP or other AECOMPL entries.
commentstr; default=’’: a comment for the card

add_aefact(sid, fractions, comment='') → AEFACT

Creates an AEFACT card, which is used by the CAEROx / PAEROx card to adjust the spacing of the sub-paneleing (and grid point paneling in the case of the CAERO3).

Parameters:

sidint: unique id
fractionslist[float, …, float]: list of percentages
commentstr; default=’’: a comment for the card

add_aeforce(mach: float, sym_xz: str, sym_xy: str, ux_id: int, mesh: str, force: int, dmik: str, perq: str) → None: adds an AEPRESS card

add_aelink(aelink_id: int, label: str, independent_labels: list[str], linking_coefficients: list[float], comment: str = '') → AELINK

Creates an AELINK card, which defines an equation linking AESTAT and AESURF cards

Parameters:

aelink_idint: unique id
labelstr: name of the dependent AESURF card
independent_labelslist[str, …, str]: name for the independent variables (AESTATs)
linking_coefficientslist[float]: linking coefficients
commentstr; default=’’: a comment for the card

add_aelist(sid: int, elements: list[int], comment: str = '') → AELIST

Creates an AELIST card, which defines the aero boxes for an AESURF/SPLINEx.

Parameters:

sidint: unique id
elementslist[int, …, int]: list of box ids
commentstr; default=’’: a comment for the card

add_aeparm(aeparm_id, label, units, comment='') → AEPARM

Creates an AEPARM card, which defines a new trim variable.

Parameters:

aeparm_idint: the unique id
labelstr: the variable name
unitsstr: unused by Nastran
commentstr; default=’’: a comment for the card

add_aepress(mach, sym_xz: str, sym_xy: str, ux_id: int, dmij: str, dmiji: str) → None: adds an AEPRESS card

add_aero(velocity: float, cref: float, rho_ref: float, acsid: int = 0, sym_xz: int = 0, sym_xy: int = 0, comment: str = '') → AERO

Creates an AERO card

Parameters:

velocityfloat: the airspeed
creffloat: the aerodynamic chord
rho_reffloat: FLFACT density scaling factor
acsidint; default=0: aerodyanmic coordinate system
sym_xzint; default=0: xz symmetry flag (+1=symmetry; -1=antisymmetric)
sym_xyint; default=0: xy symmetry flag (+1=symmetry; -1=antisymmetric)
commentstr; default=’’: a comment for the card

add_aeros(cref, bref, sref, acsid=0, rcsid=0, sym_xz=0, sym_xy=0, comment='') → AEROS

Creates an AEROS card

Parameters:

creffloat: the aerodynamic chord
breffloat: the wing span
sreffloat: the wing area
acsidint; default=0: aerodyanmic coordinate system
rcsidint; default=0: coordinate system for rigid body motions
sym_xzint; default=0: xz symmetry flag (+1=symmetry; -1=antisymmetric)
sym_xyint; default=0: xy symmetry flag (+1=symmetry; -1=antisymmetric)
commentstr; default=’’: a comment for the card

add_aestat(aestat_id: int, label: str, comment: str = '') → AESTAT

Creates an AESTAT card, which is a variable to be used in a TRIM analysis

Parameters:

aestat_idint: unique id
labelstr: name for the id
commentstr; default=’’: a comment for the card

add_aesurf(aesid, label, cid1, aelist_id1, cid2=None, aelist_id2=None, eff=1.0, ldw='LDW', crefc=1.0, crefs=1.0, pllim=-1.5707963267948966, pulim=1.5707963267948966, hmllim: float | None = None, hmulim: float | None = None, tqllim: int = None, tqulim: int = 0, comment='') → AESURF

Creates an AESURF card, which defines a control surface

Parameters:

aesidint: controller number
labelstr: controller name
cid1 / cid2int / None: coordinate system id for primary/secondary control surface
aelist_id1 / aelist_id2int / None: AELIST id for primary/secondary control surface
efffloat; default=1.0: Control surface effectiveness
ldwstr; default=’LDW’: Linear downwash flag; [‘LDW’, ‘NODLW’]
crefcfloat; default=1.0: reference chord for the control surface
crefsfloat; default=1.0: reference area for the control surface
pllim / pulimfloat; default=-pi/2 / pi/2: Lower/Upper deflection limits for the control surface in radians
hmllim / hmulimOptional[float]; default=None: Lower/Upper hinge moment limits for the control surface in force-length units
tqllim / tqulimint; default=0: Set identification numbers of TABLEDi entries that provide the lower/upper deflection limits for the control surface as a function of the dynamic pressure
commentstr; default=’’: a comment for the card

add_aesurfs(aesid, label, list1, list2, comment='') → AESURFS

Creates an AESURFS card

Parameters:

aesidint: the unique id
labelstr: the AESURF name
list1 / list2int / None: the list (SET1) of node ids for the primary/secondary control surface(s) on the AESURF card
commentstr; default=’’: a comment for the card

add_amlreg(rid: int, sid: int, name: str, infid: list[int], nlayers: int = 5, radsurf: str = 'AML', comment: str = '') → AMLREG

AMLREG	RID	SID	Name/Descriptor
	NL	RADSURF	INFID1	INFID2	INFID3

Parameters:

rid: int

AML region identification number

sidint

Surface identification number

namestr

The Name/Descriptor is an optional character string

infidlist[int]

Identification number of an infinite plane. Up to three (3) infinite planes are considered for an AML region. The infinite planes are used when acoustic results are to be computed exterior to the AML region. (Integer >= 0; Default = 0) See Remark 5.

nlayersint; default=5

Number of layers of extrusion to be formed by solver

radsurfstr; default=’AML’

Radiation surface type

1/AML: the pressure and velocities on the AML boundary: are used to compute results in the far field.
2/PHYB: the pressure and velocities on the physical: boundary (that is, all free fluid faces with the exception of faces on the AML and the infinite planes) are used to compute results in the far field.

0/NONE: the region does not radiate.

add_aset(ids, components, comment='') → ASET | ASET1

Creates an ASET/ASET1 card, which defines the degree of freedoms that will be retained during an ASET modal reduction.

Parameters:

idslist[int]: the GRID/SPOINT ids
componentslist[str]; str: the degree of freedoms to be retained (e.g., ‘1’, ‘123’) if a list is passed in, a ASET is made if a str is passed in, a ASET1 is made
commentstr; default=’’: a comment for the card

Notes

the length of components and ids must be the same

add_aset1(ids, components, comment='') → ASET | ASET1

add_axic(nharmonics, comment='') → AXIC: Creates a AXIC card

add_baror(pid, is_g0, g0, x, offt='GGG', comment: str = '') → BAROR

add_bconp(contact_id, slave, master, sfac, fric_id, ptype, cid, comment='') → BCONP: Creates a BCONP card

add_bcrpara(crid, surf='TOP', offset=None, Type='FLEX', grid_point=0, comment='') → BCRPARA

Creates a BCRPARA card

Parameters:

cridint: CRID Contact region ID.
offsetfloat; default=None: Offset distance for the contact region (Real > 0.0). None : OFFSET value in BCTPARA entry
surfstr; default=’TOP’: SURF Indicates the contact side. See Remark 1. {‘TOP’, ‘BOT’; )
Typestr; default=’FLEX’: Indicates whether a contact region is a rigid surface if it is used as a target region. {‘RIGID’, ‘FLEX’}. This is not supported for SOL 101.
grid_pointint; default=0: Control grid point for a target contact region with TYPE=RIGID or when the rigid-target algorithm is used. The grid point may be used to control the motion of a rigid surface. (Integer > 0). This is not supported for SOL 101.
commentstr; default=’’: a comment for the card

add_bctadd(csid, contact_sets, comment='') → BCTADD: Creates a BCTADD card

add_bctpara(csid, params, comment='') → BCTPARA: Creates a BCTPARA card

add_bctset(csid, sids, tids, frictions, min_distances, max_distances, comment='', sol=101) → BCTSET: Creates a BCTSET card

add_bfric(friction_id, mu1, fstiff=None, comment='')

add_blseg(line_id, nodes, comment='') → BLSEG: Creates a BLSEG card

add_bndgrid(components: str, values: list[int], comment: str = '') → None

add_bolt_msc()

add_bolt_nx(bolt_id: int, element_type: int, eids: list | None = None, nids: list | None = None, csid=None, idir=None, comment: str = '') → BOLT

add_boltfor_nx(sid: int, load_value: float, bolt_ids: list[int], comment: str = '') → BOLTFOR

add_boltseq_nx(sid: int, s_nos: list[int], b_ids: list[int], n_incs: list[int] | None = None, comment: str = '') → BOLTSEQ

add_bset(ids, components, comment='') → BSET | BSET1

Creates an BSET/BSET1 card, which defines the degree of freedoms that will be fixed during a generalized dynamic reduction or component model synthesis calculation.

Parameters:

idslist[int]: the GRID/SPOINT ids
componentslist[str]; str: the degree of freedoms to be fixed (e.g., ‘1’, ‘123’) if a list is passed in, a ASET is made if a str is passed in, a ASET1 is made
commentstr; default=’’: a comment for the card

Notes

the length of components and ids must be the same

add_bset1(ids, components, comment='') → BSET | BSET1

add_bsurf(sid, eids, comment='') → BSURF: Creates a BSURF card

add_bsurfs(bsurfs_id, eids, g1s, g2s, g3s, comment='') → BSURFS: Creates a BSURFS card

add_bulk_lines(lines: list[str]) → None

add_caabsf(eid, pid, nodes, comment='') → CHACAB

add_caero1(eid: int, pid: int, igroup: int, p1: Any, x12: float, p4: Any, x43: float, cp: int = 0, nspan: int = 0, lspan: int = 0, nchord: int = 0, lchord: int = 0, comment: str = '') → CAERO1

Defines a CAERO1 card, which defines a simplified lifting surface (e.g., wing/tail).

Parameters:

eidint: element id
pidint: int : PAERO1 ID
igroupint: Group number
p1(1, 3) ndarray float: xyz location of point 1 (leading edge; inboard)
p4(1, 3) ndarray float: xyz location of point 4 (leading edge; outboard)
x12float: distance along the flow direction from node 1 to node 2; (typically x, root chord)
x43float: distance along the flow direction from node 4 to node 3; (typically x, tip chord)
cpint; default=0: int : coordinate system
nspanint; default=0: int > 0 : N spanwise boxes distributed evenly int = 0 : use lchord
nchordint; default=0: int > 0 : N chordwise boxes distributed evenly int = 0 : use lchord
lspanint, AEFACT; default=0: int > 0 : AEFACT reference for non-uniform nspan int = 0 : use nspan
lchordint, AEFACT; default=0: int > 0 : AEFACT reference for non-uniform nchord int = 0 : use nchord
commentstr; default=’’: a comment for the card

add_caero2(eid: int, pid: int, igroup: int, p1: list[float], x12: float, cp: int = 0, nsb: int = 0, nint: int = 0, lsb: int = 0, lint: int = 0, comment: str = '') → CAERO2

Defines a CAERO2 card, which defines a slender body (e.g., fuselage/wingtip tank).

Parameters:

eidint: element id
pidint, PAERO2: int : PAERO2 ID
igroupint: Group number
p1(1, 3) ndarray float: xyz location of point 1 (forward position)
x12float: length of the CAERO2
cpint; default=0: int : coordinate system
nsbint; default=0: Number of slender body elements
lsbint; default=0: AEFACT id for defining the location of the slender body elements
nintint; default=0: Number of interference elements
lintint; default=0: AEFACT id for defining the location of interference elements
commentstr; default=’’: a comment for the card

add_caero3(eid, pid, list_w, p1, x12, p4, x43, cp=0, list_c1=None, list_c2=None, comment='') → CAERO3: Creates a CAERO3 card

add_caero4(eid, pid, p1, x12, p4, x43, cp=0, nspan=0, lspan=0, comment='') → CAERO4

Defines a CAERO4 card, which defines a strip theory surface.

Parameters:

eidint: element id
pidint: int : PAERO4 ID
p1(1, 3) ndarray float: xyz location of point 1 (leading edge; inboard)
p4(1, 3) ndarray float: xyz location of point 4 (leading edge; outboard)
x12float: distance along the flow direction from node 1 to node 2 (typically x, root chord)
x43float: distance along the flow direction from node 4 to node 3 (typically x, tip chord)
cpint; default=0: int : coordinate system
nspanint; default=0: int > 0 : N spanwise boxes distributed evenly int = 0 : use lchord
lspanint; default=0: int > 0 : AEFACT reference for non-uniform nspan int = 0 : use nspan
commentstr; default=’’: a comment for the card

add_caero5(eid: int, pid: int, p1: list[float], x12: float, p4: list[float], x43: float, cp: int = 0, nspan: int = 0, lspan: int = 0, ntheory: int = 0, nthick: int = 0, comment: str = '') → CAERO5: Creates a CAERO5 card

add_caero7(eid: int, label: str, p1: ndarray, x12: float, p4: ndarray, x43: float, cp: int = 0, nspan: int = 0, nchord: int = 0, lspan: int = 0, p_airfoil: Any = None, ztaic: Any = None, comment: str = '') → CAERO7

add_card(card_lines: list[str], card_name: str, comment: str = '', ifile=None, is_list: bool = True, has_none: bool = True) → Any

Adds a card object to the BDF object.

Parameters:

card_lines: list[str]: the list of the card fields
card_namestr: the card_name -> ‘GRID’
commentstr: an optional the comment for the card
is_listbool, optional: False : input is a list of card fields -> [‘GRID’, 1, None, 3.0, 4.0, 5.0] True : input is list of card_lines -> [‘GRID, 1,, 3.0, 4.0, 5.0’]
has_nonebool; default=True: can there be trailing Nones in the card data (e.g. [‘GRID’, 1, 2, 3.0, 4.0, 5.0, None]) can there be trailing Nones in the card data (e.g. [‘GRID’, 1, 2, 3.0, 4.0, 5.0, ‘])

Returns:

card_objectBDFCard(): the card object representation of card

Note

this is a very useful method for interfacing with the code ..

Note

the card_object is not a card-type object…so not a GRID card or CQUAD4 object. It’s a BDFCard Object. However, you know the type (assuming a GRID), so just call the mesh.Node(nid) to get the Node object that was just created.

add_card_fields(card_lines, card_name, comment='', has_none=True)

Adds a card object to the BDF object.

Parameters:

card_lines: list[str]: the list of the card fields input is a list of card fields -> [‘GRID’, 1, 2, 3.0, 4.0, 5.0]
card_namestr: the card_name -> ‘GRID’
commentstr: an optional the comment for the card
has_nonebool; default=True: can there be trailing Nones in the card data (e.g. [‘GRID’, 1, 2, 3.0, 4.0, 5.0, None])

Returns:

card_objectBDFCard(): the card object representation of card

add_card_ifile(ifile: int, card_lines: list[str], card_name: str, comment: str = '', is_list: bool = True, has_none: bool = True) → Any: Same as add_card except it has an ifile parameter

add_card_lax(card_lines: list[str], card_name: str, comment: str = '', ifile=None, is_list: bool = True, has_none: bool = True) → Any: see add_card

add_card_lines(card_lines, card_name, comment='', has_none=True)

Adds a card object to the BDF object.

Parameters:

card_lines: list[str]: the list of the card fields input is list of card_lines -> [‘GRID, 1, 2, 3.0, 4.0, 5.0’]
card_namestr: the card_name -> ‘GRID’
commentstr; default=’’: an optional the comment for the card
has_nonebool; default=True: can there be trailing Nones in the card data (e.g. [‘GRID, 1, 2, 3.0, 4.0, 5.0, ‘])

add_cbar(eid: int, pid: int, nids: list[int], x: list[float] | None, g0: int | None, offt: str = 'GGG', pa: int = 0, pb: int = 0, wa: list[float] | None = None, wb: list[float] | None = None, comment: str = '', validate: bool = False) → CBAR

Adds a CBAR card

Parameters:

pidint: property id
nidslist[int]: node ids; connected grid points at ends A and B
xlist[float, float, float]: Components of orientation vector, from GA, in the displacement coordinate system at GA (default), or in the basic coordinate system
g0int: Alternate method to supply the orientation vector using grid point G0. Direction of is from GA to G0. is then transferred to End A
offtstr; default=’GGG’: Offset vector interpretation flag
pa / pbint; default=0: Pin Flag at End A/B. Releases the specified DOFs
wa / wblist[float, float, float]: Components of offset vectors from the grid points to the end points of the axis of the shear center
commentstr; default=’’: a comment for the card

add_cbarao(eid: int, scale: str, x: list[float], comment: str = '') → CBARAO

Creates a CBARAO card, which defines additional output locations for the CBAR card.

It also changes the OP2 element type from a CBAR-34 to a CBAR-100. However, it is ignored if there are no PLOAD1s in the model. Furthermore, the type is changed for the whole deck, regardless of whether there are PLOAD1s in the other load cases.

Parameters:

eidint: element id
scalestr: defines what x means LE : x is in absolute coordinates along the bar FR : x is in fractional
xlist[float]: the additional output locations len(x) <= 6
commentstr; default=’’: a comment for the card

Notes

MSC only

add_cbeam(eid: int, pid: int, nids: list[int], x: list[float] | None, g0: int | None, offt='GGG', bit=None, pa=0, pb=0, wa=None, wb=None, sa=0, sb=0, comment='') → CBEAM

Adds a CBEAM card

Parameters:

pidint: property id
nidslist[int]: node ids; connected grid points at ends A and B
xlist[float, float, float]: Components of orientation vector, from GA, in the displacement coordinate system at GA (default), or in the basic coordinate system
g0int: Alternate method to supply the orientation vector using grid point G0. Direction of is from GA to G0. is then transferred to End A
offtstr; default=’GGG’: Offset vector interpretation flag None : bit is active
bitfloat; default=None: Built-in twist of the cross-sectional axes about the beam axis at end B relative to end A. For beam p-elements ONLY! None : offt is active
pa / pbint; default=0: Pin Flag at End A/B. Releases the specified DOFs
wa / wblist[float, float, float]: Components of offset vectors from the grid points to the end points of the axis of the shear center
sa / sbint; default=0: Scalar or grid point identification numbers for the ends A and B, respectively. The degrees-of-freedom at these points are the warping variables . SA and SB cannot be specified for beam p-elements
commentstr; default=’’: a comment for the card

Notes

offt/bit are MSC specific fields

add_cbeam3(eid, pid, nids, x, g0, wa, wb, wc, tw, s, comment='') → CBEAM3: Creates a CBEAM3 card

add_cbend(eid, pid, nids, g0, x, geom, comment='') → CBEND: Creates a CBEND card

add_cbush(eid: int, pid: int, nids, x: list[float] | None, g0: int | None, cid=None, s: float = 0.5, ocid: int = -1, si: list[float] | None = None, comment='') → CBUSH

Creates a CBUSH card

Parameters:

eidint

Element id

pidint

Property id (PBUSH)

nidslist[int]

node ids; connected grid points at ends A and B The nodes may be coincident, but then cid is required.

xlist[float, float, float]; None

listthe directional vector used to define the stiffnesses: or damping from the PBUSH card

None : use g0

g0int/None

intthe directional vector used to define the stiffnesses: or damping from the PBUSH card

None : use x

cidint; default=None

Element coordinate system identification. A 0 means the basic coordinate system. If CID is blank, then the element coordinate system is determined from GO or Xi.

s: float; default=0.5

Location of spring damper (0 <= s <= 1.0)

ocidint; default=-1

Coordinate system identification of spring-damper offset. (Integer > -1; Default = -1, which means the offset point lies on the line between GA and GB)

silist[float, float, float]; default=None

Components of spring-damper offset in the OCID coordinate system if OCID > 0. None : [None, None, None]

commentstr; default=’’

a comment for the card

add_cbush1d(eid: int, pid: int, nids: list[int], cid: int | None = None, comment: str = '') → CBUSH1D: Creates a CBUSH1D card

add_cbush2d(eid: int, pid: int, nids: list[int], cid: int = 0, plane: str = 'XY', sptid: int | None = None, comment: str = '') → CBUSH2D: Creates a CBUSH2D card

add_cconeax(eid, pid, rings, comment='') → CCONEAX: Creates a CCONEAX card

add_cdamp1(eid: int, pid: int, nids: list[int], c1: int = 0, c2: int = 0, comment: str = '') → CDAMP1

Creates a CDAMP1 card

Parameters:

eidint: element id
pidint: property id (PDAMP)
nidslist[int]: node ids
c1 / c2int; default=0: DOF for nid1 / nid2
commentstr; default=’’: a comment for the card

add_cdamp2(eid: int, b: float, nids: list[int], c1: int = 0, c2: int = 0, comment: str = '') → CDAMP2

Creates a CDAMP2 card

Parameters:

eidint: element id
bfloat: damping
nidslist[int]: SPOINT ids node ids
c1 / c2int; default=0: DOF for nid1 / nid2
commentstr; default=’’: a comment for the card

add_cdamp3(eid: int, pid: int, nids: list[int], comment: str = '') → CDAMP3

Creates a CDAMP3 card

Parameters:

eidint: element id
pidint: property id (PDAMP)
nidslist[int]: SPOINT ids
commentstr; default=’’: a comment for the card

add_cdamp4(eid: int, b: float, nids: list[int], comment: str = '') → CDAMP4

Creates a CDAMP4 card

Parameters:

eidint: element id
bfloat: damping
nidslist[int]: SPOINT ids
commentstr; default=’’: a comment for the card

add_cdamp5(eid: int, pid: int, nids: list[int], comment: str = '') → CDAMP5

Creates a CDAMP5 card

Parameters:

eidint: element id
pidint: property id (PDAMP5)
nidslist[int]: GRID/SPOINT ids
commentstr; default=’’: a comment for the card

add_celas1(eid: int, pid: int, nids: list[int], c1: int = 0, c2: int = 0, comment: str = '') → CELAS1

Creates a CELAS1 card

Parameters:

eidint: element id
pidint: property id (PELAS)
nidslist[int]: node ids
c1 / c2int; default=0: DOF for nid1 / nid2
commentstr; default=’’: a comment for the card

add_celas2(eid: int, k: float, nids: list[int], c1: int = 0, c2: int = 0, ge: float = 0.0, s: float = 0.0, comment: str = '') → CELAS2

Creates a CELAS2 card

Parameters:

eidint: element id
kfloat: spring stiffness
nidslist[int]: SPOINT ids node ids
c1 / c2int; default=0: DOF for nid1 / nid2
geint; default=0.0: damping coefficient
sfloat; default=0.0: stress coefficient
commentstr; default=’’: a comment for the card

add_celas3(eid: int, pid: int, nids: list[int], comment: str = '') → CELAS3

Creates a CELAS3 card

Parameters:

eidint: element id
pidint: property id (PELAS)
nidslist[int]: SPOINT ids
commentstr; default=’’: a comment for the card

add_celas4(eid: int, k: float, nids: list[int], comment: str = '') → CELAS4

Creates a CELAS4 card

Parameters:

eidint: element id
kfloat: spring stiffness
nidslist[int]: SPOINT ids
commentstr; default=’’: a comment for the card

add_cfast(eid: int, pid: int, Type: str, ida: int, idb: int, gs=None, ga=None, gb=None, xs=None, ys=None, zs=None, comment: str = '') → CFAST: Creates a CFAST card

add_cfluid2(eid, ringfls, rho, b, harmonic) → None

add_cfluid3(eid, ringfls, rho, b, harmonic) → None

add_cfluid4(eid, ringfls, rho, b, harmonic) → None

add_cgap(eid: int, pid: int, nids: list[int], x: list[float] | None, g0: int | None, cid: int | None = None, comment: str = '') → CGAP

Creates a CGAP card

Parameters:

eidint: Element ID
pidint: Property ID (PGAP)
nidslist[int]: node ids; connected grid points at ends A and B
xlist[float, float, float]: Components of the orientation vector, from GA, in the displacement coordinate system at GA
g0int: GO Alternate method to supply the orientation vector using grid point GO. Direction of is from GA to GO
cidint; default=None: Element coordinate system identification number. CID must be specified if GA and GB are coincident (distance from GA to GB < 10^-4)
commentstr; default=’’: a comment for the card

add_chacab(eid, pid, nodes, comment='') → CHACAB

add_chacbr(eid, pid, nodes, comment='') → CHACBR

add_chbdye(eid, eid2, side, iview_front=0, iview_back=0, rad_mid_front=0, rad_mid_back=0, comment='') → CHBDYE

Creates a CHBDYE card

Parameters:

eidint: surface element ID number for a side of an element
eid2: int: a heat conduction element identification
side: int: a consistent element side identification number (1-6)
iview_front: int; default=0: a VIEW entry identification number for the front face
iview_back: int; default=0: a VIEW entry identification number for the back face
rad_mid_front: int; default=0: RADM identification number for front face of surface element
rad_mid_back: int; default=0: RADM identification number for back face of surface element
commentstr; default=’’: a comment for the card

add_chbdyg(eid, surface_type, nodes, iview_front=0, iview_back=0, rad_mid_front=0, rad_mid_back=0, comment='') → CHBDYG: Creates a CHBDYG card

add_chbdyp(eid, pid, surface_type, g1, g2, g0=0, gmid=None, ce=0, iview_front=0, iview_back=0, rad_mid_front=0, rad_mid_back=0, e1=None, e2=None, e3=None, comment='') → CHBDYP

Creates a CHBDYP card

Parameters:

eidint: Surface element ID
pidint: PHBDY property entry identification numbers. (Integer > 0)
surface_typestr: Surface type Must be {POINT, LINE, ELCYL, FTUBE, TUBE}
iview_frontint; default=0: A VIEW entry identification number for the front face.
iview_backint; default=0: A VIEW entry identification number for the back face.
g1 / g2int: Grid point identification numbers of grids bounding the surface
g0int; default=0: Orientation grid point
rad_mid_frontint: RADM identification number for front face of surface element
rad_mid_backint: RADM identification number for back face of surface element.
gmidint: Grid point identification number of a midside node if it is used with the line type surface element.
ceint; default=0: Coordinate system for defining orientation vector
e1 / e2 / e3float; default=None: Components of the orientation vector in coordinate system CE. The origin of the orientation vector is grid point G1.
commentstr; default=’’: a comment for the card

add_chexa(eid, pid, nids, comment='') → CHEXA8 | CHEXA20

Creates a CHEXA8/CHEXA20

Parameters:

eidint: element id
pidint: property id (PSOLID, PLSOLID)
nidslist[int]: node ids; n=8 or 20
commentstr; default=’’: a comment for the card

add_chexa1(eid, mid, nids, comment='') → CHEXA1: see CHEXA

add_chexa2(eid, mid, nids, comment='') → CHEXA2: see CHEXA

add_cihex1(eid, pid, nids, comment='') → CIHEX1: see CHEXA

add_cihex2(eid, pid, nids, comment='') → CIHEX2: see CHEXA

add_cload(sid, scale, scale_factors, load_ids, comment='') → CLOAD

Creates a CLOAD card

Parameters:

sidint: load id
scalefloat: overall scale factor
scale_factorslist[float]: individual scale factors (corresponds to load_ids)
load_idslist[int]: individual load_ids (corresponds to scale_factors)
commentstr; default=’’: a comment for the card

add_cmass1(eid: int, pid: int, nids: list[int], c1: int = 0, c2: int = 0, comment: str = '') → CMASS1

Creates a CMASS1 card

Parameters:

eidint: element id
pidint: property id (PMASS)
nidslist[int, int]: node ids
c1 / c2int; default=None: DOF for nid1 / nid2
commentstr; default=’’: a comment for the card

add_cmass2(eid: int, mass: float, nids: list[int], c1: int, c2: int, comment: str = '') → CMASS2

Creates a CMASS2 card

Parameters:

eidint: element id
massfloat: mass
nidslist[int]: node ids
c1 / c2int; default=None: DOF for nid1 / nid2
commentstr; default=’’: a comment for the card

add_cmass3(eid: int, pid: int, nids: list[int], comment: str = '') → CMASS3

Creates a CMASS3 card

Parameters:

eidint: element id
pidint: property id (PMASS)
nidslist[int]: SPOINT ids
commentstr; default=’’: a comment for the card

add_cmass4(eid: int, mass: float, nids: list[int], comment: str = '') → CMASS4

Creates a CMASS4 card

Parameters:

eidint: element id
massfloat: SPOINT mass
nidslist[int]: SPOINT ids
commentstr; default=’’: a comment for the card

add_cmfree(eid, s, s2, y, n) → None

add_conm1(eid: int, nid: int, mass_matrix: Any, cid=0, comment='') → CONM1

Creates a CONM1 card

Parameters:

eidint

element id

nidint

the node to put the mass matrix

mass_matrix(6, 6) float ndarray

the 6x6 mass matrix, M

cidint; default=0

the coordinate system for the mass matrix

commentstr; default=’’

a comment for the card

::

[M] = [M11 M21 M31 M41 M51 M61]: [ M22 M32 M42 M52 M62] [ M33 M43 M53 M63] [ M44 M54 M64] [ Sym M55 M65] [ M66]

add_conm2(eid: int, nid: int, mass: float, cid: int = 0, X: list[float] | None = None, I: list[float] | None = None, comment: str = '') → CONM2

Creates a CONM2 card

Parameters:

eidint: element id
nidint: node id
massfloat: the mass of the CONM2
cidint; default=0: coordinate frame of the offset (-1=absolute coordinates)
X(3, ) list[float]; default=None -> [0., 0., 0.]: xyz offset vector relative to nid
I(6, ) list[float]; default=None -> [0., 0., 0., 0., 0., 0.]: mass moment of inertia matrix about the CG I11, I21, I22, I31, I32, I33 = I
commentstr; default=’’: a comment for the card

add_conrod(eid: int, mid: int, nids: list[int], A: float = 0.0, j: float = 0.0, c: float = 0.0, nsm: float = 0.0, comment: str = '') → CONROD

Creates a CONROD card

Parameters:

eidint: element id
midint: material id
nidslist[int]: node ids
Afloat; default=0.: area
jfloat; default=0.: polar moment of inertia
cfloat; default=0.: stress factor
nsmfloat; default=0.: non-structural mass per unit length
commentstr; default=’’: a comment for the card

add_conv(eid, pconid, ta, film_node=0, cntrlnd=0, comment='') → CONV

Creates a CONV card

Parameters:

eidint: element id
pconidint: Convection property ID
midint: Material ID
talist[int]: Ambient points used for convection 0’s are allowed for TA2 and higher
film_nodeint; default=0: Point for film convection fluid property temperature
cntrlndint; default=0: Control point for free convection boundary condition
commentstr; default=’’: a comment for the card

add_convm(eid, pconvm, ta1, film_node=0, cntmdot=0, ta2=None, mdot=1.0, comment='') → CONVM

Creates a CONVM card

Parameters:

eidint: element id (CHBDYP)
pconidint: property ID (PCONVM)
midint: Material ID
ta1int: ambient point for convection
ta2int; default=None: None : ta1 ambient point for convection
film_nodeint; default=0
cntmdotint; default=0: control point used for controlling mass flow 0/blank is only allowed when mdot > 0
mdotfloat; default=1.0: a multiplier for the mass flow rate in case there is no point associated with the CNTRLND field required if cntmdot = 0
commentstr; default=’’: a comment for the card

add_cord1c(cid: int, g1: int, g2: int, g3: int, comment: str = '') → CORD1C

Creates the CORD1C card, which defines a cylindrical coordinate system using 3 GRID points.

Parameters:

cidint: the coordinate id
g1int: grid point 1
g2int: grid point 2
g3int: grid point 3
commentstr; default=’’: a comment for the card

add_cord1r(cid: int, g1: int, g2: int, g3: int, comment: str = '') → CORD1R

Creates the CORD1R card, which defines a rectangular coordinate system using 3 GRID points.

Parameters:

cidint: the coordinate id
g1int: grid point 1
g2int: grid point 2
g3int: grid point 3
commentstr; default=’’: a comment for the card

add_cord1s(cid: int, g1: int, g2: int, g3: int, comment: str = '') → CORD1S

Creates the CORD1S card, which defines a spherical coordinate system using 3 GRID points.

Parameters:

cidint: the coordinate id
g1int: grid point 1
g2int: grid point 2
g3int: grid point 3
commentstr; default=’’: a comment for the card

add_cord2c(cid: int, origin: list[float] | Any | None, zaxis: list[float] | Any | None, xzplane: list[float] | Any | None, rid: int = 0, setup: bool = True, comment: str = '') → CORD2C

Creates the CORD2C card, which defines a cylindrical coordinate system using 3 vectors.

Parameters:

cidint: coordinate system id
ridint; default=0: the referenced coordinate system that defines the system the vectors
originlist[float, float, float]: the origin of the coordinate system
zaxislist[float, float, float]: the z-axis of the coordinate system
xzplanelist[float, float, float]: a point on the xz plane
commentstr; default=’’: a comment for the card

add_cord2r(cid: int, origin: list[float] | Any | None, zaxis: list[float] | Any | None, xzplane: list[float] | Any | None, rid: int = 0, setup: bool = True, comment: str = '') → CORD2R

Creates the CORD2R card, which defines a rectangular coordinate system using 3 vectors.

Parameters:

cidint: coordinate system id
ridint; default=0: the referenced coordinate system that defines the system the vectors
originlist[float, float, float]: the origin of the coordinate system
zaxislist[float, float, float]: the z-axis of the coordinate system
xzplanelist[float, float, float]: a point on the xz plane
commentstr; default=’’: a comment for the card

add_cord2s(cid: int, origin: list[float] | Any | None, zaxis: list[float] | Any | None, xzplane: list[float] | Any | None, rid: int = 0, setup: bool = True, comment: str = '') → CORD2S

Creates the CORD2C card, which defines a spherical coordinate system using 3 vectors.

Parameters:

cidint: coordinate system id
originlist[float, float, float]: the origin of the coordinate system
zaxislist[float, float, float]: the z-axis of the coordinate system
xzplanelist[float, float, float]: a point on the xz plane
ridint; default=0: the referenced coordinate system that defines the system the vectors
commentstr; default=’’: a comment for the card

add_cord3g(cid: int, method_es, method_int, form, thetas: list[int], rid: int, comment: str = '') → CORD3G: Creates a CORD3G card

add_cpenta(eid, pid, nids, comment='') → CPENTA6 | CPENTA15

Creates a CPENTA6/CPENTA15

Parameters:

eidint: element id
pidint: property id (PSOLID, PLSOLID)
nidslist[int]: node ids; n=6 or 15
commentstr; default=’’: a comment for the card

add_cplstn3(eid, pid, nids, theta=0.0, comment='') → CPLSTN3: Creates a CPLSTN4 card

add_cplstn4(eid, pid, nids, theta=0.0, comment='') → CPLSTN4: Creates a CPLSTN4 card

add_cplstn6(eid, pid, nids, theta=0.0, comment='') → CPLSTN6: Creates a CPLSTN6 card

add_cplstn8(eid, pid, nids, theta=0.0, comment='') → CPLSTN8: Creates a CPLSTN8 card

add_cplsts3(eid, pid, nids, theta=0.0, tflag=0, T1=None, T2=None, T3=None, comment='') → CPLSTS3: Creates a CPLSTS3 card

add_cplsts4(eid, pid, nids, theta=0.0, tflag=0, T1=None, T2=None, T3=None, T4=None, comment='') → CPLSTS4: Creates a CPLSTS4 card

add_cplsts6(eid, pid, nids, theta=0.0, tflag=0, T1=None, T2=None, T3=None, T4=None, T5=None, T6=None, comment='') → CPLSTS6: Creates a CPLSTS6 card

add_cplsts8(eid, pid, nids, theta=0.0, tflag=0, T1=None, T2=None, T3=None, T4=None, T5=None, T6=None, T7=None, T8=None, comment='') → CPLSTS8: Creates a CPLSTS8 card

add_cpyram(eid, pid, nids, comment='') → CPYRAM5 | CPYRAM13

Creates a CPYRAM5/CPYRAM13

Parameters:

eidint: element id
pidint: property id (PSOLID, PLSOLID)
nidslist[int]: node ids; n=5 or 13
commentstr; default=’’: a comment for the card

add_cquad(eid, pid, nids, theta_mcid=0.0, comment='') → CQUAD

Creates a CQUAD card

Parameters:

eidint

element id

pidint

property id (PSHELL/PCOMP/PCOMPG)

nidslist[int, int, int, int, int/None, int/None,

int/None, int/None, int/None]

node ids

theta_mcidfloat; default=0.0

floatmaterial coordinate system angle (theta) is defined: relative to the element coordinate system
intx-axis from material coordinate system angle defined by: mcid is projected onto the element

commentstr; default=’’

a comment for the card

add_cquad4(eid, pid, nids, theta_mcid=0.0, zoffset=0.0, tflag=0, T1=None, T2=None, T3=None, T4=None, comment='') → CQUAD4

Creates a CQUAD4 card

Parameters:

eidint

element id

pidint

property id (PSHELL/PCOMP/PCOMPG)

nidslist[int, int, int, int]

node ids

zoffsetfloat; default=0.0

Offset from the surface of grid points to the element reference plane. Requires MID1 and MID2.

theta_mcidfloat; default=0.0

floatmaterial coordinate system angle (theta) is defined: relative to the element coordinate system
intx-axis from material coordinate system angle defined by: mcid is projected onto the element

tflagint; default=0

0 : Ti are actual user specified thicknesses 1 : Ti are fractions relative to the T value of the PSHELL

T1 / T2 / T3 / T4float; default=None

If it is not supplied, then T1 through T4 will be set equal to the value of T on the PSHELL entry.

commentstr; default=’’

a comment for the card

add_cquad8(eid, pid, nids, theta_mcid=0.0, zoffset=0.0, tflag=0, T1=None, T2=None, T3=None, T4=None, comment='') → CQUAD8

Creates a CQUAD8 card

Parameters:

eidint

element id

pidint

property id (PSHELL/PCOMP/PCOMPG)

nidslist[int, int, int, int, int/None, int/None, int/None, int/None]

node ids

zoffsetfloat; default=0.0

Offset from the surface of grid points to the element reference plane. Requires MID1 and MID2.

theta_mcidfloat; default=0.0

floatmaterial coordinate system angle (theta) is defined: relative to the element coordinate system
intx-axis from material coordinate system angle defined by: mcid is projected onto the element

tflagint; default=0

0 : Ti are actual user specified thicknesses 1 : Ti are fractions relative to the T value of the PSHELL

T1 / T2 / T3 / T4float; default=None

If it is not supplied, then T1 through T4 will be set equal to the value of T on the PSHELL entry.

commentstr; default=’’

a comment for the card

add_cquadr(eid, pid, nids, theta_mcid=0.0, zoffset=0.0, tflag=0, T1=None, T2=None, T3=None, T4=None, comment='') → CQUADR

Creates a CQUADR card

Parameters:

eidint

element id

pidint

property id (PSHELL/PCOMP/PCOMPG)

nidslist[int, int, int, int]

node ids

zoffsetfloat; default=0.0

Offset from the surface of grid points to the element reference plane. Requires MID1 and MID2.

theta_mcidfloat; default=0.0

floatmaterial coordinate system angle (theta) is defined: relative to the element coordinate system
intx-axis from material coordinate system angle defined by: mcid is projected onto the element

tflagint; default=0

0 : Ti are actual user specified thicknesses 1 : Ti are fractions relative to the T value of the PSHELL

T1 / T2 / T3 / T4float; default=None

If it is not supplied, then T1 through T4 will be set equal to the value of T on the PSHELL entry.

commentstr; default=’’

a comment for the card

add_cquadx(eid, pid, nids, theta_mcid=0.0, comment='') → CQUADX: Creates a CQUADX card

add_cquadx4(eid, pid, nids, theta=0.0, comment='') → CQUADX4: Creates a CQUADX4 card

add_cquadx8(eid, pid, nids, theta=0.0, comment='') → CQUADX8: Creates a CQUADX8 card

add_crac2d(eid, pid, nids, comment='') → CRAC2D: Creates a PRAC2D card

add_crac3d(eid, pid, nids, comment='') → CRAC3D: Creates a CRAC3D card

add_creep(mid, T0, exp, form, tidkp, tidcp, tidcs, thresh, Type, a, b, c, d, e, f, g, comment='') → CREEP: Creates a CREEP card

add_crod(eid: int, pid: int, nids: list[int], comment: str = '') → CROD

Creates a CROD card

Parameters:

eidint: element id
pidint: property id (PROD)
nidslist[int]: node ids
commentstr; default=’’: a comment for the card

add_cset(ids, components, comment='') → CSET | CSET1

Creates an CSET/CSET1 card, which defines the degree of freedoms that will be free during a generalized dynamic reduction or component model synthesis calculation.

Parameters:

idslist[int]: the GRID/SPOINT ids
componentslist[str]; str: the degree of freedoms to be free (e.g., ‘1’, ‘123’) if a list is passed in, a CSET is made if a str is passed in, a CSET1 is made
commentstr; default=’’: a comment for the card

Notes

the length of components and ids must be the same

add_cset1(ids, components, comment='') → CSET | CSET1: See also

add_cset

add_cshear(eid, pid, nids, comment='') → CSHEAR

Creates a CSHEAR card

Parameters:

eidint: element id
pidint: property id (PSHEAR)
nidslist[int, int, int, int]: node ids
commentstr; default=’’: a comment for the card

add_csschd(sid, aesid, lschd, lalpha=None, lmach=None, comment='') → CSSCHD

Creates an CSSCHD card, which defines a specified control surface deflection as a function of Mach and alpha (used in SOL 144/146).

Parameters:

sidint: the unique id
aesidint: the control surface (AESURF) id
lalphaint; default=None: the angle of attack profile (AEFACT) id
lmachint; default=None: the mach profile (AEFACT) id
lschdint; default=None: the control surface deflection profile (AEFACT) id
commentstr; default=’’: a comment for the card

add_csuper(seid, psid, nodes, comment='') → CSUPER

add_csupext(seid, nodes, comment='') → CSUPEXT

add_ctetra(eid, pid, nids, comment='') → CTETRA4 | CTETRA10

Creates a CTETRA4/CTETRA10

Parameters:

eidint: element id
pidint: property id (PSOLID, PLSOLID)
nidslist[int]: node ids; n=4 or 10
commentstr; default=’’: a comment for the card

add_ctrax3(eid, pid, nids, theta=0.0, comment='') → CTRAX3: Creates a CTRAX3 card

add_ctrax6(eid, pid, nids, theta=0.0, comment='') → CTRAX6: Creates a CTRAX6 card

add_ctria3(eid, pid, nids, zoffset=0.0, theta_mcid=0.0, tflag=0, T1=None, T2=None, T3=None, comment='') → CTRIA3

Creates a CTRIA3 card

Parameters:

eidint

element id

pidint

property id (PSHELL/PCOMP/PCOMPG)

nidslist[int]

node ids

zoffsetfloat; default=0.0

Offset from the surface of grid points to the element reference plane. Requires MID1 and MID2.

theta_mcidfloat; default=0.0

floatmaterial coordinate system angle (theta) is defined: relative to the element coordinate system
intx-axis from material coordinate system angle defined by: mcid is projected onto the element

tflagint; default=0

0 : Ti are actual user specified thicknesses 1 : Ti are fractions relative to the T value of the PSHELL

T1 / T2 / T3float; default=None

If it is not supplied, then T1 through T3 will be set equal to the value of T on the PSHELL entry.

commentstr; default=’’

a comment for the card

add_ctria6(eid, pid, nids, theta_mcid=0.0, zoffset=0.0, tflag=0, T1=None, T2=None, T3=None, comment='') → CTRIA6

Creates a CTRIA6 card

Parameters:

eidint

element id

pidint

property id (PSHELL/PCOMP/PCOMPG)

nidslist[int, int, int, int/None, int/None, int/None]

node ids

zoffsetfloat; default=0.0

Offset from the surface of grid points to the element reference plane. Requires MID1 and MID2.

theta_mcidfloat; default=0.0

floatmaterial coordinate system angle (theta) is defined: relative to the element coordinate system
intx-axis from material coordinate system angle defined by: mcid is projected onto the element

tflagint; default=0

0 : Ti are actual user specified thicknesses 1 : Ti are fractions relative to the T value of the PSHELL

T1 / T2 / T3float; default=None

If it is not supplied, then T1 through T3 will be set equal to the value of T on the PSHELL entry.

commentstr; default=’’

a comment for the card

add_ctriar(eid, pid, nids, theta_mcid=0.0, zoffset=0.0, tflag=0, T1=None, T2=None, T3=None, comment='') → CTRIAR

Creates a CTRIAR card

Parameters:

eidint

element id

pidint

property id (PSHELL/PCOMP/PCOMPG)

nidslist[int, int, int]

node ids

zoffsetfloat; default=0.0

Offset from the surface of grid points to the element reference plane. Requires MID1 and MID2.

theta_mcidfloat; default=0.0

floatmaterial coordinate system angle (theta) is defined: relative to the element coordinate system
intx-axis from material coordinate system angle defined by: mcid is projected onto the element

tflagint; default=0

0 : Ti are actual user specified thicknesses 1 : Ti are fractions relative to the T value of the PSHELL

T1 / T2 / T3float; default=None

If it is not supplied, then T1 through T3 will be set equal to the value of T on the PSHELL entry.

commentstr; default=’’

a comment for the card

add_ctriax(eid, pid, nids, theta_mcid=0.0, comment='') → CTRIAX: Creates a CTRIAX card

add_ctriax6(eid, mid, nids, theta=0.0, comment='') → CTRIAX: Creates a CTRIAX6 card

add_ctube(eid: int, pid: int, nids: list[int], comment: str = '') → CTUBE

Creates a CTUBE card

Parameters:

eidint: element id
pidint: property id
nidslist[int]: node ids
commentstr; default=’’: a comment for the card

add_cvisc(eid: int, pid: int, nids: list[int], comment: str = '') → CVISC

Creates a CVISC card

Parameters:

eidint: element id
pidint: property id (PVISC)
nidslist[int]: GRID ids
commentstr; default=’’: a comment for the card

add_cyax(nids, comment='') → CYAX

add_cyjoin(side, coord, nids, comment='') → CYJOIN

add_darea(sid, nid, component, scale, comment='') → DAREA

Creates a DAREA card

Parameters:

sidint: darea id
nidint: GRID, EPOINT, SPOINT id
componentstr: Component number. (0-6; 0-EPOINT/SPOINT; 1-6 GRID)
scalefloat: Scale (area) factor

add_dconadd(oid, dconstrs, comment='') → DCONADD: Creates a DCONADD card

add_dconstr(oid: int, dresp_id: int, lid: float = -1e+20, uid: float = 1e+20, lowfq: float = 0.0, highfq: float = 1e+20, comment: str = '') → DCONSTR

Creates a DCONSTR card

Parameters:

oidint: unique optimization id
dresp_idint: DRESP1/2 id
lid / uid=-1.e20 / 1.e20: lower/upper bound
lowfq / highfqfloat; default=0. / 1.e20: lower/upper end of the frequency range
commentstr; default=’’: a comment for the card

add_ddval(oid, ddvals, comment='') → DDVAL: Creates a DDVAL card

add_deform(sid: int, eid: int, deformation: float, comment='') → DEFORM

Creates an DEFORM card, which defines applied deformation on a 1D element. Links to the DEFORM card in the case control deck.

Parameters:

sidint: load id
eidint: CTUBE/CROD/CONROD/CBAR/CBEAM element id
deformationfloat: the applied deformation
commentstr; default=’’: a comment for the card

add_delay(sid, nodes, components, delays, comment='') → DELAY

Creates a DELAY card

Parameters:

sidint: DELAY id that is referenced by a TLOADx, RLOADx or ACSRCE card
nodeslist[int]: list of nodes that see the delay len(nodes) = 1 or 2
componentslist[int]: the components corresponding to the nodes that see the delay len(nodes) = len(components)
delayslist[float]: Time delay (tau) for designated point Pi and component Ci len(nodes) = len(delays)
commentstr; default=’’: a comment for the card

add_dense_dmi(name: str, myarray: ndarray, form: int | str, tin=None, tout=None, validate: bool = True)

default for tin/tout = myarray.dtype

..warning :: only supports square matrices for the moment

add_deqatn(equation_id: int, eqs: list[str], comment: str = '') → DEQATN

Creates a DEQATN card

Parameters:

equation_idint

the id of the equation

eqslist[str]

the equations, which may overbound the field split them by a semicolon (;)

commentstr; default=’’

a comment for the card

DEQATN 41 F1(A,B,C,D,R) = A+B *C-(D**3 + 10.0) + sin(PI(1) * R)

A**2 / (B - C); F = A + B - F1 * D

def F1(A, B, C, D, R):

F1 = A+B *C-(D**3 + 10.0) + sin(PI(1) * R) + A**2 / (B - C) F = A + B - F1 * D return F

eqs = [

‘F1(A,B,C,D,R) = A+B *C-(D**3 + 10.0) + sin(PI(1) * R) + A**2 / (B - C)’, ‘F = A + B - F1 * D’,

]

>>> deqatn = model.add_deqatn(41, eqs, comment=’’)

add_desvar(desvar_id: int, label: str, xinit: float, xlb: float = -1e+20, xub: float = 1e+20, delx=None, ddval: int | None = None, comment: str = '') → DESVAR

Creates a DESVAR card

Parameters:

desvar_idint

design variable id

labelstr

name of the design variable

xinitfloat

the starting point value for the variable

xlbfloat; default=-1.e20

the lower bound

xubfloat; default=1.e20

the lower bound

delxfloat; default=1.e20

fractional change allowed for design variables during approximate optimization NX if blank : take from DOPTPRM; otherwise 1.0 MSC if blank : take from DOPTPRM; otherwise 0.5

ddvalint; default=None

intDDVAL id: allows you to set discrete values

None : continuous

commentstr; default=’’

a comment for the card

add_diverg(sid: int, nroots: int, machs: list[float], comment: str = '') → DIVERG

Creates an DIVERG card, which is used in divergence analysis (SOL 144).

Parameters:

sidint: The name
nrootsint: the number of roots
machslist[float, …, float]: list of Mach numbers
commentstr; default=’’: a comment for the card

add_dlink(oid: int, dependent_desvar: int, independent_desvars: list[int], coeffs: list[float], c0: float = 0.0, cmult: float = 1.0, comment: str = '') → DLINK

Creates a DLINK card, which creates a variable that is a lienar ccombination of other design variables

Parameters:

oidint: optimization id
dependent_desvarint: the DESVAR to link
independent_desvarslist[int]: the DESVARs to combine
coeffslist[int]: the linear combination coefficients
c0float; default=0.0: an offset
cmultfloat; default=1.0: an scale factor
commentstr; default=’’: a comment for the card

add_dload(sid, scale, scale_factors, load_ids, comment='') → DLOAD

Creates a DLOAD card

Parameters:

sidint: Load set identification number. See Remarks 1. and 4. (Integer > 0)
scalefloat: Scale factor. See Remarks 2. and 8. (Real)
Silist[float]: Scale factors. See Remarks 2., 7. and 8. (Real)
load_idslist[int]: Load set identification numbers of RLOAD1, RLOAD2, TLOAD1, TLOAD2, and ACSRCE entries. See Remarks 3. and 7. (Integer > 0)
commentstr; default=’’: a comment for the card

add_dmi(name: str, form: int, tin: int, tout: int, nrows: int, ncols: int, GCj, GCi, Real, Complex=None, comment: str = '') → DMI

Creates a DMI card

1 : ‘square’, 2 : ‘rectangular’, # 9 ??? 3 : ‘diagonal’, 6 : ‘symmetric’, 9 : ‘identity’,

add_dmi_w2gj(tin: int, tout: int, nrows: int, GCj, GCi, Real, comment: str = '') → DMI: Creates a DMI,W2GJ card

add_dmiax(name, matrix_form, tin, tout, ncols, GCNj, GCNi, Real, Complex=None, comment='') → DMIAX: Creates a DMIAX card

add_dmig(name, ifo, tin, tout, polar, ncols, GCj, GCi, Real, Complex=None, comment='') → DMIG

Creates a DMIG card

Parameters:

namestr: the name of the matrix
ifoint: matrix shape 4=Lower Triangular 5=Upper Triangular 6=Symmetric 8=Identity (m=nRows, n=m)
tinint: matrix input precision 1=Real, Single Precision 2=Real, Double Precision 3=Complex, Single Precision 4=Complex, Double Precision
toutint: matrix output precision 0=same as tin 1=Real, Single Precision 2=Real, Double Precision 3=Complex, Single Precision 4=Complex, Double Precision
polarint; default=0: Input format of Ai, Bi Integer=blank or 0 indicates real, imaginary format Integer > 0 indicates amplitude, phase format
ncolsint: ???
GCjlist[(node, dof)]: the [jnode, jDOFs]
GCilist[(node, dof)]: the inode, iDOFs
Reallist[float]: The real values
Complexlist[float]; default=None: The complex values (if the matrix is complex)
commentstr; default=’’: a comment for the card

add_dmig_uaccel(tin: int, ncol: int, load_sequences, comment='') → DMIG_UACCEL: Creates a DMIG,UACCEL card

add_dmij(name, form, tin, tout, nrows, ncols, GCj, GCi, Real, Complex=None, comment='') → DMIJ: Creates a DMIJ card

add_dmiji(name, ifo, tin, tout, nrows, ncols, GCj, GCi, Real, Complex=None, comment='') → DMIJI: DMIJI | NAME | 0 | IFO | TIN | TOUT POLAR | | NCOL |

add_dmik(name, ifo, tin, tout, polar, ncols, GCj, GCi, Real, Complex=None, comment='') → DMIK

Creates a DMIK card

Parameters:

namestr: the name of the matrix
ifoint: matrix shape 4=Lower Triangular 5=Upper Triangular 6=Symmetric 8=Identity (m=nRows, n=m)
tinint: matrix input precision 1=Real, Single Precision 2=Real, Double Precision 3=Complex, Single Precision 4=Complex, Double Precision
toutint: matrix output precision 0=same as tin 1=Real, Single Precision 2=Real, Double Precision 3=Complex, Single Precision 4=Complex, Double Precision
polarint; default=0: Input format of Ai, Bi Integer=blank or 0 indicates real, imaginary format Integer > 0 indicates amplitude, phase format
ncolsint: ???
GCjlist[(node, dof)]: the jnode, jDOFs
GCilist[(node, dof)]: the inode, iDOFs
Reallist[float]: The real values
Complexlist[float]; default=None: The complex values (if the matrix is complex)
commentstr; default=’’: a comment for the card

add_dmncon(constraint_id: int, constraint_type: str, xyz=None, normal=None, size=None, m=None, d=None, nsections=None, angle=None, mind=None, off_flag=None, comment: str = '') → DMNCON

add_doptprm(params: dict[str, int | float], comment='') → DOPTPRM: Creates a DOPTPRM card

add_dphase(sid, nodes, components, phase_leads, comment='') → DPHASE

Creates a DPHASE card

Parameters:

sidint: DPHASE id that is referenced by a RLOADx or ACSRCE card
nodeslist[int]: list of nodes that see the delay len(nodes) = 1 or 2
componentslist[int]: the components corresponding to the nodes that see the delay len(nodes) = len(components)
phase_leadslist[float]: Phase lead θ in degrees. len(nodes) = len(delays)
commentstr; default=’’: a comment for the card

Creates a DRESP1 card.

A DRESP1 is used to define a “simple” output result that may be optimized on. A simple result is a result like stress, strain, force, displacement, eigenvalue, etc. for a node/element that may be found in a non-optimization case.

Parameters:

dresp_idint

response id

labelstr

Name of the response

response_typeint

Response type

property_typestr

Element flag (PTYPE = ‘ELEM’), or property entry name, or panel flag for ERP responses (PTYPE = ‘PANEL’ - See Remark 34), or RANDPS ID. Blank for grid point responses. ‘ELEM’ or property name used only with element type responses (stress, strain, force, etc.) to identify the relevant element IDs, or the property type and relevant property IDs.

Must be {ELEM, PBAR, PSHELL, PCOMP, PANEL, etc.) PTYPE = RANDPS ID when RTYPE=PSDDISP, PSDVELO, or PSDACCL.

regionstr

Region identifier for constraint screening

attaint / float / str / blank

Response attribute

attbint / float / str / blank

Response attribute

attilist[int / float / str]

the response values to pull from list[int]:

list of grid ids list of property ids

list[str]: ‘ALL’

commentstr; default=’’

a comment for the card

validatebool; default=True

should the card be validated when it’s created

Examples

Stress/PSHELL

>>> dresp_id = 103
>>> label = 'resp1'
>>> response_type = 'STRESS'
>>> property_type = 'PSHELL'
>>> pid = 3
>>> atta = 9 # von mises upper surface stress
>>> region = None
>>> attb = None
>>> atti = [pid]
>>> DRESP1(dresp_id, label, response_type, property_type, region, atta, attb, atti)

Stress/PCOMP

>>> dresp_id = 104
>>> label = 'resp2'
>>> response_type = 'STRESS'
>>> property_type = 'PCOMP'
>>> pid = 3
>>> layer = 4
>>> atta = 9 # von mises upper surface stress
>>> region = None
>>> attb = layer
>>> atti = [pid]
>>> DRESP1(dresp_id, label, response_type, property_type, region, atta, attb, atti)

add_dresp2(dresp_id: int, label: str, dequation: int | str, region: int, params, method: str = 'MIN', c1: float = 1.0, c2: float = 0.005, c3: float = 10.0, validate: bool = True, comment: str = '') → DRESP2

Creates a DRESP2 card.

A DRESP2 is used to define a “complex” output result that may be optimized on. A complex result is a result that uses:

simple (DRESP1) results

complex (DRESP2) results

default values (DTABLE)

DVCRELx values

DVMRELx values

DVPRELx values

DESVAR values

Then, an equation (DEQATN) is used to formulate an output response.

Parameters:

dresp_idint

response id

labelstr

Name of the response

dequationint

DEQATN id

regionstr

Region identifier for constraint screening

paramsdict[(index, card_type)] = values

the storage table for the response function index : int

a counter

card_typestr: the type of card to pull from DESVAR, DVPREL1, DRESP2, etc.
valueslist[int]: the values for this response

methodstr; default=MIN

flag used for FUNC=BETA/MATCH FUNC = BETA

valid options are {MIN, MAX}

FUNC = MATCH: valid options are {LS, BETA}

c1 / c2 / c3float; default=1. / 0.005 / 10.0

constants for FUNC=BETA or FUNC=MATCH

commentstr; default=’’

a comment for the card

validatebool; default=False

should the card be validated when it’s created

params = {

(0, ‘DRESP1’) = [10, 20], (1, ‘DESVAR’) = [30], (2, ‘DRESP1’) = [40],

}

add_dresp3(dresp_id, label, group, Type, region, params, validate=True, comment='') → DRESP3: Creates a DRESP3 card

add_dscons(dscid: int, label: str, constraint_type: str, nid_eid: int, comp: int, limit: float = 0.0, opt: str = 'MAX', layer_id: int = 1): Design Constraint Defines a design constraint in design sensitivity analysis (original DSA). See the MSC.Nastran Reference Manual, Chapter 15.

DSCONS | DSCID | LABEL | TYPE | ID | COMP | LIMIT | OPT | LAMNO |

DSCONS | 21 | G101DX | DISP | 4 | 1 | 0.06 | MAX | 6 |

add_dscreen(rtype: str, trs: float = -0.5, nstr: int = 20, comment: str = '') → DSCREEN

Creates a DSCREEN object

Parameters:

rtypestr: Response type for which the screening criteria apply
trsfloat: Truncation threshold
nstrint: Maximum number of constraints to be retained per region per load case
commentstr; default=’’: a comment for the card

add_dtable(default_values: dict[str, float], comment='') → DTABLE

Creates a DTABLE card

Parameters:

default_valuesdict

keystr: the parameter name
valuefloat: the value

commentstr; default=’’

a comment for the card

add_dti(name: str, fields: dict[int, list], comment='') → DTI | DTI_UNITS: Creates a DTI card

add_dvar(bid: int, label: str, vids: list[float], deltab: float = 0.02)

Design Variable

Defines a design variable for design sensitivity analysis (original DSA) described in the MSC.Nastran Reference Manual, Chapter 15.

DVAR | BID | LABEL | DELTAB | VID1 | VID2 | VID3 | VID4 | VID5 |

| VID6 | etc. | | | | | | |

DVAR | 10 | LFDOOR | 0.01 | 2 | 4 | 5 | 6 | 9 |

| 10 | | | | | | | |

MSC 2001

Parameters:

BIDint: Design variable identification number. Must be unique for all DVAR.
LABELstr: Label used to describe variable in output.
DELTABfloat; default=0.02: The change in the dimensionless design variable B to be used in the calculation of the design sensitivity coefficients.
VIDilist[int]: Identification number of DVSET entry.

add_dvcrel1(oid, Type, eid, cp_name, dvids, coeffs, cp_min=None, cp_max=1e+20, c0=0.0, validate=True, comment='') → DVCREL1

Creates a DVCREL1 card

Parameters:

oidint: optimization id
prop_typestr: property card name (e.g., PSHELL)
EIDint: element id
cp_namestr/int: optimization parameter as an element connectivity name (e.g., X1)
dvidslist[int]: DESVAR ids
coeffslist[float]: scale factors for DESVAR ids
cp_minfloat; default=None: minimum value
cp_maxfloat; default=1e20: maximum value
c0float; default=0.: offset factor for the variable
validatebool; default=False: should the variable be validated
commentstr; default=’’: a comment for the card

add_dvcrel2(oid, Type, eid, cp_name, deqation, dvids, labels, cp_min=None, cp_max=1e+20, validate=True, comment='') → DVCREL2: Creates a DVCREL2 card

add_dvgrid(dvid: int, nid: int, dxyz: Any, cid: int = 0, coeff: float = 1.0, comment: str = '') → DVGRID

Creates a DVGRID card

Parameters:

dvidint: DESVAR id
nidint: GRID/POINT id
dxyz(3, ) float ndarray: the amount to move the grid point
cidint; default=0: Coordinate system for dxyz
coefffloat; default=1.0: the dxyz scale factor
commentstr; default=’’: a comment for the card

add_dvmrel1(oid: int, mat_type: str, mid: int, mp_name: str, dvids: list[int], coeffs: list[float], mp_min: float | None = None, mp_max: float = 1e+20, c0: float = 0.0, validate: bool = True, comment: str = '') → DVMREL1

Creates a DVMREL1 card

Parameters:

oidint: optimization id
prop_typestr: material card name (e.g., MAT1)
midint: material id
mp_namestr: optimization parameter as a pname (material name; E)
dvidslist[int]: DESVAR ids
coeffslist[float]: scale factors for DESVAR ids
mp_minfloat; default=None: minimum material property value
mp_maxfloat; default=1e20: maximum material property value
c0float; default=0.: offset factor for the variable
validatebool; default=False: should the variable be validated
commentstr; default=’’: a comment for the card

add_dvmrel2(oid: int, mat_type: str, mid: int, mp_name: str, deqation: int, dvids: list[int], labels: list[str], mp_min: float | None = None, mp_max: float = 1e+20, validate: bool = True, comment: str = '') → DVMREL2

Creates a DVMREL2 card

Parameters:

oidint: optimization id
mat_typestr: material card name (e.g., MAT1)
midint: material id
mp_namestr: optimization parameter as a pname (material name; E)
deqationint: DEQATN id
dvidslist[int]; default=None: DESVAR ids
labelslist[str]; default=None: DTABLE names
mp_minfloat; default=None: minimum material property value
mp_maxfloat; default=1e20: maximum material property value
validatebool; default=False: should the variable be validated
commentstr; default=’’: a comment for the card

Notes

either dvids or labels is required

add_dvprel1(oid: int, prop_type: str, pid: int, pname_fid: int | str, dvids: list[int], coeffs: list[float], p_min=None, p_max: float = 1e+20, c0: float = 0.0, validate: bool = True, comment: str = '') → DVPREL1

Creates a DVPREL1 card

Parameters:

oidint: optimization id
prop_typestr: property card name (e.g., PSHELL)
pidint: property id
pname_fidstr/int: optimization parameter as a pname (property name; T) or field number (fid)
dvidslist[int]: DESVAR ids
coeffslist[float]: scale factors for DESVAR ids
p_minfloat; default=None: minimum property value
p_maxfloat; default=1e20: maximum property value
c0float; default=0.: offset factor for the variable
validatebool; default=False: should the variable be validated
commentstr; default=’’: a comment for the card

add_dvprel2(oid: int, prop_type: str, pid: int, pname_fid: int | str, deqation: int, dvids: list[int] = None, labels: list[str] = None, p_min: float | None = None, p_max: float = 1e+20, validate: bool = True, comment: str = '') → DVPREL2

Creates a DVPREL2 card

Parameters:

oidint: optimization id
prop_typestr: property card name (e.g., PSHELL)
pidint: property id
pname_fidstr/int: optimization parameter as a pname (property name; T) or field number (fid)
deqationint: DEQATN id
dvidslist[int]; default=None: DESVAR ids
labelslist[str]; default=None: DTABLE names
p_minfloat; default=None: minimum property value
p_maxfloat; default=1e20: maximum property value
validatebool; default=False: should the variable be validated
commentstr; default=’’: a comment for the card

Notes

either dvids or labels is required

add_dvset(vid: int, dv_type: str, field: int, pref: float, pids: list[float], alpha: float = 1.0)

Design Variable Set Property

Defines a set of element properties that vary in a fixed relation to a design variable for design sensitivity analysis (original DSA). See the MSC.Nastran Reference Manual, Chapter 15.

| PID4 | PID5 | etc. | | | | | |

DVSET | 21 | PSHELL | 4 | 0.20 | 1.0 | 99 | 101 | 110 |

| 111 | 122 | | | | | | |

DVSET |  VID |  TYPE  | FIELD | PREF | ALPHA | PID  | THRU | PID2 |
DVSET |  21  | PSHELL |   4   | 0.20 |  1.0  |  101 | THRU |  105 |
DVSET |  VID |  TYPE  | FIELD | MIDV |       | PIDl | PID2 | PID3 |
DVSET |  21  | PSHELL |   3   | 134  |       |  87  |  101 |      |

MSC 2001

add_dvtrel1(dvtrel_id: int, label: str, group_id: int, state: str = 'ACTIVE', dsv_flag: int = 0, dvid1: int = 0, validate=False, comment: str = '') → DVTREL1

add_dynred(sid, fmax, nirv, nit, idir, nqdes) → None

add_eigb(sid, method, L1, L2, nep, ndp, ndn, norm, G, C, comment='') → EIGB: Creates an EIGB card

add_eigc(sid, method, grid, component, epsilon, neigenvalues, norm='MAX', mblkszs=None, iblkszs=None, ksteps=None, NJIs=None, alphaAjs=None, omegaAjs=None, alphaBjs=None, omegaBjs=None, LJs=None, NEJs=None, NDJs=None, shift_r1=None, shift_i1=None, isrr_flag=None, nd1=None, comment='') → EIGC: Creates an EIGC card

add_eigp(sid, alpha1, omega1, m1, alpha2, omega2, m2, comment='') → EIGP: Creates an EIGP card

add_eigr(sid, method='LAN', f1=None, f2=None, ne=None, nd=None, norm='MASS', G=None, C=None, comment='') → EIGR

Adds a EIGR card

Parameters:

sidint: method id
methodstr; default=’LAN’: eigenvalue method recommended: {LAN, AHOU} obsolete : {INV, SINV, GIV, MGIV, HOU, MHOU, AGIV}
f1 / f2float; default=None: lower/upper bound eigenvalue
f2float; default=None: upper bound eigenvalue
neint; default=None: estimate of number of roots (used for INV)
ndint; default=None: desired number of roots
msglvlint; default=0: debug level; 0-4
maxsetint; default=None: Number of vectors in block or set
shfsclfloat; default=None: estimate of first flexible mode natural frequency
normstr; default=None: {MAX, MASS, AF, POINT} default=MASS (NX)
Gint; default=None: node id for normalization; only for POINT
Cint; default=None: component for normalization (1-6); only for POINT
commentstr; default=’’: a comment for the card

add_eigrl(sid, v1=None, v2=None, nd=None, msglvl=0, maxset=None, shfscl=None, norm=None, options=None, values=None, comment='') → EIGRL

Adds an EIGRL card

Parameters:

sidint: method id
v1float; default=None: lower bound eigenvalue
v2float; default=None: upper bound eigenvalue
ndint: number of roots
msglvlint; default=0: debug level; 0-4
maxsetint; default=None: Number of vectors in block or set
shfsclfloat; default=None: estimate of first flexible mode natural frequency
normstr; default=None: {MAX, MASS}
optionslist[str]; default=None -> []: line 2 keys
valueslist[int | float | str]; default=None -> []: line 2 values
commentstr; default=’’: a comment for the card

add_epoint(ids: int | list[int], comment: str = '') → EPOINTs

Creates the EPOINTs card that contains many EPOINTs

Parameters:

idslist[int]: EPOINT ids
commentstr; default=’’: a comment for the card

add_extrn(nids: list[int], comps: list[str])

add_feedge(edge_id, nids, cid, geom_ids, geomin='POINT', comment='') → FEEDGE

add_feface(face_id, nids, cid, surf_ids, comment='') → FEFACE

add_flfact(sid: int, factors: list[float], comment: str = '') → FLFACT

Creates an FLFACT card, which defines factors used for flutter analysis. These factors define either:

density

mach

velocity

reduced frequency

depending on the FLUTTER method chosen (e.g., PK, PKNL, PKNLS)

Parameters:

sidint

the id of a density, reduced_frequency, mach, or velocity table the FLUTTER card defines the meaning

factorsvaries

valueslist[float, …, float]

list of factors

list[f1, THRU, fnf, nf, fmid]

f1float: first value
THRUstr: the word THRU
fnffloat: second value
nfint: number of values
fmidfloat; default=(f1 + fnf) / 2.: the mid point to bias the array

TODO: does f1 need be be greater than f2/fnf???

commentstr; default=’’

a comment for the card

add_flutter(sid: int, method: str, density: int, mach: int, reduced_freq_velocity: int, imethod: str = 'L', nvalue: int | None = None, omax: float | None = None, epsilon: float = 0.001, comment: str = '', validate: bool = False) → FLUTTER

Creates a FLUTTER card, which is required for a flutter (SOL 145) analysis.

Parameters:

sidint

flutter id

methodstr

valid methods = [K, KE,: PKS, PKNLS, PKNL, PKE]

densityint

defines a series of air densities in units of mass/volume PARAM,WTMASS does not affect this AERO affects this references an FLFACT id

machint

defines a series of the mach numbers references an FLFACT id

reduced_freq_velocityint

Defines a series of either:

reduced frequencies - K, KE
velocities - PK, PKNL, PKS, PKNLS

depending on the method chosen. references an FLFACT id

imethodstr; default=’L’

Choice of interpolation method for aerodynamic matrix interpolation. imethods :

L - linear

S - surface

TCUB - termwise cubic

nvalueint

Number of eigenvalues beginning with the first eigenvalue for output and plots

omaxfloat

For the PKS and PKNLS methods, OMAX specifies the maximum frequency (Hz), to be used in he flutter sweep. MSC only.

epsilonfloat; default=1.0e-3

Convergence parameter for k. Used in the PK and PKNL methods only

commentstr; default=’’

a comment for the card

add_force(sid: int, node: int, mag: float, xyz: ndarray, cid: int = 0, comment: str = '') → FORCE

Creates a FORCE card

Parameters:

sidint: load id
nodeint: the node to apply the load to
magfloat: the load’s magnitude
xyz(3, ) float ndarray: the load direction in the cid frame
cidint; default=0: the coordinate system for the load
commentstr; default=’’: a comment for the card

add_force1(sid, node, mag, g1, g2, comment='') → FORCE1

Creates a FORCE1 card

Parameters:

sidint: load id
nodeint: the node to apply the load to
magfloat: the load’s magnitude
n1 / n2int / int: defines the load direction n = n2 - n1
commentstr; default=’’: a comment for the card

add_force2(sid, node, mag, g1, g2, g3, g4, comment='') → FORCE2

Creates a FORCE2 card

Parameters:

sidint: load id
nodeint: the node to apply the load to
magfloat: the load’s magnitude
g1 / g2 / g3 / g4int / int / int / int: defines the load direction n = (g2 - g1) x (g4 - g3)
commentstr; default=’’: a comment for the card

add_forceax(sid, ring_id, hid, scale, f_rtz, comment='') → FORCEAX

add_freq(sid, freqs, comment='') → FREQ

Creates a FREQ card

Parameters:

sidint: set id referenced by case control FREQUENCY
freqslist[float]: the frequencies for a FREQx object
commentstr; default=’’: a comment for the card

add_freq1(sid, f1, df, ndf=1, comment='') → FREQ1

Creates a FREQ1 card

Parameters:

sidint: set id referenced by case control FREQUENCY
f1float: first frequency
dffloat: frequency increment
ndfint; default=1: number of frequency increments
commentstr; default=’’: a comment for the card

add_freq2(sid, f1, f2, nf=1, comment='') → FREQ2

Creates a FREQ2 card

Parameters:

sidint: set id referenced by case control FREQUENCY
f1float: first frequency
f2float: last frequency
nfint; default=1: number of logorithmic intervals
commentstr; default=’’: a comment for the card

add_freq3(sid, f1, f2=None, Type='LINEAR', nef=10, cluster=1.0, comment='') → FREQ3: Creates a FREQ3 card

add_freq4(sid, f1=0.0, f2=1e+20, fspread=0.1, nfm=3, comment='') → FREQ4

Creates a FREQ4 card

Parameters:

sidint: set id referenced by case control FREQUENCY
f1float; default=0.0: Lower bound of frequency range in cycles per unit time.
f2float; default=1E20: Upper bound of frequency range in cycles per unit time.
nfmint; default=3: Number of evenly spaced frequencies per ‘spread’ mode.
commentstr; default=’’: a comment for the card

add_freq5(sid, fractions, f1=0.0, f2=1e+20, comment='') → FREQ5

Creates a FREQ5 card

Parameters:

sidint: set id referenced by case control FREQUENCY
f1float; default=0.0: Lower bound of frequency range in cycles per unit time.
f2float; default=1e20: Upper bound of frequency range in cycles per unit time.
fractionslist[float]: Fractions of the natural frequencies in the range F1 to F2.
commentstr; default=’’: a comment for the card

Notes

FREQ5 is only valid in modal frequency-response solutions (SOLs 111, 146, and 200) and is ignored in direct frequency response solutions.

add_genel_flexibility(eid, ul, ud, z, s=None) → GENEL: creates a GENEL card using the flexiblity (Z) approach

add_genel_stiffness(eid, ul, ud, k, s=None) → GENEL: creates a GENEL card using the stiffness (K) approach

add_gmcurv(curve_id, group, data, cid_in=0, cid_bc=0, comment='') → GMCURV

add_gmspc(conid, component, entity, entity_id, comment='') → GMSPC: Creates a GMSPC card

add_gmsurf(curve_id, group, data, cid_in=0, cid_bc=0, comment='') → GMSURF

add_grav(sid, scale, N, cid=0, mb=0, comment='') → GRAV

Creates an GRAV card

Parameters:

sidint: load id
scalefloat: scale factor for load
N(3, ) float ndarray: the acceleration vector in the cid frame
cidint; default=0: the coordinate system for the load
mbint; default=0: ???
commentstr; default=’’: a comment for the card

add_grdset(cp: int, cd: int, ps: str, seid: int, comment: str = '') → GRDSET

Creates the GRDSET card

Parameters:

cpint; default=0: the xyz coordinate frame
cdint; default=0: the analysis coordinate frame
psstr; default=’’: Additional SPCs in the analysis coordinate frame (e.g. ‘123’). This corresponds to DOF set SG.
seidint; default=0: superelement id TODO: how is this used by Nastran???
commentstr; default=’’: a comment for the card

add_grid(nid: int, xyz: list[float] | Any, cp: int = 0, cd: int = 0, ps: str = '', seid: int = 0, comment: str = '') → GRID

Creates the GRID card

Parameters:

nidint: node id
cpint; default=0: the xyz coordinate frame
xyz(3, ) float ndarray; default=None -> [0., 0., 0.]: the xyz/r-theta-z/rho-theta-phi values
cdint; default=0: the analysis coordinate frame
psstr; default=’’: Additional SPCs in the analysis coordinate frame (e.g. ‘123’). This corresponds to DOF set SG.
seidint; default=0: superelement id TODO: how is this used by Nastran???
commentstr; default=’’: a comment for the card

add_group(group_id: int, nodes, elements, properties, comment: str = '') → GROUP

add_gust(sid, dload, wg, x0, V=None, comment='') → GUST

Creates a GUST card, which defines a stationary vertical gust for use in aeroelastic response analysis.

Parameters:

sidint

gust load id

dloadint

TLOADx or RLOADx entry that defines the time/frequency dependence

wgfloat

Scale factor (gust velocity/forward velocity) for gust velocity

x0float

Streamwise location in the aerodynamic coordinate system of the gust reference point.

Vfloat; default=None

floatvelocity of the vehicle (must be the same as the: velocity on the AERO card)

None : ???

commentstr; default=’’

a comment for the card

add_include_file(include_filename: str, is_windows: bool | None = None) → None

add_load(sid, scale, scale_factors, load_ids, comment='') → LOAD

Creates a LOAD card

Parameters:

sidint: load id
scalefloat: overall scale factor
scale_factorslist[float]: individual scale factors (corresponds to load_ids)
load_idslist[int]: individual load_ids (corresponds to scale_factors)
commentstr; default=’’: a comment for the card

add_loadcyh(sid, scale, hid, htype, scales, load_ids, comment='') → LOADCYH: Creates a LOADCYH card

add_loadcyn(sid, scale, segment_id, scales, load_ids, segment_type=None, comment='') → LOADCYN: Creates a LOADCYN card

add_lseq(sid, excite_id, lid, tid=None, comment='') → LSEQ

Creates a LSEQ card

Parameters:

sidint: loadset id; LOADSET points to this
excite_idint: set id assigned to this static load vector
lidint: load set id of a set of static load entries; LOAD in the Case Control
tidint; default=None: temperature set id of a set of thermal load entries; TEMP(LOAD) in the Case Control
commentstr; default=’’: a comment for the card

add_massset(mass_set_id, scale, scales, mass_set_ids) → None: adds an MASSSET card

add_mat1(mid: int, E: float, G: float, nu: float, rho: float = 0.0, a: float = 0.0, tref: float = 0.0, ge: float = 0.0, St: float = 0.0, Sc: float = 0.0, Ss: float = 0.0, mcsid: int = 0, comment: str = '') → MAT1

Creates a MAT1 card

Parameters:

midint: material id
Efloat / None: Young’s modulus
Gfloat / None: Shear modulus
nufloat / None: Poisson’s ratio
rhofloat; default=0.: density
afloat; default=0.: coefficient of thermal expansion
treffloat; default=0.: reference temperature
gefloat; default=0.: damping coefficient
St / Sc / Ssfloat; default=0.: tensile / compression / shear allowable
mcsidint; default=0: material coordinate system id used by PARAM,CURV
commentstr; default=’’: a comment for the card
If E, G, or nu is None (only 1), it will be calculated

add_mat10(mid, bulk, rho, c, ge=0.0, gamma=None, table_bulk=None, table_rho=None, table_ge=None, table_gamma=None, comment='') → MAT10

Creates a MAT10 card

Parameters:

midint: material id
bulkfloat; default=None: Bulk modulus
rhofloat; default=None: Density
cfloat; default=None: Speed of sound
gefloat; default=0.: Damping
gammafloat; default=None: NX : ratio of imaginary bulk modulus to real bulk modulus; default=0.0 MSC : normalized admittance coefficient for porous material
table_bulkint; default=None: TABLEDx entry defining bulk modulus vs. frequency None for MSC Nastran
table_rhoint; default=None: TABLEDx entry defining rho vs. frequency None for MSC Nastran
table_geint; default=None: TABLEDx entry defining ge vs. frequency None for MSC Nastran
table_gammaint; default=None: TABLEDx entry defining gamma vs. frequency None for MSC Nastran
commentstr; default=’’: a comment for the card

add_mat11(mid, e1, e2, e3, nu12, nu13, nu23, g12, g13, g23, rho=0.0, a1=0.0, a2=0.0, a3=0.0, tref=0.0, ge=0.0, comment='') → MAT11: Creates a MAT11 card

add_mat2(mid, G11, G12, G13, G22, G23, G33, rho=0.0, a1=None, a2=None, a3=None, tref=0.0, ge=0.0, St=None, Sc=None, Ss=None, mcsid=None, comment='') → MAT2: Creates an MAT2 card

add_mat3(mid, ex, eth, ez, nuxth, nuthz, nuzx, rho=0.0, gzx=None, ax=0.0, ath=0.0, az=0.0, tref=0.0, ge=0.0, comment='') → MAT3: Creates a MAT3 card

add_mat3d(mid, e1, e2, e3, nu12, nu13, nu23, g12, g13, g23, rho=0.0, comment='') → MAT3D: This is a VABS specific card that is almost identical to the MAT11.

add_mat4(mid, k, cp=0.0, rho=1.0, H=None, mu=None, hgen=1.0, ref_enthalpy=None, tch=None, tdelta=None, qlat=None, comment='') → MAT4: Creates a MAT4 card

add_mat5(mid, kxx=0.0, kxy=0.0, kxz=0.0, kyy=0.0, kyz=0.0, kzz=0.0, cp=0.0, rho=1.0, hgen=1.0, comment='') → MAT5: Creates a MAT5 card

add_mat8(mid, e11, e22, nu12, g12=0.0, g1z=100000000.0, g2z=100000000.0, rho=0.0, a1=0.0, a2=0.0, tref=0.0, Xt=0.0, Xc=None, Yt=0.0, Yc=None, S=0.0, ge=0.0, F12=0.0, strn=0.0, comment='') → MAT8: Creates a MAT8 card

add_mat9(mid, G11=0.0, G12=0.0, G13=0.0, G14=0.0, G15=0.0, G16=0.0, G22=0.0, G23=0.0, G24=0.0, G25=0.0, G26=0.0, G33=0.0, G34=0.0, G35=0.0, G36=0.0, G44=0.0, G45=0.0, G46=0.0, G55=0.0, G56=0.0, G66=0.0, rho=0.0, A=None, tref=0.0, ge=0.0, comment='') → MAT9: Creates a MAT9 card

add_matcid(cid: int, form: int, eids=None, start: int | None = None, thru: int | None = None, by: int | None = None, comment: str = '') → MATCID

Creates the MATCID card, which defines the Material Coordinate System for Solid Elements

Overrides the material coordinate system for:

CHEXA, CPENTA, CTETRA, and CPYRAM solid elements when the elements reference a PSOLID property.
CHEXA and CPENTA solid elements when the elements reference a PCOMPS property.
CHEXCZ and CPENTCZ solid elements.

Parameters:

cidint

coordinate system id

form: int

integer indicating the format alternative (for reference, see the 4 different formats below)

eidsarray[int, …]

Array of element identification numbers

start: int

used in format alternative 2 and 3, indicates starting eID

thruint

used in format alternative 2 and 3

byint

used in format alternative 3

commentstr; default=’’

a comment for the card

Format (alternative 1):

1	2	3	4	5	6	7	8	9
MATCID	CID	EID1	EID2	EID3	EID4	EID5	EID6	EID7
	EID8	EID9	-etc-

Format (alternative 2):

1	2	3	4	5	6	7	8	9
MATCID	CID	EID1	“THRU”	EID2

Format (alternative 3):

1	2	3	4 \| 5 \| 6 \| 7				8	9
MATCID	CID	EID1	“THRU”	EID2	“BY”	N

Format (alternative 4):

1	2	3	4	5	6	7	8	9
MATCID	CID	“ALL”

add_matdmg(mid, ppf_model, y012, yc12, ys12, ys22, y11limt, y11limc, ksit=None, ksic=None, b2=None, b3=None, a=None, litk=None, bigk=None, expn=None, tau=None, adel=None, plyuni=None, tid=None, hbar=None, dmax=None, pe=None, user=None, r01=None, ds=None, gic=None, giic=None, giiic=None, comment='') → MATDMG: Creates a MATDMG card

add_matg(mid, idmem, behav, tabld, tablu, yprs, epl, gpl, gap=0.0, tab_yprs=None, tab_epl=None, tab_gpl=None, tab_gap=None, comment='') → MATG: Creates a MATG card

add_mathe(mid, model, bulk, mus, alphas, betas, mooney, sussbat, aboyce, gent, rho=0.0, texp=0.0, tref=0.0, ge=0.0, comment='') → MATHE: Creates a MATHE card

add_mathp(mid, a10=0.0, a01=0.0, d1=None, rho=0.0, av=0.0, tref=0.0, ge=0.0, na=1, nd=1, a20=0.0, a11=0.0, a02=0.0, d2=0.0, a30=0.0, a21=0.0, a12=0.0, a03=0.0, d3=0.0, a40=0.0, a31=0.0, a22=0.0, a13=0.0, a04=0.0, d4=0.0, a50=0.0, a41=0.0, a32=0.0, a23=0.0, a14=0.0, a05=0.0, d5=0.0, tab1=None, tab2=None, tab3=None, tab4=None, tabd=None, comment='') → MATHP: Creates a MATHP card

add_matpor_craggs(mid: int, rho: float, c: float, resistivity: float, porosity: float, tortuosity: float, comment: str = '')

MATPOR MID MODEL RHO C: RES POR TORT

add_matpor_delmiki(mid: int, rho: float, c: float, resistivity: float, porosity: float, frame: str, density: float = 0.0, comment: str = '')

add_matpor_jca(mid: int, rho: float, c: float, resistivity: float, porosity: float, tortuosity: float, frame: str, gamma: float, prandtl_number: float, mu: float, L1: float, L2: float, density: float = 0.0, comment: str = '')

add_mats1(mid, tid, Type, h, hr, yf, limit1, limit2, comment='') → MATS1: Creates a MATS1 card

add_matt1(mid, e_table=None, g_table=None, nu_table=None, rho_table=None, a_table=None, ge_table=None, st_table=None, sc_table=None, ss_table=None, comment='') → int: Creates a MATT1 card

add_matt11(mid: int, e1_table=None, e2_table=None, e3_table=None, nu12_table=None, nu13_table=None, nu23_table=None, g12_table=None, g13_table=None, g23_table=None, rho_table=None, a1_table=None, a2_table=None, a3_table=None, ge_table=None, comment: str = '') → MATT11

add_matt2(mid, g11_table=None, g12_table=None, g13_table=None, g22_table=None, g23_table=None, g33_table=None, rho_table=None, a1_table=None, a2_table=None, a3_table=None, ge_table=None, st_table=None, sc_table=None, ss_table=None, comment='') → MATT2: Creates a MATT2 card

add_matt3(mid, ex_table=None, eth_table=None, ez_table=None, nuth_table=None, nuxz_table=None, rho_table=None, gzx_table=None, ax_table=None, ath_table=None, az_table=None, ge_table=None, comment='') → MATT3: Creates a MATT3 card

add_matt4(mid, k_table=None, cp_table=None, h_table=None, mu_table=None, hgen_table=None, comment='') → MATT4: Creates a MATT4 card

add_matt5(mid, kxx_table=None, kxy_table=None, kxz_table=None, kyy_table=None, kyz_table=None, kzz_table=None, cp_table=None, hgen_table=None, comment='') → MATT5: Creates a MATT5 card

add_matt8(mid, e1_table=None, e2_table=None, nu12_table=None, g12_table=None, g1z_table=None, g2z_table=None, rho_table=None, a1_table=None, a2_table=None, xt_table=None, xc_table=None, yt_table=None, yc_table=None, s_table=None, ge_table=None, f12_table=None, comment='') → MATT8: Creates a MATT8 card

add_matt9(mid, g11_table=None, g12_table=None, g13_table=None, g14_table=None, g15_table=None, g16_table=None, g22_table=None, g23_table=None, g24_table=None, g25_table=None, g26_table=None, g33_table=None, g34_table=None, g35_table=None, g36_table=None, g44_table=None, g45_table=None, g46_table=None, g55_table=None, g56_table=None, g66_table=None, rho_table=None, a1_table=None, a2_table=None, a3_table=None, a4_table=None, a5_table=None, a6_table=None, ge_table=None, comment='') → MATT9

add_mdlprm(mdlprm_dict: dict[str, int | float], comment: str = '') → MDLPRM

Creates a MDLPRM card

Parameters:

mdlprm_dictdict[name, value]

namestr: the name of the MDLPRM
value: int/float: varies depending on the type of MDLPRM

commentstr; default=’’

a comment for the card

add_micpnt(eid: int, node_id: int, name: str, comment: str = '') → None

add_mkaero1(machs: list[float], reduced_freqs: list[float], comment: str = '') → MKAERO1

Creates an MKAERO1 card, which defines a set of mach and reduced frequencies.

Parameters:

machslist[float]: series of Mach numbers
reduced_freqslist[float]: series of reduced frequencies
commentstr; default=’’: a comment for the card

add_mkaero2(machs, reduced_freqs, comment='') → MKAERO2

Creates an MKAERO2 card, which defines a set of mach and reduced frequency pairs.

Parameters:

machslist[float]: series of Mach numbers
reduced_freqslist[float]: series of reduced frequencies
commentstr; default=’’: a comment for the card

add_modtrak(sid, low_range, high_range, mt_filter, comment: str = '') → MODTRAK

add_moment(sid, node, mag, xyz, cid=0, comment='') → MOMENT

Creates a MOMENT card

Parameters:

sidint: load id
nodeint: the node to apply the load to
magfloat: the load’s magnitude
cidint; default=0: the coordinate system for the load
xyz(3, ) float ndarray; default: the load direction in the cid frame
commentstr; default=’’: a comment for the card

add_moment1(sid, node, mag, g1, g2, comment='') → MOMENT1

Creates a MOMENT1 card

Parameters:

sidint: load id
nodeint: the node to apply the load to
magfloat: the load’s magnitude
n1 / n2int / int: defines the load direction n = n2 - n1
commentstr; default=’’: a comment for the card

add_moment2(sid, node, mag, g1, g2, g3, g4, comment='') → MOMENT2

Creates a MOMENT2 card

Parameters:

sidint: load id
nodeint: the node to apply the load to
magfloat: the load’s magnitude
g1 / g2 / g3 / g4int / int / int / int: defines the load direction n = (g2 - g1) x (g4 - g3)
commentstr; default=’’: a comment for the card

add_mondsp1(name: str, label: str, axes: str, aecomp_name: str, xyz: ndarray, cp: int = 0, cd=None, ind_dof: str = '123', comment: str = '') → MONDSP1

Creates a MONDSP1 card

Parameters:

namestr: Character string of up to 8 characters identifying the monitor point
labelstr: A string comprising no more than 56 characters that identifies and labels the monitor point.
axesstr: components {1,2,3,4,5,6}
aecomp_namestr: name of the AECOMP/AECOMPL entry
xyzlist[float, float, float]; default=None: The coordinates in the CP coordinate system about which the loads are to be monitored. None : [0., 0., 0.]
cpint, CORDx; default=0: coordinate system of XYZ
cdint; default=None -> cp: the coordinate system for load outputs
ind_dofstr; default=’123’: the dofs to map
commentstr; default=’’: a comment for the card

Notes

MSC specific card

add_monpnt1(name: str, label: str, axes: str, aecomp_name: str, xyz: list[float], cp: int = 0, cd: int | None = None, comment: str = '') → MONPNT1

Creates a MONPNT1 card

Parameters:

namestr: Character string of up to 8 characters identifying the monitor point
labelstr: A string comprising no more than 56 characters that identifies and labels the monitor point.
axesstr: components {1,2,3,4,5,6}
aecomp_namestr: name of the AECOMP/AECOMPL entry
xyzlist[float, float, float]; default=None: The coordinates in the CP coordinate system about which the loads are to be monitored. None : [0., 0., 0.]
cpint, CORDx; default=0: int : coordinate system
cdint; default=None -> cp: the coordinate system for load outputs
commentstr; default=’’: a comment for the card

Notes

CD - MSC specific field

add_monpnt2(name, label, table, Type, nddl_item, eid, comment='') → MONPNT2: Creates a MONPNT2 card

add_monpnt3(name, label, axes, grid_set, elem_set, xyz, cp=0, cd=None, xflag=None, comment='') → MONPNT3: Creates a MONPNT3 card

add_mpc(conid: int, nodes: list[int], components: list[str], coefficients: list[float], comment: str = '') → MPC

Creates an MPC card

Parameters:

conidint: Case Control MPC id
nodeslist[int]: GRID/SPOINT ids
componentslist[str]: the degree of freedoms to constrain (e.g., ‘1’, ‘123’)
coefficientslist[float]: the scaling coefficients

add_mpcadd(conid, sets, comment='') → MPCADD: Creates an MPCADD card

add_nlparm(nlparm_id, ninc=None, dt=0.0, kmethod='AUTO', kstep=5, max_iter=25, conv='PW', int_out='NO', eps_u=0.01, eps_p=0.01, eps_w=0.01, max_div=3, max_qn=None, max_ls=4, fstress=0.2, ls_tol=0.5, max_bisect=5, max_r=20.0, rtol_b=20.0, comment='') → NLPARM: Creates an NLPARM card

add_nlpci(nlpci_id, Type='CRIS', minalr=0.25, maxalr=4.0, scale=0.0, desiter=12, mxinc=20, comment='') → NLPCI: Creates an NLPCI card

add_nlrsfd(sid, ga, gb, plane, bdia, blen, bclr, soln, visco, pvapco, nport, pres1, theta1, pres2, theat2, npnt, offset1, offset2) → None

add_nolin1(sid, gi, ci, s, gj, cj, t) → None

add_nolin2(sid, g, ci, s, gj, cj, gk, ck) → None

add_nolin3(sid, gi, ci, s, gj, cj, a) → None

add_nolin4(sid, gi, ci, s, gj, cj, a) → None

add_nsm(sid: int, nsm_type: str, pid_eid: int, value: float, comment: str = '') → NSM

Creates an NSM card

Parameters:

sidint

Case control NSM id

nsm_typestr

Type of card the NSM is applied to valid_properties = {

PSHELL, PCOMP, PBAR, PBARL, PBEAM, PBEAML, PBCOMP, PROD, CONROD, PBEND, PSHEAR, PTUBE, PCONEAX, PRAC2D, ELEMENT

}

pid_eidlist[int]; int

property id or element id depending on nsm_type

valuelist[float]; float

the non-structural pass per unit length/area same length as pid_eid

commentstr; default=’’

a comment for the card

add_nsm1(sid: int, nsm_type: str, value: float, ids: list[int], comment: str = '') → NSM1

Creates an NSM1 card

Parameters:

sidint

Case control NSM id

nsm_typestr

Type of card the NSM is applied to valid_properties = {

PSHELL, PCOMP, PBAR, PBARL, PBEAM, PBEAML, PBCOMP, PROD, CONROD, PBEND, PSHEAR, PTUBE, PCONEAX, PRAC2D, ELEMENT

}

valuefloat

the non-structural pass per unit length/area

idslist[int]

property ids or element ids depending on nsm_type

commentstr; default=’’

a comment for the card

add_nsmadd(sid: int, sets: list[int], comment: str = '') → NSMADD

Creates an NSMADD card, which sum NSM sets

Parameters:

sidint: the NSM Case Control value
setslist[int]: the NSM, NSM1, NSML, NSML1 values
commentstr; default=’’: a comment for the card

add_nsml(sid: int, nsm_type: str, pid_eid: int, value: float, comment: str = '') → NSML

Creates an NSML card, which defines lumped non-structural mass

Parameters:

sidint

Case control NSM id

nsm_typestr

Type of card the NSM is applied to valid_properties = {

PSHELL, PCOMP, PBAR, PBARL, PBEAM, PBEAML, PBCOMP, PROD, CONROD, PBEND, PSHEAR, PTUBE, PCONEAX, PRAC2D, ELEMENT

}

pid_eidlist[int]; int

property id or element id depending on nsm_type

valuelist[float]; float

the non-structural pass per unit length/area same length as pid_eid

commentstr; default=’’

a comment for the card

add_nsml1(sid: int, nsm_type: str, value: float, ids: list[int], comment: str = '') → NSML1

Creates an NSML1 card, which defines lumped non-structural mass

Parameters:

sidint

Case control NSM id

nsm_typestr

Type of card the NSM is applied to valid_properties = {

PSHELL, PCOMP, PBAR, PBARL, PBEAM, PBEAML, PBCOMP, PROD, CONROD, PBEND, PSHEAR, PTUBE, PCONEAX, PRAC2D, ELEMENT

}

valuefloat

the non-structural pass per unit length/area

idslist[int]

property ids or element ids depending on nsm_type

commentstr; default=’’

a comment for the card

add_nxstrat(sid, params, comment='') → NXSTRAT: Creates an NXSTRAT card

add_omit1(ids: list[int], components: str, comment='') → OMIT | OMIT1

Creates an OMIT1 card, which defines the degree of freedoms that will be excluded (o-set) from the analysis set (a-set).

Parameters:

idslist[int]: the GRID/SPOINT ids
componentsstr: the degree of freedoms to be omitted (e.g., ‘1’, ‘123’)
commentstr; default=’’: a comment for the card

add_paabsf(pid, tzreid=None, tzimid=None, s=1.0, a=1.0, b=0.0, k=0.0, rhoc=1.0, comment='')

add_pacabs(pid, cutfr, b, k, m, synth=True, tid_resistance=None, tid_reactance=None, tid_weight=None, comment='') → PACBAR

Creates a PACABS card

Parameters:

pidint: Property identification number.
synthbool; default=True: Request the calculation of B, K, and M from the tables TIDi below
tid_resistanceint; default=None: Identification of the TABLEDi entry that defines the resistance.
tid_reactanceint; default=None: Identification of the TABLEDi entry that defines the reactance.
tid_weightint; default=None: Identification of the TABLEDi entry that defines the weighting function.
cutfrfloat: Cutoff frequency for tables referenced above. (Real > 0.0)
B, K, Mfloat: Equivalent damping, stiffness and mass values per unit area. (Real > 0.0)
..note:: tables are defined as a function of frequency in cycles/time

add_pacbar(pid: int, mback: float, mseptm: float, freson: float, kreson: float, comment: str = '') → PACBAR

Creates a PACBAR card

Parameters:

pidint: Property identification number. (Integer > 0)
mbackfloat: Mass per unit area of the backing material
mseptmfloat: Mass per unit area of the septum material
fresonfloat; default=None: Resonant frequency of the sandwich construction in hertz.
kresonfloat; default=None: Resonant stiffness of the sandwich construction.

add_paero1(pid, caero_body_ids=None, comment='') → PAERO1

Creates a PAERO1 card, which defines associated bodies for the panels in the Doublet-Lattice method.

Parameters:

pidint: PAERO1 id
caero_body_idslist[int]; default=None: CAERO2 ids that are within the same IGID group
commentstr; default=’’: a comment for the card

add_paero2(pid: int, orient: str, width: float, AR: float, thi: list[int], thn: list[int], lrsb: int | None = None, lrib: int | None = None, lth: int | None = None, comment: str = '') → PAERO2

Creates a PAERO2 card, which defines additional cross-sectional properties for the CAERO2 geometry.

Parameters:

pidint

PAERO1 id

orientstr

Orientation flag. Type of motion allowed for bodies. Refers to the aerodynamic coordinate system of ACSID. See AERO entry. valid_orientations = {Z, Y, ZY}

widthfloat

Reference half-width of body and the width of the constant width interference tube

ARfloat

Aspect ratio of the interference tube (height/width)

thi / thnlist[int]

The first (thi) and last (thn) interference element of a body to use the theta1/theta2 array

lrsbint; default=None

intAEFACT id containing a list of slender body half-widths: at the end points of the slender body elements

None : use width

lribint; default=None

intAEFACT id containing a list of interference body: half-widths at the end points of the interference elements

None : use width

lthlist[int, int]; default=None

AEFACT ids for defining theta arrays for interference calculations for theta1/theta2; length=2

commentstr; default=’’

a comment for the card

add_paero3(pid, nbox, ncontrol_surfaces, x, y, comment='') → PAERO3

Creates a PAERO3 card, which defines the number of Mach boxes in the flow direction and the location of cranks and control surfaces of a Mach box lifting surface.

Parameters:

pidint: PAERO1 id
nboxint: Number of Mach boxes in the flow direction; 0 < nbox < 50
ncontrol_surfacesint: Number of control surfaces. (0, 1, or 2)
x / ylist[float, None]: float : locations of points 5 through 12, which are in the aerodynamic coordinate system, to define the cranks and control surface geometry.
commentstr; default=’’: a comment for the card

add_paero4(pid, docs, caocs, gapocs, cla=0, lcla=0, circ=0, lcirc=0, comment='') → PAERO4: Creates a PAERO4 card

add_paero5(pid: int, caoci: list[float], nalpha: int = 0, lalpha: int = 0, nxis: int = 0, lxis: int = 0, ntaus: int = 0, ltaus: int = 0, comment='') → PAERO5: Creates a PAERO5 card

add_panel(names: list[str], set_ids: list[int]) → None

add_param(key: str, values: list[int | float | str], comment: str = '') → PARAM

add_pbar(pid, mid, A=0.0, i1=0.0, i2=0.0, i12=0.0, j=0.0, nsm=0.0, c1=0.0, c2=0.0, d1=0.0, d2=0.0, e1=0.0, e2=0.0, f1=0.0, f2=0.0, k1=100000000.0, k2=100000000.0, comment='') → PBAR

Creates a PBAR card

Parameters:

pidint: property id
midint: material id
Afloat: area
i1, i2, i12, jfloat: moments of inertia
nsmfloat; default=0.: nonstructural mass per unit length
c1/c2, d1/d2, e1/e2, f1/f2float: the y/z locations of the stress recovery points c1 - point C.y c2 - point C.z
k1 / k2float; default=1.e8: Shear stiffness factor K in K*A*G for plane 1/2.
commentstr; default=’’: a comment for the card

add_pbarl(pid: int, mid: int, Type: str, dim: list[float], group: str = 'MSCBML0', nsm: float = 0.0, comment: str = '') → PBARL

Creates a PBARL card, which defines A, I1, I2, I12, and J using dimensions rather than explicit values.

Parameters:

pidint

property id

midint

material id

Typestr

type of the bar valid_types = {

ROD, TUBE, I, CHAN, T, BOX, BAR, CROSS, H, T1, I1, CHAN1, Z, CHAN2, T2, BOX1, HEXA, HAT, HAT1, DBOX

}

dimlist[float]

dimensions for cross-section corresponding to Type; the length varies

groupstr default=’MSCBML0’

this parameter can lead to a very broken deck with a very bad error message; don’t touch it!

nsmfloat; default=0.

non-structural mass

commentstr; default=’’

a comment for the card

The shear center and neutral axis do not coincide when:

Type = I and dim2 != dim3
Type = CHAN, CHAN1, CHAN2
Type = T
Type = T1, T2
Type = BOX1
Type = HAT, HAT1
Type = DBOX

add_pbcomp(pid, mid, y, z, c, mids, area=0.0, i1=0.0, i2=0.0, i12=0.0, j=0.0, nsm=0.0, k1=1.0, k2=1.0, m1=0.0, m2=0.0, n1=0.0, n2=0.0, symopt=0, comment='') → PBCOMP

Creates a PBCOMP card

Parameters:

pidint: Property ID
midint: Material ID
midslist[int]: Material ID for the i-th integration point
y / zlist[float]: The (y,z) coordinates of the lumped areas in the element coordinate system
clist[float]; default=0.0: Fraction of the total area for the i-th lumped area default not supported…
areafloat: Area of beam cross section
i1 / i2float; default=0.0: Area moment of inertia about plane 1/2 about the neutral axis
i12float; default=0.0: area product of inertia
jfloat; default=0.0: Torsional moment of interia
nsmfloat; default=0.0: Nonstructural mass per unit length
k1 / k2float; default=1.0: Shear stiffness factor K in K*A*G for plane 1/2
m1 / m2float; default=0.0: The (y,z) coordinates of center of gravity of nonstructural mass
n1 / n2float; default=0.0: The (y,z) coordinates of neutral axis
symoptint; default=0: Symmetry option to input lumped areas for the beam cross section 0 < Integer < 5
commentstr; default=’’: a comment for the card

add_pbeam(pid, mid, xxb, so, area, i1, i2, i12, j, nsm=None, c1=None, c2=None, d1=None, d2=None, e1=None, e2=None, f1=None, f2=None, k1=1.0, k2=1.0, s1=0.0, s2=0.0, nsia=0.0, nsib=None, cwa=0.0, cwb=None, m1a=0.0, m2a=0.0, m1b=None, m2b=None, n1a=0.0, n2a=0.0, n1b=None, n2b=None, comment='') → PBEAM

Todo

fix 0th entry of self.so, self.xxb

Creates a PBEAM card

Parameters:

pidint: property id
midint: material id
xxblist[float]: The percentage locations along the beam [0., …, 1.]
solist[str]: YES, YESA, NO
arealist[float]: area
i1, i2, i12, jlist[float]: moments of inertia
nsmlist[float]; default=None -> [0.]*nxxb: nonstructural mass per unit length
c1/c2, d1/d2, e1/e2, f1/f2list[float]; default=None -> [0.]*nxxb: the y/z locations of the stress recovery points c1 - point C.y c2 - point C.z
k1 / k2float; default=1.: Shear stiffness factor K in K*A*G for plane 1/2.
s1 / s2float; default=0.: Shear relief coefficient due to taper for plane 1/2.
nsia / nsiafloat; default=0. / nsia: non structural mass moment of inertia per unit length about nsm center of gravity at Point A/B.
cwa / cwbfloat; default=0. / cwa: warping coefficient for end A/B.
m1a / m2afloat; default=0. / 0.: y/z coordinate of center of gravity of nonstructural mass for end A.
m1b / m2bfloat; default=m1a / m2a: y/z coordinate of center of gravity of nonstructural mass for end B.
n1a / n2afloat; default=0. / 0.: y/z coordinate of neutral axis for end A.
n1b / n2bfloat; default=n1a / n2a: y/z coordinate of neutral axis for end B.
commentstr; default=’’: a comment for the card

add_pbeam3(pid, mid, A, iz, iy, iyz=0.0, j=None, nsm=0.0, cy=0.0, cz=0.0, dy=0.0, dz=0.0, ey=0.0, ez=0.0, fy=0.0, fz=0.0, comment='') → PBEAM3: Creates a PBEAM3 card

add_pbeaml(pid: int, mid: int, beam_type: str, xxb: list[float], dims: list[list[float]], so=None, nsm=None, group: str = 'MSCBML0', comment: str = '') → PBEAML

Creates a PBEAML card

Parameters:

pidint

property id

midint

material id

beam_typestr

the section profile

xxblist[float]

The percentage locations along the beam [0., …, 1.]

dimslist[dim]

dimlist[float]: The dimensions for each section

solist[str]; default=None

YES, YESA, NO None : [0.] * len(xxb)

nsmlist[float]; default=None

nonstructural mass per unit length None : [0.] * len(xxb)

groupstr; default=’MSCBML0’

this parameter can lead to a very broken deck with a very bad error message; don’t touch it!

commentstr; default=’’

a comment for the card

add_pbeaml_dvprel1(pid: int, mid: int, beam_type: str, xxb, dims, dim_constraints, so=None, nsm=None, group: str = 'MSCBML0', comment: str = '') → tuple[PBARL, list[DESVAR], list[DVPREL1]]

dim = [0.1, 0.2, 0.3, 0.4] dim_constraints = [

None, [0.01, 1.0], [None, 1.0], None,

]

add_pbend(pid, mid, beam_type, A, i1, i2, j, c1, c2, d1, d2, e1, e2, f1, f2, k1, k2, nsm, rc, zc, delta_n, fsi, rm, t, p, rb, theta_b, comment='') → PBEND: Creates a PBEND card

add_pbmsect(pid, mid, form, options, comment='') → PBMSECT: Creates a PBMSECT card

add_pbrsect(pid, mid, form, options, comment='') → PBRSECT: Creates a PBRSECT card

add_pbush(pid, k, b, ge, rcv=None, mass=None, comment='') → PBUSH

Creates a PBUSH card, which defines a property for a CBUSH

Parameters:

pidint: property id
klist[float]: Nominal stiffness values in directions 1 through 6. len(k) = 6
blist[float]: Nominal damping coefficients in direction 1 through 6 in units of force per unit velocity len(b) = 6
gelist[float]: Nominal structural damping constant in directions 1 through 6. len(ge) = 6
rcvlist[float]; default=None -> (None, None, None, None): [sa, st, ea, et] = rcv length(rcv) = 4
massfloat; default=None: lumped mass of the CBUSH This is an MSC only parameter.
commentstr; default=’’: a comment for the card

add_pbush1d(pid: int, k: float = 0.0, c: float = 0.0, m: float = 0.0, sa: float = 0.0, se: float = 0.0, optional_vars=None, comment: str = '') → PBUSH1D: Creates a PBUSH1D card

add_pbush2d_cross(pid: int, k11: float, k22: float, b11: float, b22: float, m11: float, m22: float, k12: float, k21: float, b12: float, b21: float, m12: float, m21: float, comment: str = '') → PBUSH2D: MSC only card

PBUSH2D | PID | K11 | K22 | B11 | B22 | M11 | M22 |

| CROSS | K12 | K21 | B12 | B21 | M12 | M21 |

add_pbusht(pid: int, k_tables: list[int], b_tables: list[int], ge_tables: list[int], kn_tables: list[int], comment: str = '') → PBUSHT: Creates a PBUSHT card

add_pcomp(pid: int, mids: list[int], thicknesses: list[float], thetas=None, souts=None, nsm=0.0, sb=0.0, ft=None, tref=0.0, ge=0.0, lam=None, z0=None, comment='') → PCOMP

Creates a PCOMP card

Parameters:

pidint: property id
midslist[int, …, int]: material ids for each ply
thicknesseslist[float, …, float]: thicknesses for each ply
thetaslist[float, …, float]; default=None: ply angle None : [0.] * nplies
soutslist[str, …, str]; default=None: should the stress? be printed; {YES, NO} None : [NO] * nplies
nsmfloat; default=0.: nonstructural mass per unit area
sbfloat; default=0.: Allowable shear stress of the bonding material. Used by the failure theory
ftstr; default=None: failure theory; {HILL, HOFF, TSAI, STRN, None}
treffloat; default=0.: reference temperature
gefloat; default=0.: structural damping
lamstr; default=None: symmetric flag; {SYM, MEM, BEND, SMEAR, SMCORE, None} None : not symmmetric
z0float; default=None: Distance from the reference plane to the bottom surface None : -1/2 * total_thickness
commentstr; default=’’: a comment for the card

add_pcompg(pid, global_ply_ids, mids, thicknesses, thetas=None, souts=None, nsm=0.0, sb=0.0, ft=None, tref=0.0, ge=0.0, lam=None, z0=None, comment='') → PCOMPG

Creates a PCOMPG card

Parameters:

pidint: property id
global_ply_idslist[int]: the ply id
midslist[int, …, int]: material ids for each ply
thicknesseslist[float, …, float]: thicknesses for each ply
thetaslist[float, …, float]; default=None: ply angle None : [0.] * nplies
soutslist[str, …, str]; default=None: should the stress? be printed; {YES, NO} None : [NO] * nplies
nsmfloat; default=0.: nonstructural mass per unit area
sbfloat; default=0.: Allowable shear stress of the bonding material. Used by the failure theory
ftstr; default=None: failure theory; {HILL, HOFF, TSAI, STRN, None}
treffloat; default=0.: reference temperature
gefloat; default=0.: structural damping
lamstr; default=None: symmetric flag; {SYM, MEM, BEND, SMEAR, SMCORE, None} None : not symmmetric
z0float; default=None: Distance from the reference plane to the bottom surface None : -1/2 * total_thickness
commentstr; default=’’: a comment for the card

add_pcomps(pid: int, global_ply_ids: list[int], mids: list[int], thicknesses: list[float], thetas: list[float], cordm: int = 0, psdir: int = 13, sb=None, nb=None, tref: float = 0.0, ge: float = 0.0, failure_theories=None, interlaminar_failure_theories=None, souts: list[str] = None, comment: str = '') → PCOMPS: Creates a PCOMPS card

add_pconeax(pid, mid1, t1=None, mid2=0, i=None, mid3=None, t2=None, nsm=0.0, z1=None, z2=None, phi=None, comment='') → PCONEAX: Creates a PCONEAX card

add_pconv(pconid, mid=None, form=0, expf=0.0, ftype=0, tid=None, chlen=None, gidin=None, ce=0, e1=None, e2=None, e3=None, comment='') → PCONV

Creates a PCONV card

Parameters:

pconidint: Convection property ID
midint; default=None: Material ID
formint; default=0: Type of formula used for free convection Must be {0, 1, 10, 11, 20, or 21}
expffloat; default=0.0: Free convection exponent as implemented within the context of the particular form that is chosen
ftypeint; default=0: Formula type for various configurations of free convection
tidint; default=None: Identification number of a TABLEHT entry that specifies the two variable tabular function of the free convection heat transfer coefficient
chlenfloat; default=None: Characteristic length
gidinint; default=None: Grid ID of the referenced inlet point
ceint; default=0: Coordinate system for defining orientation vector.
e1 / e2 / e3list[float]; default=None: Components of the orientation vector in coordinate system CE. The origin of the orientation vector is grid point G1
commentstr; default=’’: a comment for the card

add_pconvm(pconid: int, mid: int, coef: float, form: int = 0, flag: int = 0, expr: float = 0.0, exppi: float = 0.0, exppo: float = 0.0, comment: str = '') → PCONVM

Creates a PCONVM card

Parameters:

pconidint: Convection property ID
mid: int: Material ID
coef: float: Constant coefficient used for forced convection
form: int; default=0: Type of formula used for free convection Must be {0, 1, 10, 11, 20, or 21}
flag: int; default=0: Flag for mass flow convection
expr: float; default=0.0: Reynolds number convection exponent
exppi: float; default=0.0: Prandtl number convection exponent for heat transfer into the working fluid
exppo: float; default=0.0: Prandtl number convection exponent for heat transfer out of the working fluid
commentstr; default=’’: a comment for the card

add_pdamp(pid: int, b: float, comment: str = '') → PDAMP: Creates a PDAMP card

add_pdamp5(pid: int, mid: int, b: float, comment: str = '') → PDAMP5: Creates a PDAMP5 card

add_pdampt(pid: int, tbid: int, comment: str = '') → PDAMPT: Creates a PDAMPT card

add_pelas(pid: int, k: float, ge: float = 0.0, s: float = 0.0, comment: str = '') → PELAS

Creates a PELAS card

Parameters:

pidint: property id
kfloat: spring stiffness
geint; default=0.0: damping coefficient
sfloat; default=0.0: stress coefficient
commentstr; default=’’: a comment for the card

add_pelast(pid: int, tkid: int = 0, tgeid: int = 0, tknid: int = 0, comment: str = '') → PELAST

Creates a PELAST card

Parameters:

pidint: property id
tkidfloat: TABLEDx that defines k vs. frequency
tgeidint; default=0: TABLEDx that defines ge vs. frequency
tknidfloat; default=0.: TABLEDx that defines force vs. displacement
commentstr; default=’’: a comment for the card

add_pfast(pid: int, d: int, kt1: float, kt2: float, kt3: float, mcid: int = -1, mflag: int = 0, kr1: float = 0.0, kr2: float = 0.0, kr3: float = 0.0, mass: float = 0.0, ge: float = 0.0, comment: str = '') → PFAST

Creates a PAST card

Parameters:

pidint: property id
dint: diameter of the fastener
kt1, kt2, kt3float: stiffness values in directions 1-3
mcidint; default=01: specifies the element stiffness coordinate system
mflagint; default=0: 0-absolute; 1-relative
kr1, kr2, kr3float; default=0.0: rotational stiffness values in directions 1-3
massfloat; default=0.0: lumped mass of the fastener
gefloat; default=0.0: structural damping
commentstr; default=’’: a comment for the card

add_pgap(pid: int, u0: float = 0.0, f0: float = 0.0, ka: float = 100000000.0, kb: float | None = None, mu1: float = 0.0, kt: float | None = None, mu2: float | None = None, tmax: float = 0.0, mar: float = 100.0, trmin: float = 0.001, comment: str = '') → PGAP

Defines the properties of the gap element (CGAP entry).

Parameters:

pidint: property id for a CGAP
u0float; default=0.: Initial gap opening
f0float; default=0.: Preload
kafloat; default=1.e8: Axial stiffness for the closed gap
kbfloat; default=None -> 1e-14 * ka: Axial stiffness for the open gap
mu1float; default=0.: Coefficient of static friction for the adaptive gap element or coefficient of friction in the y transverse direction for the nonadaptive gap element
ktfloat; default=None -> mu1*ka: Transverse stiffness when the gap is closed
mu2float; default=None -> mu1: Coefficient of kinetic friction for the adaptive gap element or coefficient of friction in the z transverse direction for the nonadaptive gap element
tmaxfloat; default=0.: Maximum allowable penetration used in the adjustment of penalty values. The positive value activates the penalty value adjustment
marfloat; default=100.: Maximum allowable adjustment ratio for adaptive penalty values KA and KT
trminfloat; default=0.001: Fraction of TMAX defining the lower bound for the allowable penetration
commentstr; default=’’: a comment for the card

add_phbdy(pid, af=None, d1=None, d2=None, comment='') → PHBDY

Creates a PHBDY card

Parameters:

eidint: element id
pidint: property id
afint: Area factor of the surface used only for CHBDYP element Must be {POINT, LINE, TUBE, ELCYL} TUBE : constant thickness of hollow tube
d1, d2float; default=None: Diameters associated with the surface Used with CHBDYP [ELCYL, TUBE, FTUBE] surface elements
commentstr; default=’’: a comment for the card

add_pihex(pid, mid, cordm=0, integ=None, stress=None, isop=None, fctn='SMECH', comment='') → PIHEX: See also

PSOLID

add_pload(sid, pressure, nodes, comment='') → PLOAD

Creates a PLOAD card, which defines a uniform pressure load on a shell/solid face or arbitrarily defined quad/tri face

Parameters:

sidint: load id
pressurefloat: the pressure to apply
nodeslist[int]: The nodes that are used to define the normal are defined using the same method as the CTRIA3/CQUAD4 normal. n = 3 or 4
commentstr; default=’’: a comment for the card

add_pload1(sid, eid, load_type, scale, x1, p1, x2=None, p2=None, comment='') → PLOAD1

Creates a PLOAD1 card, which may be applied to a CBAR/CBEAM

Parameters:

sidint: load id
eidint: element to apply the load to
load_typestr: type of load that’s applied valid_types = {FX, FY, FZ, FXE, FYE, FZE,

MX, MY, MZ, MXE, MYE, MZE}
scalestr: Determines scale factor for X1, X2. {LE, FR, LEPR, FRPR}
x1 / x2float / float: the starting/end position for the load application the default for x2 is x1
p1 / p2float / float: the magnitude of the load at x1 and x2 the default for p2 is p1
commentstr; default=’’: a comment for the card
Point Loadx1 == x2
Distributed Loadx1 != x2

add_pload2(sid, pressure, eids, comment='') → PLOAD2

Creates a PLOAD2 card, which defines an applied load normal to the quad/tri face

Parameters:

sidint: load id
pressurefloat: the pressure to apply to the elements
eidsint / list[int]: the elements to apply pressure to For NX Nastran and MSC Nastran < 2018 the list must have no more than 6 ids or it must be a continouus monotonic list (e.g., [1, 2, …, 1000]). If you don’t follow this rule, you’ll incur in a fatal error. This limitation does not apply to MSC Nastran >= 2018.
commentstr; default=’’: a comment for the card

add_pload4(sid, eids, pressures, g1=None, g34=None, cid=0, nvector=None, surf_or_line='SURF', line_load_dir='NORM', comment='') → PLOAD4

Creates a PLOAD4 card

Parameters:

sidint: the load id
eidslist[int, …]: shells : the range of element ids; must be sequential solids : must be length 1
pressureslist[float, float, float, float]: tri : must be length 4 (the last value should be the same as the 0th value) quad : must be length 4
g1int/None: only used for solid elements
g34int / None: only used for solid elements
cidint; default=0: the coordinate system for ???
nvector(3, ) float ndarray: blank : load acts normal to the face the local pressure vector
surf_or_linestr; default=’SURF’: SURF : surface load LINE : line load (only defined for QUADR, TRIAR) not supported
line_load_dirstr; default=’NORM’: direction of the line load (see surf_or_line); {X, Y, Z, TANG, NORM} not supported
commentstr; default=’’: a comment for the card
TODO: fix the way “pressures” works

add_ploadx1(sid, eid, pa, nids, pb=None, theta=0.0, comment='') → PLOADX1

Creates a PLOADX1 card, which defines surface traction for axisymmetric elements.

Parameters:

sidint: load id
eidint: element id (CQUADX, CTRIAX, or CTRIAX6)
nidslist[int, int]: Corner grid points. GA and GB are any two adjacent corner grid points of the element
pa / pbfloat / None: Surface traction at grid point GA or GB pb : default is None -> pa
thetafloat; default=0.0: Angle between surface traction and inward normal to the line segment.
commentstr; default=’’: a comment for the card

add_plotel(eid: int, nodes: list[int], comment: str = '') → PLOTEL

Adds a PLOTEL card

Parameters:

eidint: Element ID
nodeslist[int, int]: Unique GRID point IDs
commentstr; default=’’: a comment for the card

add_plplane(pid, mid, cid=0, stress_strain_output_location='GRID', comment='') → PLPLANE: Creates a PLPLANE card

add_plsolid(pid, mid, stress_strain='GRID', ge=0.0, comment='') → PLSOLID

Creates a PLSOLID card

Parameters:

pidint: property id
midint: material id
stress_strainstr: Location of stress and strain output valid types = {GRID, GAUSS}
gefloat; default=0.: damping coefficient
commentstr; default=’’: a comment for the card

add_pmass(pid: int, mass: float, comment: str = '') → PMASS

Creates an PMASS card, which defines a mass applied to a single DOF

Parameters:

pidint: Property id used by a CMASS1/CMASS3 card
massfloat: the mass to apply
commentstr; default=’’: a comment for the card

add_pmic(pid: int, comment: str = '') → PMIC

add_point(nid: int, xyz: Any, cp: int = 0, comment: str = '') → POINT

Creates the POINT card

Parameters:

nidint: node id
xyz(3, ) float ndarray; default=None -> [0., 0., 0.]: the xyz/r-theta-z/rho-theta-phi values
cpint; default=0: coordinate system for the xyz location
commentstr; default=’’: a comment for the card

add_pointax(nid, ringax, phi, comment='') → POINTAX: Creates a POINTAX card

add_pplane(pid: int, mid: int, t: float = 0.0, nsm: float = 0.0, formulation_option: int = 0, comment: str = '') → PPLANE: Creates a PPLANE card

add_prac2d(pid, mid, thick, iplane, nsm=0.0, gamma=0.5, phi=180.0, comment='') → PRAC2D: Creates a PRAC2D card

add_prac3d(pid, mid, gamma=0.5, phi=180.0, comment='') → PRAC3D: Creates a PRAC3D card

add_presax(sid, pressure, rid1, rid2, phi1=0.0, phi2=360.0, comment='') → PRESAX: Creates a PRESAX card

add_prod(pid: int, mid: int, A: float, j: float = 0.0, c: float = 0.0, nsm: float = 0.0, comment: str = '') → PROD

Creates a PROD card

Parameters:

pidint: property id
midint: material id
Afloat: area
jfloat; default=0.: polar moment of inertia
cfloat; default=0.: stress factor
nsmfloat; default=0.: nonstructural mass per unit length
commentstr; default=’’: a comment for the card

add_pset(idi, poly1, poly2, poly3, cid, typei, typeids, comment='') → PSET: PSET ID POLY1 POLY2 POLY3 CID SETTYP ID

add_pshear(pid: int, mid: int, t: float, nsm: float = 0.0, f1: float = 0.0, f2: float = 0.0, comment: str = '') → PSHEAR

Creates a PSHEAR card

Parameters:

pidint: property id
midint: material id
tfloat: shear panel thickness
nsmfloat; default=0.: nonstructural mass per unit length
f1float; default=0.0: Effectiveness factor for extensional stiffness along edges 1-2 and 3-4
f2float; default=0.0: Effectiveness factor for extensional stiffness along edges 2-3 and 1-4
commentstr; default=’’: a comment for the card

add_pshell(pid, mid1=None, t=None, mid2=None, twelveIt3=1.0, mid3=None, tst=0.833333, nsm=0.0, z1=None, z2=None, mid4=None, comment='') → PSHELL

Creates a PSHELL card

Parameters:

pidint: property id
mid1int; default=None: defines membrane material defines element density (unless blank)
mid2int; default=None: defines bending material defines element density if mid1=None
mid3int; default=None: defines transverse shear material
mid4int; default=None: defines membrane-bending coupling material
twelveIt3float; default=1.0: Bending moment of inertia ratio, 12I/T^3. Ratio of the actual bending moment inertia of the shell, I, to the bending moment of inertia of a homogeneous shell, T^3/12. The default value is for a homogeneous shell.
nsmfloat; default=0.0: non-structural mass per unit area
z1 / z2float; default=None: fiber distance location 1/2 for stress/strain calculations z1 default : -t/2 if thickness is defined z2 default : t/2 if thickness is defined
commentstr; default=’’: a comment for the card

add_psolid(pid, mid, cordm=0, integ=None, stress=None, isop=None, fctn='SMECH', comment='') → PSOLID

Creates a PSOLID card

Parameters:

pidint: property id
midint: material id
cordmint; default=0: material coordinate system
integint; default=None: None-varies depending on element type 0, ‘BUBBLE’ 1, ‘GAUSS’ 2, ‘TWO’ 3, ‘THREE’ REDUCED FULL
stressint/str; default=None: None/GRID, 1-GAUSS
isopint/str; default=None: 0-REDUCED 1-FULL
fctnstr; default=’SMECH’: PFLUID/SMECH
commentstr; default=’’: a comment for the card

add_ptube(pid, mid, OD1, t=None, nsm=0.0, OD2=None, comment='') → PTUBE

Adds a PTUBE card

Parameters:

pidint: property id
midint: material id
OD1float: outer diameter at End A
tfloat; default=None -> OD1/2.: thickness
nsmfloat; default=0.: non-structural mass per unit length
OD2float; default=None -> OD1: outer diameter at End B
commentstr; default=’’: a comment for the card

add_pval(idi, poly1, poly2, poly3, cid, typei, typeids, comment='') → PVAL: PVAL ID POLY1 POLY2 POLY3 CID SETTYP ID

add_pvisc(pid, ce, cr, comment='') → PVISC

Creates a PVISC card

Parameters:

pidint: property id for a CVISC
cefloat: Viscous damping values for extension in units of force per unit velocity
crfloat: Viscous damping values for rotation in units of moment per unit velocity.
commentstr; default=’’: a comment for the card

add_qbdy1(sid, qflux, eids, comment='') → QBDY1: Creates a QBDY1 card

add_qbdy2(sid, eid, qfluxs, comment='') → QBDY2: Creates a QBDY2 card

add_qbdy3(sid, Q0, cntrlnd, eids, comment='') → QBDY3

Creates a QBDY3 card

Parameters:

sidint: Load set identification number. (Integer > 0)
q0float; default=None: Magnitude of thermal flux vector into face
control_idint; default=0: Control point
eidslist[int] or THRU: Element identification number of a CHBDYE, CHBDYG, or CHBDYP entry
commentstr; default=’’: a comment for the card

add_qhbdy(sid, flag, q0, grids, af=None, comment=''

bdf Module

`bdf` Module