usd-convert-cad 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,20 @@
1
+ # NVIDIA Omniverse Licensing Terms
2
+
3
+ The **Omniverse CAD Converter**, distributed on GitHub and PyPI using the
4
+ `usd-convert-cad` repository, package, and command-line identifier, is governed
5
+ by the following NVIDIA agreements:
6
+
7
+ - [NVIDIA Software License Agreement](https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-software-license-agreement/)
8
+ - [Product Specific Terms for NVIDIA AI Products](https://www.nvidia.com/en-us/agreements/enterprise-software/product-specific-terms-for-ai-products/)
9
+
10
+ These terms govern the use of NVIDIA Omniverse by individuals and commercial
11
+ customers. Customers may redistribute the Omniverse CAD Converter as permitted
12
+ by those terms.
13
+
14
+ By downloading or using NVIDIA Omniverse, you agree to the terms. See the
15
+ [Omniverse License Agreement](https://docs.omniverse.nvidia.com/dev-guide/latest/common/NVIDIA_Omniverse_License_Agreement.html).
16
+
17
+ The Omniverse CAD Converter uses the Tech Soft 3D HOOPS Exchange SDK, licensed
18
+ by NVIDIA, to read supported CAD data for conversion to OpenUSD. See
19
+ [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) for third-party
20
+ acknowledgements and license notices that must accompany the software.
@@ -0,0 +1,159 @@
1
+ Metadata-Version: 2.4
2
+ Name: usd-convert-cad
3
+ Version: 0.2.0
4
+ Summary: Convert supported CAD assets to OpenUSD (.usd, .usda, .usdc).
5
+ Project-URL: Homepage, https://github.com/NVIDIA-Omniverse/usd-convert-cad
6
+ Project-URL: Documentation, https://github.com/NVIDIA-Omniverse/usd-convert-cad#readme
7
+ Project-URL: Repository, https://github.com/NVIDIA-Omniverse/usd-convert-cad
8
+ Project-URL: Issues, https://github.com/NVIDIA-Omniverse/usd-convert-cad/issues
9
+ Author: NVIDIA
10
+ License: # NVIDIA Omniverse Licensing Terms
11
+ The **Omniverse CAD Converter**, distributed on GitHub and PyPI using the
12
+ `usd-convert-cad` repository, package, and command-line identifier, is governed
13
+ by the following NVIDIA agreements:
14
+ - [NVIDIA Software License Agreement](https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-software-license-agreement/)
15
+ - [Product Specific Terms for NVIDIA AI Products](https://www.nvidia.com/en-us/agreements/enterprise-software/product-specific-terms-for-ai-products/)
16
+ These terms govern the use of NVIDIA Omniverse by individuals and commercial
17
+ customers. Customers may redistribute the Omniverse CAD Converter as permitted
18
+ by those terms.
19
+ By downloading or using NVIDIA Omniverse, you agree to the terms. See the
20
+ [Omniverse License Agreement](https://docs.omniverse.nvidia.com/dev-guide/latest/common/NVIDIA_Omniverse_License_Agreement.html).
21
+ The Omniverse CAD Converter uses the Tech Soft 3D HOOPS Exchange SDK, licensed
22
+ by NVIDIA, to read supported CAD data for conversion to OpenUSD. See
23
+ [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) for third-party
24
+ acknowledgements and license notices that must accompany the software.
25
+ License-File: LICENSE.md
26
+ Requires-Python: <3.13,>=3.12
27
+ Description-Content-Type: text/markdown
28
+
29
+ # Omniverse CAD Converter (`usd-convert-cad`)
30
+
31
+ Pip-installable Omniverse CAD Converter package for converting supported CAD
32
+ assets to OpenUSD.
33
+
34
+ `usd-convert-cad` converts supported CAD, AEC, and interchange files to OpenUSD. The wheel includes the converter command line, Python package, required native runtime components, and the canonical agent skill.
35
+
36
+ ## Installing
37
+
38
+ Create an isolated Python environment and install the package:
39
+
40
+ ```shell
41
+ python -m venv .venv
42
+ python -m pip install usd-convert-cad
43
+ ```
44
+
45
+ ## Converting Files
46
+
47
+ Run the console command with an input CAD asset and output USD path:
48
+
49
+ ```shell
50
+ usd-convert-cad --input model.stp --output model.usdc
51
+ ```
52
+
53
+ Short flags are also supported:
54
+
55
+ ```shell
56
+ usd-convert-cad -i model.stp -o model.usda
57
+ ```
58
+
59
+ The package supports module execution as well:
60
+
61
+ ```shell
62
+ python -m usd_convert_cad --input model.stp --output model.usdc
63
+ ```
64
+
65
+ ## Output Formats
66
+
67
+ The output path determines the USD file format. Supported output extensions are
68
+ `.usd`, `.usda`, and `.usdc`. USDZ (`.usdz`) export is not supported.
69
+
70
+ Examples:
71
+
72
+ ```bash
73
+ usd-convert-cad -i assembly.stp -o assembly.usdc
74
+ usd-convert-cad -i part.igs -o part.usda
75
+ usd-convert-cad -i model.prt -o model.usd
76
+ ```
77
+
78
+ ## Conversion Options
79
+
80
+ Run `usd-convert-cad --help` to view all options.
81
+
82
+ Options include:
83
+
84
+ - `--global-xforms`: Author global transforms instead of local transforms.
85
+ - `--convert-curves`: Convert wire and curve geometry.
86
+ - `--convert-metadata`: Convert CAD metadata to USD custom attributes.
87
+ - `--no-dedup`: Disable mesh and material deduplication.
88
+ - `--tess-lod <0-4>`: Set tessellation level of detail.
89
+ - `--revit-lod <0-3>`: Set Revit detail level. Values are `0` for file
90
+ default, `1` coarse, `2` medium, and `3` fine.
91
+ - `--accurate-tessellation`: Enable accurate tessellation.
92
+ - `--fast-surface-curvatures`: Disable accurate surface curvature computation.
93
+ - `--no-normals`: Do not author normals.
94
+ - `--no-materials`: Do not author materials.
95
+ - `--material-type <type>`: Choose material output type. Valid values:
96
+ `none`, `preview-surface`, `preview-surface-omnipbr`.
97
+ - `--up-axis <axis>`: Override output stage up-axis. Valid values:
98
+ `file`, `y`, `z`.
99
+ - `--instancing-style <style>`: Choose how repeated components are authored.
100
+ Valid values: `none`, `reference`, `instanceable-reference`.
101
+ - `--composition-style <style>`: Choose how external sub-assemblies and parts
102
+ are authored. Valid values: `none`, `reference`, `payload`.
103
+ - `--filter-style <style>`: Choose how hidden CAD elements are converted.
104
+ Valid values: `none`, `omit`, `hide`, `deactivate`.
105
+ - `--load-hidden`: Load hidden CAD elements before filtering.
106
+ - `--progress`: Print converter progress.
107
+ - `--progress-frequency <hz>`: Set progress report frequency in Hz.
108
+ - `--creator <value>`: Set creator metadata on output USD layers.
109
+ - `--convert-physics-data`: Author physical properties on USD prims.
110
+ - `--physics-accuracy-level <0.0-1.0>`: Set physical property accuracy.
111
+ - `--physics-use-geometry-on-ribrep`: Use geometry instead of topology for
112
+ RiBRep physical properties.
113
+ - `--view-layer-name <name>`: Convert a CAD view layer or simplified
114
+ representation by name.
115
+
116
+ Pass the selected value after the option name:
117
+
118
+ ```bash
119
+ usd-convert-cad \
120
+ --input model.stp \
121
+ --output model.usdc \
122
+ --convert-metadata \
123
+ --tess-lod 3 \
124
+ --material-type preview-surface \
125
+ --up-axis z \
126
+ --instancing-style instanceable-reference \
127
+ --composition-style payload \
128
+ --filter-style hide \
129
+ --progress-frequency 4 \
130
+ --progress
131
+ ```
132
+
133
+ ## Python Package
134
+
135
+ The installed Python package exposes version helpers:
136
+
137
+ ```python
138
+ import usd_convert_cad
139
+
140
+ print(usd_convert_cad.__version__)
141
+ print(usd_convert_cad.get_version())
142
+ ```
143
+
144
+ The wheel also installs the canonical agent skill at
145
+ `usd_convert_cad/skills/omniverse-cad-to-usd/SKILL.md`.
146
+
147
+ ## Uninstalling
148
+
149
+ ```bash
150
+ python -m pip uninstall usd-convert-cad
151
+ ```
152
+
153
+ ## License and Third-Party Notices
154
+
155
+ The Omniverse CAD Converter is governed by the applicable
156
+ [NVIDIA Omniverse licensing terms](https://docs.omniverse.nvidia.com/dev-guide/latest/common/NVIDIA_Omniverse_License_Agreement.html).
157
+ NVIDIA licenses the Tech Soft 3D HOOPS Exchange SDK to read supported CAD data
158
+ for conversion to OpenUSD. See the repository [license](https://github.com/NVIDIA-Omniverse/usd-convert-cad/blob/main/LICENSE.md)
159
+ and [third-party notices](https://github.com/NVIDIA-Omniverse/usd-convert-cad/blob/main/THIRD_PARTY_NOTICES.md).
@@ -0,0 +1,10 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
2
+ # SPDX-License-Identifier: Apache-2
3
+
4
+ [build-system]
5
+ requires = ["wheel-stub"]
6
+ build-backend = "wheel_stub.buildapi"
7
+
8
+ [tool.wheel_stub]
9
+ index_url = "https://pypi.nvidia.com/"
10
+ include_cuda_debuginfo = true