GTC Package Specification 2 1 1
GTC Package Specification 2 1 1
1 Mai 2018
Version History
Changes
Date Description
Major Minor Small
1 Introduction
Generic Tool Catalog (GTC) is a format introduced as a complement to ISO 13399, with the purpose of
facilitating cutting tool catalog exchange between cutting tool vendors, system vendors, end users, and other
stakeholders.
This document specifies the GTC package format for delivering a catalog of cutting tool items described
according to ISO13399, which includes the folder structure and general requirement for each folder and file.
Every package created by a tool vendor will have this format, even if it contains only a small number of tools.
General notes:
product_data_files disclaimer
en-us
product_3d_models_detailed
disclaimer_en.txt
product_3d_models_basic sv-se
product_pictures disclaimer_sv.txt
package_assortment.xml
product_2d_drawings
package_subset_assortment.xml
product_family_drawings
gtc_class_hierarchy_vendor.xml
class_drawings
package_meta_data.xml
class_icons
<package_logo>.<ext>
product_brand_logos
readme.txt
<logo_file_name>.<ext>
All folders and files must be placed under the root directory of the zip folder to guarantee
that all package components can be found directly when the zip folder is open.
The GTC package typically includes information on both the GTC classification hierarchy and product data,
however 3 cases are possible:
The file “gtc_class_hierarchy_vendor.*” is an indicator that the class hierarchy is included in the package. The files
“package_assortment.xml” or package_subset_assortment.xml indicate that product data is included in the
package. It is mandatory that at least one of them is included in a GTC package.
<product_data_file_id>.p21
This folder contains product data files which describe cutting tool parameters. The product data file is a
STEP file which uses EXPRESS schema defined in ISO 13399-1 Annex C, and the file format is defined in
ISO 10303-21 (.p21).
3.2 product_3d_models_detailed
product_3d_models_detailed
<3d_model_file_name>.stp
This folder contains detailed 3D models of cutting tools. File format is defined in ISO 10303-21 (the same
format as product data file, but use ".stp"extension for differentiation), and use EXPRESS schema
defined in ISO 10303 part 203, or 214.(Note: part 242 is published on 2014-12-01 to revise part 203 and
214, but at the time when this document is written, the commercial implementation of part 242 is
limited. Going forward, GTC will support 242 model instead of 203 and 214)
ISO13399-80 defines needs/requirements for cutting tool 3D models. Part 80 is currently being revised,
and GTC adopts the recommendation of the new revision. Examples can be found in released and
upcoming ISO 13399 part 2xx, 3xx, 4xx.
File name must be the same as the corresponding external document name (case sensitive) stated in the
product data p21 file.
product_3d_model_detailed is the document description that points to this file within the P21 file.
The model detail level should be enough to produce tool assembly drawings for the shop floor use of
assembling and measuring the tool assembly. This model may also be used by receiving applications to
create a basic model.
3.3 product_3d_models_basic
product_3d_models_basic
<3d_model_file_name>.stp
This folder contains basic 3D models of cutting tools. File format is defined in ISO 10303-21 (the same
format as product data file, but use ".stp" extension for differentiation), and use EXPRESS schema
defined in ISO 10303 part 203 or 214.(Note: part 242 is published on 2014-12-01 to revise part 203 and
214, but at the time when this document is written, the commercial implementation of part 242 is
limited. Going forward, GTC will support 242 model instead of 203 and 214)
ISO13399-80 defines needs/requirements for cutting tool 3D models. Part 80 is currently being revised,
and GTC adopts the recommendation of the new revision.Examples can be found in ISO 13399 part 2xx,
3xx, 4xx.
File name must be the same as the corresponding external document name (case sensitive) stated in the
product data p21 file.
product_3d_model_basic is the document description that points to this file within the P21 file.
The model basic level should be enough for simulation and collision detection of the tool with the part
or the machine tool.
3.4 product_pictures
product_pictures
<file_name>.jpg
3.5 product_2d_drawings
product_2d_drawings
<2d_drawing_file_name>.dxf
This folder contains the 2D drawings of cutting tools, which shows the tool to scale, in a side view
defined in the standard ISO 13399-70.
".dxf" format.
Needs and requirements are defined in ISO13399-70 (layers, colors, etc).
File name must be the same as the corresponding external document name stated in the product data
p21 file.
product_2d_drawing is the document description that points to this file within the P21 file.
The drawing detail level should be enough to produce tool assembly drawings for the shop floor use of
assembling and measuring the tool assembly.
3.6 product_family_drawings
product_family_drawings
<file_name>.jpg
This folder contains the descriptive drawings, which are not to scale as they are intended for display
purposes only. These drawings can be assigned to a product or a group of products and may be helpful
to interpret the meaning of the main properties.
File name must be the same as the corresponding external document name stated in the product data
p21 file.
product_family_drawing is the document description that points to this file within the P21 file.
Both bitmap and vector formats are accepted. Vector formats are preferred considering the pictures
can be zoomed in for detail view. (Which formats are actually supported depends on the receiving
systems, so it’s suggested that data provider check with data receiver which formats will work on
corresponding receiving systems.)
Recommended vector formats: ".cgm", ".dwg", ".dxf", ".hpg", ".hpgl". (Data provider needs to check
with data receiver which formats are actually supported.)
Recommended bitmaps formats: ".gif", ".jpeg", ".jpg", ".png" (, ".bmp", ".tif". Data provider needs to
check with data receiver which formats are actually supported.)
Recommended minimum size of bitmaps drawings: 400x300 pixels.
Recommended aspect ratio for bitmap drawings is 4:3, but other aspect ratios are accepted as well since
tool shapes are various.
3.7 class_drawings
class_drawings
<file_name>.jpg
This folder contains drawings showing important properties in each GTC leaf node class or on higher
levels. This can be one of the product property descriptive drawings selected to represent the general
properties that are applicable to products which belong to the GTC class node.
File name must be the same as the corresponding reference file name stated in
gtc_class_hierarchy_vendor.xml
Both bitmap and vector formats are accepted. Vector formats are preferred considering the pictures
can be zoomed in for detail view. (Which formats are actually supported depends on the receiving
systems, so it’s suggested that data provider check with data receiver which formats will work on
corresponding receiving systems.)
Recommended vector formats: ".cgm", ".dwg", “.dxf", ".hpg", ".hpgl". (Data provider needs to check
with data receiver which formats are actually supported.)
Recommended bitmaps formats: ".gif”, ".jpeg", ".jpg", ".png" (, ".bmp", ".tif”. Data provider needs to
check with data receiver which formats are actually supported.)
Recommended minimum size of bitmaps drawings: 400x300 pixels.
Recommended aspect ratio for bitmap drawings is 4:3, but other aspect ratios are accepted as well since
tool shapes are various.
LTA
3.8 class_icons
class_icons
<icon_file_name>.jpg
3.9 product_brand_logos
Product_brand_logos
<logo_file_name>.<ext>
3.10 disclaimer
disclaimer
en-us
disclaimer_en.txt
sv-se
disclaimer_sv.txt
3.11 package_assortment.xml
List of all products in the delivered data package.
This file states where a product fits in the GTC class hierarchy.
<product_id> must be an unambigiously unique identifier for the product from the tool vendor
to be used by the receiving system to uniquely indentify the product from the vendor in the
system.
<p21_value_change_timestamp> and <p21_structure_change_timestamp> provides timestamp
information to enable updating.
<effectivity_active_start_date> and < effectivity_active_end_date > specify a period when a
produc is active.
effectivity_active_start_ effectivity_active_end
date _date Description
n/a n/a The product is always active
The product will be active starting
<start_date> n/a <start-date>
The product is active (since <start-
<start_date> n/a date>)
The product will be discontinued
n/a <end_date> starting <end-date>
The product is obsolete (since
n/a <end_date> <end-date>)
The product will be active starting
<start_date> <end_date> <start-date>
The product is active but will be
<start_date> <end_date> discontinued
The product is obsolete (since
<start_date> <end_date> <end-date>)
= current_date
<replacement_product_id> indicates that there is a replacement product for this product if the
current product is in process of being obsolete or is obsolete.
<gtc_version> indicates the GTC hierarchy version number which the assortment is based on.
Every product has a unit. <unit_system> indicates in which unit system (metric or imperial) the
vendor intends the data to be presented to the user.
3.12 package_subset_assortment.xml
This file is the assortment for a subset of products. (e.g. assortment for milling only, assortment
for new products only). Assortment for all catalog product is specified in section 3.11
The purpose of this file to make it easier for data receiver to import defined subsets of products
in the provided package without retrieving the full assortment.
The content of string_value is determined by cutting tool vendor.
3.13 gtc_class_hierarchy_vendor.xml
This file is created based on the GTC generic hierarchy and the products the vendor has.
The vendor hierarchy should include all the classes that the tool vendor has.
GTC generic hierarchy is provided on the GTC website gtc-tools.com/gtc-current-working-
documents, GTC Release.
The file also includes rules for creating vendor level classes under each leaf-level generic class.
The mapping rules are explained in document GTC mapping rule specification on the GTC
website gtc-tools.com/gtc-current-working-documents, GTC Format Specification.
The file GTC package description provides additional information and explication concerning data
and meaning of this file. It is on the GTC website gtc-tools.com/gtc-current-working-documents,
GTC Format Specification.
attributes
gtc_generic_hierarchy_version
type xs:string
plib_version
type xs:string
time_stamp
type xs:dateTime
id
type xs:string
parent_id
type xs:string
node_name
*
type xs:multi_language_string
gtc_class_hierarchy_vendor ...
root element
preferred_name
*
type xs:multi_language_string
... gtc_class
modified_date
type xs:dateTime
1..
mapping_rule
type xs:string
sort_level
type xs:string
usage
type xs:string
format
constraints document_list
type xs:dateTime
... document
type xs:string
file_name
1.. type xs:string
unique uniqueClassID
location
type xs:anyURI
selector hGTCClass
field ID
multi_language_string
language
type xs:string
* ... string_with_language
1..
string_value
type xs:string
3.14 package_meta_data.xml
This file describes the generic information on the package.
Supported GTC generic versions include the generic version that the package is based on as well
as all backward compatible generic versions. In case of multiple versions, version numbers
should be devided by command, e.g. 1.7, 1.10
Vendor hierarchy version that the package is based on (numeric format, e.g. 14.1), this number
will be compared with the current version stored in the receiving system of the GTC vendor
hierarchy version, if larger(in numeric order), the whole hierarchy will be re-read.
Include vendor name and acronym.
Include the package creation date, package ID, the version of the vendor system.
Enable a short description, and optionally a long description in different languages.
<online_connection_configuration> and <download_security> are optional and are used for
online package only. <online_connection_configuration> points to an url address which can be
seen as the entrance door for accessing to the online data. The url address can be the root
address of the online package, or technical configuration file for online delivery interface.
vendor_hierarchy_version
type xs:string
vendor_name
type xs:string
vendor_acronym
type xs:string
gtc_package_creation_date
type xs:dateTime
gtc_package_id
type xs:string
logo_url
root element
download_security
type xs:string
online_connection_configuration
type xs:string
vendor_system_version
type xs:string
language_code
type xs:string
short_description
type xs:string
language
...
long_description
1..
type xs:string
disclaimer_url
type xs:string
3.15 package_logo.ext
If there is a specific logo for the package being delivered. It is shown in the picture below in the
colums "Icon"
File name is: <package_logo>.<ext>.
<ext> is a placeholder for a value from the list of supported bitmat formats.
List of supported bitmap formats: { ".png", ".jpg", ".jpeg", ".gif".} (Data provider needs to check
with data receiver which formats are actually supported.)
Recommended maximum logo size is 300 x 110 pixels
3.16 readme.txt
Regular text file containing the list of known issues and other important information for the
package deployment.
Annex A
Terminology to clarify difference of usable product identifiers.
Annex B
1. package_assortment.xml
2. package_subset_assortment
3. gtc_class_hierarchy_vendor.xml
Attributes
gtc_vendor_hierarchy_version Vendor specific versioning. Numerical format only, (e.g. '14.2',
'14.3.1'). Larger number = newer version
gtc_generic_herarchy_version The GTC generic hierarchy version used as a base for this GTC
vendor hierarchy. Numerical format only, (e.g. '1.7', '1.10').
plib_version Plib version used as a base for plib classes in the GTC package
(product files). Example: 0112/1///13399_002
time_stamp The time when the hierarchy file is created. Format:
https://www.w3.org/TR/xmlschema-2/#dateTime. (e.g. 2016-11-
16T14:58:00. (see also Annex C)
GTC class
id Matches the GTC_vendor_id in file GTC_generic_hierarchy.
parent_id Matches GTC_vendor_parent_id in file GTC_generic_hierarchy.
The parent of root class id is defined as 'GTC-root'.
node_name Matches GTC_vendor_node_name in file GTC_generic_hierarchy.
node_name ... language Use alpha-3 code as specified in ISO 639-2 (e.g. 'eng' for English,
'swe' for Swedish).
preferred_name Matches GTC_vendor_preferred_name in file
GTC_generic_hierarchy.
preferred_name ... language Use alpha-3 code as specified in ISO 639-2 (e.g. 'eng' for English,
'swe' for Swedish).
modified_date The latest modified date.
mapping_rule Can be used to support the mapping of products to GTC node.
sort_level To specify the order of children for each parent. Classes with smaller
numbers are presented before classes with larger numbers.
document list
document
usage The usage of the document: valid entries are 'class_icon' or
'class_drawing'
format File extension for this document. Recommended formats: see
chapters for class_icon and class_drawing.
file_name Simple file name. Examples: CTL.png or ADPRS_MHSK_WZYL.jpg
location URI providing full path. Example:
http://documents.toolvendor.com/images/ADPRS_MHSK_WZYL.jpg
4. package_meta_data.xml
supported_gtc_generic_versions the gtc generic version which this package is based on + all
backward compatible generic versions, examples: 1.7, 1.10
vendor_hierarchy_version vendor hierarchy version in numeric format, example: 14.2
vendor_name
vendor_acronym Must be unique, max. 5 characters following rules described in ISO
13399-60, all in capital letters.
Annex C
DateTime Format
Support date and time formats based on the standard ISO 8601.
"If a date and a time value are stored together in a single data field, then ISO 8601 suggests that they
should be separated by a Latin capital letter T, as in 19951231T235959.”
This UTC postfix can be in one of 4 formats: "±hh:mm", "±hhmm", "±hh" or "Z" (for GMT or UTC+0)
"YYYY[-]MM[-]DDThh[[:]mm[[:]ss]][±hh[[:]mm]|[Z]] "
Date: 2017-11-06
Combined date and time in UTC: 2017-11-06T15:30:07+00:00
2017-11-06T15:30:07Z
20171106T153007Z