Top level commands

isUpgradeRequiredForOdb

This method determines if an output database file needs to be upgraded to the current release.

Prototype

bool isUpgradeRequiredForOdb(const odb_String& upgradeRequiredOdbPath);

Required arguments

upgradeRequiredOdbPath: An odb_String specifying the path to an output database file to test. The test determines if the output database needs to be upgraded to the current release.

Optional arguments

None.

Return value

A Boolean indicating the result of the test. A value of True indicates that the output database needs to be upgraded to the current release.

Exceptions

None.

maxEnvelope

Retrieve the maximum value of an output variable over a number of fields.

Prototype

odb_SequenceFieldOutput maxEnvelope(
    const odb_SequenceFieldOutput & inputFields);
odb_SequenceFieldOutput maxEnvelope(
    const odb_SequenceFieldOutput & inputFields,
    odb_Enum::odb_InvariantEnum invariant);
odb_SequenceFieldOutput maxEnvelope(
    const odb_SequenceFieldOutput & inputFields,
    const odb_String& componentLabel);

Required arguments


Argument
An odb_SequenceFieldoutput object containing all the fieldOutput objects from which the maximum value will be computed.
A SymbolicConstant specifying the invariant or component label to be used when comparing vectors or tensors. Possible values are odb_Enum::MAGNITUDE odb_Enum::MISES odb_Enum::TRESCA odb_Enum::PRESS odb_Enum::INV3 odb_Enum::MAX_PRINCIPAL odb_Enum::MID_PRINCIPAL odb_Enum::MIN_PRINCIPAL You must provide either this argument or the following argument if the field is a vector or tensor.
An odb_String specifying the component of the tensor or vector to be used for selecting the maximum value.

Optional arguments

None.

Return value

An odb_SequenceFieldOutput object. The first fieldOutput object contains the maximum value. The second fieldOutput object contains the index of the field containing the maximum value. The index follows the order in which fields are positioned in the list of fieldOutput objects provided as the argument to the function.

Exceptions

OdbError

TypeError: This function takes no keyword arguments.

minEnvelope

Retrieve the minimum value of an output variable over a number of fields.

Prototype

odb_SequenceFieldOutput minEnvelope(
    const odb_SequenceFieldOutput & inputFields);
odb_SequenceFieldOutput minEnvelope(
    const odb_SequenceFieldOutput & inputFields,
    odb_Enum::odb_InvariantEnum invariant);
odb_SequenceFieldOutput minEnvelope(
    const odb_SequenceFieldOutput & inputFields,
    const odb_String& componentLabel);

Required arguments


Argument
An odb_SequenceFieldoutput object containing all the fieldOutput objects from which the maximum value will be computed.
A SymbolicConstant specifying the invariant or component label to be used when comparing vectors or tensors. Possible values are odb_Enum::MAGNITUDE odb_Enum::MISES odb_Enum::TRESCA odb_Enum::PRESS odb_Enum::INV3 odb_Enum::MAX_PRINCIPAL odb_Enum::MID_PRINCIPAL odb_Enum::MIN_PRINCIPAL You must provide either this argument or the following argument if the field is a vector or tensor.
An odb_String specifying the component of the tensor or vector to be used for selecting the minimum value.

Optional arguments

None.

Return value

An odb_SequenceFieldOutput object. The first fieldOutput object contains the minimum value. The second fieldOutput object contains the index of the field containing the minimum value. The index follows the order in which fields are positioned in the list of fieldOutput objects provided as the argument to the function.

Exceptions

OdbError

TypeError: This function takes no keyword arguments.

openOdb

This method opens an existing output database (.odb) file and creates a new Odb object.

Prototype

odb_Odb& openOdb(const odb_String& path);

Required arguments

path: A odb_String specifying the path to an existing output database (.odb) file.

Optional arguments

readOnly: A Boolean specifying whether the file will permit only read access or both read and write access. The initial value is False, indicating that both read and write access will be permitted.
readInternalSets: A Boolean specifying whether the file will permit access to sets specified as Internal in the database. The initial value is False, indicating that internal sets will not be read.

Return value

An Odb object.

Exceptions

If the output database was generated by a previous release of Abaqus and needs upgrading:

OdbError: The database is from a previous release of Abaqus. Run abaqus upgrade

-job <newFilename> -odb <oldFileName> to upgrade it.

If the output database was generated by a newer release of Abaqus, and the installation of Abaqus needs upgrading:

OdbError: Abaqus installation must be upgraded before this output database can be opened.

openOdb

This method opens an existing output database (.odb) file and creates a new Odb object.

Prototype

odb_Odb& openOdb(const odb_String& name,
const odb_String& path, bool readOnly, bool checkPhase, bool readInternalSets, STRMODE_DECL);

Required arguments

name: A odb_String specifying the repository key.

Optional arguments

path: A odb_String specifying the path to an existing output database (.odb) file.
readOnly: A Boolean specifying whether the file will permit only read access or both read and write access. The initial value is False, indicating that both read and write access will be permitted.
checkPhase: A Boolean specifying whether an error message will be printed if another process is modifying the database. The initial value is True, indicating an error message will be printed.
readInternalSets: A Boolean specifying whether the file will permit access to sets specified as Internal in the database. The initial value is False, indicating that internal sets will not be read.
STRMODE_DECL: A constant specifying whether the current locale encoding should be retained. If the ODB path uses only ASCII characters or if the path is known to be encoded in UTF-8, this argument need not be defined.

Return value

An Odb object.

Exceptions

If the output database was generated by a previous release of Abaqus and needs upgrading:

OdbError: The database is from a previous release of Abaqus. Run abaqus upgrade

-job <newFilename> -odb <oldFileName> to upgrade it.

If the output database was generated by a newer release of Abaqus, and the installation of Abaqus needs upgrading:

OdbError: Abaqus installation must be upgraded before this output database can be opened.

If the file is not a valid database:

AbaqusException: Cannot open file <filename>.

upgradeOdb

This method upgrades an existing Odb object to the current release and writes the upgraded version of the Odb object to a file. In addition, Abaqus/CAE writes information about the status of the upgrade to a log (*.log) file.

Prototype

void upgradeOdb(const odb_String& existingOdbPath,
const odb_String& upgradedOdbPath);

Required arguments

existingOdbPath: An odb_String specifying the path to the file containing the output database to be upgraded.
upgradedOdbPath: An odb_String specifying the path to the file that will contain the upgraded output database.

Optional arguments

None.

Return value

None.

Exceptions

If the output database upgrade fails:: OdbError: cannot convert database

getActiveOdb

This method is intended to be used inside an Abaqus/Standard or Abaqus/Explicit user subroutine written in C++. It fetches the object that is in use by the analysis product and enables a user to modify it inside the user subroutine. This method will throw an exception if more than one output database is currently open.

Prototype

odb_Odb& getActiveOdb();

Arguments

None.

Return value

An object.

Exceptions

If more than one output database file is open:: OdbError: The getActiveOdb method can only be called if a single odb file is open.
If no output database files are open:: OdbError: No odb files are open.

odb_IsA

This method takes a type and a base object and returns a boolean indicating whether the subtype of the supplied base object matches the type argument. This method is useful when fetching base Section, Profile, or Amplitude objects from their containers. If, for example, the user wants to determine if the base odb_Section object returned by the odb_SectionContainer is actually of type odb_BeamSection, he would call this method with the odb_BeamSection as the type and the odb_Section object as the base object.

Prototype

bool odb_IsA(TYPE, const BASETYPE& obj);

Required arguments

TYPE: The potential type of the base class object.
obj: The base object being tested for the TYPE.

Optional arguments

None.

Return value

A Boolean.

Exceptions

None.

odb_dynamicCast

This method casts a supplied Section, Profile, or Amplitude to the specified subtype. This method is useful for retrieving the base objects out of the appropriate containers and casting them to the subtype to access the data members for that particular subtype. This method will throw an odb_BaseException if the cast is not possible.

Prototype

const TYPE& returnObj = odb_dynamicCast(TYPE, const BASETYPE& obj);

Required arguments

TYPE: The potential type of the base class object.
obj: The base object being case to TYPE.

Optional arguments

None.

Return value

An object of type TYPE.

Exceptions

If the cast is not possible:: Bad cast: From BASETYPE To TYPE.