Focus-Chart Coverage

Audit focus-chart instrument coverage.

Description

A focus chart records lighting instruments and their intended focus.

A focus chart records lighting instruments and their intended focus. Instrument-label coverage identifies missing entries without evaluating focus quality.^[1]

Audit focus-chart instrument coverage.

When to use Focus-Chart Coverage

Use this tool to audit focus-chart instrument coverage.

Prepare production measurements or checklist records for one planning period. Confirm units, staffing assumptions and caller-selected criteria before running the calculation.

How to use Focus-Chart Coverage and understand its results

Prepare production measurements or checklist records for one planning period. Confirm units, staffing assumptions and caller-selected criteria before running the calculation.
Enter requiredInstruments, documentedInstruments using the field table and calculation rules, then run the tool.
Read coveragePercent, matched, missing, unexpected. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
requiredInstruments	Required focus-chart instruments	list of string	Required
documentedInstruments	Documented instruments	list of string	Required

Enter requiredInstruments and documentedInstruments label lists. Trim labels, reject blank entries and match case-insensitively with en-US lowercase. Deduplicate each list, requiring at least one distinct required item; an empty observed list is allowed. Return matched, missing, unexpected labels and coverage. Duplicate normalized labels keep their last trimmed spelling at the first key position.

coverage%=100 matchedDistinctRequirements/distinctRequirements

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
coveragePercent	Coverage (%)	number; minimum: 0; maximum: 100
matched	Matched items	list of string
missing	Missing items	list of string
unexpected	Unexpected items	list of string

json

{
  "input": {
    "requiredInstruments": [
      "alpha",
      "beta",
      "gamma",
      "delta"
    ],
    "documentedInstruments": [
      "beta",
      "alpha",
      "extra"
    ]
  },
  "output": {
    "coveragePercent": 50,
    "matched": [
      "alpha",
      "beta"
    ],
    "missing": [
      "gamma",
      "delta"
    ],
    "unexpected": [
      "extra"
    ]
  }
}

Limitations and assumptions

It does not inspect beam geometry, physical focus or chart measurements. Spelling differences beyond case and outer whitespace remain distinct.

Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Magic-Sheet Coverage: Audit magic-sheet lighting-channel coverage. For a complementary task, use Projection Pixel Density: Calculate linear and angular pixel density for a projected image.

References

Focus-Chart Coverage — tool.io

Similar or alternative tools

Magic-Sheet Coverage
Audit magic-sheet lighting-channel coverage.
Projection Pixel Density
Calculate linear and angular pixel density for a projected image.