Professional Documents
Culture Documents
JT Bi-Directional
Translator for Catia
V5 13.0
User Assistance
Contents
You can edit the options listed in this section to change how you translate CATIA V5 files to JT.
1. Open an existing configuration file with a text editor.
none
true
Translate_Bodies Translate_Bodies = true
false
"all"
Translate_OpenBodies "none" Translate_OpenBodies = "all"
"<OpenBody1, OpenBody2>"
true
Translate_Curves Translate_Curves = true
false
true
Translate_Surfaces Translate_Surfaces = true
false
true
Translate_Points Translate_Points = true
false
true Translate_PointCloudData =
Translate_PointCloudData
false true
true Translate_InactiveLayerEntities
Translate_InactiveLayerEntities
false = true
true Translate_NoShowEntities =
Translate_NoShowEntities
false false
none
Translate_Textures embed Translate_Textures = "embed"
external
"D:\CATIA_V5\win_b64\startup
TextureImageSearchPath "String"
\materials”
AssySearchCriteria =
"InternalLink;CurrentWorking
AssySearchCriteria "String"
Directory;RelativeFolder;
AssySearchPath”
AssySearchPath "String" AssySearchPath = ""
true
OptimizeBrep OptimizeBrep = false
false
"all"
"none"
"{error, warning, info}"
true
XTbrep XTbrep = true
false
true
SimplifyGeom SimplifyGeom = false
false
CATTPS_CATNls_File=”
CATTPS_CATNls_File “<location_of_the_file>”
<location_of_the_file>”
close brace } }
"high"
TransparencyQuality TransparencyQuality = "high"
"low"
true
EnableEquipmentRuns EnableEquipmentRuns = false
false
Note
If you edit an option be sure to include a space both before and after the equal sign.
catiaConfig
Purpose
You can use this option in a configuration file to mark the beginning of CATIA translation options.
Syntax
catiaConfig {
PartHierarchy
Purpose
You can use this option to specify how your JT translation appears in the Assembly Tree of the
Teamcenter viewer. This option sets the product structure of resulting translated JT files.
Syntax
PartHierarchy = "collapsetopart"
Arguments
Use this option To do this
Display one node for each CATPart.
Note
collapsetopart
You can use this option when you
want all entities within a part to be
written into just one node.
Note
showopenbodies
The CATIA V5 name convention is
duplicated for each geometrical set.
Note
Supporting geometry visibility in a Capture will cause additional leaf structure to be translated to
the JT file - for "collapsetopart" as well as "showopenbodies" setting.
appendCADExtension
Purpose
You can use this option to add an extension to the names of the JT files. You use this option to
more precisely identify your part or assembly nodes by choosing from the following.
Syntax
appendCADExtension = "none"
Arguments
Use this option To do this
Add _CATPart or _CATProduct to the JT file
part_and_asm
name.
Add _CATPart to the JT part name.
part_only Note
JT assembly files are not changed.
Note
conflict_only
This prevents conflicts with
embedded parts if you use the full
shatter option.
Translate_Bodies
Purpose
You can use this option to activate processing CATIA V5 solid bodies.
Syntax
Translate_Bodies = true
Translate_OpenBodies
Purpose
You can use this option to specify if you want to translate CATIA V5 open bodies. Open bodies
are named containers for CATIA geometry. Use the following additional options to specify how
you want CATIA V5 open bodies translated.
Syntax
Translate_Openbodies = "all"
Arguments
Use this option To do this
"all" Translate all open bodies.
"none" Disable translating open bodies.
Specify the exact open bodies you want to
"<comma-separated list>"
process.
Notes
• When your CATProduct or CATPart contains nested open bodies, this option only applies to
the top level open body.
• You can use PartHierarchy to control how the translated open bodies are displayed in the
viewer.
• Supporting geometry visibility in a Capture will require some open bodies to be translated.
Translate_OpenBodies setting will be overridden in such cases.
Translate_Curves
Purpose
You can use this option to activate processing CATIA V5 curves as wire frames.
Syntax
Translate_Curves = true
Translate_Surfaces
Purpose
You can use this option to activate processing CATIA V5 free-form surfaces.
Syntax
Translate_Surfaces = true
Translate_Points
Purpose
You can use this option to activate processing CATIA V5 points.
Syntax
Translate_Points = true
Translate_PointCloudData
Purpose
You can use this option to activate processing CATIA V5 point cloud data such as points,
scans, grids and meshes.
Syntax
Translate_PointCloudData = true
Translate_InactiveLayerEntities
Purpose
You can use this option to activate processing CATIA V5 entities that are not on the active layer.
Syntax
Translate_InactiveLayerEntities = true
Translate_NoShowEntities
Purpose
You can use this option to activate processing CATIA V5 entities when CATIA modeling has
set them not to show.
Syntax
Translate_NoShowEntities = false
Note
When geometry visibility in a Capture is enabled by setting the
CAPTURE_GEOMETRY_VISIBILITY environment variable to TRUE, geometry will be translated,
regardless of its Show / Hide status, if it is referenced by a Capture.
Translate_Textures
Purpose
You can use this option to specify if you want to translate CATIA V5 material textures to JT.
Use the following additional options to specify how you want CATIA V5 material textures to
translated to JT.
Syntax
Translate_Textures = "embed"
Arguments
Use this option To do this
"none" Disable translation of textures of JT.
Texture image will be embedded inside the JT
"embed"
file.
JT file will have a reference to an external
texture image file. Texture image will be copied
to the folder specified by 'outputDirectory'
"external" option.
Updating the image file will cause the JT
visualization to be updated automatically to
reflect the new image file.
Note
For non-cubic texture mapping types, the texture display in JT may not match that of
CATIA V5. It is recommended that the user either change the mapping type to cubic
in CATIA V5 and re-translate or adjust the display using the ‘Render’ functionality in
TC Visualization and re-save the JT file.
Texture definition is stored in the tessellation container. Deleting ‘all’ the LODs and
re-tessellating will cause the texture definition to be lost.
TextureImageSearchPath
Purpose
Use this option to locate the texture images referenced by the CATProducts/CATParts.
Syntax
TextureImageSearchPath = "<path_to_texture_image_files>"
Notes
• You can use this option to search in several directories. You must separate or delimit each
directory with a semicolon.
• If no directories are specified in this option, the translator will look for the texture image in the
absolute location stored internally in the file. It will also search in the directory that contains
the input CATProduct/CATPart.
Example
TextureImageSearchPath = "D:\CATIA_V5\win_b64\startup\materials"
TextureImageSearchPath = "D:\CATIA_V5\win_b64\startup\materials;
D:\CATIA_V5\win_b64\startup\materials\textures"
AssySearchCriteria
Purpose
Use this option to specify the search criteria to use for locating components referenced by the
CATProducts you want translated.
Syntax
AssySearchCriteria = "InternalLink;CurrentWorkingDirectory;RelativeFolder;AssySearchPath"
Notes
• You can use this option to specify the combination of InternalLink, CurrentWorkingDirectory,
RelativeFolder and AssySearchPath to be used for locating components.
Example
AssySearchCriteria = "CurrentWorkingDirectory;Relative Folder"
AssySearchPath
Purpose
Use this option to locate components referenced by the CATProducts you want translated. When
you translate a CATProduct by specifying the path, the directory and subdirectories listed in
AssySearchPath are searched.
Syntax
AssySearchPath = "<path_to_CATProduct>"
Notes
• You can use this option to search in several directories and their subdirectories. You must
separate or delimit each directory with a semicolon.
Example
AssySearchPath = "D:\CATIA_V5\test_data\F123456"; AssySearchPath =
"D:\CATIA_V5\test_data;D:\CATIA_V5\more_test_data"
OptimizeBrep
Purpose
You can use this option to optimize the model for better downstream usability.
Syntax
OptimizeBrep = false
Notes
• You must also set the XTbrep option to true.
• This option attempts to repair tolerant geometry by recalculating edge and vertex geometry
to Parasolid precision wherever possible and ensures that edges that were designed to be
tangent are tangent to within Parasolid tolerance.
• This option attempts to remove redundant topology. For example, it attempts to merge two
half-cylinder faces into one cylindrical face.
• This option removes any duplicate underlying curve and surface geometry by attempting to
share geometry within a sheet or solid body. Duplicate curves or surfaces are those that are
of the same curve or surface type and are spatially and parametrically exactly the same.
LogReporting
Purpose
You can use this option to control error reporting details. You can choose from the various options
to determine how you want error messages written to the log file.
Syntax
LogReporting = "none"
Arguments
Use this option To do this
"all" Write all error messages to the log file.
"none" Disable error messaging.
Select a combination of error message types
to write to the log file.
LogFileName
Purpose
You can use this option to specify the name of your error message log file. And, you can add
other supported information that may be useful to organizing log files.
Syntax
LogFileName = "cat_file"
Arguments
Use this option To do this
Display the input file name as part of the log
"cat_file"
file name.
Display the input file extension in the log file
"cat_ext"
name.
"user" Display the system user in the log file name.
Display the system process ID in the log file
"pid"
name.
"time" Display the system time in the log file name.
Notes
• The log file is saved to the location you specified in outputDirectory.
• You can use any combination of these options for the name of the log file by surrounding a
list of comma separated options with quotation marks.
Example
This example translates XYZ.CATProduct as root user and creates the log file name –
XYZ_root.log.
LogFileName = "cat_file, user"
This next example translates XYZ.CATProduct and creates the log file name –
XYZ_CATProduct_root.log.
LogFileName = "cat_file, cat_ext, user"
ConsoleReporting
Purpose
You can use this option to control error reporting details. You can choose from the various options
to determine how you want error messages written to the console.
Syntax
ConsoleReporting = "error"
Arguments
Use this option To do this
"all" Send all error messages to the console.
Disable sending any error message to the
"none"
console.
XTbrep
Purpose
You can use this option to activate the use of XT B-rep when translating models and parts. Use
this feature to generate Parasolid XT B-rep, the common strategy for sharing XT data across
B-rep processing geometry, as an alternative JT B-rep for precise geometry.
Syntax
XTbrep = true
SimplifyGeom
Purpose
You can use this option to activate an attempt to recover analytic representations of the geometry
from B–Spline geometry.
Syntax
SimplifyGeom = false
Notes
• You must also set the XTbrep option to true.
• This option will convert Rational B-Curves and B-Surfaces to Non rational B-Curves and
B-Surfaces.
CATTPS_CATNls_File
Purpose
Use this option to specify the path to a file that defines localized PMI labels.
Syntax
CATTPS_CATNls_File = “<location_of_the_file>”
Notes
• The specified path may be absolute or relative to the working directory.
Example
CATTPS_CATNls_File = "P:\parts\catiav5\CAD_Data\PMI\Localization
\French_CATTPS.CATNls"
CATTPS_CATNls_File = ".\German_CATTPS.CATNls”
close brace
Purpose
You can use the right brace (}) to indicate the end of a section in the configuration file.
TransparencyQuality
Purpose
You can use this option to mimic the transparency display in CATIA V5.
Syntax
TransparencyQuality= “high”
Notes
• When TransparencyQuality = “high”, the transparency value is faithfully translated to JT
Example
TransparencyQuality = "low"
EnableEquipmentRuns
Purpose
You can use this option to create a place holder node in the JT assembly for a CATIA V5 Run
node.
Syntax
EnableEquipmentRuns = false
2. Edit one or more of the following options in the Setup section of the configuration file.
Note
If you edit an option make sure to include a space both before and after the equal sign.
EAITranslator
Purpose
You can use the left brace ({) to mark the beginning section of the configuration file.
OutputDirectory
Purpose
You can use this option to specify the directory name and path for saved JT files.
Example
The default value is
OutputDirectory = "./"
chordalOption
Purpose
You can use this option to specify how you want the Level of Detail (LOD) chordal value set
during the translation. You set this option to an absolute value in model units or as a percentage
of the part size.
Arguments
Use one of these arguments.
Example
• If you specify RELATIVE, a bolt is tessellated to the same degree as a larger part, and both
have the same surface quality. This is the optimum setting.
• If you specify ABSOLUTE, and have a chordal value of 1, that value is used to tessellate a
part that is one unit across, and for a part that is 100 units across. This process results in
larger parts being more tessellated than smaller parts.
structureOption
Purpose
You can use this option to define and specify how you want to display the JT file.
Arguments
Use one of these arguments.
Example
Use the following product structure to see how the various structureOption arguments affect how
the JT files are displayed.
Option Resulting JT
MONOLITHIC A.JT
A.JT
A/P1.JT
PER_PART A/P2.JT
A/P3.JT
A/P4.JT
A.JT
B.JT
C.JT
FULL_SHATTER P1.JT
P2.JT
P3.JT
P4.JT
When you display product structure using the MIMIC argument, the results will vary depending on
the your JT translator. Use MIMIC to produce one-to-one JT file output for your specific CAD
input. For example, if the original data in the product structure example contained three CAD
assembly files, A.model, B.model, and C.model, the following table shows the results.
Note
The MONOLITHIC and MIMIC arguments may produce hybrid JT files containing both assembly
and part product structure. This may result in non-intuitive translations if the writeWhichFiles
option is not set to "JTPARTS,JTASSEMBLY."
writeWhichFiles
Purpose
You can use this option to filter how you want JT files translated.
Arguments
Choose one of these arguments.
Note
• Install JT Utilities in order to
run the jttoascii utility from the
command-line in the same
translator environment.
"JTASCII"
• The new file will have an .ajt
extension together with the
name of the assembly.
Note
• To explore or examine your
PLMXML file use a utility like
Jumpstart (included in the
"PLMXML" PLMXML SDK).
Note
“AP242XML”
The most common usage of
this setting will take the shape
writeWhichFiles=”JTPARTS,AP242XML”
Note
Your configuration file may include a deprecated option, writeWhichFiles =
"PARTS_ONLY,ASSEMBLY_ONLY". The software will automatically change the option to
writeWhichFiles = "JTPARTS,JTASSEMBLY".
Example
The default is
writeWhichFiles = "JTPARTS,JTASSEMBLY"
pmiOption
Purpose
You can use this option to specify which product manufacturing information (PMI) data, if any, you
want to make available during the translation. Once pmiOption is set, you will need to enable
specific PMI entities for the specific JT translator you use.
Arguments
Choose one of the following arguments.
Example
pmiOption = "PART_AND_ASM"
Notes
• The user needs to install TcVis V10.0.0.3 or higher for geometry visibility in captures to
work correctly.
JtFileFormat
Purpose
You can use this option to specify the most appropriate JT file format supported by your
environment.
Syntax
JtFileFormat = "10"
Arguments
Use this value To do this
Translate geometry content as losslessly or
lossily; all other content is translated with
losslessy compression.
Note
"8"
This setting is supported by the
following software:
• Teamcenter Visualization 4.0
and later.
Note
This setting is supported by the
following software:
• Teamcenter Visualization 2007
and later.
"10"
Note
This setting is supported by the
following software:
• Teamcenter Visualization 10.1
and later.
Notes
• For JT V9 and later, do not use Simplification in the first LOD level; this would remove
Topomesh data.
triStripOpt
Purpose
You can use this option to enable or disable an additional optimization on the tessellated geometry
data in each JT part file. Use this option to reduce the number of triangles in the tristrips, without
reducing the quality of the displayed geometry. The process increases visualization quality, but
it also increases translation time.
Example
triStripOpt = true
seamSewing
Purpose
You can use this option to enable or disable creating shared edges in NURB data. Creating
shared edges is useful for face-modeled data.
Note
When you make seamSewing available, use seamSewingTol to set specific tolerance values.
Example
The default value is
seamSewing = false
seamSewingTol
Purpose
You can use this option to specify tolerance for two vertices in a seam selected to be sewn. The
value you set is a floating point that represents a percentage of the bounding box.
Example
The default value is
seamSewingTol = 0.001
includeBrep
Purpose
You can use this option to enable or disable precise model geometry in translated part files.
Notes
• When you make includeBrep available, the size of the JT file will increase because you are
including precise measurement and analysis work.
• For many JT translators, you can use the Include Precise Geometry menu on the translator
interface.
Example
The default value is
includeBrep = true
autoNameSanitize
Purpose
You can use this option to enable or disable various Filter options.
Example
The default value is
autoNameSanitize = true
updateChangedPartsOnly
Purpose
You can use this option to enable or disable a review of existing JT files to determine if the original
part changed. When you set updateChangedPartsOnly to true, only updated parts are translated.
Note
For this JT translator, if the geometry of the JT file was modified by Assembly Features (Holes,
Cuts, Grooves), the JT part file is not updated.
Example
updateChangedPartsOnly = false
writeAsciiAssembly
Purpose
You can use this option to enable or disable creating a text file containing the hierarchy for the
model. The text file uses an .alt extension and is named according to the assembly file name.
The text file also has an .ajt extension.
Notes
• Make sure that you have installed JT Utilities so that jttoascii runs correctly.
• For some translators, this option corresponds to the Write Assembly Text File menu on the
interface.
Example
writeAsciiAssembly = false
singlePartsNoAssem
Purpose
Use this option to activate or make unavailable creating a JT assembly structure when a JT
model is being translated with structureOption set to PER_PART. If the JT file consists only of an
assembly and single part, the entire model is replaced with a single part. The software names the
part the name of the original assembly node. You can then translate one-part models without
creating a JT assembly file.
Note
If you set singlePartsNoAssem to true and writeWhichFiles was set to JTASSEMBLY, this
option will be overridden.
Example
singlePartsNoAssem = true
smartLODgeneration
Purpose
You can use this option to enable or disable creating of more levels of detail (LODs) than the
number specified in numLODs if the last LOD contains more than 200 polygons.
Example
smartLODgeneration = false
autoLowLODgeneration
Purpose
You can use this option to enable or disable the translator to automatically analyze and create
two simplified default levels of detail: a convex hull and a bounding box.
Example
The default value is
autoLowLODgeneration = false
numLODs
Purpose
You can use this option to specify the number of levels of detail (LODs) for the translated file.
Each LOD can have separate tessellation options and these options are specified in the LOD
section of the configuration file.
Note
It is possible to declare up to ten LODs, but for the best translation performance consider using
three or less
Example
numLODs = 3
close brace
Purpose
You can use the right brace (}) to indicate the end of a section in the configuration file.
You can edit the Filter section of the configuration file to specify how filenames are sanitized and to
specify how metadata keys are filtered.
1. Open an existing configuration file with a text editor.
Note
If you edit an option make sure to include a space both before and after the equal sign.
Filter
Purpose
You can use the left brace ({) to mark the beginning of the Filter section in the configuration file.
FilenameSanitizeSet
Purpose
You can use this Filter option to modify the file names created by the translator. You may have
source files that include naming conventions that are not supported by your environment. Use this
option to specify a set of characters in file names that are to be replaced with an underscore ("_").
Notes
• You can specify alphabetic letters and numbers, and you can also sanitize the following
symbols from file names:`~!@#$%^&*()-+=\"\\':;,./<>?|[]{}
• If you update or write a new set of characters, your existing set or default set is overwritten.
Example
You have unsupported file names that begin with 1a. To change all “1's” and “a's” to underscores,
in Filter section of your configuration file enter:
FilenameSanitizeSet = "1a".
FilenameSanitizeSetAdd
Purpose
You can use this Filter option to add one or more characters to the file name sanitize string
specified by FilenameSanitizeSet .
Example
You want to add 2b to your existing file name sanitize set. To replace “2's” and “b's” with
underscores, in the Filter section of your configuration file type:
FilenameSanitizeSetAdd = "2b"
FilenameSanitizeSetDelete
Purpose
You can use this Filter option to delete previously set sanitized file name characters. You can
ignore one or more characters from the sanitize string set from FilenameSanitizeSet. This option
is useful if you do not want to sanitize specific characters
Example
You want to include periods in your file names, but periods are include in your sanitize set. To
include periods in your file names, in the Filter section of your configuration file type:
FilenameSanitizeSetDelete = "."
MetadataKey
Purpose
You can use this Filter option to specify that all keys in “MetadataKey” are to be removed from JT
files (EXCLUDE), or to specify that all keys except those in “Metadatakey” are to be removed
from JT files (INCLUDE).
Example
MetadataKey = <metadata key to include or exclude>
MetadataFilter
Purpose
Controls if specified metadata keys are removed from JT files (EXCLUDE) or if all other keys
other than those specified are removed from JT files (INCLUDE).
Example
MetadataKeyFilter = "EXCLUDE"
close brace
Purpose
You can use the right brace (}) to indicate the end of a section in the configuration file.
Tip
You will achieve the best translation and viewing performance if you define three or fewer
LODs. Each new LOD requires time and adds size to the translated JT file.
If you edit an option make sure to include a space both before and after the equal sign.
LOD
Purpose
You can use this Level of Detail option to indicate the beginning section of the configuration file
that sets details of your LODs. The syntax includes the keyword (LOD) indicating the beginning
of this section, a number that indicates the number of LODs you want, and a left brace ({).
Example
The default value is
LOD "1" {
Level
Purpose
You can use this Level of Detail (LOD) option to specify how many levels of detail you want set
for each translation. If there are three levels of detail, this line is repeated three times, each
with a different level of detail.
Example
The default value is
Level = 1
Label
Purpose
You can use this Level of Detail (LOD) option to assign labels to one or more LODs. To create a
label for each LOD, in the LOD section of the configuration file, enter Label = <label_name>
Example
• Label = Manufacturing
•
LOD "1" {
Level = 1
Label = Manufacturing
Chordal = 0.001
Angular = 20.0
Length = 0.0
FeatureSuppression = 0.0
Simplify = 1.0
AdvCompressionLevel = 0.0
• The benefit of using LOD labels is they help improve loading LODs in Teamcenter's lifecycle
visualization. If the JT file has several unlabeled LODs, each one will be loaded. When
you define one or more LODs, you can then use Teamcenter's lifecycle visualization
features to load specifically labeled LODs. For example, you can label an LOD containing
specified details (Chordals, Angulars, etc.) as Manufacturing, and the Teamcenter's lifecycle
visualization user can then open this LOD only, or any other LOD they want to open.
Chordal
Purpose
You can use this Level of Detail option to define the maximum absolute distance that a line
segment may deviate from the smooth curve it is approximating. The value you set for this option
produces the levels of detail representing each part and it specifies polygonal approximations of
models defined with curved surfaces.
Example
• Chordal = 0.001
Angular
Purpose
You can use this Level of Detail (LOD) option to limit the absolute maximum angle between two
adjacent line segments in a curve approximation. The value you set produces the levels of
detail representing each part and it specifies polygonal approximations of models defined with
curved surfaces.
Example
• Angular = 25
Tip
For best results, use both chordal and angular parameters. The chordal value
affects larger features of the model, while the angular value affects smaller
features.
• The round object has a small hole through the center of it. If the translator tessellates the
object with only the angular parameter, the polygons that define the hole follow the surface
much better than the polygons that define the perimeter. If the translator tessellates the
object with only the chordal parameter, the polygons along the perimeter of the object follow
the curves much better than the polygons that define the hole.
Tip
For best results, use both chordal and angular parameters. The chordal value affects
larger features of the model, while the angular value affects smaller features.
Length
Purpose
A line segment in the tessellation of a curve has a certain length. This parameter specifies
the exact length allowed.
Example
The default value is
Length = 0.0
FeatureSuppression
Purpose
You can use this Level of Detail option to suppress holes and arcs smaller than the specified
number.
Example
The default value is
FeatureSuppression = 0
Simplify
Purpose
You can use this Level of Detail (LOD) option to specify a minimum level of simplification for the
model, relative to the first level of detail. The value is expressed as a percentage of the first
level of detail.
Example
• Simplify = 0.60
• Assume that a model contains 100,000 polygons for the first level of detail. You decide to set
the second level of detail to 60% of the first level. Enter the following in the configuration file:
Simplify = 0.60.
The software checks the translated JT file to see if the second LOD has 60,000 or fewer
polygons. If there are more than 60,000 polygons, the translator continues to simplify the
model until the number of polygons meets 60%.
Notes
• Make sure the first LOD is set to 1.0 (one hundred percent) because it should have the
highest level of detail.
advCompressionLevel
Purpose
Use this option to specify the level of advanced compression for each Level of Detail (LOD) you
set when translating JT files. A value of 0.0 specifies lossless compression, while a value of
1.0 specifies lossy compression. Set the value of this option as a floating point in the range of
0.0 to 1.0.
Set the advanced compression level to 0.0 for the finest LOD. This setting is required for
exchanging JT files in multi-CAD environments.
Notes
Compression methods include lossless and lossy standards.
lossless A compression method where original data is not lost after compressing
files. The size of the file is larger than from using lossy compression.
Example
advCompressionLevel = 0.5
close brace
Purpose
You can use the right brace (}) to indicate the end of a section in the configuration file.
You can edit the Metadata section of the configuration file to modify how metadata is displayed
in your translated JT files.
1. Open an existing configuration file in a text editor.
AddToAllNodes = "<metadata
AddToAllNodes "string of characters" key>" AddToAllNodes =
"<metadata value>"
close brace } }
Note
Enter these options in pairs. The first line of text defines the metadata key and the second
line defines the metadata value.
If you edit an option make sure to include a space both before and after the equal sign.
Metadata
Purpose
You can use the left brace ({) to mark the beginning of the Metadata section of the configuration
file.
AddToParts
Purpose
You can use this Metadata option to add common metadata properties to all model part nodes.
Example
Enter pair values in the Metadata section of the configuration file; one line defines the metadata
key and the other line defines the metadata value.
AddToParts = "Creator"
AddToParts = "Mr. Smith"
AddToAssemblies
Purpose
You can use this Metadata option to add common metadata properties to all model assembly
nodes.
Example
Enter pair values in the Metadata section of the configuration file; one line defines the metadata
key and the other line defines the metadata value.
AddToAssemblies = "Creator"
AddToAssemblies = "Mr. Smith"
AddToAllNodes
Purpose
You can use this metadata option to add common metadata properties to all model part and
assembly nodes.
Example
Enter pair values in the Metadata section of the configuration file; one line defines the metadata
key and the other line defines the metadata value.
AddToAllNodes = "Creator"
AddToAllNodes = "Mr. Smith"
close brace
Purpose
You can use the right brace (}) to indicate the end of a section in the configuration file.
Note
If you do not include a reference to your specific configuration file, the default
configuration file is used.
Example
jt_catiav5 Part1.CATPart catiatojt.config
jt_catiav5 -dir="d:\scratch" —
AssySearchCriteria="CurrentWorkingDirectory;AssySearchPath" —
AssySearchPath=d:\scratch\;c:\scratch" catiatojt.config
JtFileFormat = “9”
triStripOpt = true
seamSewing = false
seamSewingTol = 0.001
includeBrep = true
autoNameSanitize = true
updateChangedPartsOnly = false
writeAsciiAssembly = false
singlePartsNoAssem = false
autoLowLODgeneration = true
smartLODgeneration = false
numLODs = 3
verboseReporting = false
}
Filter {
MetadataKey = ""
MetadataFilter = "EXCLUDE"
FilenameSanitizeSet = ""
FilenameSanitizeSetAdd = ""
FilenameSanitizeSetDelete = ""
}
Metadata {
AddToParts = ""
AddToAssemblies = ""
AddToAllNodes = ""
}
LOD "1" {
Level = 1
Chordal = 0.001
Angular = 20.0
Length = 0.0
AdvCompressionLevel = 0.0
}
LOD "2" {
Level = 2
Chordal = 0.002
Angular = 0.0
Length = 0.0
FeatureSuppression = 0.0
Simplify = 0.4
AdvCompressionLevel = 0.5
}
LOD "3" {
Level = 3
Chordal = 0.009
Angular = 0.0
Length = 0.0
FeatureSuppression = 0.0
Simplify = 0.1
AdvCompressionLevel = 1.0
}
catiaConfig {
PartHierarchy = "collapsetopart"
Translate_Bodies = true
Translate_OpenBodies = "all"
Translate_Curves = true
Translate_Surfaces = true
Translate_Points = true
Translate_PointCloudData = false
Translate_NoShowEntities = false
Translate_InactiveLayerEntities = true
Translate_Textures = "none"
TextureImageSearchPath = “”
AssySearchCriteria =
"InternalLink;CurrentWorkingDirectory;RelativeFolder;AssySearchPath"
AssySearchPath = ""
FontsSearchPath = ""
LogReporting = "error"
LogFileName = "cat_file"
ConsoleReporting = "error"
XTbrep = true
SimplifyGeom = false
OptimizeBrep = false
appendCADExtension = "none"
CATTPS_CATNls_File = ""
TransparencyQuality = "high"
}
1. When you use the configuration file from the command prompt to enter the path and file name
of the file.
2. When you do not use the command prompt, or if you use the GUI, the translator looks for a
configuration file in the current working directory.
Note
If the current working directory does not have the required file permissions, then the
.config file will be written to the directory defined on Windows by the environment
variable %USERPROFILE% and on UNIX by the environment variable $HOME.
3. When you do not have a configuration file saved in the current working directory, the translator
reads the default file located in the <translator_installation_directory>/etc directory.
The JT to CATIA V5 configuration file contains preferences and options that determine how you
can translate JT files to the CATIA V5 format.
You can begin translating JT files to CATIA V5 files by using the default configuration file that is
provided during installation. Or, you can edit this standard configuration file and change any default
value associated with parameters used to translate files.
• You can also use command line options to modify how files are translated.
You can edit the options listed in this section to change how you translate JT files to CATIA V5.
1. Open an existing configuration file with a text editor.
"all"
"none"
"{error, warning, info}"
close brace } }
Note
If you edit an option be sure to include a space both before and after the equal sign.
catiaConfig
Purpose
You can use this option in a configuration file to mark the beginning of CATIA translation options.
Syntax
catiaConfig {
Translate_Bodies
Purpose
You can use this option to activate processing CATIA V5 solid bodies.
Syntax
Translate_Bodies = true
Translate_Curves
Purpose
You can use this option to activate processing CATIA V5 curves as wire frames.
Syntax
Translate_Curves = true
Translate_Points
Purpose
You can use this option to activate processing CATIA V5 points.
Syntax
Translate_Points = true
EnableHybridDesign
Purpose
You can use this option to either enable or disable hybrid design inside Part Bodies and Bodies
created from a JT to CATIA V5 translation.
Example
EnableHybridDesign = true
CatiaV5FileFormat
Purpose
You can use this option to specify the version of CATIA V5 files that are to be produced from a
JT to CATIA V5 translation.
Syntax
CatiaV5FileFormat = "R14"
Notes
Use this option To do this
"R14" Write CATIA V5R14 files.
"R19" Write CATIA V5R19 files.
LogReporting
Purpose
You can use this option to control error reporting details. You can choose from the various options
to determine how you want error messages written to the log file.
Syntax
LogReporting = "none"
Arguments
Use this option To do this
"all" Write all error messages to the log file.
"none" Disable error messaging.
Select a combination of error message types
to write to the log file.
LogFileName
Purpose
You can use this option to specify the name of your error message log file. And, you can add
other supported information that may be useful to organizing log files.
Syntax
LogFileName = "cat_file"
Arguments
Use this option To do this
Display the input file name as part of the log
"cat_file"
file name.
Display the input file extension in the log file
"cat_ext"
name.
"user" Display the system user in the log file name.
Display the system process ID in the log file
"pid"
name.
"time" Display the system time in the log file name.
Notes
• The log file is saved to the location you specified in outputDirectory.
• You can use any combination of these options for the name of the log file by surrounding a
list of comma separated options with quotation marks.
Example
This example translates XYZ.CATProduct as root user and creates the log file name –
XYZ_root.log.
LogFileName = "cat_file, user"
This next example translates XYZ.CATProduct and creates the log file name –
XYZ_CATProduct_root.log.
LogFileName = "cat_file, cat_ext, user"
ConsoleReporting
Purpose
You can use this option to control error reporting details. You can choose from the various options
to determine how you want error messages written to the console.
Syntax
ConsoleReporting = "error"
Arguments
Use this option To do this
"all" Send all error messages to the console.
Disable sending any error message to the
"none"
console.
Select a combination of error message types
to send to the console.
close brace
Purpose
You can use the right brace (}) to indicate the end of a section in the configuration file.
Note
If you do not include a reference to your specific configuration file, the default
configuration file is used.
Example
jt_catiav5 file1.jt jttocatia.config
Note
To import files into a CATIA V5 session you must purchase a license for JT Import for
CATIA V5. This application is a separate, independent software program.
Note
o See Locate configuration files for a description of how the translator locates the
configuration file for populating the JT Preferences dialog.
o Configuring settings using the JT Preferences interface will not modify the
configuration files located in the “etc” folder of the translator install. If the translator
locates the configuration file in the “etc” folder, a configuration file with the changed
settings will be written to the current working directory. If the current working
directory does not have the required file permissions, the configuration file will
be written to the directory defined on Windows by the environment variable
%USERPROFILE% and on UNIX by the environment variable $HOME.
• Import JT files.
• Insert a JT file in a selected node. The inserted file can be a CGR, CATPart, or CATProduct file.
You can use the interface from your operating system to:
• Specify frequently used configuration settings.
Note
o See Locate configuration files for a description of how the translator locates the
configuration file for populating the JT Preferences dialog.
o Configuring settings using the JT Preferences interface will not modify the
configuration files located in the “etc” folder of the translator install. If the translator
locates the configuration file in the “etc” folder, a configuration file with the changed
settings will be written to the current working directory. If the current working
directory does not have the required file permissions, the configuration file will
be written to the directory defined on Windows by the environment variable
%USERPROFILE% and on UNIX by the environment variable $HOME.
Note
Converting JT to CGR is not supported using the operating system interface.
Use the JT Toolbar to set export and import preferences, to convert JT files to CATPart, CATProduct,
and CGR file types, to insert JT files into a CATIA V5 node, and to save CATPart, CATProducts, and
CGR files as JT files.
The CATIA JT toolbar is a Windows only feature.
You can:
• Specify translation preferences.
b. From the JT Preferences dialog box, click the Export JT tab, and then choose from the
available preferences.
Use this
To do this
option
Translate
CATIA data
Single JT into an
Assembly Assembly JT
Select JT Contents File Structure file and to a
and
subfolder JT part file
of JT parts directory.
This setting
is the default.
Translate
CATIA data
All JT in a and display
single file a single file
containing all
of the data.
Translate
CATIA data
Mimic
and display
CATIA files
a JT file for
in a single
each node
folder
in the JT
Assembly.
Translate
CATIA data
Mimic and display
CATIA one output
files and file per
use CATIA original CAD
folders file to mimic
the CAD file
structure.
Select or clear precise model
geometry in translated JT
Include Precise Geometry files.
The default setting is
selected.
Select to display one node
for each geometrical set or
Separate JT node for each one node for each CATPart.
Geometrical Set The default is to clear this
option; that is, to display one
node for each CATPart.
Select to activate an
attempt to recover analytic
Simplify Curves and Surfaces representations of the
to Analytics B-Spline geometry.
See SimplifyGeom option for
further details
Select this option to
optimize the model for
Optimize Model for better downstream usability.
Advanced Settings Downstream Usability
See OptimizeBrep option for
further details.
Specify how parts will be
tessellated.
Relative – Interpret the
Chordal option tessellation value of all parts
relative to the size of the file
and with the same surface
quality.
Note
While you can
Number of levels select up to ten
levels, three
levels of detail
provide translated
details for most
translations.
Note
The following table represents LOD options and their possible values:
b. From the JT Preferences dialog box, click the Import JT tab, and then choose from the
available preferences.
3. Click OK to save the catiatojt.config and jttocatia.config files in the current working directory.
4. Click Cancel to end the JT preferences session without saving the settings.
5. Click Help to open the online Help for JT Bi-directional translator for CATIA V5.
2. In the Open JT File dialog box, select the JT file or files you want to convert to CATIA files,
and then click Open.
Note
When the conversion is successful, press any key to close the translation window and the
translated files will appear in the CATIA session.
b. Click the Import JT tab and from the Insert JT section, select As CGR or As
CATProducts/CATParts.
2. From an active CATIA V5 session containing an open CATProduct, highlight the CATProduct
node to insert the JT file.
4. In the Select JT File to Insert dialog box, choose the JT file, and then click Open.
5. Press any key to close the translation window and the translated files will appear in the CATIA
session.
From an active CATIA session, you can save CATPart, CATProduct, and CGR files to JT using options
from the JT Toolbar. You can specify how CATIA files are translated by setting export preferences.
1. Choose how you want the JT file translated by doing the following:
2. Open the CATPart or CATProduct that you want to translate and save as a JT file.
4. In the Select Directory for JT Files window, select an output directory and then click OK.
2. You can drag JT, CATProduct, CATPart, CATShape, CGR files and drop them onto the list section
of the JT Bi-directional Translator for CATIA V5 dialog box.
3. Alternatively, in the JT Bi-directional Translator for CATIA V5 dialog box, in the Select file(s)
section, click Browse.
4. From Files of Type, select the type of file you want to translate.
6. (Optional) To remove one or more files from the list, right-click the specific file and then click
Remove graphic.
• Click Apply to launch jt_catiaV5, but keep the interface session open.
• Click Help to open the online Help for the JT Bi-directional Translator for CATIA V5.
2. In the JT Bi-directional Translator for CATIA V5 dialog box, select Change Output Folders.
3. If you click Browse, you can use the graphic tools to navigate to the directory of your choice,
and click Open.
If you select Same As Input Directory, the output files are written in the same location as that of
the input files. If the location of the input directory is read-only, then a message box appears.
Click Continue to overwrite the existing files.
Click Cancel to adjust your file selection or output folder choices.
3. Select the Export JT tab, and then choose from the available preferences.
Use this
To do this
option
Translate
CATIA data
Single JT into an
Assembly Assembly JT
Select JT Contents File Structure file and to a
and
subfolder JT part file
of JT parts directory.
This setting
is the default.
Translate
CATIA data
All JT in a and display
single file a single file
containing all
of the data.
Translate
CATIA data
Mimic
and display
CATIA files
a JT file for
in a single
each node
folder
in the JT
Assembly.
Translate
CATIA data
Mimic and display
CATIA one output
files and file per
use CATIA original CAD
folders file to mimic
the CAD file
structure.
Select or clear precise model
geometry in translated JT
Include Precise Geometry files.
The default setting is
selected.
Select to display one node
for each geometrical set or
Separate JT node for each one node for each CATPart.
Geometrical Set The default is to clear this
option; that is, to display one
node for each CATPart.
Select to activate an
attempt to recover analytic
Simplify Curves and Surfaces representations of the
to Analytics B-Spline geometry.
See SimplifyGeom option for
further details
Select this option to
optimize the model for
Optimize Model for better downstream usability.
Advanced Settings Downstream Usability
See OptimizeBrep option for
further details.
Specify how parts will be
tessellated.
Relative – Interpret the
Chordal option tessellation value of all parts
relative to the size of the file
and with the same surface
quality.
Note
While you can
Number of levels select up to ten
levels, three
levels of detail
provide translated
details for most
translations.
The following table represents LOD options and their possible values:
4. Click OK to save the catiatojt.config and jttocatia.config files in the current working directory.
5. Click Cancel to end the JT preferences session without saving the settings.
6. Click Help to open the online Help for JT Bi-directional translator for CATIA V5.
At this time, the operating system interface supports importing CATProduct and CATPart files.
1. Open the interface in one of these ways:
• (Windows) Navigate to <translator_installation_directory> and run OS_GUI.bat.
3. Select the Import JT tab, and then choose from the available preferences.
4. Click OK to save the catiatojt.config and jttocatia.config files in the current working directory.
5. Click Cancel to end the JT preferences session without saving the settings.
6. Click Help to open the online Help for JT Bi-directional translator for CATIA V5.
Mapping entities
It may be useful to understand how the translators map various CATIA entities during processing.
Refer to the entity mapping tables for mapping CATIA V5 to JT below.
CATIA V5 JT
Axis System Coordinate System PMI
Axis Reference Line PMI
JT with JT with
CATIA V5
PartHierarchy=CollapseToPart PartHierarchy=ShowOpenBodies
CATProduct JT Assembly JT Assembly
CGR JT Part JT Part
CATPart JT Part JT Assembly
Contents of Geometrical Sets are JT Part for the top level Geometrical
Geometrical Set
transferred to the B-rep Set
CATIA V5 JT
Capture Model View
3D Note 3D Notes
Note Object Attribute User Defined Symbol
Datum Datum Feature Symbol
Datum Target Datum Target
Geometrical Tolerance Feature Control Frame
Dimension Dimension
Roughness Surface Finish
CATIA V5 JT
Product Properties (Part
Number, Revision, Definition
JT Property
Nomenclature, Source,
Description)
User added properties JT Property
Mass Properties (Density,
Mass, Center of Gravity, JT Property
Moment of Inertia)
CATIA V5 User Parameters
such as Standard Notes,
JT Property
Annotation Notes, Part
Notes
JT CATIA V5
Point Point
Line Line
Circle Circle Arc
Ellipse Ellipse
B-spline B-Curve
JT CATIA V5
Cone Cone
Cylinder Cylinder
Plane Plane
Sphere Sphere
Torus Torus
Swept B-Surface
Offset B-Surface
Revolution B-Surface
Blending B-Surface
B-Surface B-Surface
Other Surface Types B-Surface
JT CATIA V5
Coordinate System Axis System
Reference Line PMI Axis
JT CATIA V5
JT Assembly CATProduct (CGR with JT→CGR)
JT Part CATPart (CGR with JT→CGR)
JT CATIA V5
JT Property User added property
Indenture Level
When you specify either an assembly node or a partition node, the first column contains the indenture
level of the node. The indenture level indicates the depth of the node in the assembly tree.
Note
The root assembly node always resides at level 0 and the direct children of the root node
reside at level 1. Lines that specify transforms or attributes do not indicate the indenture
level. These properties are attached to the previous assembly or partition node.
Assembly Nodes
Assembly nodes are specified by the keyword ASM followed by the node name contained in double
quotes.
0 ASM "Node name"
Partition Nodes
Partition nodes are specified using two lines. The first line contains the keyword PRT followed by
the node name contained in double quotes. The second line contains the keyword FILE followed by
the file path in double quotes. Either a relative or absolute path may be used. A partition node may
refer to an assembly file or a part file.
1 PRT "Partition name"
File "./pathtopart/part.jt"
Transforms
Transformations may be added to a node using the keyword MATRIX followed by a 4x4 transformation
matrix. The following entry translates -5 units in the X direction, 2 units in the Y direction, and 4
units in the Z direction.
MATRIX [ 1 0 0 0 ] [ 0 1 0 0 ] [ 0 0 1 0 ] [-5 2 4 1 ]
Note
If a matrix is not specified then the identity matrix is assumed.
Attributes
Two types of attributes can be added to a node: regular attributes and hidden attributes. Use the
keyword ATTR to specify a regular attribute and ATTR_H to specify a hidden attribute. Both regular
and hidden attributes require three fields: a type, a key, and a value. The type of field indicates
whether the value is a string, an integer, a floating point number, or a date (keywords: STRING, INT,
FLOAT, DATE). The key identifies the attribute and is associated with a value. The key appears on
the left side of the "attribute" window and the value appears on the right. The following lines specify
four attributes.
ATTR Type="STRING" Key="My String Key" Value="test value"
ATTR Type="INT" Key="My Int Key" Value="3"
ATTR Type="FLOAT" Key="My Float Key" Value="2.1234"
ATTR Type="DATE" Key="Translated" Value="12 31 1998 11 45 30"
Specifications
• The extension on all ASCII Direct Model files is .ajt.
• A node is indicated by placing the indenture level of the node in column 0 followed by the node
type and the node name in double quotes.
• The first node always starts at level 0. It is the only node to reside at level 0.
• The indenture level may only increase by one level at a time when increasing.
• There are no limits on the node level step size when decreasing.
• There are currently only two types of nodes: assemblies and partitions. Assemblies are identified
by the keyword ASM and partitions by the key word PRT. The name of each node immediately
follows each key word and is contained in double quotes.
• Partition nodes must have a file path associated with them. Preceding each file path is the key
word FILE. If a relative path is used, the path must be relative to the output JT file.
• Matrices are indicated with the keyword MATRIX. The matrices are set at 4 x 4 dimensions. If
a matrix is not specified then the identity matrix is assumed.
Example file
An example of the ASCII format is given in fishing_reel.ajt. The assembly tree created by this file
is shown below.
Understanding JT files
When you export model files, the translator creates a JT assembly file containing hierarchy, offset,
and other information necessary to assemble the part files of your model. The translator also creates
a subdirectory with the same name as the JT assembly file, and it writes each part of your model to
an individual JT part file that contains all the levels of detail in the subdirectory.
The translator supports part-instancing in the JT assembly files. When you export an instanced
model, the translator writes only one copy of the part geometry to a JT part file, even though the part
may repeat several times throughout the model.
The translator automatically names the JT assembly file according to the name of the model file
that you load in the interface.
Example
When you load a file named formula_car into the translator, it creates a JT assembly
file named formula_car.jt in the specified directory, then creates a subdirectory named
formula_car, for which the part files for the model are written.
Note
• JT-based applications are backward-compatible with all earlier JT versions. For
example, Teamcenter's lifecycle visualization 8.1, which introduced JT 10.0, also reads
all 9.x and 8.x JT files.
• JT-based applications are also forward-compatible, provided that all JT versions are
within the same major JT file version. For example, Teamcenter's lifecycle visualization
2007.2, which introduced JT 9.0, also reads JT 9.1, 10.0, 10.0, and 10.0 files, plus
all future minor versions of JT 9.0. However, newer JT file versions may contain data
that is not understood by older viewers. In this case, the non-understood data is not
displayed in the viewer.
Note
• Do not modify the MessageCode syntax because it is alphanumeric and unique to
the code.
• You can modify and customize the MessageString syntax. Be sure to keep format
descriptors within the text in the order they are used. Format descriptors are
programming references such as %s and %d.
To report any serious problems about this translator or for help obtaining a license, please contact
the Global Technical Access Center.
Phone:
• Outside the United States and Canada: Contact your local support office.
Website:
You can also log and view existing resolutions for incident reports on the Web at
http://www.siemens.com/plm/support
Headquarters
Europe
Granite Park One
Stephenson House
5800 Granite Parkway
Sir William Siemens Square
Suite 600
Frimley, Camberley
Plano, TX 75024
Surrey, GU16 8QD
USA
+44 (0) 1276 413200
+1 972 987 3000
Asia-Pacific
Americas
Suites 4301-4302, 43/F
Granite Park One
AIA Kowloon Tower, Landmark East
5800 Granite Parkway
100 How Ming Street
Suite 600
Kwun Tong, Kowloon
Plano, TX 75024
Hong Kong
USA
+852 2230 3308
+1 314 264 8499