Artisan Grasshopper

Exporters

18 components in Artisan › Exporters.

Exporter 3DM Files

Export jewelry geometry to 3DM and GLB with layer organization

Nickname: Exporter 3DM · Tab: Artisan › Exporters

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Enable or disable export
Long Geometric SKU	`Long Geom. SKU`	Text	item	—	SKU string
Path (optional)	`Path`	Text	item	—	Folder path where files will be saved. If empty, uses the Grasshopper definition folder.
Metal 01 (optional)	`Metal 01`	Geometry	list	—	Metal geometry 01
Metal 02 (optional)	`Metal 02`	Geometry	list	—	Metal geometry 02
Metal 03 (optional)	`Metal 03`	Geometry	list	—	Metal geometry 03
Gem 01 (optional)	`Gem 01`	Generic	list	—	Gem object 01
Gem 02 (optional)	`Gem 02`	Generic	list	—	Gem object 02
Gem 03 (optional)	`Gem 03`	Generic	list	—	Gem object 03
Overwrite	`Overwrite`	Boolean	item	`true`	Overwrite files if they already exist

Outputs

Name	Nickname	Type	Access	Description
File Paths	`Paths`	Text	list	Exported file paths

Exporter GLB Files

Export jewelry geometry to 3DM and GLB with layer organization

Nickname: Exporter GLB · Tab: Artisan › Exporters

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Enable or disable export
Long Geometric SKU	`Long Geom. SKU`	Text	item	—	SKU string
Path (optional)	`Path`	Text	item	—	Folder path where files will be saved. If empty, uses the Grasshopper definition folder.
Metal 01 (optional)	`Metal 01`	Geometry	list	—	Metal geometry 01
Metal 02 (optional)	`Metal 02`	Geometry	list	—	Metal geometry 02
Metal 03 (optional)	`Metal 03`	Geometry	list	—	Metal geometry 03
Gem 01 (optional)	`Gem 01`	Generic	list	—	Gem object 01
Gem 02 (optional)	`Gem 02`	Generic	list	—	Gem object 02
Gem 03 (optional)	`Gem 03`	Generic	list	—	Gem object 03
Overwrite	`Overwrite`	Boolean	item	`true`	Overwrite files if they already exist

Outputs

Name	Nickname	Type	Access	Description
File Paths	`Paths`	Text	list	Exported file paths

Exporter Manufacturing STL

Export manufacturing geometry to STL

Nickname: Export STL · Tab: Artisan › Exporters

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Enable or disable export
Long Geometric SKU	`Long Geom. SKU`	Text	item	—	SKU string
Path (optional)	`Path`	Text	item	—	Folder path where files will be saved. If empty, uses the Grasshopper definition folder.
Metal 01 (optional)	`Metal 01`	Geometry	list	—	Metal geometry 01
Metal 02 (optional)	`Metal 02`	Geometry	list	—	Metal geometry 02
Metal 03 (optional)	`Metal 03`	Geometry	list	—	Metal geometry 03
Overwrite	`Overwrite`	Boolean	item	`true`	Overwrite files if they already exist

Outputs

Name	Nickname	Type	Access	Description
File Paths	`Paths`	Text	list	Exported STL file paths

Part

Names a piece of the jewel for the web exporters: the geometry of one record prefix (center_stone, gemset, shank, gemset.<id>, shank.cathedral_gems…), metal or gems, with its material. The same name is the key prefix in the record, the ‘part’ in the GLB extras and in every TECH entry. Parts with the same path are exported as one.

Nickname: Part · Tab: Artisan › Exporters

Inputs

Name	Nickname	Type	Access	Description
Path	`Path`	Text	item	Record prefix of this part: a section (center_stone, gemset, shank, eternity), a section with an instance id (gemset.side: wire the Path output of the Reader that has that Id) or a sub-part inside a section (shank.cathedral_gems).
Geometry (optional)	`Geometry`	Generic	list	Geometry of the part: metal (Breps, Meshes, SubDs, Extrusions) or gems (Gem objects). One kind per part.
Material (optional)	`Material`	Text	item	Material token of the part (GOLD_WHITE_18, PLATINUM, DIAMOND…), usually the Material output of the Reader. Default: GOLD_WHITE_18 for metal, DIAMOND for gems.
Scheme (optional)	`Scheme`	Generic	item	Scheme dictionary of the component that made this geometry (Basket, Cathedral…). It comes out tagged with the part id so Export Scheme nests it under <section>.<id>. Leave it empty for sub-parts (shank.cathedral_gems).
Label (optional)	`Label`	Text	item	Human name for the UI (“Side setting”). The path is used when empty.
Setting (optional)	`Setting`	Text	item	Gem parts only: setting type for the technical chart (PRONGS, PAVE, CHANNEL, BEZEL, FLUSH…). Default PRONGS.

Outputs

Name	Nickname	Type	Access	Description
Part	`Part`	Part	item	The part, for Exporter GLB Parts and Technical Chart Parts.
Scheme	`Scheme`	Generic	item	The Scheme input tagged with this part’s id, for Export Scheme. Empty when no Scheme is connected.

Technical Chart

Calculates gem count/carats and metal volume/weight from MetalInfo and GemInfo inputs

Nickname: Technical Chart · Tab: Artisan › Exporters

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Enable or disable export
SKU (optional)	`SKU`	Text	item	—	SKU string, used as the filename for the exported .tech file
Path (optional)	`Path`	Text	item	—	Folder path where the .tech file will be saved. If empty, uses the Grasshopper definition folder.
Design Type (optional)	`DT`	Text	item	—	Design type from DesignTypeList component
Metal 1 (optional)	`M1`	Generic	item	—	MetalInfo object from Metal Info component
Metal 2 (optional)	`M2`	Generic	item	—	MetalInfo object from Metal Info component
Metal 3 (optional)	`M3`	Generic	item	—	MetalInfo object from Metal Info component
Overwrite	`Overwrite`	Boolean	item	`false`	Overwrite files if they already exist
GemInfo 1 (optional)	`G1`	Generic	item	—	GemInfo object from Gem Info component

Outputs

Name	Nickname	Type	Access	Description
Summary	`Summary`	Text	item	Human-readable breakdown summary
Exported Path	`Exported`	Text	item	Path of the exported JSON file, or empty if not exported
JSON	`JSON`	Text	item	JSON content of the breakdown
Semantic	`Semantic`	Text	item	Semantic description of metals and gems for AI/search indexing

Export Scheme Base64

Combines the global scheme and any number of component schemes into one flat JSON and returns it as a Base64 string (no disk write).

Nickname: Export Scheme64 · Tab: Artisan › Exporters

Inputs

Name	Nickname	Type	Access	Description
Global (optional)	`Global`	Generic	item	Global scheme dictionary
Schemes (optional)	`Schemes`	Generic	list	Scheme dictionaries from the center stone, gemset, shank and eternity components. Connect as many as needed (Shift+drag): each one goes to the section its keys belong to.

Outputs

Name	Nickname	Type	Access	Description
Base64	`Base64`	Text	item	Flat combined scheme JSON encoded as a Base64 string
JSON	`JSON`	Text	item	Flat combined scheme: one object whose keys are <section>.<field>, matching the readers’ schemes.

Export Info

Exports product info as JSON (name, descriptions, style_id, default_sku).

Nickname: Export Info · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Set to true to enable saving
Name (optional)	`Name`	Text	item	—	Product name
Short Description (optional)	`Short Desc`	Text	item	—	Short description of the product
Description (optional)	`Description`	Text	item	—	Full description of the product
StyleID (optional)	`StyleID`	Text	item	—	Style identifier. If empty, uses the Grasshopper filename.
Default SKU (optional)	`Default SKU`	Text	item	—	Default SKU for the product
Path (optional)	`Path`	Text	item	—	Directory path where the file will be saved

Outputs

Name	Nickname	Type	Access	Description
JSON	`JSON`	Text	item	JSON content of the exported file
Path	`Path`	Text	item	Path of the exported JSON file

Export Scheme

Combines the global scheme and any number of component schemes into one flat JSON (keys prefixed with their section, e.g. center_stone.material), outputs each section as its own flat JSON and writes variants/<sku>.scheme. The section of each scheme is inferred from its keys (basket_… is gemset, cathedral_… is shank…).

Nickname: Export Scheme · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Enable or disable the file export. The JSON outputs are always computed.
SKU (optional)	`SKU`	Text	item	—	SKU string: the file is written as variants/<SKU>.scheme.
Path (optional)	`Path`	Text	item	—	Folder path where the file will be saved. If empty, uses the Grasshopper definition folder.
Overwrite	`Overwrite`	Boolean	item	`false`	Overwrite the file if it already exists.
Global (optional)	`Global`	Generic	item	—	Global scheme dictionary
Schemes (optional)	`Schemes`	Generic	list	—	Scheme dictionaries from the center stone, gemset, shank and eternity components. Connect as many as needed (Shift+drag): each one goes to the section its keys belong to.

Outputs

Name	Nickname	Type	Access	Description
JSON	`JSON`	Text	item	Flat combined scheme: one object whose keys are <section>.<field>, matching the readers’ schemes.
Global	`Global`	Text	item	Global scheme as a flat JSON (feeds Global Reader).
Center Stone	`Center Stone`	Text	item	Center stone scheme as a flat JSON (feeds Center Stone Reader).
Gemset	`Gemset`	Text	item	Gemset scheme as a flat JSON (feeds the Gemset readers).
Shank	`Shank`	Text	item	Shank scheme as a flat JSON (feeds the Shank readers).
Eternity	`Eternity`	Text	item	Eternity scheme as a flat JSON (feeds Eternity Reader).
File Paths	`Paths`	Text	list	Exported file paths
Wedding	`Wedding`	Text	item	Wedding rings scheme as a flat JSON (feeds Wedding Reader).

Export UI Files

Saves JSON for UI

Nickname: Exporter UI · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Set to true to enable saving
StyleID (optional)	`StyleID`	Text	item	—	Style identifier prefix. If empty, uses the Grasshopper filename.
Path (optional)	`Path`	Text	item	—	Directory path where the files will be saved
Text_Selectors (optional)	`Selectors`	Text	item	—	JSON content for selectors (optional)
Page 1 (optional)	`Page1`	Text	item	—	Page name

Outputs

Name	Nickname	Type	Access	Description
JSON	`JSON`	Text	item	JSON content of the exported file
Path	`Path`	Text	item	Path of the exported JSON file

Exporter GLB Base64

Export jewelry geometry to a GLB Base64 string (no disk write)

Nickname: Exporter GLB64 · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Description
Metal 01 (optional)	`Metal 01`	Geometry	list	Metal geometry 01
Metal 02 (optional)	`Metal 02`	Geometry	list	Metal geometry 02
Metal 03 (optional)	`Metal 03`	Geometry	list	Metal geometry 03
Gem 01 (optional)	`Gem 01`	Generic	list	Gem object 01
Gem 02 (optional)	`Gem 02`	Generic	list	Gem object 02
Gem 03 (optional)	`Gem 03`	Generic	list	Gem object 03

Outputs

Name	Nickname	Type	Access	Description
Base64	`Base64`	Text	item	GLB encoded as Base64 string

Exporter GLB Parts

Exports Parts to a GLB Base64 string (no disk write): one glTF node per part, named after it, with the part, kind, material and gem data in the node extras and the list of parts in the scene extras.

Nickname: GLB Parts · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Description
Parts	`Parts`	Part	list	Parts of the jewel (from Part components). Parts with the same path are joined.

Outputs

Name	Nickname	Type	Access	Description
Base64	`Base64`	Text	item	GLB encoded as a Base64 string
Parts	`Parts`	Text	item	JSON list of the exported parts (the same manifest the GLB carries in its scene extras).

Exporter STL Base64

Export manufacturing geometry to an STL Base64 string (no disk write)

Nickname: Exporter STL64 · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Description
Metal 01 (optional)	`Metal 01`	Geometry	list	Metal geometry 01
Metal 02 (optional)	`Metal 02`	Geometry	list	Metal geometry 02
Metal 03 (optional)	`Metal 03`	Geometry	list	Metal geometry 03

Outputs

Name	Nickname	Type	Access	Description
Base64	`Base64`	Text	item	STL encoded as Base64 string

Semantic Export

Semantic file export. Add extra Semantic inputs via Zoom (+/-).

Nickname: Semantic · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Enable or disable export
SKU (optional)	`SKU`	Text	item	—	SKU string
Path (optional)	`Path`	Text	item	—	Folder path where files will be saved. If empty, uses the Grasshopper definition folder.
Design Type (optional)	`Type`	Text	item	—	Design type (e.g. Ring, Bracelet, Earring…)
Overwrite	`Overwrite`	Boolean	item	`false`	Overwrite files if they already exist
Semantic 1 (optional)	`S1`	Text	item	—	Semantic text fragment

Outputs

Name	Nickname	Type	Access	Description
Semantic Text	`Semantic`	Text	item	Generated semantic text
File Paths	`Paths`	Text	list	Exported file paths

SKU Combiner

Combine geometric SKU list with material/gem options into all possible combinations.

Nickname: SKU Combiner · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`false`	Enable saving JSON to disk
Prefix	`Prefix`	Text	item	—	Style identifier prefix (e.g. RIN001)
Path (optional)	`Path`	Text	item	—	Folder path where the JSON file will be saved
SKU Geometric	`SKU's Geometric`	Text	list	—	Geometric SKU list
Geometry Version (optional)	`Version`	Integer	item	`1`	Geometry version number
Metal 01	`M1`	Text	list	—	Lines: value,sku,name
Metal 02	`M2`	Text	list	—	Lines: value,sku,name
Metal 03	`M3`	Text	list	—	Lines: value,sku,name
Gem 01	`G1`	Text	list	—	Lines: value,sku,name
Gem 02	`G2`	Text	list	—	Lines: value,sku,name
Gem 03	`G3`	Text	list	—	Lines: value,sku,name

Outputs

Name	Nickname	Type	Access	Description
SKU	`SKU`	Text	list	Combinatorial SKUs
Max	`Max`	Integer	item	Total number of SKUs generated
JSON	`JSON`	Text	item	JSON array with all SKU combinations
Exported Path	`Exported`	Text	item	Path of the exported JSON file, or empty if not exported

SKU Equals

Extracts a single variant from a SKU Bundle by index.

Nickname: SKU Equals · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Bundle	`Bundle`	Generic	item	—	Bundle output from SKU Super Generator
Index	`Index`	Integer	item	`0`	Variant index (0-based counter)

Outputs

Name	Nickname	Type	Access	Description
SKU	`SKU`	Text	item	Sequential SKU at index (e.g. StyleID-000001)
StyleID	`StyleID`	Text	item	Style identifier
Geom Value	`Geom Val`	Text	list	Geometric values at index (split by ’-‘)
Geom SKU	`Geom SKU`	Text	item	Geometric SKU at index
Geom SKU Long	`Geom SKU Long`	Text	item	StyleID-GeomSKU
Variant Value	`Var Val`	Text	list	Variant values at index (split by ’-‘)
Variant SKU	`Var SKU`	Text	item	Variant SKU at index
Index	`Idx`	Integer	item	Input variant index
Geom Index	`Geom Idx`	Integer	item	Resolved geometric index from the variant SKU

SKU Super Generator

Generate all SKU combinations from fixed Metal/Gem inputs and dynamic panels (value,sku,name triples).

Nickname: SKU Super Generator · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	`Enabled`	Boolean	item	`true`	Enable or disable export
StyleID (optional)	`StyleID`	Text	item	—	Style identifier prefix. If empty, uses the Grasshopper filename.
Path (optional)	`Path`	Text	item	—	Directory path where the SKU JSON will be saved. If empty, uses the Grasshopper definition folder.
Version	`Version`	Integer	item	`1`	Geometry version number
Metal 1 (optional)	`M1`	Text	list	—	Metal 1: Metal enum value (e.g. GOLD_YELLOW_18) or value,sku,name
Metal 2 (optional)	`M2`	Text	list	—	Metal 2: Metal enum value (e.g. GOLD_YELLOW_18) or value,sku,name
Metal 3 (optional)	`M3`	Text	list	—	Metal 3: Metal enum value (e.g. GOLD_YELLOW_18) or value,sku,name
Gem 1 (optional)	`G1`	Text	list	—	Gem 1 panel with lines: value,sku,name
Gem 2 (optional)	`G2`	Text	list	—	Gem 2 panel with lines: value,sku,name
Gem 3 (optional)	`G3`	Text	list	—	Gem 3 panel with lines: value,sku,name
Overwrite	`Overwrite`	Boolean	item	`true`	Overwrite files if they already exist
Panel 1 (optional)	`P1`	Text	list	—	Panel with lines: value,sku,name

Outputs

Name	Nickname	Type	Access	Description
Geom Values	`Geom Val`	Text	list	Geometric Values (from dynamic panels only)
Geom SKU	`Geom SKU`	Text	list	Geometric SKUs (from dynamic panels only)
Max Geom	`Max Geom`	Integer	item	Total number of GeomSKUs generated
Variant Values	`Var Val`	Text	list	Variant Values (Panels + Metals + Gems)
Variant SKU	`Var SKU`	Text	list	Variant SKUs (Panels + Metals + Gems)
Max Variants	`Max Variants`	Integer	item	Total number of Variant SKUs generated
StyleID	`StyleID`	Text	item	Style identifier used
SKU	`SKU`	Text	list	Sequential SKUs: StyleID-000001, StyleID-000002, …
Bundle	`Bundle`	Generic	item	All outputs packed as a dictionary for single-wire connection
JSON	`JSON`	Text	item	JSON content of the SKU file
File Path	`File`	Text	item	Path of the exported JSON file

Technical Chart 64

Calculates gem count/carats and metal volume/weight; outputs JSON only (no disk write)

Nickname: Tech Chart 64 · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Description
Design Type (optional)	`DT`	Text	item	Design type from DesignTypeList component
Metal 1 (optional)	`M1`	Generic	item	MetalInfo object from Metal Info component
Metal 2 (optional)	`M2`	Generic	item	MetalInfo object from Metal Info component
Metal 3 (optional)	`M3`	Generic	item	MetalInfo object from Metal Info component
GemInfo 1 (optional)	`G1`	Generic	item	GemInfo object from Gem Info component

Outputs

Name	Nickname	Type	Access	Description
JSON	`JSON`	Text	item	JSON content of the breakdown

Technical Chart Parts

Technical chart from Parts: metal volume and weight per part, gem count and carats per part, every entry tagged with its part; outputs JSON only (no disk write).

Nickname: Tech Parts · Tab: Artisan › Exporters · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Description
Design Type (optional)	`DT`	Text	item	Design type from DesignTypeList component
Parts	`Parts`	Part	list	Parts of the jewel (from Part components). Parts with the same path are joined.

Outputs

Name	Nickname	Type	Access	Description
JSON	`JSON`	Text	item	JSON content of the breakdown