XVL BOM Assembler Tutorial For Version 1.0 and later

LATTICE TECHNOLOGY, INC.

XVL BOM Assembler TutorialFor Version 1.0 and laterFor Version 1.0 and later

December 2010 Lattice Technology, Inc. 2

Introduction and Objectives

The XVL BOM Assembler is a command-line application that converts XVL models into XML structure files and XML structure files into XVL models.

By the end of this tutorial, you will be able to perform the following command-line operations:

– Generate assembly structure XML file.– Generate XVL assembly model out of XML file and part files.– Export mass properties in XML.– Export a log file.


Agenda

• Required Files• Installing the Visual C++ Runtime Component • Command Syntax• Generating Assembly Structure XML Files• Generating XVL Assembly Models• Exporting XML with Mass Properties• Exporting Log Files• XML Format


Required Files

• In order to execute XVL BOM Assembler, you need the following files*:

– xvlbomassembler.exe Command line application

– xvlbom_schema.xsd XML schema check file

– xerces-c_1_3x8.dll Xerces-C++ DLL for reading and writing XVL files

– xerces-c_2_8.dll Xerces-C++ DLL for reading and writing XML files

* These files are located in: \Lt_BomAssembler\Bin\


Installing the Visual C++ Runtime Component

• To use XVL BOM Assembler, Visual C++ runtime component must be installed.

• To install Visual C++ runtime component, simply double-click the vcredist_x86.exe* file.

* vcredist_x86.exe is located in: \Lt_BomAssembler\

Basic Format:


Command Syntax

Parameter Description

-i input_file Input file.

-o output_file Output file.

-m Specify this option when output file is to include mass properties.

-t type num tolSpecifies the tessellation parameters to be used in the mass properties calculation. (This option is meaningful only when [–m] option is specified.)

-rSpecify this option to output a log file in the same folder as the output file.

xvlbomassembler.exe < -i input_file > < -o output_file >

[-m] [-t type num tol] [-r]

* Parameters in braces ([ ]) are optional.

Generating Assembly Structure XML Files

• Specify an XVL file as input and an XML file as output to generate and assembly structure XML file for the XVL file.


Assembly structural tree

+

XVL assembly model

XVL part files

Generate

XML

Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml

Generating XVL Assembly Models

• Specify an XML file as input and an XVL file as output to generate an XVL model from an XML file.


Assembly structural tree

+

XVL part files

Generate

XML

Example: xvlbomassembler.exe -i sample.xml -o sample.xv2

XVL assembly model

• Use the –m option to add mass properties to the XML file.

Exporting XML with Mass Properties 1/2


<component name="STT36 Engine" entityId="_6" surfaceArea="38166.293" volume="87484.987" weight="87484.987" massCenter="0.730 -16.240 -1.147" moment_x="86508113.135" moment_y="43024018.796" moment_z="57047574.638" url="STT36 Engine(4).xv2"><matrix origin="0.798286 -24.5931 19.184" />

Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml -m

Example of mass properties (in XML):

Assembly structural tree+

Mass properties

XVL assembly model

XML

Generate

• Use the –t option to specify the tessellation tolerance to use when calculating the mass properties.

Exporting XML with Mass Properties 2/2


Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml –m –t 4 8 0.1


typeSpecify one of the following integer values to indicate the polygon division type. 1: Rough 2: Fast 3: Normal 4: Fine 5: Analytic

numMaximum number of divisions for polygon division (an integer between 1 and 32).

tol Specify the tolerance for polygon division.

Basic Format: xvlbomassembler.exe < -i input_file> < -o output_file>

[-m] [-t type num tol]

* When the –t option is not specified, default values are used.

• Use the –r option to export a log file.

Exporting Log Files


Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml –r


-r

A log file is exported in the same folder as the output file.The log file name is the same as the output file but with the extension ".log“.

Return code: 0 Successful completion. -1 Incorrect format. -2 Cannot find license. -3 Cannot open input file. -4 Cannot open output file. -5 The specified input or output file name extension is invalid. -6 The version of the XVL file is not supported. -7 Schema error for input XML file. -8 Entity ID or instance ID update error for input XVL file. (An XVL assembly or part name is not set correctly, for example) -100 An unexpected error occurred.

• For details of the XML format, please see XVL_BOM_Assembler-XML_Format.pdf.*

XML Format


* XVL_BOM_Assembler-XML_Format.pdf is located in: \Lt_BomAssembler\Doc


Questions?

E. [email protected] T. +1.415.274.1670 F. +1.415.274.1671 W. www.lattice3d.com

XVL BOM Assembler Tutorial For Version 1.0 and later

Documents

Transcript of XVL BOM Assembler Tutorial For Version 1.0 and later