product-light.schema.json¶

This schema validates one product in products[] in the Lens Light dataset. It uses the same top-level block names as the Full dataset and retains only the fields needed by the existing web display.

Generation rules from Full¶

Light does not add values of its own or calculate new ranges or representative values. The JSON Schema validates the structures permitted in Light. hatch run validate also checks the relationship to Full.

Full and Light examples¶

The following example uses lens.aperture from the NIKKOR Z 24-70mm f/2.8 S II to show how Light reduces the structure while preserving the same values. Each code block is actual data containing only lens.aperture from the corresponding product.

{
  "fNumber": {
    "maximumAperture": [
      {
        "value": 2.8,
        "conditions": {}
      }
    ],
    "minimumAperture": [
      {
        "value": 22,
        "conditions": {}
      }
    ],
    "effective": null
  },
  "diaphragm": {
    "present": true,
    "bladeCount": 11,
    "bladeShape": "rounded"
  },
  "controlMechanism": "electronic"
}

{
  "fNumber": {
    "maximumAperture": [
      {
        "value": 2.8,
        "conditions": {}
      }
    ]
  }
}

Light retains the maximum aperture of 2.8 and its measurement conditions unchanged, while omitting the minimum aperture, diaphragm mechanism, and control mechanism.

Top-level fields¶

All seven common fields from id through physical are required. In addition, the product contains exactly one lens, teleconverter, or pinhole block matching productType; the other two blocks are not permitted.

Retained common fields¶

All three fields directly under identity are required, and every officialProductPages[] entry requires url. All three fields directly under physical are also required. When dimensionMeasurements or weightMeasurements is an array, it must contain at least one entry. A filter interface contains only the size field selected by type. When sheetDimensionsMm for rear-gelatin is an object, both width and height are required.

Lens¶

The lens block retains an overview of the optical system and the presence information used by the web display. The lens block requires focalLength, aperture, coverage, focus, stabilization, and specialized. Within aperture, fNumber is required. An object-valued fNumber and any present tNumber require maximumAperture. Each array-valued maximumAperture, minimumFocusDistances, or reproductionMagnifications must contain at least one entry. The focus block requires autofocus, manualFocus, minimumFocusDistances, and reproductionMagnifications. When autofocus, manualFocus, or stabilization is an object, present is required.

Teleconverter¶

All five fields in teleconverter are required. When compatibleLensIds is an array, it must contain at least one ID and cannot contain duplicates.

Pinhole¶

All three fields in pinhole are required. When imagingModes is an array, it must contain at least one entry.

The Light pinhole specifications do not retain pinhole.anglesOfView from Full.

Related pages¶

• product-full: corresponding product structure in Full
• dataset-light: Light distribution metadata
• Lens and related optical product field reference: comparison of actual Full and Light data

JSON Schema file