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.
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. |