37.3 AcisFile object

The AcisFile object is a file object used to open ACIS-, STEP-, and IGES-format files.

Access
import part


37.3.1 openAcis(...)

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

Path
mdb.openAcis

Required argument

fileName

A String specifying the path to the ACIS file to open.

Optional argument

scaleFromFile

A Boolean specifying whether to scale, rotate, and translate the part using the transform read from the ACIS file. The default value is OFF.

Return value

An AcisFile object.

Exceptions

File is from a newer version of ACIS than the CAE kernel.

Texterror: ACIS File version exceeds Kernel.

The data in the ACIS file are corrupted.

Texterror: Failed to read ACIS file.


37.3.2 openCatia(...)

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

Path
mdb.openCatia

Required argument

fileName

A String specifying the path to the CATIA file to open.

Optional arguments

topology

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. If a CATIA V4-format file contains different toplogies, only the selected topology is imported from the file. The default value is SOLID .

convertUnits

A SymbolicConstant specifying whether the original units should be retained. Possible values are ON and OFF. The default value is OFF.

combineBodies

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 V4–format and CATProduct files, this option will be ignored.

Return value

An AcisFile object.

Exceptions

None.


37.3.3 openEnf(...)

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.

Path
mdb.openEnf

Required arguments

fileName

A String specifying the path to the Elysium Neutral File that was created by I-DEAS, Pro/ENGINEER, or CATIA V5.

fileType

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.

Optional arguments

topology

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

A Boolean specifying if the dimensions of the part should be converted to millimeters. The default value is OFF.

Return value

An AcisFile object.

Exceptions

None.


37.3.4 openIges(...)

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

Path
mdb.openIges

Required argument

fileName

A String specifying the path to the IGES file to open.

Optional arguments

trimCurve

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

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

A Boolean specifying if the IGES file contains MSBO (Manifold Solid B-Rep Object) entities. The default value is False.

includedLayers

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

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

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.

Return value

An AcisFile object.

Exceptions

The data in the IGES file are corrupted.

Texterror: Failed to read IGES file.


37.3.5 openParasolid(...)

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

Path
mdb.openParasolid

Required argument

fileName

A String specifying the path to the Parasolid file to open.

Optional argument

topology

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.

Return value

An AcisFile object.

Exceptions

None.


37.3.6 openStep(...)

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

Path
mdb.openStep

Required argument

fileName

A String specifying the path to the STEP file to open.

Optional argument

scale

A Float specifying the scaling factor to apply to the imported geometric entities. The default value is 1.0.

Return value

An AcisFile object.

Exceptions

The data in the STEP file are corrupted.

Texterror: Failed to read STEP file.


37.3.7 openVda(...)

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

Path
mdb.openVda

Required argument

fileName

A String specifying the path to the VDA-FS file to open.

Optional arguments

None.

Return value

An AcisFile object.

Exceptions

The data in the VDA-FS file are corrupted.

Texterror: Failed to read VDA file.


37.3.8 writeAcisFile(...)

This method exports the assembly to a named file in ACIS format.

Required argument

fileName

A String specifying the name of the file to which to write.

Optional argument

version

A Float specifying the ACIS version. For example, the Float “12.0” corresponds to ACIS Version 12.0. The default value is the current version of ACIS.

Return value

None

Exceptions

None.


37.3.9  Members

The AcisFile object has the following member:

numberOfParts

An Int specifying the number of parts in the object.