V5i NX User Guide - theorem.com€¦ · CADverter v19.2 for CATIA V5i - NX 3 ... The CATIA V5i to...

CADverter for CATIA V5i to NX

Product Release Version 19.2

USER GUIDE Revision: 1.0

Issued: 22/07/2016

© THEOREM SOLUTIONS 2016

CADverter v19.2 for CATIA V5i - NX

1 | P a g e ©Theorem Solutions 2016

Contents

Overview of CADverter .............................................................................................................. 3

About Theorem ......................................................................................................................3

What is CADverter? ................................................................................................................3

The CATIA V5i Bi-directional NX CADverter ...........................................................................4

Primary Product Features .......................................................................................................4

Primary Product benefits? ......................................................................................................5

Getting Started .......................................................................................................................... 6

Documentation .......................................................................................................................6

Installation Media ...................................................................................................................6

Installation ..............................................................................................................................6

License Configuration .............................................................................................................6

Running the Product ...............................................................................................................7

Using the Product ...................................................................................................................... 8

Default Translations ...........................................................................................................8

Default Translation – via the Unified Interface ..............................................................8

Default Translation – via the Command Line .................................................................9

Translator Customization ........................................................................................................ 11

Common Options for CATIA V5i to NX ................................................................................ 11

CATIA V5i Read Arguments ............................................................................................. 12

NX Write Arguments ........................................................................................................ 12

3D PDF Write Arguments ................................................................................................ 13

CATIA V5i to NX Entity Mask Arguments ......................................................................... 13

CATIA V5i to NX General Arguments ............................................................................... 15

Common Options for NX to CATIA V5i ................................................................................ 17

NX Read Arguments ......................................................................................................... 17

Catia V5i Write Arguments .............................................................................................. 18

3D PDF Write Arguments ................................................................................................ 19

CATIA V5i to NX Entity Masking Arguments .................................................................... 19



NX to CATIA V5i General Arguments ............................................................................... 21

Command Line Advanced Arguments ................................................................................. 22

CATIA V5i to NX Advanced Arguments ............................................................................ 22

NX to CATIA V5i Advanced Arguments ............................................................................ 23

Appendix A: Write 3D PDF Arguments .................................................................................... 24



Overview of CADverter

About Theorem

Theorem Solutions is a world leader in the field of

Engineering Data Services and Solutions. This

leadership position stems from the quality of our

technology and the people in the company. Quality

comes not only from the skills and commitment of

our staff, but also from the vigorous industrial use of

our technology & services by world leading customers.

We are proud that the vast majority of the world's leading Automotive, Aerospace, Defense,

Power Generation and Transportation companies and their Supply chains use our products

and services daily. Working closely with our customers, to both fully understand their

requirements and feed their input into our development processes has significantly

contributed to our technology and industry knowledge.

Theorem Solutions is an independent UK headquartered company incorporated in 1990,

with sales and support offices in the UK and USA. Theorem has strong relationships with the

major CAD and PLM vendors, including; Autodesk, Dassault Systemes, ICEM Technologies (a

Dassault company), PTC, SolidWorks, Spatial Technology and Siemens PLM Software. These

relationships enable us to deliver best in class services and solutions to engineering

companies worldwide.

What is CADverter?

CADverter is one of 5 core Theorem brands which consist of:

CADverter

Direct translation of 3D data to or from an alternate CAD, Visualization

or Standards Based format

Multi-CAD

Interactive integration of non-native 3D data formats into the native

CAD system

Visualize 3D

Direct translation of 3D data for the purpose of Visualization



Publish 3D

The creation of documents enriched with 3D content

Process Automation

Applications to automate any Data Exchange and collaboration

processes

The CATIA V5i Bi-directional NX CADverter

The CATIA V5i to NX CADverter is a direct database converter between CATIA V5 and NX. It enables the user to convert all forms of mechanical design geometry, as well as assembly and attribute information, between these two systems without requiring access to a CATIA V5 license. CADverter can be purchased as a uni-directional, CATIA V5 to NX, or NX to CATIA V5 product, or as a bi-directional product. The translator can be invoked in batch mode with the command line interface allowing the conversion process to be integrated into any process oriented operation. Alternatively the conversion process may be operated by using the Theorem Unified Interface.

Primary Product Features

CADverter converts all geometry

If assembly data (product structure) is in the file, the assembly structure will be mapped between the two systems as well as colour information

The user can filter data to optimize the process

If you wish to visualise and interrogate the CATIA V5 or NX data this can be done by using the integrated User Interface, which is included with CADverter

In addition CADverter will work with other Theorem products including Data Exchange Navigator

There is no dependency on a CATIA V5 installation or application license

The conversion process can be in Batch Mode or using the Unified Interface

Command line interface allows process integration



Primary Product benefits?

Direct conversion between CATIA V5 and NX reduces processing time, simplifies integration and retains accuracy of the model

The integrated viewing capability enables visual verification, pre and post translation

The integrated data filtering options allows selected data ONLY to be processed, enabling optimisation of translations and time savings

By converting all forms of geometry no data is lost, eliminating the time required to recreate missing data

With over 20 years industrial use Theorem’s product robustness and quality is well proven, reducing your business risk

This document will focus specifically on guidance for the use of the CADverter for CATIA V5i to NX product. For information regarding any of Theorem’s product ranges please contact [email protected]

mailto:[email protected]



Getting Started

Documentation The latest copy of this documentation can be found on our web site at:

http://www.theorem.com/Documentation

Each product has a specific link that provides user documentation in the form of PDF and

Tutorials.

Installation Media The latest copy of Theorem software can be found via our web site at:

http://www.theorem.com/Product-Release-Notes

Each product has a specific link to the Product Release Document, which contains a link to

the download location of the installation CD.

Alternatively, you can request a copy of the software to be shipped on a physical CD.

Installation The installation is run from the CD or ZIP file download provided.

Currently, there are 2 distinct installation stages that are required.

To install the translator, select the Setup.exe file and follow the installation

process. For a full guide to the process, please see our ‘Translator Installation

Process’ demonstration video located here.

In addition, the Theorem Unified Interface will also need to be installed. The

installation process is the same as for the Translator. For a full guide to the

process, please see our ‘Translator Installation Process’ demonstration video

located here.

License Configuration In order for the translation to run successfully, the Theorem license file

provided to you needs to be configured using FlexLM. For a full guide to this

process, please see our ‘FlexLM License Set Up and Configuration’

demonstration video located here.

http://www.theorem.com/Documentation

http://www.theorem.com/Product-Release-Notes

http://www.theorem.com/Documentation/CADverter/Install.mp4

http://www.theorem.com/Documentation/CADverter/UI_Install.mp4

http://www.theorem.com/Documentation/CADverter/License_Config.mp4

http://www.theorem.com/Documentation/CADverter/Install.mp4

http://www.theorem.com/Documentation/CADverter/UI_Install.mp4

http://www.theorem.com/Documentation/CADverter/License_Config.mp4



Running the Product Once configured and licensed, the product is ready to be run.

There are 2 distinct ways of running the translator:

Via the Theorem Unified Interface

The Unified Interface offers a Desktop Environment that allows CAD

and Visualization data to be viewed pre and post translation

Via the Command Line

The Command Line Interface provides a direct method of invoking the

translator. It can be used via a DOS shell or called via a third party

application as part of a wider process requirement.

http://www.theorem.com/Documentation/CADverter/V5i_NX_UI.mp4

http://www.theorem.com/Documentation/CADverter/V5i_NX_CMD.mp4



Using the Product

Default Translations

Default Translation – via the Unified Interface The Unified Interface can be started via the Start Menu – if a shortcut was added during

installation.

Alternatively, the Unified Interface can be run via a Windows Explorer selection in:

<UI_installation_directory>\bin\Unified_Interface.cmd

The following interface will be launched:

The default layout is split into 4 primary areas, which can be altered to the users prefer:

File

Browser

Active

Configurations

C

Output

Logs

Translation

Activity



The simplest way to translate from CATIA V5 to NX is to drag a file from the file Browser

Pane on to the Active Configurations for the translation you require.

On completion, the Unified Interface will display the activity information and details from

the log file created during the translation, if requested, in the Translation Activity and

Output Log panes, respectively.

The generated output data can be located by selecting the translation from the Activity pane

and opening the output folder:

Default Translation – via the Command Line Running a translation via the command line can be carried out via the cad_run.cmd file

located in the <installation_directory>\bin directory. The format of the command is as

follows when translating from CATIA V5 to NX:



<Translator_installation_directory>\bin\cad_run.cmd Catia5i_nx –i <input_file> -o

<output_file>

The example above will translate a CATIA V5 sample file provided within the installation and

produce the following screen output:

The file will be output to the target location. In this case:

%Theorem_Installation%\samples\catia5\NIST\nist_ctc_02_asme1_ct5210_rc.prt



Translator Customization

The Theorem translator allows the information that is read from the source system and

written to the target system to be tailored via a set of user specified arguments. Commonly

used arguments are supported via the Unified Interface, with Advanced Arguments being

described within this document for use in the Unified Interface or via the Command Line

invocation.

Common Options for CATIA V5i to NX Within the Configuration Manager pane of the Unified Interface, arguments that can be

specified when publishing CATIA V5 data into NX are grouped into the following areas:

CATIA V5i Read – Those arguments that affect how data is read from CATIA V5

NX Write – Those arguments that affect how the data is written to NX

3DPDF Write – Those arguments that affect how the data is written to 3DPDF

Masking - Additional Read/Write options to limit the types of data translated

e.g. Solids Only

General – Those arguments that are common to ALL Publishing activities

regardless of source data



CATIA V5i Read Arguments The image below shows the CATIA V5I Read arguments that are available, with their default

settings:

Each of these options is described below:

Option Description

Retain Assembly

Structure

Retain the assembly structure. Default is ON.

o Command Line Syntax

offditto (to disable) – reduces an assembly to

a single Part

Read Face Colours Process face colours in preference to body colours. Default is ON

Command Line Syntax

disable_face_colours

Read Hidden Data Allow selective data types to be read regardless of hide/show state.

Default is OFF.

Command Line Syntax

read_hidden_geometry

Read PMI Reads any PMI data available in the V5 file(s)

Categorise PMI Categorise the PMI by its type (Notes, Datum, GDT etc.

Read Hidden Views Reads any Views that are hidden

NX Write Arguments The image below shows the NX Write arguments that are available, with their default settings:




Option Description

Delete Existing Sub-parts

Delete existing sub-parts. Default is OFF.

o Command Line Syntax delete_parts

Concatenate Assembly Name

Concatenates assembly name. Default is OFF. Command Line Syntax

Concat_assy

Create Faceted Solid

Creates a faceted solid if the source data is faceted. Default is ON.

Command Line Syntax

No_poly_sol – to turn off

Produce Tessellated Output

Create a tessellated JT file instead of an NX file. Default is OFF.

Command Line Syntax

Tess_output – to turn off

3D PDF Write Arguments The CATIA V5 to NX Translator provides an Add On service module to support the capability

to output a 3D PDF file as part of the translation process.

Please Note! This capability requires an additional theorem license.

Please refer to Appendix A 3D PDF Write Arguments

CATIA V5i to NX Entity Mask Arguments



The image below shows the CATIA V5i to NX Entity Mask arguments that are available, with their default settings:


Option Description

Mask File

Specifies the Mask File to be written to, that can be referenced by future

translations. A Mask file MUST be specified if masking is required. The

first line in this file is OFF ALL ENT:

Command Line Syntax:

Mask <filename>

Entity Types

Translated

Specifies a selection list from which to select which entity types are to be

processed. The following types are available:

"SOL" - Masks any 3D entity

"SKIN" - Masks any 2D entity

"CUR" - Masks any 1D entity

"POI" - Masks any 0D entity

"AXIS" - Masks Axis Systems

"ISOL" - Masks Isolated facetted solids

"CCRV" - If on creates a CCRV curve for wire frame edges that

have more than one supporting curve

"TEXT" - Masks PMI Text


Add any of the above to the specified mask file,

one entry per line prefixed by the word ON,

e.g.:

ON POI



to ensure they are considered in the translation

Layers

Translated

Specifies a selection list from which to select which layers are to be

processed.


A single entry of ON ALL LAY Must precede any

Layer Mask command.

Add a list or range of numbers representing layer

to be processed to the specified mask file to

ensure they are NOT considered in the

translation

e.g.:

OFF LAY 114,149,166,167,168

Convert No

Show Geometry

Enables Hidden geometry to be processed (Default = Off)


Add the following entry to the Mask file

ON NOSHOW GEO

Convert No

Show Structure

Enables Hidden Assembly Structure to be processed (Default = Off)



ON NOSHOW STR

Convert No

Show AXIS

Enables Hidden Axis Systems to be processed (Default = Off)



ON NOSHOW AXI

CATIA V5i to NX General Arguments The image below shows the General arguments that are available, with their default

settings:


Option Description

Mass Properties

CATIA V5 mass properties (volume/area CofG) are read and

any applied materials, using this option, in cases where a part

has multiple solids, volume and area values are summed, but

CofG data is invalid.

Command Line Syntax

mprops



Advanced Allows any of the Command Line Advanced arguments

documented to be passed to the Unified Interface invocation.



Common Options for NX to CATIA V5i Within the Configuration Manager pane of the Unified Interface, arguments that can be

specified when publishing NX into CATIA V5 data are grouped into the following areas:

NX Read – Those arguments that affect how data is read from NX

Catia5i Write – Those arguments that affect how the data is written to Catia5

3DPDF Write – Those arguments that affect how the data is written to 3DPDF

Masking - Additional Read/Write options to limit the types of data translated

e.g. Solids Only

General – Those arguments that are common to ALL Publishing activities

regardless of source data

NX Read Arguments The image below shows the CATIA V5I Read arguments that are available, with their default

settings:

Each of these options is described below.

Option Description

Assembly Retain assembly structure. Default is ON.


ditto

noditto – to turn off

Reference Set Enabled reference set processing. Default is OFF


ref_set – to turn on

Process ALL Layers Process all layers, else 'As Saved'. Default is ON




part_layer – to turn off

Read NX names Read NX entity names, if they exist. Default is OFF.


no_read_name – default

read_name – to turn on

Convert surfaces to NURBS Read surfaces as NURBS surfaces (else read in native form).

Default is ON.


Noprep – to turn off

Convert Edge Curves to

NURBS

Read edge curves as NURBS curves (else read in native

format). Default is ON.


rd_native_edge – to turn off

Catia V5i Write Arguments The image below shows the CATIA V5I Write arguments that are available, with their default

settings:


Option Description

Save Catia5 Version Save a specified version of Catia5 data (default 25 (2015))


save_catia5_version <version>

Where versions are :

16

17

18

19

20

21

22 or 2012

23 or 2013

24 or 2014



25 or 2015

disable_points Prevents point entities from being written


disable_points

disable_wireframe Prevents wireframe entities from being written


disable_ wireframe

Create CGR Writes data as a CGR file


Create_CGR

3D PDF Write Arguments The CATIA V5 to NX Translator provides an Add On service module to support the capability

to output a 3D PDF file as part of the translation process.


Please refer to Appendix A 3D PDF Write Arguments

CATIA V5i to NX Entity Masking Arguments The image below shows the CATIA V5i to NX Entity Mask arguments that are available, with their default settings:




Option Description

Mask File

Specifies the Mask File to be written to, that can be referenced by future

translations. A Mask file MUST be specified if masking is required. The

first line in this file is OFF ALL ENT:


Mask <filename>

Entity Types

Translated

Specifies a selection list from which to select which entity types are to be

processed. The following types are available:

"SOL" - Masks any 3D entity

"SKIN" - Masks any 2D entity

"CUR" - Masks any 1D entity

"POI" - Masks any 0D entity

"AXIS" - Masks Axis Systems

"ISOL" - Masks Isolated facetted solids

"CCRV" - If on creates a CCRV curve for wire frame edges that

have more than one supporting curve

"TEXT" - Masks PMI Text


Add any of the above to the specified mask file,

one entry per line prefixed by the word ON,

e.g.:

ON POI

to ensure they are considered in the translation

Layers

Translated

Specifies a selection list from which to select which layers are to be

processed.


A single entry of ON ALL LAY Must precede any

Layer Mask command.

Add a list or range of numbers representing layer

to be processed to the specified mask file to

ensure they are NOT considered in the

translation

e.g.:

OFF LAY 114,149,166,167,168

Convert No

Show Geometry

Enables Hidden geometry to be processed (Default = Off)



ON NOSHOW GEO

Convert No

Show Structure

Enables Hidden Assembly Structure to be processed (Default = Off)





ON NOSHOW STR

Convert No

Show AXIS

Enables Hidden Axis Systems to be processed (Default = Off)



ON NOSHOW AXI

NX to CATIA V5i General Arguments The image below shows the General arguments that are available, with their default

settings:

The option is described below:

Option Description

Mass Properties

NX mass properties (volume/area CofG) are read and any

applied materials, using this option, in cases where a part has

multiple solids, volume and area values are summed, but

CofG data is invalid.

Command Line Syntax

mprops

Advanced Allows any of the Command Line Advanced arguments

documented below to be passed to the Unified Interface

invocation



Command Line Advanced Arguments Any of the Advanced arguments can be added to the Command Line Invocation or to the

General->Advanced field when run from within the User Interface.

CATIA V5i to NX Advanced Arguments Option Description

Simplify Curves Convert NURBS curves to conics. Default is OFF.

Command Line Syntax

simplify_curve

Convert Curves to

NURBS

Convert curves to NURBS. Default is OFF.

Command Line Syntax

convert_curves

Conversion Tolerance A secondary argument to ‘Convert Curves’ defining the conversion

tolerance. Default is 0.00001

Command Line Syntax

convert_curve_tol 0.00001

Convert Surfaces to

NURBS

Process data (read) types as NURBS. Data type is selected from

options. Default is Fillets.

Command Line Syntax

None: dont_convert_fillets

Fillets: Default Option.

Spheres: dont_convert_fillets

convert_spheres

Fillets + Spheres: convert_spheres

All: convert_surfaces

Convert Torus to

NURBS

Even when data is read as NURBS data, the Torus types are

converted to NURBS by default, this can be disabled using the

command line

Command Line Syntax

dont_convert_torus

Conversion Tolerance A secondary option to ‘Convert Surfaces to NURBS’. Defines the

conversion tolerance. Default is 0.00001.

Command Line Syntax

convert_surface_tol 0.00001

Trim Face Surfaces Trims face surfaces. Default is ON.

Command Line Syntax

dont_trim_surfaces

Process Large Faces Enable reading of faces larger than 1km. Default is OFF.

Command Line Syntax

allow_large_faces

UDF Axis Systems Enable reading of User Defined Axis systems. Default is OFF.

Command Line Syntax

read_udf_axis – to turn on

Graphical Read By default the BREP data will be read. It is possible to read the

CATIA V5 data as a graphical representation using this option



Command Line Syntax

enable_graphical

Filter Geometry It is possible to filter large planes (construction planes) larger than a

given size using (default being 1000 meters)

Command Line Syntax

filter_large_geom <meters>

There is a special case for PLANES (typically construction planes)

which by default are not read, these can be enabled using

Command Line Syntax

read_planes

NX to CATIA V5i Advanced Arguments

Advanced Option Description

Small Curves

Report Small curves as errors. (default OFF)


small_curves (to enable)

Extend Nurb Surfaces Extends NURBS surfaces beyond face limits for curve

projection (default state)


no_extend_nurb -(Don’t extend

NURBS surfaces to face limits)

extend_nurb <int> - (trims NURBS

surfaces to <int> * 0.0001 face

extents in u and v)

Remove Groups Remove Group entities into assembly structure. (default OFF)


remove_groups (to enable)

Use Ref Name Uses file name from input system to name files (default OFF)


use_ref_name (to enable)



Appendix A: Write 3D PDF Arguments


These arguments are common to both directions of the V5i <> NX converter when available

with an additional license.

The image below shows the ‘Write 3D PDF’ arguments that are available, with their default

settings:



Each of these arguments is described below:

Option Description

Create PDF Allows creation of 3D PDF file. Default is OFF.

Write Mode Contains two options:

Use a Template – Allows data to be published to a given

template (Default)


Publish std <list of Manifest files>

No Template – No template will be used during

publishing. If this option is selected, ‘Template Selection’

is excluded as an option.


Publish off

Template Selection Select which templates Publish 3D will use to create the output

3D PDF, if Write Mode is set to Use a Template (Default =

defaultManifest.xml)


This is a secondary argument to the publish

command. The argument can be a single xml

manifest file to a text file containing a list of

manifest files

Attachments This option allows files to be attached to the output PDF file

together with a brief description of the selected files. (Default is

for no files to be attached)


Attach_file <Attachment List>

Where Attachment_List is a list of full path

names to file followed by an optional description

line:

e.g. C:\TEMP\my_image.jpg This is a jpg Image C:\TEMP\report.txt Report Document C:\TEMP\related.pdf C:\TEMP\another.pdf This PDF has a description

Note in this example the 'Related.pdf' attached file doesn't have the optional comment.

The file path may contain environment variables which will be

resolved. e.g. %TEMP%/myFile.pdf Password Protect Contains two options Access and Edit:

Unchecked – Specifies that no password will be used to

Access/Edit the PDF Document (Default). If this option is

selected Password is excluded as an option.




No entry required

Checked – Allow a password to be specified to

Access/Edit the PDF document.


Password <password>

Password Specify a password is to be used.

See Password Protect - This is a secondary argument to

the password command.

3D View Activation Controls when the 3D view is activated in the PDF document.

Has 3 options:

Automatic – Activates when the page is opened.

(Default)

o Command Line Syntax:

Activate_mode PAGE_OPEN

On Selection – Activates when the user clicks on the

model.


Activate_mode CLICK (default via the

command line)

Page Visible – Activates when the page becomes visible

to the user


Activate_mode PAGE_VISIBLE

Add Standard Views Add isometric views to the data being written to PDF (Default is off)

o Command Line Syntax: add_standard_views

Disable Views Switch off any Captures/Views from being written into the PDF. (Default is off)

o Command Line Syntax: no_views

Disable View Sections Switch off any sections within the Captures/Views from being written into the PDF. (Default is off)

o Command Line Syntax: no_sections

Show Cutting Plane Enable cut plane visualization. (Default is off)

o Command Line Syntax: cutplane_on

Render Mode Controls which Rendering Mode to use for the model. Options

are:

Solid (Default)

Transparent

Wire

Illustrated

Outline

Shaded




Render_mode <mode>

Where mode is set to one of the above

values

Light Mode Controls which Light Mode to use. Options are:

Default

Off

Day

Bright

Prim

Night

Blue

Red

Cube

Head


light_mode <mode>

Where mode is set to one of the above values. Note! No

command is required for the default value.

Hide Toolbar Hide the 3D Toolbar in the resultant document. This can be re-

enabled in Adobe if required. (Default is off)


hide_toolbar

Hide Model Tree Hide the Model Tree in the resultant document. This can be re-

enabled in Adobe if required. (Default is off)


hide_model_tree

Fill PMI Text Create filled fonts for PMI (Default is off) o Command Line Syntax:

Disable Wireframe Disable Wireframe Processing (Default is to Enable Wireframe processing)


process_wf off

Detail Level The Detail Level option can be used to set the render quality of the resultant 3D PDF output. A number of discrete values are made available via the UI. They correspond to a relative chordal deviation (% of the diagonal length across the model bounding box) or absolute chordal deviation, whichever is the smaller. The following options are available:

Auto (Corresponds approximately to High)

Very High (relative = 0.0001%, absolute = 0.001mm)

High (relative = 0.001%, absolute = 0.01mm)

Medium (relative = 0.01%, absolute = 0.1mm)

Low (relative = 0.1%, absolute = 1mm)

Very Low (relative = 0.5%, absolute = 5mm)



Ultra_Low (relative = 2.0%, absolute = 25mm) for very large plant data

For very large (detailed) parts the use of this option (Low or Very Low) can significantly reduce the size of the output PDF file and the time taken to produce it, at the cost of quality. A setting of Medium is seen as a good compromise, between

quality and size. This value is the default value.

o Command Line Syntax: lod_level <value>

Where value = ultra_low, v_low, low, med, high, v_high, off

Document Title Set the Document Properties 'title' field. o Command Line Syntax:

the text should be quoted

Document Author Set the Document Properties 'author' field o Command Line Syntax:

doc_description_author <text>


Document Subject Set the Document Properties ‘subject’ field o Command Line Syntax:

doc_description_subject <text>


V5i NX User Guide - theorem.com€¦ · CADverter v19.2 for CATIA V5i - NX 3 ... The CATIA V5i to...

Documents

Transcript of V5i NX User Guide - theorem.com€¦ · CADverter v19.2 for CATIA V5i - NX 3 ... The CATIA V5i to...