ModelJob object

The ModelJob object defines a Job object that analyzes a model on a model database (MDB).

The ModelJob object is derived from the Job object.

This page discusses:

Access

import job
mdb.adaptivityProcesses[name].job
mdb.jobs[name]

Job(...)

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

Path

mdb.Job

Required arguments

name

A String specifying the name of the new job. The name must be a valid Abaqus/CAE object name.

model

A String specifying the name of the model to be analyzed or a Model object specifying the model to be analyzed.

Optional arguments

description

A String specifying a description of the job.

type

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

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

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

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

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

A Boolean specifying whether an echo of the input data is printed. The default value is OFF.

contactPrint

A Boolean specifying whether contact constraint data are printed. The default value is OFF.

modelPrint

A Boolean specifying whether model definition data are printed. The default value is OFF.

historyPrint

A Boolean specifying whether history data are printed. The default value is OFF.

scratch

A String specifying the location of the scratch directory. The default value is an empty string.

userSubroutine

A String specifying the file containing the user's subroutine definitions. The default value is an empty string.

numCpus

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

An Int specifying the amount of memory available to an Abaqus analysis. The value should be expressed in the units supplied in memoryUnits. The default value is 90.

memoryUnits

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

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

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.

numDomains

An Int specifying the number of domains for parallel execution in Abaqus/Explicit. When using more than 1 numCpus, numDomains must be a multiple of numCpus. The default value is 1.

activateLoadBalancing

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

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

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.

Return value

A ModelJob object.

Exceptions

AbaqusException.

writeInput(...)

This method writes an input file.

Required arguments

None.

Optional arguments

consistencyChecking

A Boolean specifying whether to perform consistency checking for the job. The default value is ON. It is not recommended that you turn off the consistency checking unless you are absolutely sure that the model is consistent.

Return value

None.

Exceptions

None.

setValues(...)

This method modifies the ModelJob object.

Required arguments

None.

Optional arguments

The optional arguments to setValues are the same as the arguments to the ModelJob method.

Return value

None.

Exceptions

None.

Members

The ModelJob object can have the following members:

name

A String specifying the name of the new job. The name must be a valid Abaqus/CAE object name.

echoPrint

A Boolean specifying whether an echo of the input data is printed. The default value is OFF.

contactPrint

A Boolean specifying whether contact constraint data are printed. The default value is OFF.

modelPrint

A Boolean specifying whether model definition data are printed. The default value is OFF.

historyPrint

A Boolean specifying whether history data are printed. The default value is OFF.

model

A String specifying the name of the model to be analyzed or a Model object specifying the model to be analyzed.

description

A String specifying a description of the job.

type

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.

waitHours

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

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.

numCpus

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

An Int specifying the amount of memory available to an Abaqus analysis. The value should be expressed in the units supplied in memoryUnits. The default value is 90.

memoryUnits

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.

getMemoryFromAnalysis

A Boolean specifying whether to retrieve the recommended memory settings from the last datacheck or analysis run and use those values in subsequent submissions. The default value is ON.

explicitPrecision

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

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

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

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

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

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.

analysis

A SymbolicConstant specifying whether the job will be analyzed by Abaqus/Standard or Abaqus/Explicit. Possible values are STANDARD, EXPLICIT, and UNKNOWN.

If the object has the type JobFromInputFile, analysis=UNKNOWN.

status

A SymbolicConstant specifying the status of the analysis. Possible values are SUBMITTED, RUNNING, ABORTED, TERMINATED, COMPLETED, CHECK_RUNNING, and CHECK_COMPLETED.

If the message member is empty, status is set to NONE.

queue

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.

atTime

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

A String specifying the location of the scratch directory. The default value is an empty string.

userSubroutine

A String specifying the file containing the user's subroutine definitions. The default value is an empty string.

messages

A MessageArray object specifying the messages received during an analysis.

environment

A tuple of Strings specifying the environment variables and their values.