Adams Basic Package > Adams View > Adams View > Exchanging Data in Adams > Importing and Exporting Geometry

Importing and Exporting Geometry

Comparison of CAD File Formats

The following compares the different CAD file formats for importing geometry using Adams View.
 
The file format:
Has the advantages/disadvantages:
Render
Volume information is supported within the given tolerance in the shape. Adams products, therefore, can calculate mass properties.
Each render file can contain many shapes, but when you import it, Adams View attaches all its geometry to only one part.
Color information is retained.
Importing your geometry as Stereolithography (STL) or render geometry is more reliable than using other CAD formats, such as IGES or STEP.
File format is very simple.
The files are much larger than IGES file.
Because the surfaces have been represented as polygons, you cannot change the accuracy of the surface representations in Adams View. You must specify the accuracy when you create the files in your CAD program.
Stereolithography
When exporting geometry from a CAD program, shapes are represented by triangles. Most CAD programs support the ability to specify a tolerance, and, therefore, the number of triangles.
Volume information of solid bodies is supported in Adams View, within the given tolerance in the shape. Using that shape, Adams products can calculate mass properties. Volume information of thin-walled bodies is not supported, so no mass properties can be calculated for it.
Only one body for each STL file.
Color information is not retained.
Only ASCII-based STL files are supported. Binary STL files will not import.
Parasolid
Currently, Adams View uses Parasolid version 35.
Using Parasolid files, you can import the whole model while you can only import part by part using STEP, IGES and STL (ASCII only).

About Importing and Exporting CAD Data Using Adams View

Adams View imports standard geometry files from any software package that supports Parasolid file formats, and converts the data into a set of Adams View geometry elements. These elements correspond to standard Adams Solver GRAPHICS statements, polylines, or shells. You associate the geometry with any rigid body part of the Adams View model before or after you run an Adams View simulation.
Importing CAD Data reduces the need to recreate geometry primitives within Adams View and enhances your ability to realistically view the behavior of complicated mechanical systems. You can also use the imported geometry for model building in Adams View and for locating parts, constraints, and forces based on the imported geometric data.
For recommendations of the best ways to export data from the CAD packages so you can import it effectively into Adams, see Recommendations for Exporting CAD Data.

About Exporting CAD Data

Adams View exports the geometric definition of an Adams model from Adams View to the geometry file format, Parasolid. The geometry file can then be read into CAD or CAE software.

About Importing CAD Data with Density

When a CAD geometry with the density attribute is imported under a part and ‘Ignore CAD density’ is not selected, the behavior is as follows,
 
Part has “Define mass by” set to
Part has zero bodies at the time of import
Part already has one or more bodies at the time of import
Geometry and material type
Switch to “Geometry and density” with the density value set to the one read-in from the import
Stay with the “Geometry and material type” option and ignore the density value read-in. The following message will be seen:
Ignoring density value of <density value> in imported file and instead using density of parent part <part name>'s material <material_name>.
Geometry and density
Continue with the “Geometry and density” option and modify density to new value read-in
Continue with the “Geometry and density” option and modify density to new value read-in from the import. The following warning message will be displayed:
WARNING: Overwriting density of <part density> for the parent part <part_name> to value in imported file, <imported density>.
User Input
Switch to “Geometry and density” with the density value set to the one read-in from the import
1. If user input mass > 0.0 then
keep the mass calculations to “User input” and ignore the density value read-in. The following message will be displayed: “Ignoring density value in imported file because parent part <part_name> has user-defined mass properties already.”
Else
2. Switch to “Geometry and density” with the density value set to the one read-in from the import
 
Note:  
If ‘Ignore CAD density’ is selected then any density values in the file will be ignored and not applied to the corresponding part(s)

About IGES Import and Export

The Initial Graphics Exchange Specification (IGES) was originally developed in 1979, by the National Bureau of Standards (NBS), to facilitate the transfer of geometry and annotations from one CAD/CAM system to another. IGES is the predominant format used for the transfer of geometry information. The IGES specification defines a structured hierarchical file format and the representation of a variety of entities within the format. The entity set includes: geometric, annotation, structure, associativity, property, and attribute entities.
The next sections explain how Adams View works with IGES files. For a detailed explanation of the IGES entity types, please refer to The Initial Graphics Exchange Specification (IGES) Version 5.0 manual.

Linear Approximation

Adams View directly supports only a subset of the geometry encountered in the IGES file. Some of the unsupported IGES entities are approximated using a technique called linear approximation. Adams View translates the nonlinear entities (for example, surface, curve, and so on) it encounters in the IGES file to polylines. For IGES curves, surfaces, and annotation entities that are nonlinear in definition, linear approximation produces a piecewise linear string of points or polygons that approximates the geometry to within a specified tolerance. For more information, refer to the discussion of the tolerance option in Import - STEP, IGES.

Unit Conversion

The import process in Adams View automatically converts all coordinate data in the IGES file to the internal units (meters, kilograms, seconds) of Adams View.

Manually Importing Assemblies

The concept of assemblies within IGES only exists within the IGES CSG definition (Constructed Solid Geometry; entity type 184). Adams View explodes all of the instances of the assembly into individual Adams parts.
There are three methods of importing assemblies into Adams View from an IGES file.
Defining Levels Before Generating IGES File (this is the recommended method)
The different method are explained in the next sections.
Defining Levels Before Generating IGES File
Defining levels in the IGES file is the best method to import an assembly into Adams View. When using this method, before importing the IGES file to Adams View, place each part in the assembly that corresponds to an Adams View part on a separate level. Refer to the CAD program that you are using to generate the IGES file for information on IGES levels.
After you generate the IGES file with the parts separated by levels, import the file into Adams View. Follow the instructions in Import - STEP, IGES. or use the IGES FILE READ command once for each part in the model using the PART_NAME parameter and the LEVEL parameter to ensure that the geometry from the appropriate level is placed on the correct part. You might find it easier to use the IGES FILE READ command than using the dialog box explained in the earlier section because you can create a command file that repeats the IGES FILE READ command as necessary.
For example, if you wanted to import an assembly of a pendulum, you first generate the IGES file with the ground part on level 1 and the pendulum on level 2. The complete geometric definition of the pendulum assembly exists in the IGES file but the levels identify the geometry on the ground part and the geometry on the pendulum part. Execute the following commands to read the IGES file and associate the desired geometry with the appropriate part:
FILE GEOM READ TYPE=IGES FILE= "pendulum.igs" PART_NAME= /pend/ground LEVEL= 1
FILE GEOM READ TYPE=IGES FILE= "pendulum.igs" PART_NAME= /pend/mass LEVEL= 2
Generating Separate IGES File
The second method to import an assembly is to generate a separate IGES file for each part in the assembly. For the previous example, you would generate two files: pendulum_ground.igs and pendulum_mass.igs. You would then execute the following commands to read the IGES files and transfer the geometry to the appropriate part:
FILE GEOMETRY READ TYPE=IGES FILE= "pendulum_ground.igs" PART_NAME= /pend/ground
FILE GEOMETRY READ TYPE=IGES FILE= "pendulum_mass.igs" PART_NAME= /pend/mass
This method has the advantage of not requiring the existence of levels in the IGES file but does require that you create multiple IGES files.
Importing Assembly as One Part
The third method is to import the geometry for the entire assembly onto one part and then use Adams View commands to move the geometry to the appropriate part. This method is tedious if the IGES file contains a large number of parts or a large number of geometric entities.

IGES Input Log File

Adams View generates a log file containing a list of any warnings or errors that may have occurred during the import into Adams View. Adams View creates the log file in the current directory and assigns it the same name as the IGES file with the extension .log.

Imported Mass Properties

Adams View does not support mass properties for IGES files if you import the geometry as a polygon or if the original shape is not solid.

Imported Subfigures

Adams View does not support subfigures. Therefore, Adams View does not import any geometry defined as subfigures in an IGES file.

Exported IGES Levels

When Adams View exports geometry in IGES format, it places the geometry for each Adams View part on a separate level within the IGES file. This provides for easier handling of geometry for individual parts after the IGES file has been written.
Adams View uses the Adams ID of the part as the integer ID identifying the IGES level. It writes dynamic geometry (graphic spring dampers and outlines that span multiple parts) to a separate level with an integer ID that is equal to 1 greater than the highest Adams part ID.

Exported Colors

Adams View writes the colors of geometric entities to the IGES file. It supports any color defined within Adams View. The RGB (red, green, blue) values are stored as entity number 314, Color Definition, in the IGES file. Note that not all IGES vendors support RGB color values.

Exported Visibility

Adams View translates invisible geometric objects to the IGES file as blanked entities. The visibility of the object as it appears in Adams View determines how it is interpreted when written to the IGES file as shown in the table below.
 
Adams View visibility:
IGES translation:
On
Normal
Off
Blanked
No Opinion
Normal

Supported IGES Entities

A summary of the supported IGES entities is shown in the table below. Note that the three-dimensional graphic icons representing Adams modeling elements (joints, and so on) are not translated to the IGES file.
 
Adams View object:
Entity type number:
IGES entity:
Import, export, or both:
Arc
100
Circular arc
Both
Circle
100
Circular arc
Both
Graphic force
102
Composite curve
Export
Spline
102
Composite curve
Export
Outline
102 or 106
Composite curve or copious data
Export
Polyline
102 or 106
Composite curve or copious data
Both
Ellipse/nurbcurve
104
Ellipse/nurb_curve
Both
Block
106
Copious data
Export
Cylinder
106
Copious data
Export
Ellipsoid
106
Copious data
Export
Extrusion
106
Copious data
Export
Frustum
106
Copious data
Export
Link
106
Copious data
Export
Graphic spring damper
106
Copious data
Export
Revolution
106
Copious data
Export
Shell
106
Copious data
Export
Tire
106
Copious data
Export
Torus
106
Copious data
Export
Face (trimmed surf)
108:1
Plane
Both
Polyline
110:0
Line
Both
nurb_curve
112:0
Parametric spline curve
Both
nurb_surf
114:0
Parametric spline surface
Both
Marker
116
Point
NS
Polyline
116:0
Point
Import
nurb_surf
118
Ruled surface
Import
nurb_surf
120:0
Surface of revolution
Import
nurb_surf
122:0
Tabulated cylinder
Import
Explode
125:0
Flash entity
Import
Polyline
125:2
Polyline
Import
arc
125:3
Arc
Import
polyline
125:4
Polyline
Import
nurb_curve
126
Rational b-spline curve
Import
nurb_surf
128
Rational b-spline surface
Import
nurb_curve
130:0
Offset curve
Import
explode
132:0
Connect point entity
Import
nurb_surf
140:0
Offset surface
Import
Chain
141:0
Composite edge curve (boundary)
Import
Chain
142:0
Composite edge curve
Import
Face
143:0
Bounded surface
Both
Face
144:0
Trimmed parametric surface
Both
Solid
186:0
Manifold solid B-rep object
Import
Explode
202:0
Angular dimension
Import
Explode
204:0
Curve dimension
Import
Explode
206:0
Diameter dimension
Import
106:11 and explode
208:0
Flag note
Import
Explode
210:0
General label
Import
Polyline
212
Polyline
Import
Polyline
214
Leader
Import
Explode
216
Linear dimension
Import
Explode
220:0
Point dimension
Import
Explode
222
Radius dimension
Import
Explode
228
General symbol
Import
106 and explode
230
Sectioned area
Import
Explode
308:0
Subfigure definition
Import
Explode
320:0
Network subfigure definition
Import
Explode
408:0
Singular subfigure instance
Import
Explode
412:0
Rectangular array subfigure
Import
Explode
414:0
Circular array subfigure
Import
Explode
420:0
Network subfigure instance
Import

About STEP Import and Export

STEP is officially known as ISO 10303 - Exchange of Product Model Data. A summary of STEP is provided in the ISO document, STEP Part 1: overview and fundamental principles. The following is a paragraph from the ISO document describing STEP format.
The Standard for the Exchange of Product Model Data (STEP) is a neutral mechanism capable of completely representing product data throughout the life cycle of a product (Neutral in this context indicates independence from any particular CAx software system). The completeness of this representation makes it suitable not only for neutral file exchange, but also as a basis for implementing and sharing product databases and archiving. There is an undeniable need to transfer product data in computer-readable form from one site to another. These sites may have one of a number of relationships between them (contractor and subcontractor, customer and supplier); the information invariably needs to iterate between the sites, retaining both data completeness and functionality, until it is ultimately archived. The most cost effective manner to encapsulate such information is in a neutral format, independent of any Computer-Aided (CAx) software system.
Contact the U.S. Product Data Association (USPRO) for more information on STEP. Their address is P.O Box 3310, Gaithersberg, Maryland, 20885-3310. Their phone number is 301-975-4658, their FAX number is 310-926-8730, and their e-mail is uspro@scra.org.

Imported Mass Properties

Adams calculates mass properties for parts using STEP geometry by multiplying the volume of the STEP geometry by the material density defined in the Adams part. Mass properties that are explicitly defined in Adams will continue to be used.

Supported STEP Entities

Adams View supports STEP applications protocols AP 203 and AP 214 for import and AP 203 for export. A summary of the supported STEP entities is provided in the table below. Note that the three-dimensional graphic icons representing Adams modeling elements (joints, and so on) are not translated to the STEP file.
In addition, note that we do not support conformance class 5, which contains faceted B-rep shape representations. AP 214 is still in the committee-draft stages of its development and, therefore, we do not encourage its use.
 
Adams View object:
STEP entity:
Import, export or both:
Arc
step_circle
Both
Polyline
step_cartesian_point
Import
Polyline
step_line
Both
Polyline
step_polyline
Both
Cone
step_conical_surface
Import
Cylinder
step_cylindrical_surface
Import
Ellipse
step_ellipse
Both
Sphere
step_spherical_surface
Import
Torus
step_toroidal_surface
Import
nurb_curve
step_bezier_curve
Import
nurb_curve
step_b_spline_curve_with_knots
Both
nurb_curve
step_offset_curve_2d
Import
nurb_curve
step_offset_curve_3d
Import
nurb_curve
step_parabola
Import
nurb_curve
step_hyperbola
Import
nurb_curve
step_quasi_uniform_curve
Import
nurb_curve
step_rational_bezier_curve
Import
nurb_curve
step_rational_b_spline_curve_with_knots
Both
nurb_curve
step_rational_quasi_uniform_curve
Import
nurb_curve
step_rational_uniform_curve
Import
nurb_curve
step_trimmed_curve
Import
nurb_curve
step_uniform_curve
Import
nurb_surf
step_bezier_surface
Import
nurb_surf
step_offset_surface
Import
nurb_surf
step_b_spline_surface_with_knots
Both
nurb_surf
step_quasi_uniform_surface
Import
nurb_surf
step_rational_bezier_surface
Import
nurb_surf
step_rational_b_spline_surface_with_knots
Both
nurb_surf
step_rational_quasi_uniform_surface
Import
nurb_surf
step_rational_uniform_surface
Import
nurb_surf
step_rectangular_trimmed_surface
Import
nurb_surf
step_surface_of_linear_extrusion
Import
nurb_surf
step_surface_of_revolution
Import
nurb_surf
step_uniform_surface
Import
Solid
step_brep_with_voids
Both
Solid
step_manifold_solid_brep
Both
Chain
step_composite_curve
Both
Face (trimmed surf)
step_curve_bounded_surface
Both

Tips on Importing Wavefront Files

The Wavefront file is unitless even though most of the ViewPoint graphics internally use one hardcoded unit system. You will need to scale the vertices to make them fit the units set in the Adams View model. For example, if the Viewpoint graphics were originally created using the length unit, mm, then, if your Adams View session units are in meters, you’ll use a scale factor of .001.
You may find that you need to experiment with different scale factors to create a model that contains practical scales. To experiment with the different scale factors, just undo the import if it does not work using the Undo command.
Before importing the graphics, create a dummy part to which you’ll attach the Wavefront graphics. Creating dummy parts is helpful because the orientation within the Viewpoint dataset is usually different than the orientation of your model. Dummy parts provide an easy method of moving and rotating the graphics to match your Adams model. To move the graphics, you just move the dummy part.
Here is a procedure for ensuring that the geometry is attached to the correct part:
1. From the View menu, select Part, and select the dummy part to view.
2. Rename each shell so that it belongs to the correct part.
Different shells start disappearing from the dummy part while in View Part Only mode.
3. After renaming all the geometry, delete the dummy part.
4. Display the model.
Now you have the model with different graphics elements attached to correct parts and at correct locations and orientations.
A convenient way to read in an entire Viewpoint dataset and avoid some of the problems mentioned earlier is to reduce the number of group names in the dataset before importing it into Adams View.
Generally, groups in the Wavefront file become parts in Adams View. If a part already exists that has the same name as a group, however, the graphics simply attach to the existing part without creating a new part. If Adams View finds a group with no corresponding part, it creates a new part for the group.
If you have multiple groups with the same name in the Wavefront file, all groups attach to the same Adams View part but become separate geometric entities. This allows you to use different colors within the same Adams part to create more realistic images.
The only lines that are significant in the Wavefront file are the ones that begin with g (groups), f (facets), and v (vertex). Adams View ignores everything else.
To reduce the number of group names, open the dataset in a text editor and substitute names before importing the set into Adams View. For example, a car body dataset typically has the following group names:
g hood
g fender
g windows
g bumper
Change them to the same name so they attach to a single part. For example:
g body
g body
g body
g body

Recommendations for Exporting CAD Data

The following sections provide recommendations for how you should export data from different CAD packages so you can best import them into Adams:

General Comments on Exporting

For those CAD systems based on the Parasolids kernel, there are many benefits to transferring geometry in Parasolid files. Adams View creates solid bodies from the Parasolids information that allows for further Boolean operations as well as the selection of geometric features such as the center of a circle. It is important that you export the version of the Parasolids file that Adams View supports.
In general, the simpler the representation of the geometric information the better. This is why we often recommend that you used Stereolithography over formats such as IGES and STEP. Other simple formats include render and shell files. Shell files are Adams-specific so you will not find them as part of the standard CAD export formats. Please remember that some of these formats do not have colors.
Successful transfer of IGES and STEP files from CAD systems to Adams View depends on both systems. Some CAD systems export information that is easily processed by Adams View while others CAD systems generate files that are difficult or impossible for Adams View to import. We have taken this into consideration in the Recommendations for Exporting CAD Data.

Recommendations for Exporting CAD Data

The following table provides recommendations for the file formats in which you should export data from a CAD program so you can import it effectively into Adams. Please note that the recommendations are in order of preference. For a comparison of the different file formats, see Comparison of CAD File Formats.
 
For the CAD package:
Recommendations in order of preference:
Comments:
Unigraphics (UG)
If using the Adams_CAD_Translators license, then UG NX .prt files can be read by Adams View directly.
Otherwise, export from UG in these file formats in order of preference:
Parasolids
Stereolithography
Using Parasolids (without the embedded motion products) is convenient because one file contains all the geometry and Adams View creates a separate part for each solid.
Stereolithography is dependable but requires you to output each part separately. It only works on solid bodies.
CATIA
If using the Adams_CAD_Translators license, then CATIA V4 (.model, .dlv, .exp, session) files and CATIA V5 (.CATPart, .CATProduct) files can be read by Adams View directly.
Otherwise, export from CATIA in these formats in order of preference:
Stereolithography
STEP
IGES
IGES and STEP export is time consuming and Adams View can have difficulties reading the resulting files.
Pro/Engineer or Creo
If using the Adams_CAD_Translators license, then Pro/Engineer and Creo files (.prt, .asm) can be read by Adams View directly.
Otherwise, export from Pro/ENGINEER or Creo in these formats in order of preference:
Render
Stereolithography
IGES
Render files contain color, while Stereolithography files do not.
Solidworks
If using the Adams_CAD_Translators license, then Soidworks files (.sldprt and .sldasm) can be read by Adams View directly.
Otherwise, export using Dynamic Designer with Shells (v2000)
Or, export from Solidworks in these formats in order of preference:
Parasolid
Stereolithography
IGES
Exporting from the embedded motion product automates the geometry export/import process.
Using Parasolid is convenient because one file contains all the geometry and Adams View creates a separate part for each solid.
Stereolithography is dependable but requires you to output each part separately. It only works on solid bodies.
SolidEdge
Export using Dynamic Designer with Shells (v2000).
Or, export from SolidEdge in these file formats in order of preference:
Parasolids
Stereolithography
IGES
Exporting from the embedded motion product automates the geometry export/import process.
Using Parasolid is convenient because one file contains all the geometry and Adams View creates a separate part for each solid.
Stereolithography is dependable but requires you to output each part separately. It only works on solid bodies.
Mechanical Desktop
Export using Dynamic Designer with Shells (v2000).
Or, export from Mechanical Desktop in these file formats in order of preference:
IGES
Stereolithography
Exporting from the embedded motion product automates the geometry export/import process.
IGES transfers are complicated but are reasonably dependable.
Stereolithography exports are unpredictable because the model has to be in a particular quadrant before exporting.
Microstation
Parasolid
Using Parasolid is convenient because one file contains all the geometry and Adams View creates a separate part for each solid.