SimReady Conform FET_033_STANDARD
Purpose
Use this exact feature skill when the selected profile, validation report, or user request names FET_033_STANDARD. It repairs or stages Metadata conformance (thumbnail and nested provenance metadata) without drifting into another runtime contract.
Default to FET_033_STANDARD@0.4.0 when the user asks for this feature without a version. Use an older version only when the profile, validation report, or user explicitly pins it. If the report names a different FET_###_RUNTIME feature, switch to that feature's matching skill before editing.
Source of Truth
Before changing an asset or package, read:
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.4.0.json (latest)
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.3.0.json (preserved)
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.2.0.json (preserved)
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.1.0.json (preserved)
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD.md
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/sim_ready/requirements/thumbnail-exist.md (SR.002)
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/sim_ready/requirements/nested-simready-metadata.md (SR.003)
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/sim_ready/requirements/metadata-union.md (SR.004)
Treat the selected JSON manifest as authoritative for dependencies and requirement IDs. Use the feature markdown for human-readable contract details, requirement links, samples, benchmarks, and adapters.
Feature Versions
Workflow
- Confirm the input exists and identify the exact selected feature/version from the profile TOML, validation report, or user request.
- Load the selected
FET_033_STANDARD manifest and the feature markdown before editing.
- Load requirement docs linked from the feature markdown for every reported failing requirement.
- Create or use a staged output location unless the user explicitly asks for in-place edits.
- Repair only the requirements listed by the selected
FET_033_STANDARD manifest and its dependencies.
- Rerun the same profile gate or the narrowest available feature/capability validation gate. If runtime evidence is required and unavailable, report that limitation instead of claiming a pass.
- Summarize the selected
FET_033_STANDARD version, changed files, validation evidence, and the first remaining blocker or next exact feature gate.
Feature Guidance
- Repair only the requirements listed by the selected
FET_033_STANDARD manifest and its dependencies.
- For
SR.002, ensure a representative PNG thumbnail exists at .thumbs/256x256/<asset_filename>.png next to the root asset.
- For
SR.003 at FET_033_STANDARD@0.2.0 / @0.3.0, the published feature contract places required fields inside root-layer customLayerData.SimReady_Metadata.
- For
SR.004 at FET_033_STANDARD@0.4.0, author required provenance fields in the USD/sidecar metadata union: author, asset_name, asset_type, asset_license, category, source_file, and usd_date_generated. Fields may live in root-layer customLayerData (optionally inside SimReady_Metadata), in <usd_stem>.json beside the root USD, or split across both. Neither location is required on its own, but a field must not be authored in both.
- For
SR.003 at version 0.3.0 and SR.004 at version 0.4.0, also author these required asset-descriptive fields (nested in SimReady_Metadata at 0.3.0; in the USD/sidecar union at 0.4.0):
qcode (string): Wikidata Q-Code for the asset's general category, a capital Q followed by one or more digits (for example Q42177).
rigid_body_count (int): non-negative count of rigid bodies in the asset.
asset_extents (float3): asset bounding-box size in meters as XYZ, with non-negative components.
mass (float): asset mass in kilograms, strictly positive.
- Do not author
SR.003 0.3.0 / SR.004 0.4.0 descriptive fields with placeholder or fabricated physical values. Derive rigid_body_count, asset_extents, and mass from the actual asset (rigid-body prims, computed bounds, and authored mass); if a value cannot be derived, report it as a blocker instead of guessing.
How to Generate Metadata
The SR.003 / SR.004 requirements are declarative (they check the end state in
nested SimReady_Metadata or the USD/sidecar union), so use the
bundled helper to populate provenance fields. The helper
only derives what the stage can prove and never fabricates values. You may
write the helper output into customLayerData.SimReady_Metadata, into
<usd_stem>.json, or split across both.
Helper script: assets/scripts/extract_simready_metadata.py (run with a USD-core
Python; the same interpreter used to run SimReady validation works).
- Derived deterministically from the stage:
asset_extents (float3, meters) from the default prim's world bounding box,
converted with the stage metersPerUnit.
rigid_body_count (int) by counting prims with UsdPhysicsRigidBodyAPI.
mass (kg) by summing authored physics:mass on prims with
UsdPhysicsMassAPI; reported as null (needs input) when none is authored.
qcode (Wikidata Q-Code) from the default (root) prim's authored Wikidata
semantics. Both encodings are read: the newer UsdSemantics
semantics:labels:<taxonomy> token array (taxonomy name containing qcode)
and the legacy multi-apply semantic:<instance>:params:semanticData with a
wikidata_qcode type. Reported under needs_input when the root prim has no
Q-Code semantic. Pass --set qcode=<Qxxxx> to override or supply one.
- Not derivable here (must be supplied, never invented):
author,
asset_name, asset_type, asset_license, category, source_file,
usd_date_generated. Pass them with repeated --set KEY=VALUE.
Typical usage:
# 1) Inspect what can be derived (no writes):
python assets/scripts/extract_simready_metadata.py <asset.usd> --dry-run
# 2) Stamp derived fields (incl. qcode from root-prim semantics) plus
# caller-supplied strings into a staged copy:
python assets/scripts/extract_simready_metadata.py <asset.usd> \
--output <staged/asset.usd> \
--set author=<author> --set asset_name=<name> \
--set asset_type=<type> --set asset_license=<license> \
--set category=<category> --set source_file=<source> \
--set usd_date_generated=<date>
# add --set qcode=<Qxxxx> only to override the derived value or when the
# asset carries no Wikidata Q-Code semantic.
The helper keeps existing metadata values unless --overwrite is passed, writes
a JSON/markdown report with --report/--markdown-report, and lists every field
still needing input under needs_input. Treat a null mass or a missing
asset_extents as a blocker to resolve (author UsdPhysicsMassAPI / fix
geometry, or supply the value) rather than stamping a fabricated number.
Mass Plausibility Check (advisory)
Beyond presence/type validation, the helper reports whether the authored mass
is physically plausible for the object. This is advisory only: it emits warnings
and a verdict, never a hard failure, because plausible mass depends on what the
asset represents in the real world.
Every run includes a mass_check block with per-body and aggregate solid volume
(computed from mesh geometry), and the implied density mass / volume. Two
signals:
- Deterministic (automatic): an implied density outside the physically
possible range (
1–23000 kg/m^3, i.e. lighter than any real solid or denser
than osmium) is flagged as a likely mass or unit error (for example mass
authored in grams, or a cm^3/m^3 mix-up). This needs no external knowledge.
- Agentic (recommended for the real-world judgement): decide a plausible mass
range for the object from its type and dimensions — and, when available, a
render or the source mesh — then pass it back so the report records the
comparison and rationale:
python assets/scripts/extract_simready_metadata.py <asset.usd> --dry-run \
--expected-mass-min <kg> --expected-mass-max <kg> \
--mass-rationale "office chair, mostly plastic + steel base, ~5-10 kg"
The verdict is plausible (inside the range), review (outside but within
~100x), or implausible (>=100x off, almost certainly an authoring/unit error).
Because this is a real-world judgement, a vision-capable agent should set the
expected range from visual/mesh evidence; if the agent cannot make that
judgement, report it as manual review rather than asserting the mass is correct.
Do not change the authored mass to satisfy this check — surface a warning and
let a human or the asset author correct the source value.
- Do not add schemas, metadata, or runtime behavior for a sibling runtime feature.
- Report missing runtime/tooling evidence as a validation limitation instead of claiming a pass.
Report Fields
| Field |
Meaning |
feature |
Exact feature ID and version, for example FET_033_STANDARD@0.4.0. |
input |
Source asset, package root, or package definition inspected. |
output |
Staged output path, or in-place only when explicitly requested. |
requirements_repaired |
Requirement IDs repaired in this pass. |
validation |
Command or inspection used to verify this exact feature. |
status |
passed, failed, skipped, or blocked. |
next_step |
The next exact feature skill or user/runtime evidence needed. |
1---2name: simready-foundation-conform-fet-033-standard3description: "Use for repairing exact FET_033_STANDARD Metadata conformance (thumbnail and provenance metadata). Use when a profile, validation report, or user request names FET_033_STANDARD; default to version `0.4.0` unless a profile or report pins another version."4license: Apache-2.05metadata:6 source: https://skillmd.com/skills/nvidia/simready-foundation-conform-fet-033-standard7 author: "Shaad Boochoon <sboochoon@nvidia.com>"8 tags:9 - simready10 - conformance11 - standard12---1314# SimReady Conform FET_033_STANDARD1516## Purpose1718Use this exact feature skill when the selected profile, validation report, or user request names `FET_033_STANDARD`. It repairs or stages Metadata conformance (thumbnail and nested provenance metadata) without drifting into another runtime contract.1920Default to `FET_033_STANDARD@0.4.0` when the user asks for this feature without a version. Use an older version only when the profile, validation report, or user explicitly pins it. If the report names a different `FET_###_RUNTIME` feature, switch to that feature's matching skill before editing.2122## Source of Truth2324Before changing an asset or package, read:2526- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.4.0.json` (latest)27- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.3.0.json` (preserved)28- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.2.0.json` (preserved)29- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD-0.1.0.json` (preserved)30- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_033_STANDARD.md`31- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/sim_ready/requirements/thumbnail-exist.md` (`SR.002`)32- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/sim_ready/requirements/nested-simready-metadata.md` (`SR.003`)33- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/sim_ready/requirements/metadata-union.md` (`SR.004`)3435Treat the selected JSON manifest as authoritative for dependencies and requirement IDs. Use the feature markdown for human-readable contract details, requirement links, samples, benchmarks, and adapters.3637## Feature Versions3839| Version | Dependencies | Requirements |40|---|---|---|41| `0.1.0` | FET_031_STANDARD@0.1.0 | `SR.002` |42| `0.2.0` | FET_031_STANDARD@0.1.0 | `SR.002`, `SR.003` (nested `SimReady_Metadata`) |43| `0.3.0` | FET_031_STANDARD@0.1.0 | `SR.002`, `SR.003` (stricter nested provenance fields) |44| `0.4.0` | FET_031_STANDARD@0.1.0 | `SR.002`, `SR.004` (same 0.3.0 fields; USD/sidecar union) |4546## Workflow47481. Confirm the input exists and identify the exact selected feature/version from the profile TOML, validation report, or user request.492. Load the selected `FET_033_STANDARD` manifest and the feature markdown before editing.503. Load requirement docs linked from the feature markdown for every reported failing requirement.514. Create or use a staged output location unless the user explicitly asks for in-place edits.525. Repair only the requirements listed by the selected `FET_033_STANDARD` manifest and its dependencies.536. Rerun the same profile gate or the narrowest available feature/capability validation gate. If runtime evidence is required and unavailable, report that limitation instead of claiming a pass.547. Summarize the selected `FET_033_STANDARD` version, changed files, validation evidence, and the first remaining blocker or next exact feature gate.5556## Feature Guidance5758- Repair only the requirements listed by the selected `FET_033_STANDARD` manifest and its dependencies.59- For `SR.002`, ensure a representative PNG thumbnail exists at `.thumbs/256x256/<asset_filename>.png` next to the root asset.60- For `SR.003` at `FET_033_STANDARD@0.2.0` / `@0.3.0`, the published feature contract places required fields inside root-layer `customLayerData.SimReady_Metadata`.61- For `SR.004` at `FET_033_STANDARD@0.4.0`, author required provenance fields in the USD/sidecar metadata union: `author`, `asset_name`, `asset_type`, `asset_license`, `category`, `source_file`, and `usd_date_generated`. Fields may live in root-layer `customLayerData` (optionally inside `SimReady_Metadata`), in `<usd_stem>.json` beside the root USD, or split across both. Neither location is required on its own, but a field must not be authored in both.62- For `SR.003` at version `0.3.0` and `SR.004` at version `0.4.0`, also author these required asset-descriptive fields (nested in `SimReady_Metadata` at `0.3.0`; in the USD/sidecar union at `0.4.0`):63 - `qcode` (string): Wikidata Q-Code for the asset's general category, a capital `Q` followed by one or more digits (for example `Q42177`).64 - `rigid_body_count` (int): non-negative count of rigid bodies in the asset.65 - `asset_extents` (float3): asset bounding-box size in meters as XYZ, with non-negative components.66 - `mass` (float): asset mass in kilograms, strictly positive.67- Do not author `SR.003` `0.3.0` / `SR.004` `0.4.0` descriptive fields with placeholder or fabricated physical values. Derive `rigid_body_count`, `asset_extents`, and `mass` from the actual asset (rigid-body prims, computed bounds, and authored mass); if a value cannot be derived, report it as a blocker instead of guessing.6869## How to Generate Metadata7071The `SR.003` / `SR.004` requirements are declarative (they check the end state in72nested `SimReady_Metadata` or the USD/sidecar union), so use the73bundled helper to populate provenance fields. The helper74only derives what the stage can prove and never fabricates values. You may75write the helper output into `customLayerData.SimReady_Metadata`, into76`<usd_stem>.json`, or split across both.7778Helper script: `assets/scripts/extract_simready_metadata.py` (run with a USD-core79Python; the same interpreter used to run SimReady validation works).8081- Derived deterministically from the stage:82 - `asset_extents` (float3, meters) from the default prim's world bounding box,83 converted with the stage `metersPerUnit`.84 - `rigid_body_count` (int) by counting prims with `UsdPhysicsRigidBodyAPI`.85 - `mass` (kg) by summing authored `physics:mass` on prims with86 `UsdPhysicsMassAPI`; reported as `null` (needs input) when none is authored.87 - `qcode` (Wikidata Q-Code) from the default (root) prim's authored Wikidata88 semantics. Both encodings are read: the newer `UsdSemantics`89 `semantics:labels:<taxonomy>` token array (taxonomy name containing `qcode`)90 and the legacy multi-apply `semantic:<instance>:params:semanticData` with a91 `wikidata_qcode` type. Reported under `needs_input` when the root prim has no92 Q-Code semantic. Pass `--set qcode=<Qxxxx>` to override or supply one.93- Not derivable here (must be supplied, never invented): `author`,94 `asset_name`, `asset_type`, `asset_license`, `category`, `source_file`,95 `usd_date_generated`. Pass them with repeated `--set KEY=VALUE`.9697Typical usage:9899```bash100# 1) Inspect what can be derived (no writes):101python assets/scripts/extract_simready_metadata.py <asset.usd> --dry-run102103# 2) Stamp derived fields (incl. qcode from root-prim semantics) plus104# caller-supplied strings into a staged copy:105python assets/scripts/extract_simready_metadata.py <asset.usd> \106 --output <staged/asset.usd> \107 --set author=<author> --set asset_name=<name> \108 --set asset_type=<type> --set asset_license=<license> \109 --set category=<category> --set source_file=<source> \110 --set usd_date_generated=<date>111 # add --set qcode=<Qxxxx> only to override the derived value or when the112 # asset carries no Wikidata Q-Code semantic.113```114115The helper keeps existing metadata values unless `--overwrite` is passed, writes116a JSON/markdown report with `--report`/`--markdown-report`, and lists every field117still needing input under `needs_input`. Treat a `null` `mass` or a missing118`asset_extents` as a blocker to resolve (author `UsdPhysicsMassAPI` / fix119geometry, or supply the value) rather than stamping a fabricated number.120121## Mass Plausibility Check (advisory)122123Beyond presence/type validation, the helper reports whether the authored `mass`124is physically plausible for the object. This is advisory only: it emits warnings125and a verdict, never a hard failure, because plausible mass depends on what the126asset represents in the real world.127128Every run includes a `mass_check` block with per-body and aggregate solid volume129(computed from mesh geometry), and the implied density `mass / volume`. Two130signals:131132- **Deterministic (automatic):** an implied density outside the physically133 possible range (`1`–`23000` kg/m^3, i.e. lighter than any real solid or denser134 than osmium) is flagged as a likely mass or unit error (for example mass135 authored in grams, or a cm^3/m^3 mix-up). This needs no external knowledge.136- **Agentic (recommended for the real-world judgement):** decide a plausible mass137 range for the object from its type and dimensions — and, when available, a138 render or the source mesh — then pass it back so the report records the139 comparison and rationale:140141```bash142python assets/scripts/extract_simready_metadata.py <asset.usd> --dry-run \143 --expected-mass-min <kg> --expected-mass-max <kg> \144 --mass-rationale "office chair, mostly plastic + steel base, ~5-10 kg"145```146147The `verdict` is `plausible` (inside the range), `review` (outside but within148~100x), or `implausible` (>=100x off, almost certainly an authoring/unit error).149Because this is a real-world judgement, a vision-capable agent should set the150expected range from visual/mesh evidence; if the agent cannot make that151judgement, report it as manual review rather than asserting the mass is correct.152Do not change the authored `mass` to satisfy this check — surface a warning and153let a human or the asset author correct the source value.154- Do not add schemas, metadata, or runtime behavior for a sibling runtime feature.155- Report missing runtime/tooling evidence as a validation limitation instead of claiming a pass.156157## Report Fields158159| Field | Meaning |160|---|---|161| `feature` | Exact feature ID and version, for example `FET_033_STANDARD@0.4.0`. |162| `input` | Source asset, package root, or package definition inspected. |163| `output` | Staged output path, or `in-place` only when explicitly requested. |164| `requirements_repaired` | Requirement IDs repaired in this pass. |165| `validation` | Command or inspection used to verify this exact feature. |166| `status` | `passed`, `failed`, `skipped`, or `blocked`. |167| `next_step` | The next exact feature skill or user/runtime evidence needed. |