Abaqus Model Database#

Mdb commands are used to create and upgrade an Abaqus model database that stores models and analysis controls.

Objects in Mdb

Object features#

Mdb#

class Mdb(pathName='')[source]#

The Mdb object is the high-level Abaqus model database. A model database stores models and analysis controls.

Note

This object can be accessed by:

mdb

Note

Check Mdb on help.3ds.com/0.1..

Public Data Attributes:

Inherited from MdbBase

`version`	An Int specifying the release number of the Mdb object in memory.
`lastChangedCount`	A Float specifying the value of a counter associated with the Mdb object.
`jobs`	A repository of Job objects.
`adaptivityProcesses`	A repository of AdaptivityProcess objects.
`coexecutions`	A repository of Coexecution objects.
`optimizationProcesses`	A repository of OptimizationProcess objects.
`meshEditOptions`	A `MeshEditOptions` object specifying the undo/redo behavior when editing meshes on parts or part instances.
`models`	A repository of Model objects.
`customData`	A `RepositorySupport` object.
`annotations`	A repository of Annotation objects.

Public Methods:

Model(name[, description, stefanBoltzmann, ...])

This method creates a Model object.

Inherited from AcisMdb

`openAcis`(fileName[, scaleFromFile])	This method creates an AcisFile object from a file containing ACIS-format geometry.
`openCatia`(fileName[, topology, ...])	This method creates an AcisFile object from a file containing V5-format geometry.
`openEnf`(fileName, fileType[, topology, ...])	This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER.
`openIges`(fileName[, trimCurve, ...])	This method creates an AcisFile object from a file containing IGES-format geometry.
`openParasolid`(fileName[, topology])	This method creates an AcisFile object from a file containing Parasolid-format geometry.
`openStep`(fileName[, scale])	This method creates an AcisFile object from a file containing STEP-format geometry.
`openVda`(fileName)	This method creates an AcisFile object from a file containing VDA-FS-format geometry.
`openSolidworks`(fileName[, topology])	This method creates an AcisFile object from a file containing Solidworks format geometry.

Inherited from JobMdb

`Job`(name, model[, description, type, queue, ...])	This method creates an analysis job using a model on a model database (MDB) for the model definition.
`JobFromInputFile`(name, inputFileName[, ...])	This method creates an analysis job using an input file for the model definition.
`OptimizationProcess`(name, model, task, ...)	This method creates an OptimizationProcess object.

Inherited from MdbBase

`__init__`([pathName])	This constructor creates an empty Mdb object.
`importDxf`(fileName)	This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry.
`openMdb`(pathName)	This method opens an existing model database file.
`close`()	This method closes an open Mdb object but does not save the Mdb object to disk.
`save`()	This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).
`saveAs`(pathName)	This method saves an Mdb object to disk at the specified location.
`openAuxMdb`(pathName)	This method opens an auxiliary Mdb object on the disk at the specified location.
`closeAuxMdb`()	This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`getAuxMdbModelNames`()	This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`copyAuxMdbModel`(fromName[, toName])	This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Job(name, model, description='', type=abaqusConstants.ANALYSIS, queue='', waitHours=0, waitMinutes=0, atTime='', echoPrint=OFF, contactPrint=OFF, modelPrint=OFF, historyPrint=OFF, scratch='', userSubroutine='', numCpus=1, memory=90, memoryUnits=abaqusConstants.PERCENTAGE, explicitPrecision=abaqusConstants.SINGLE, nodalOutputPrecision=abaqusConstants.SINGLE, parallelizationMethodExplicit=abaqusConstants.DOMAIN, numDomains=1, activateLoadBalancing=OFF, multiprocessingMode=abaqusConstants.DEFAULT, licenseType=abaqusConstants.DEFAULT, *args, **kwargs)[source]#

This method creates an analysis job using a model on a model database (MDB) for the model definition.

Note

This function can be accessed by:

mdb.Job

Note

Check Job on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the new job. The name must be a valid Abaqus/CAE object name.
model (str) – A String specifying the name of the model to be analyzed or a Model object specifying the model to be analyzed.
description (str, default: '') – A String specifying a description of the job.
type (SymbolicConstant, default: ANALYSIS) – A SymbolicConstant specifying the type of job. Possible values are ANALYSIS, SYNTAXCHECK, RECOVER, and RESTART. The default value is ANALYSIS.If the object has the type JobFromInputFile, type = RESTART is not available.
queue (str, default: '') – A String specifying the name of the queue to which to submit the job. The default value is an empty string.Note:You can use the queue argument when creating a Job object on a Windows workstation; however, remote queues are available only on Linux platforms.
waitHours (int, default: 0) – An Int specifying the number of hours to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitMinutes. waitHours and atTime are mutually exclusive.
waitMinutes (int, default: 0) – An Int specifying the number of minutes to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitHours. waitMinutes and atTime are mutually exclusive.
atTime (str, default: '') – A String specifying the time at which to submit the job. If queue is empty, the string syntax must be valid for the Linux at command. If queue is set, the syntax must be valid according to the system administrator. The default value is an empty string.Note:You can use the atTime argument when creating a Job object on a Windows workstation; however, the at command is available only on Linux platforms.
echoPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an echo of the input data is printed. The default value is OFF.
contactPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether contact constraint data are printed. The default value is OFF.
modelPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether model definition data are printed. The default value is OFF.
historyPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether history data are printed. The default value is OFF.
scratch (str, default: '') – A String specifying the location of the scratch directory. The default value is an empty string.
userSubroutine (str, default: '') – A String specifying the file containing the user’s subroutine definitions. The default value is an empty string.
numCpus (int, default: 1) – An Int specifying the number of CPUs to use for this analysis if parallel processing is available. Possible values are numCpus >> 0. The default value is 1.
memory (int, default: 90) – An Int specifying the amount of memory available to Abaqus analysis. The value should be expressed in the units supplied in memoryUnits. The default value is 90.
memoryUnits (SymbolicConstant, default: PERCENTAGE) – A SymbolicConstant specifying the units for the amount of memory used in an Abaqus analysis. Possible values are PERCENTAGE, MEGA_BYTES, and GIGA_BYTES. The default value is PERCENTAGE.
explicitPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying whether to use the double precision version of Abaqus/Explicit. Possible values are SINGLE, FORCE_SINGLE, DOUBLE, DOUBLE_CONSTRAINT_ONLY, and DOUBLE_PLUS_PACK. The default value is SINGLE.
nodalOutputPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying the precision of the nodal output written to the output database. Possible values are SINGLE and FULL. The default value is SINGLE.
parallelizationMethodExplicit (SymbolicConstant, default: DOMAIN) – A SymbolicConstant specifying the parallelization method for Abaqus/Explicit. This value is ignored for Abaqus/Standard. Possible values are DOMAIN and LOOP. The default value is DOMAIN.
numDomains (int, default: 1) – An Int specifying the number of domains for parallel execution in Abaqus/Explicit. When parallelizationMethodExplicit = DOMAIN, numDomains must be a multiple of numCpus. The default value is 1.
activateLoadBalancing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to activate dyanmic load balancing for jobs running on multiple processors with multiple domains in Abaqus/Explicit. The default value is OFF.
multiprocessingMode (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether an analysis is decomposed into threads or into multiple processes that communicate through a message passing interface (MPI). Possible values are DEFAULT, THREADS, and MPI. The default value is DEFAULT.
licenseType (SymbolicConstant, default: DEFAULT) –
A SymbolicConstant specifying the type of license type being used in the case of the DSLS SimUnit license model. Possible values are DEFAULT, TOKEN, and CREDIT. The default value is DEFAULT.If the license model is not the DSLS SimUnit, the licenseType is not available.

Changed in version 2022: The licenseType argument was added.

Returns:

A ModelJob object.

Return type:

ModelJob

Raises:

AbaqusException –

JobFromInputFile(name, inputFileName, type=abaqusConstants.ANALYSIS, queue='', waitHours=0, waitMinutes=0, atTime='', scratch='', userSubroutine='', numCpus=1, memory=90, memoryUnits=abaqusConstants.PERCENTAGE, explicitPrecision=abaqusConstants.SINGLE, nodalOutputPrecision=abaqusConstants.SINGLE, parallelizationMethodExplicit=abaqusConstants.DOMAIN, numDomains=1, activateLoadBalancing=OFF, multiprocessingMode=abaqusConstants.DEFAULT, licenseType=abaqusConstants.DEFAULT)[source]#

This method creates an analysis job using an input file for the model definition.

Note

This function can be accessed by:

mdb.JobFromInputFile

Note

Check JobFromInputFile on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the new job. The name must be a valid Abaqus/CAE object name.
inputFileName (str) – A String specifying the input file to read. Possible values are any valid file name. If the .inp extension is not included in the value of the argument, the system will append it for the user.
type (SymbolicConstant, default: ANALYSIS) – A SymbolicConstant specifying the type of job. Possible values are ANALYSIS, SYNTAXCHECK, and RECOVER. The default value is ANALYSIS.For theJobFromInputFile object, type = RESTART is not currently supported.
queue (str, default: '') – A String specifying the name of the queue to which to submit the job. The default value is an empty string.Note: You can use the queue argument when creating a Job object on a Windows workstation; however, remote queues are available only on Linux platforms.
waitHours (int, default: 0) – An Int specifying the number of hours to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitMinutes. waitHours and atTime are mutually exclusive.
waitMinutes (int, default: 0) – An Int specifying the number of minutes to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitHours. waitMinutes and atTime are mutually exclusive.
atTime (str, default: '') – A String specifying the time at which to submit the job. If queue is empty, the string syntax must be valid for the Linux at command. If queue is set, the syntax must be valid according to the system administrator. The default value is an empty string.Note: You can use the atTime argument when creating a Job object on a Windows workstation; however, the at command is available only on Linux platforms.
scratch (str, default: '') – A String specifying the location of the scratch directory. The default value is an empty string.
userSubroutine (str, default: '') – A String specifying the file containing the user’s subroutine definitions. The default value is an empty string.
numCpus (int, default: 1) – An Int specifying the number of CPUs to use for this analysis if parallel processing is available. Possible values are numCpus >> 0. The default value is 1.
memory (int, default: 90) – An Int specifying the amount of memory available to Abaqus analysis. The value should be expressed in the units supplied in memoryUnits. The default value is 90.
memoryUnits (SymbolicConstant, default: PERCENTAGE) – A SymbolicConstant specifying the units for the amount of memory used in an Abaqus analysis. Possible values are PERCENTAGE, MEGA_BYTES, and GIGA_BYTES. The default value is PERCENTAGE.
explicitPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying whether to use the double precision version of Abaqus/Explicit. Possible values are SINGLE, FORCE_SINGLE, DOUBLE, DOUBLE_CONSTRAINT_ONLY, and DOUBLE_PLUS_PACK. The default value is SINGLE.
nodalOutputPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying the precision of the nodal output written to the output database. Possible values are SINGLE and FULL. The default value is SINGLE.
parallelizationMethodExplicit (SymbolicConstant, default: DOMAIN) – A SymbolicConstant specifying the parallelization method for Abaqus/Explicit. This value is ignored for Abaqus/Standard. Possible values are DOMAIN and LOOP. The default value is DOMAIN.
numDomains (int, default: 1) – An Int specifying the number of domains for parallel execution in Abaqus/Explicit. When parallelizationMethodExplicit = DOMAIN, numDomains must be a multiple of numCpus. The default value is 1.
activateLoadBalancing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to activate dyanmic load balancing for jobs running on multiple processors with multiple domains in Abaqus/Explicit. The default value is OFF.
multiprocessingMode (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether an analysis is decomposed into threads or into multiple processes that communicate through a message
licenseType (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the type of license type being used in the case of the DSLS SimUnit license model. Possible values are DEFAULT, TOKEN, and CREDIT. The default value is DEFAULT.If the license model is not the DSLS SimUnit, the licenseType is not available.

Model(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]#

This method creates a Model object.

Note

This function can be accessed by:

mdb.Model

Note

Check Model on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.
stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.
absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.
waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.
modelType (SymbolicConstant, default: STANDARD_EXPLICIT) – A SymbolicConstant specifying the analysis model type. Possible values are STANDARD_EXPLICIT and ELECTROMAGNETIC. The default is STANDARD_EXPLICIT.
universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.
copyConstraints (Union[AbaqusBoolean, bool], default: ON) – A boolean specifying whether to copy the constraints created in the model to the model that instances this model. The default value is ON.
copyConnectors (Union[AbaqusBoolean, bool], default: ON) – A boolean specifying whether to copy the connectors created in the model to the model that instances this model. The default value is ON.
copyInteractions (Union[AbaqusBoolean, bool], default: ON) – A boolean specifying whether to copy the interactions created in the model to the model that instances this model. The default value is ON.

Returns:

model – A Model object

Return type:

Model

OptimizationProcess(name, model, task, prototypeJob, description='', maxDesignCycle=15, dataSaveFrequency=abaqusConstants.OPT_DATASAVE_SPECIFY_CYCLE, saveInitial=True, saveFirst=True, saveLast=True, saveEvery=None)[source]#

This method creates an OptimizationProcess object.

Note

This function can be accessed by:

mdb.OptimizationProcess

Note

Check OptimizationProcess on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying name of the optimization process.
model (str) – A String specifying name of the model to be used for the optimization process.
task (str) – A String specifying name of the optimization task to be used for the optimization process.
prototypeJob (str) – A String specifying name of the job to be used as the prototype for all analysis jobs run by the optimization process.
description (str, default: '') – A String specifying a description of the optimization process.
maxDesignCycle (int, default: 15) – An Int specifying the maximum number of allowed design cycles for the optimization process. The default value is 15.
dataSaveFrequency (str, default: OPT_DATASAVE_SPECIFY_CYCLE) – An Enum specifying whether Abaqus should save every iteration file in the optimization process or a selection of iteration files saved at a user-specified frequency. If you set dataSaveFrequency = OPT_DATASAVE_EVERY_CYCLE, Abaqus saves every iteration file; if you set dataSaveFrequency = OPT_DATASAVE_SPECIFY_CYCLE, Abaqus saves iteration files according to the frequency defined by the saveEvery parameter. The default value is OPT_DATASAVE_SPECIFY_CYCLE.
saveInitial (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the initial cycle should be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. The default value is True.
saveFirst (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the first cycle should be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. The default value is True.
saveLast (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the last cycle should be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. The default value is True.
saveEvery (Optional[int], default: None) – An Int specifying every nth cycle iterations to be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. Abaqus saves file iterations for every nth iteration after iteration 1; if you set saveEvery = 3, Abaqus saves file iterations for cycles 1, 4, 7, and so on. The default value is None.

Returns:

An OptimizationProcess object.

Return type:

OptimizationProcess

Raises:

AbaqusException –

adaptivityProcesses: Dict[str, AdaptivityProcess] = {}[source]#: A repository of AdaptivityProcess objects.

annotations: Dict[str, Annotation] = {}[source]#: A repository of Annotation objects.

close()[source]#: This method closes an open Mdb object but does not save the Mdb object to disk. After closing the Mdb object, this method creates a new unnamed empty Mdb object.

closeAuxMdb()[source]#

This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Raises:: .. note:: – Check MdbBase.closeAuxMdb on help.3ds.com/0.1..
Parameters:: MdbError – The auxiliary Mdb was not opened; If the auxiliary Mdb was not opened earlier

coexecutions: Dict[str, Coexecution] = {}[source]#: A repository of Coexecution objects.

copyAuxMdbModel(fromName, toName='')[source]#

This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Note

Check MdbBase.copyAuxMdbModel on help.3ds.com/0.1..

Parameters:

fromName (str) – A String specifying the model name in the auxiliary Mdb which is to be copied.
toName (str, default: '') – A String specifying the name to be given to the model after it is copied into the Mdb. If this argument is not specified toName is assumed to be the same as fromName. If a model with name toName already exists in Mdb, it is overwritten.

Raises:

MdbError – The auxiliary Mdb was not opened; If the auxiliary Mdb was not opened earlier
KeyError – fromName does not exist; If the model fromName does not exist in the auxiliary Mdb

customData: RepositorySupport = <abaqus.CustomKernel.RepositorySupport.RepositorySupport object>[source]#: A RepositorySupport object.

getAuxMdbModelNames()[source]#

This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Returns:: A list of model names present in the auxiliaryMdb
Return type:: List[str]
Raises:: MdbError – The auxiliary Mdb was not opened; If the auxiliary Mdb was not opened earlier

importDxf(fileName)[source]#

This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry. Only a limited number of entities are supported. This format should be used only if no other formats are available.

Note

This function can be accessed by:

Mdb

Note

Check MdbBase.importDxf on help.3ds.com/0.1..

Parameters:: fileName (str) – A String specifying the path to the dxf file to open.
Returns:: A Mdb object
Return type:: Mdb

jobs: Dict[str, Job] = {}[source]#: A repository of Job objects.

lastChangedCount: Optional[float] = None[source]#: A Float specifying the value of a counter associated with the Mdb object. The counter indicates when the Mdb object was last changed.

meshEditOptions: MeshEditOptions = <abaqus.EditMesh.MeshEditOptions.MeshEditOptions object>[source]#: A MeshEditOptions object specifying the undo/redo behavior when editing meshes on parts or part instances.

models: Dict[str, Model] = {'Model-1': <abaqus.Model.Model.Model object>}[source]#: A repository of Model objects.

static openAcis(fileName, scaleFromFile=OFF)[source]#

This method creates an AcisFile object from a file containing ACIS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis

Note

Check AcisMdb.openAcis on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the ACIS file to open.
scaleFromFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to scale, rotate, and translate the part using the transform read from the ACIS file. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – File is from a newer version of ACIS than the CAE kernel.
Texterror – The data in the ACIS file are corrupted.

openAuxMdb(pathName)[source]#

This method opens an auxiliary Mdb object on the disk at the specified location. This enables models from the auxiliary Mdb object to be copied into the current Mdb.

Note

Check MdbBase.openAuxMdb on help.3ds.com/0.1..

Parameters:

pathName (str) – A String specifying the path to the auxiliary Mdb which is to be opened. If you do not provide a file extension, .cae is appended automatically to the path.

Raises:

MdbError – invalid model database; If the file is an invalid model database
MdbError – incompatible release number; If the file contains a model database from an Abaqus release other than the Abaqus release you are currently running
MdbError – cannot open file; If the command fails to open the model database file for reasons not mentioned above

static openCatia(fileName, topology=None, convertUnits=OFF, combineBodies=OFF)[source]#

This method creates an AcisFile object from a file containing V5-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openCatia

Note

Check AcisMdb.openCatia on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the CATIA file to open.
topology (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID .
convertUnits (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the original units should be retained. Possible values are ON and OFF. The default value is OFF.
combineBodies (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to combine the bodies in the CATPart file. If the bodies to be combined touch or overlap, invalid entities would result. For CATProduct files, this option will be ignored.

Returns:

An AcisFile object.

Return type:

AcisFile

static openEnf(fileName, fileType, topology=abaqusConstants.SOLID, convertUnits=OFF)[source]#

This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openEnf

Note

Check AcisMdb.openEnf on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the Elysium Neutral File that was created by I-DEAS, Pro/ENGINEER, or CATIA V5.
fileType (str) – A String specifying the type of CAD system that created the file. Possible values are “ideas”, “proe”, or “catiav5” or a combination similar to “proe/ideas/catiav5” if the type is unknown.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.
convertUnits (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying if the dimensions of the part should be converted to millimeters. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

static openIges(fileName, trimCurve=abaqusConstants.DEFAULT, scaleFromFile=OFF, msbo=False, includedLayers=(), topology=abaqusConstants.SOLID, uniteWires=ON)[source]#

This method creates an AcisFile object from a file containing IGES-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openIges

Note

Check AcisMdb.openIges on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the IGES file to open.
trimCurve (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to define the trim curves that bound parametric surfaces. Possible values are:DEFAULT, use either of the following as specified by the contents of the IGES file.PARAMETRIC_DATA, use the parameter space of the surface being trimmed.THREED_DATA, use real space—the coordinate system of the part along with an indication that the trim curve lies on the parametric surface.The default value is DEFAULT.
scaleFromFile (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the imported geometry needs to be scaled using the units information available in the IGES file. Possible values are ON and OFF. The default value is OFF. When the argument is set to ON, the geometry is scaled to millimeters with respect to the unit system specified in the IGES file.
msbo (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying if the IGES file contains MSBO (Manifold Solid B-Rep Object) entities. The default value is False.
includedLayers (tuple, default: ()) – A sequence of Ints specifying the levels or layers of entities that will be translated from the IGES file to build the part. The default is to include all the layers.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.
uniteWires (SymbolicConstant, default: ON) – A SymbolicConstant specifying whether the imported wires need to be united or not. Possible values are ON and OFF. The default value is ON. When importing a sketch, this value is set to OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the IGES file are corrupted.

openMdb(pathName)[source]#

This method opens an existing model database file.

Note

This function can be accessed by:

Mdb

Note

Check MdbBase.openMdb on help.3ds.com/0.1..

Parameters:

pathName (str) – A String specifying the path to the model database file to open. If you do not provide a file extension, Abaqus/CAE attempts to open the file with .cae appended to the path.

Returns:

A Mdb object

Return type:

Mdb

Raises:

MdbError – invalid model database; If the file is an invalid model database
MdbError – incompatible release number, expected <Abaqus release>, got <earlier or later Abaqus release>; If the file contains a model database from an Abaqus release other than the Abaqus release you are currently running
MdbError – cannot open file; may be in use by another CAE session; If the model database file is already opened in write mode
MdbError – cannot open file; If the command fails to open the model database file for reasons not mentioned above

static openParasolid(fileName, topology=abaqusConstants.SOLID)[source]#

This method creates an AcisFile object from a file containing Parasolid-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openParasolid

Note

Check AcisMdb.openParasolid on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the Parasolid file to open.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

Returns:

An AcisFile object.

Return type:

AcisFile

static openSolidworks(fileName, topology=abaqusConstants.SOLID)[source]#

This method creates an AcisFile object from a file containing Solidworks format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

openSolidworks

New in version 2020: The openSolidworks method was added.

Note

Check AcisMdb.openSolidworks on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the Solidworks file to open.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID, SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid entity. If topology = SHELL, Abaqus/CAE builds the body as a shell entity, not as a solid entity. The default value is SOLID.

Return type:

An AcisFile object.

Raises:

Texterror – The data in the Solidworks file are corrupted.

static openStep(fileName, scale=1)[source]#

This method creates an AcisFile object from a file containing STEP-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openStep

Note

Check AcisMdb.openStep on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the STEP file to open.
scale (float, default: 1) – A Float specifying the scaling factor to apply to the imported geometric entities. The default value is 1.0.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the STEP file are corrupted.

static openVda(fileName)[source]#

This method creates an AcisFile object from a file containing VDA-FS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openVda

Note

Check AcisMdb.openVda on help.3ds.com/0.1..

Parameters:: fileName (str) – A String specifying the path to the VDA-FS file to open.
Returns:: An AcisFile object.
Return type:: AcisFile
Raises:: Texterror – The data in the VDA-FS file are corrupted.

optimizationProcesses: Dict[str, OptimizationProcess] = {}[source]#: A repository of OptimizationProcess objects.

save()[source]#

This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).

Raises:

MdbError – cannot save file: pathname member is empty; If pathName is empty
MdbError – “abaqus.cae” is an invalid CAE filename; If pathName is abaqus.cae
.. note:: – Check MdbBase.save on help.3ds.com/0.1..

Parameters:

MdbError – cannot save file; If the command fails to save the Mdb object to disk for reasons not mentioned above

saveAs(pathName)[source]#

This method saves an Mdb object to disk at the specified location.

Note

Check MdbBase.saveAs on help.3ds.com/0.1..

Parameters:

pathName (str) – A String specifying the path to be used when the model database is saved to a file. If you do not provide a file extension, .cae is appended automatically to the path.

Raises:

MdbError – “abaqus.cae” is an invalid CAE filename; If pathName is abaqus.cae
MdbError – cannot save file; If the command fails to save the Mdb object to disk for reasons not mentioned above

version: Optional[int] = None[source]#: An Int specifying the release number of the Mdb object in memory.

MdbBase#

class MdbBase(pathName='')[source]#

The Mdb object is the high-level Abaqus model database. A model database stores models and analysis controls.

Note

This object can be accessed by:

mdb

Note

Check MdbBase on help.3ds.com/0.1..

Public Data Attributes:

`version`	An Int specifying the release number of the Mdb object in memory.
`lastChangedCount`	A Float specifying the value of a counter associated with the Mdb object.
`jobs`	A repository of Job objects.
`adaptivityProcesses`	A repository of AdaptivityProcess objects.
`coexecutions`	A repository of Coexecution objects.
`optimizationProcesses`	A repository of OptimizationProcess objects.
`meshEditOptions`	A `MeshEditOptions` object specifying the undo/redo behavior when editing meshes on parts or part instances.
`models`	A repository of Model objects.
`customData`	A `RepositorySupport` object.
`annotations`	A repository of Annotation objects.

Public Methods:

`__init__`([pathName])	This constructor creates an empty Mdb object.
`importDxf`(fileName)	This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry.
`openMdb`(pathName)	This method opens an existing model database file.
`close`()	This method closes an open Mdb object but does not save the Mdb object to disk.
`save`()	This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).
`saveAs`(pathName)	This method saves an Mdb object to disk at the specified location.
`openAuxMdb`(pathName)	This method opens an auxiliary Mdb object on the disk at the specified location.
`closeAuxMdb`()	This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`getAuxMdbModelNames`()	This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`copyAuxMdbModel`(fromName[, toName])	This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

adaptivityProcesses: Dict[str, AdaptivityProcess] = {}[source]#: A repository of AdaptivityProcess objects.

annotations: Dict[str, Annotation] = {}[source]#: A repository of Annotation objects.

close()[source]#: This method closes an open Mdb object but does not save the Mdb object to disk. After closing the Mdb object, this method creates a new unnamed empty Mdb object.

closeAuxMdb()[source]#

This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Raises:: .. note:: – Check MdbBase.closeAuxMdb on help.3ds.com/0.1..
Parameters:: MdbError – The auxiliary Mdb was not opened; If the auxiliary Mdb was not opened earlier

coexecutions: Dict[str, Coexecution] = {}[source]#: A repository of Coexecution objects.

copyAuxMdbModel(fromName, toName='')[source]#

This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Note

Check MdbBase.copyAuxMdbModel on help.3ds.com/0.1..

Parameters:

fromName (str) – A String specifying the model name in the auxiliary Mdb which is to be copied.
toName (str, default: '') – A String specifying the name to be given to the model after it is copied into the Mdb. If this argument is not specified toName is assumed to be the same as fromName. If a model with name toName already exists in Mdb, it is overwritten.

Raises:

MdbError – The auxiliary Mdb was not opened; If the auxiliary Mdb was not opened earlier
KeyError – fromName does not exist; If the model fromName does not exist in the auxiliary Mdb

customData: RepositorySupport = <abaqus.CustomKernel.RepositorySupport.RepositorySupport object>[source]#: A RepositorySupport object.

getAuxMdbModelNames()[source]#

This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Returns:: A list of model names present in the auxiliaryMdb
Return type:: List[str]
Raises:: MdbError – The auxiliary Mdb was not opened; If the auxiliary Mdb was not opened earlier

importDxf(fileName)[source]#

This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry. Only a limited number of entities are supported. This format should be used only if no other formats are available.

Note

This function can be accessed by:

Mdb

Note

Check MdbBase.importDxf on help.3ds.com/0.1..

Parameters:: fileName (str) – A String specifying the path to the dxf file to open.
Returns:: A Mdb object
Return type:: Mdb

jobs: Dict[str, Job] = {}[source]#: A repository of Job objects.

lastChangedCount: Optional[float] = None[source]#: A Float specifying the value of a counter associated with the Mdb object. The counter indicates when the Mdb object was last changed.

meshEditOptions: MeshEditOptions = <abaqus.EditMesh.MeshEditOptions.MeshEditOptions object>[source]#: A MeshEditOptions object specifying the undo/redo behavior when editing meshes on parts or part instances.

models: Dict[str, Model] = {'Model-1': <abaqus.Model.Model.Model object>}[source]#: A repository of Model objects.

openAuxMdb(pathName)[source]#

This method opens an auxiliary Mdb object on the disk at the specified location. This enables models from the auxiliary Mdb object to be copied into the current Mdb.

Note

Check MdbBase.openAuxMdb on help.3ds.com/0.1..

Parameters:

pathName (str) – A String specifying the path to the auxiliary Mdb which is to be opened. If you do not provide a file extension, .cae is appended automatically to the path.

Raises:

MdbError – invalid model database; If the file is an invalid model database
MdbError – incompatible release number; If the file contains a model database from an Abaqus release other than the Abaqus release you are currently running
MdbError – cannot open file; If the command fails to open the model database file for reasons not mentioned above

openMdb(pathName)[source]#

This method opens an existing model database file.

Note

This function can be accessed by:

Mdb

Note

Check MdbBase.openMdb on help.3ds.com/0.1..

Parameters:

pathName (str) – A String specifying the path to the model database file to open. If you do not provide a file extension, Abaqus/CAE attempts to open the file with .cae appended to the path.

Returns:

A Mdb object

Return type:

Mdb

Raises:

MdbError – invalid model database; If the file is an invalid model database
MdbError – incompatible release number, expected <Abaqus release>, got <earlier or later Abaqus release>; If the file contains a model database from an Abaqus release other than the Abaqus release you are currently running
MdbError – cannot open file; may be in use by another CAE session; If the model database file is already opened in write mode
MdbError – cannot open file; If the command fails to open the model database file for reasons not mentioned above

optimizationProcesses: Dict[str, OptimizationProcess] = {}[source]#: A repository of OptimizationProcess objects.

save()[source]#

This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).

Raises:

MdbError – cannot save file: pathname member is empty; If pathName is empty
MdbError – “abaqus.cae” is an invalid CAE filename; If pathName is abaqus.cae
.. note:: – Check MdbBase.save on help.3ds.com/0.1..

Parameters:

MdbError – cannot save file; If the command fails to save the Mdb object to disk for reasons not mentioned above

saveAs(pathName)[source]#

This method saves an Mdb object to disk at the specified location.

Note

Check MdbBase.saveAs on help.3ds.com/0.1..

Parameters:

pathName (str) – A String specifying the path to be used when the model database is saved to a file. If you do not provide a file extension, .cae is appended automatically to the path.

Raises:

MdbError – “abaqus.cae” is an invalid CAE filename; If pathName is abaqus.cae
MdbError – cannot save file; If the command fails to save the Mdb object to disk for reasons not mentioned above

version: Optional[int] = None[source]#: An Int specifying the release number of the Mdb object in memory.

AcisMdb#

class AcisMdb(pathName='')[source]

The Mdb object is the high-level Abaqus model database. A model database stores models and analysis controls.

Note

This object can be accessed by:

mdb

Note

Check AcisMdb on help.3ds.com/0.1..

Public Data Attributes:

Inherited from MdbBase

`version`	An Int specifying the release number of the Mdb object in memory.
`lastChangedCount`	A Float specifying the value of a counter associated with the Mdb object.
`jobs`	A repository of Job objects.
`adaptivityProcesses`	A repository of AdaptivityProcess objects.
`coexecutions`	A repository of Coexecution objects.
`optimizationProcesses`	A repository of OptimizationProcess objects.
`meshEditOptions`	A `MeshEditOptions` object specifying the undo/redo behavior when editing meshes on parts or part instances.
`models`	A repository of Model objects.
`customData`	A `RepositorySupport` object.
`annotations`	A repository of Annotation objects.

Public Methods:

`openAcis`(fileName[, scaleFromFile])	This method creates an AcisFile object from a file containing ACIS-format geometry.
`openCatia`(fileName[, topology, ...])	This method creates an AcisFile object from a file containing V5-format geometry.
`openEnf`(fileName, fileType[, topology, ...])	This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER.
`openIges`(fileName[, trimCurve, ...])	This method creates an AcisFile object from a file containing IGES-format geometry.
`openParasolid`(fileName[, topology])	This method creates an AcisFile object from a file containing Parasolid-format geometry.
`openStep`(fileName[, scale])	This method creates an AcisFile object from a file containing STEP-format geometry.
`openVda`(fileName)	This method creates an AcisFile object from a file containing VDA-FS-format geometry.
`openSolidworks`(fileName[, topology])	This method creates an AcisFile object from a file containing Solidworks format geometry.

Inherited from MdbBase

`__init__`([pathName])	This constructor creates an empty Mdb object.
`importDxf`(fileName)	This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry.
`openMdb`(pathName)	This method opens an existing model database file.
`close`()	This method closes an open Mdb object but does not save the Mdb object to disk.
`save`()	This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).
`saveAs`(pathName)	This method saves an Mdb object to disk at the specified location.
`openAuxMdb`(pathName)	This method opens an auxiliary Mdb object on the disk at the specified location.
`closeAuxMdb`()	This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`getAuxMdbModelNames`()	This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`copyAuxMdbModel`(fromName[, toName])	This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

static openAcis(fileName, scaleFromFile=OFF)[source]

This method creates an AcisFile object from a file containing ACIS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis

Note

Check AcisMdb.openAcis on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the ACIS file to open.
scaleFromFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to scale, rotate, and translate the part using the transform read from the ACIS file. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – File is from a newer version of ACIS than the CAE kernel.
Texterror – The data in the ACIS file are corrupted.

static openCatia(fileName, topology=None, convertUnits=OFF, combineBodies=OFF)[source]

This method creates an AcisFile object from a file containing V5-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openCatia

Note

Check AcisMdb.openCatia on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the CATIA file to open.
topology (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID .
convertUnits (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the original units should be retained. Possible values are ON and OFF. The default value is OFF.
combineBodies (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to combine the bodies in the CATPart file. If the bodies to be combined touch or overlap, invalid entities would result. For CATProduct files, this option will be ignored.

Returns:

An AcisFile object.

Return type:

AcisFile

static openEnf(fileName, fileType, topology=abaqusConstants.SOLID, convertUnits=OFF)[source]

This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openEnf

Note

Check AcisMdb.openEnf on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the Elysium Neutral File that was created by I-DEAS, Pro/ENGINEER, or CATIA V5.
fileType (str) – A String specifying the type of CAD system that created the file. Possible values are “ideas”, “proe”, or “catiav5” or a combination similar to “proe/ideas/catiav5” if the type is unknown.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.
convertUnits (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying if the dimensions of the part should be converted to millimeters. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

static openIges(fileName, trimCurve=abaqusConstants.DEFAULT, scaleFromFile=OFF, msbo=False, includedLayers=(), topology=abaqusConstants.SOLID, uniteWires=ON)[source]

This method creates an AcisFile object from a file containing IGES-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openIges

Note

Check AcisMdb.openIges on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the IGES file to open.
trimCurve (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to define the trim curves that bound parametric surfaces. Possible values are:DEFAULT, use either of the following as specified by the contents of the IGES file.PARAMETRIC_DATA, use the parameter space of the surface being trimmed.THREED_DATA, use real space—the coordinate system of the part along with an indication that the trim curve lies on the parametric surface.The default value is DEFAULT.
scaleFromFile (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the imported geometry needs to be scaled using the units information available in the IGES file. Possible values are ON and OFF. The default value is OFF. When the argument is set to ON, the geometry is scaled to millimeters with respect to the unit system specified in the IGES file.
msbo (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying if the IGES file contains MSBO (Manifold Solid B-Rep Object) entities. The default value is False.
includedLayers (tuple, default: ()) – A sequence of Ints specifying the levels or layers of entities that will be translated from the IGES file to build the part. The default is to include all the layers.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.
uniteWires (SymbolicConstant, default: ON) – A SymbolicConstant specifying whether the imported wires need to be united or not. Possible values are ON and OFF. The default value is ON. When importing a sketch, this value is set to OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the IGES file are corrupted.

static openParasolid(fileName, topology=abaqusConstants.SOLID)[source]

This method creates an AcisFile object from a file containing Parasolid-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openParasolid

Note

Check AcisMdb.openParasolid on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the Parasolid file to open.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

Returns:

An AcisFile object.

Return type:

AcisFile

static openSolidworks(fileName, topology=abaqusConstants.SOLID)[source]

This method creates an AcisFile object from a file containing Solidworks format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

openSolidworks

New in version 2020: The openSolidworks method was added.

Note

Check AcisMdb.openSolidworks on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the Solidworks file to open.
topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID, SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid entity. If topology = SHELL, Abaqus/CAE builds the body as a shell entity, not as a solid entity. The default value is SOLID.

Return type:

An AcisFile object.

Raises:

Texterror – The data in the Solidworks file are corrupted.

static openStep(fileName, scale=1)[source]

This method creates an AcisFile object from a file containing STEP-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openStep

Note

Check AcisMdb.openStep on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the path to the STEP file to open.
scale (float, default: 1) – A Float specifying the scaling factor to apply to the imported geometric entities. The default value is 1.0.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the STEP file are corrupted.

static openVda(fileName)[source]

This method creates an AcisFile object from a file containing VDA-FS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openVda

Note

Check AcisMdb.openVda on help.3ds.com/0.1..

Parameters:: fileName (str) – A String specifying the path to the VDA-FS file to open.
Returns:: An AcisFile object.
Return type:: AcisFile
Raises:: Texterror – The data in the VDA-FS file are corrupted.

JobMdb#

class JobMdb(pathName='')[source]

The Mdb object is the high-level Abaqus model database. A model database stores models and analysis controls.

Note

This object can be accessed by:

mdb

Note

Check JobMdb on help.3ds.com/0.1..

Public Data Attributes:

Inherited from MdbBase

`version`	An Int specifying the release number of the Mdb object in memory.
`lastChangedCount`	A Float specifying the value of a counter associated with the Mdb object.
`jobs`	A repository of Job objects.
`adaptivityProcesses`	A repository of AdaptivityProcess objects.
`coexecutions`	A repository of Coexecution objects.
`optimizationProcesses`	A repository of OptimizationProcess objects.
`meshEditOptions`	A `MeshEditOptions` object specifying the undo/redo behavior when editing meshes on parts or part instances.
`models`	A repository of Model objects.
`customData`	A `RepositorySupport` object.
`annotations`	A repository of Annotation objects.

Public Methods:

`Job`(name, model[, description, type, queue, ...])	This method creates an analysis job using a model on a model database (MDB) for the model definition.
`JobFromInputFile`(name, inputFileName[, ...])	This method creates an analysis job using an input file for the model definition.
`OptimizationProcess`(name, model, task, ...)	This method creates an OptimizationProcess object.

Inherited from MdbBase

`__init__`([pathName])	This constructor creates an empty Mdb object.
`importDxf`(fileName)	This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry.
`openMdb`(pathName)	This method opens an existing model database file.
`close`()	This method closes an open Mdb object but does not save the Mdb object to disk.
`save`()	This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).
`saveAs`(pathName)	This method saves an Mdb object to disk at the specified location.
`openAuxMdb`(pathName)	This method opens an auxiliary Mdb object on the disk at the specified location.
`closeAuxMdb`()	This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`getAuxMdbModelNames`()	This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.
`copyAuxMdbModel`(fromName[, toName])	This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Job(name, model, description='', type=abaqusConstants.ANALYSIS, queue='', waitHours=0, waitMinutes=0, atTime='', echoPrint=OFF, contactPrint=OFF, modelPrint=OFF, historyPrint=OFF, scratch='', userSubroutine='', numCpus=1, memory=90, memoryUnits=abaqusConstants.PERCENTAGE, explicitPrecision=abaqusConstants.SINGLE, nodalOutputPrecision=abaqusConstants.SINGLE, parallelizationMethodExplicit=abaqusConstants.DOMAIN, numDomains=1, activateLoadBalancing=OFF, multiprocessingMode=abaqusConstants.DEFAULT, licenseType=abaqusConstants.DEFAULT, *args, **kwargs)[source]

This method creates an analysis job using a model on a model database (MDB) for the model definition.

Note

This function can be accessed by:

mdb.Job

Note

Check Job on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the new job. The name must be a valid Abaqus/CAE object name.
model (str) – A String specifying the name of the model to be analyzed or a Model object specifying the model to be analyzed.
description (str, default: '') – A String specifying a description of the job.
type (SymbolicConstant, default: ANALYSIS) – A SymbolicConstant specifying the type of job. Possible values are ANALYSIS, SYNTAXCHECK, RECOVER, and RESTART. The default value is ANALYSIS.If the object has the type JobFromInputFile, type = RESTART is not available.
queue (str, default: '') – A String specifying the name of the queue to which to submit the job. The default value is an empty string.Note:You can use the queue argument when creating a Job object on a Windows workstation; however, remote queues are available only on Linux platforms.
waitHours (int, default: 0) – An Int specifying the number of hours to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitMinutes. waitHours and atTime are mutually exclusive.
waitMinutes (int, default: 0) – An Int specifying the number of minutes to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitHours. waitMinutes and atTime are mutually exclusive.
atTime (str, default: '') – A String specifying the time at which to submit the job. If queue is empty, the string syntax must be valid for the Linux at command. If queue is set, the syntax must be valid according to the system administrator. The default value is an empty string.Note:You can use the atTime argument when creating a Job object on a Windows workstation; however, the at command is available only on Linux platforms.
echoPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an echo of the input data is printed. The default value is OFF.
contactPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether contact constraint data are printed. The default value is OFF.
modelPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether model definition data are printed. The default value is OFF.
historyPrint (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether history data are printed. The default value is OFF.
scratch (str, default: '') – A String specifying the location of the scratch directory. The default value is an empty string.
userSubroutine (str, default: '') – A String specifying the file containing the user’s subroutine definitions. The default value is an empty string.
numCpus (int, default: 1) – An Int specifying the number of CPUs to use for this analysis if parallel processing is available. Possible values are numCpus >> 0. The default value is 1.
memory (int, default: 90) – An Int specifying the amount of memory available to Abaqus analysis. The value should be expressed in the units supplied in memoryUnits. The default value is 90.
memoryUnits (SymbolicConstant, default: PERCENTAGE) – A SymbolicConstant specifying the units for the amount of memory used in an Abaqus analysis. Possible values are PERCENTAGE, MEGA_BYTES, and GIGA_BYTES. The default value is PERCENTAGE.
explicitPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying whether to use the double precision version of Abaqus/Explicit. Possible values are SINGLE, FORCE_SINGLE, DOUBLE, DOUBLE_CONSTRAINT_ONLY, and DOUBLE_PLUS_PACK. The default value is SINGLE.
nodalOutputPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying the precision of the nodal output written to the output database. Possible values are SINGLE and FULL. The default value is SINGLE.
parallelizationMethodExplicit (SymbolicConstant, default: DOMAIN) – A SymbolicConstant specifying the parallelization method for Abaqus/Explicit. This value is ignored for Abaqus/Standard. Possible values are DOMAIN and LOOP. The default value is DOMAIN.
numDomains (int, default: 1) – An Int specifying the number of domains for parallel execution in Abaqus/Explicit. When parallelizationMethodExplicit = DOMAIN, numDomains must be a multiple of numCpus. The default value is 1.
activateLoadBalancing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to activate dyanmic load balancing for jobs running on multiple processors with multiple domains in Abaqus/Explicit. The default value is OFF.
multiprocessingMode (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether an analysis is decomposed into threads or into multiple processes that communicate through a message passing interface (MPI). Possible values are DEFAULT, THREADS, and MPI. The default value is DEFAULT.
licenseType (SymbolicConstant, default: DEFAULT) –
A SymbolicConstant specifying the type of license type being used in the case of the DSLS SimUnit license model. Possible values are DEFAULT, TOKEN, and CREDIT. The default value is DEFAULT.If the license model is not the DSLS SimUnit, the licenseType is not available.

Changed in version 2022: The licenseType argument was added.

Returns:

A ModelJob object.

Return type:

ModelJob

Raises:

AbaqusException –

JobFromInputFile(name, inputFileName, type=abaqusConstants.ANALYSIS, queue='', waitHours=0, waitMinutes=0, atTime='', scratch='', userSubroutine='', numCpus=1, memory=90, memoryUnits=abaqusConstants.PERCENTAGE, explicitPrecision=abaqusConstants.SINGLE, nodalOutputPrecision=abaqusConstants.SINGLE, parallelizationMethodExplicit=abaqusConstants.DOMAIN, numDomains=1, activateLoadBalancing=OFF, multiprocessingMode=abaqusConstants.DEFAULT, licenseType=abaqusConstants.DEFAULT)[source]

This method creates an analysis job using an input file for the model definition.

Note

This function can be accessed by:

mdb.JobFromInputFile

Note

Check JobFromInputFile on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the new job. The name must be a valid Abaqus/CAE object name.
inputFileName (str) – A String specifying the input file to read. Possible values are any valid file name. If the .inp extension is not included in the value of the argument, the system will append it for the user.
type (SymbolicConstant, default: ANALYSIS) – A SymbolicConstant specifying the type of job. Possible values are ANALYSIS, SYNTAXCHECK, and RECOVER. The default value is ANALYSIS.For theJobFromInputFile object, type = RESTART is not currently supported.
queue (str, default: '') – A String specifying the name of the queue to which to submit the job. The default value is an empty string.Note: You can use the queue argument when creating a Job object on a Windows workstation; however, remote queues are available only on Linux platforms.
waitHours (int, default: 0) – An Int specifying the number of hours to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitMinutes. waitHours and atTime are mutually exclusive.
waitMinutes (int, default: 0) – An Int specifying the number of minutes to wait before submitting the job. This argument is ignored if queue is set. The default value is 0.This argument works in conjunction with waitHours. waitMinutes and atTime are mutually exclusive.
atTime (str, default: '') – A String specifying the time at which to submit the job. If queue is empty, the string syntax must be valid for the Linux at command. If queue is set, the syntax must be valid according to the system administrator. The default value is an empty string.Note: You can use the atTime argument when creating a Job object on a Windows workstation; however, the at command is available only on Linux platforms.
scratch (str, default: '') – A String specifying the location of the scratch directory. The default value is an empty string.
userSubroutine (str, default: '') – A String specifying the file containing the user’s subroutine definitions. The default value is an empty string.
numCpus (int, default: 1) – An Int specifying the number of CPUs to use for this analysis if parallel processing is available. Possible values are numCpus >> 0. The default value is 1.
memory (int, default: 90) – An Int specifying the amount of memory available to Abaqus analysis. The value should be expressed in the units supplied in memoryUnits. The default value is 90.
memoryUnits (SymbolicConstant, default: PERCENTAGE) – A SymbolicConstant specifying the units for the amount of memory used in an Abaqus analysis. Possible values are PERCENTAGE, MEGA_BYTES, and GIGA_BYTES. The default value is PERCENTAGE.
explicitPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying whether to use the double precision version of Abaqus/Explicit. Possible values are SINGLE, FORCE_SINGLE, DOUBLE, DOUBLE_CONSTRAINT_ONLY, and DOUBLE_PLUS_PACK. The default value is SINGLE.
nodalOutputPrecision (SymbolicConstant, default: SINGLE) – A SymbolicConstant specifying the precision of the nodal output written to the output database. Possible values are SINGLE and FULL. The default value is SINGLE.
parallelizationMethodExplicit (SymbolicConstant, default: DOMAIN) – A SymbolicConstant specifying the parallelization method for Abaqus/Explicit. This value is ignored for Abaqus/Standard. Possible values are DOMAIN and LOOP. The default value is DOMAIN.
numDomains (int, default: 1) – An Int specifying the number of domains for parallel execution in Abaqus/Explicit. When parallelizationMethodExplicit = DOMAIN, numDomains must be a multiple of numCpus. The default value is 1.
activateLoadBalancing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to activate dyanmic load balancing for jobs running on multiple processors with multiple domains in Abaqus/Explicit. The default value is OFF.
multiprocessingMode (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether an analysis is decomposed into threads or into multiple processes that communicate through a message
licenseType (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the type of license type being used in the case of the DSLS SimUnit license model. Possible values are DEFAULT, TOKEN, and CREDIT. The default value is DEFAULT.If the license model is not the DSLS SimUnit, the licenseType is not available.

OptimizationProcess(name, model, task, prototypeJob, description='', maxDesignCycle=15, dataSaveFrequency=abaqusConstants.OPT_DATASAVE_SPECIFY_CYCLE, saveInitial=True, saveFirst=True, saveLast=True, saveEvery=None)[source]

This method creates an OptimizationProcess object.

Note

This function can be accessed by:

mdb.OptimizationProcess

Note

Check OptimizationProcess on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying name of the optimization process.
model (str) – A String specifying name of the model to be used for the optimization process.
task (str) – A String specifying name of the optimization task to be used for the optimization process.
prototypeJob (str) – A String specifying name of the job to be used as the prototype for all analysis jobs run by the optimization process.
description (str, default: '') – A String specifying a description of the optimization process.
maxDesignCycle (int, default: 15) – An Int specifying the maximum number of allowed design cycles for the optimization process. The default value is 15.
dataSaveFrequency (str, default: OPT_DATASAVE_SPECIFY_CYCLE) – An Enum specifying whether Abaqus should save every iteration file in the optimization process or a selection of iteration files saved at a user-specified frequency. If you set dataSaveFrequency = OPT_DATASAVE_EVERY_CYCLE, Abaqus saves every iteration file; if you set dataSaveFrequency = OPT_DATASAVE_SPECIFY_CYCLE, Abaqus saves iteration files according to the frequency defined by the saveEvery parameter. The default value is OPT_DATASAVE_SPECIFY_CYCLE.
saveInitial (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the initial cycle should be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. The default value is True.
saveFirst (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the first cycle should be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. The default value is True.
saveLast (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the last cycle should be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. The default value is True.
saveEvery (Optional[int], default: None) – An Int specifying every nth cycle iterations to be saved when dataSaveFrequency is OPT_DATASAVE_SPECIFY_CYCLE. Abaqus saves file iterations for every nth iteration after iteration 1; if you set saveEvery = 3, Abaqus saves file iterations for cycles 1, 4, 7, and so on. The default value is None.

Returns:

An OptimizationProcess object.

Return type:

OptimizationProcess

Raises:

AbaqusException –