spectral op• Data kinds: none → matrix (an op determined by its arguments alone — it takes no image or data input)
• Call: import fullseye as fs; fs.ledger.hyperspectral_band_weights(wavelengths_nm=None, band_centers_nm=(950.0, 960.0, 970.0, 980.0, 990.0, 1000.0, 1010.0, 1020.0, 1030.0, 1040.0, 1050.0, 1060.0, 1070.0, 1080.0, 1090.0, 1100.0, 1110.0, 1120.0, 1130.0, 1140.0, 1150.0, 1160.0, 1170.0, 1180.0, 1190.0, 1200.0, 1210.0, 1220.0, 1230.0, 1240.0, 1250.0, 1260.0, 1270.0, 1280.0, 1290.0, 1300.0, 1310.0, 1320.0, 1330.0, 1340.0, 1350.0, 1360.0, 1370.0, 1380.0, 1390.0, 1400.0, 1410.0, 1420.0, 1430.0, 1440.0, 1450.0, 1460.0, 1470.0, 1480.0, 1490.0, 1500.0, 1510.0, 1520.0, 1530.0, 1540.0, 1550.0, 1560.0, 1570.0, 1580.0, 1590.0, 1600.0, 1610.0, 1620.0, 1630.0, 1640.0, 1650.0), band_fwhm_nm=10.0, source_temperature_k=3000.0, irradiance_w_m2=10000.0, f_number=2.0, pixel_um=25.0, exposure_s=0.001, optics_material='SILICA', optics_thickness_mm=None, qe_cutoff_nm=1700.0) (to call the implementation directly, import spectralrad; spectralrad.hyperspectral_band_weights(wavelengths_nm=None, band_centers_nm=(950.0, 960.0, 970.0, 980.0, 990.0, 1000.0, 1010.0, 1020.0, 1030.0, 1040.0, 1050.0, 1060.0, 1070.0, 1080.0, 1090.0, 1100.0, 1110.0, 1120.0, 1130.0, 1140.0, 1150.0, 1160.0, 1170.0, 1180.0, 1190.0, 1200.0, 1210.0, 1220.0, 1230.0, 1240.0, 1250.0, 1260.0, 1270.0, 1280.0, 1290.0, 1300.0, 1310.0, 1320.0, 1330.0, 1340.0, 1350.0, 1360.0, 1370.0, 1380.0, 1390.0, 1400.0, 1410.0, 1420.0, 1430.0, 1440.0, 1450.0, 1460.0, 1470.0, 1480.0, 1490.0, 1500.0, 1510.0, 1520.0, 1530.0, 1540.0, 1550.0, 1560.0, 1570.0, 1580.0, 1590.0, 1600.0, 1610.0, 1620.0, 1630.0, 1640.0, 1650.0), band_fwhm_nm=10.0, source_temperature_k=3000.0, irradiance_w_m2=10000.0, f_number=2.0, pixel_um=25.0, exposure_s=0.001, optics_material='SILICA', optics_thickness_mm=None, qe_cutoff_nm=1700.0); from the registry, opsoptics.get("hyperspectral_band_weights"))
Linear map W (B × L) from reflectance to electrons per band; electrons = W @ R(λ) (before noise).
> The detailed description below is the original text — the summary and the headings are translated.
鎖: ハロゲン(黒体 *source_temperature_k*、ベルト面の 900〜2500 nm の放射照度を *irradiance_w_m2* に合わせる)→ Lambert 面の放射輝度 L = E R/π → レンズ(F 値 *f_number*、像面照度 π L T/(4N²)、物体は遠方)→ ガラスの内部透過率(materials.material_transmittance、*optics_material* の厚さ *optics_thickness_mm*(None = 表面反射だけ)—— 光学系も観察対象と同じ材料表を引く)→ 分光の帯域(Gauss、半値全幅 *band_fwhm_nm*)→ 光子数(λ/hc)→ InGaAs の QE (ingaas_photodiode_qe、*qe_cutoff_nm*)× 画素面積 × 露光時間。
返り値: (B, L) の ndarray。*wavelengths_nm* は反射率の波長格子(nm、昇順、各帯の ±3σ を覆うこと。None なら 900〜2500 nm を 5 nm おき = spectral_reflectance_from_material の既定の格子)。
Every optics op validates its input before computing (nothing slips through silently):
• Units are baked into the argument name — _mm / _um / _deg / _mrad. Confusing mm with µm does not crash; it yields a plausible-looking wrong answer, so the name prevents it. Nothing here guesses the unit from the magnitude.
• Strings raise ValueError — float('50') succeeds, so an unparsed configuration value would slip through as a length (measured: thin_lens('50', '200') returned a plausible 66.667 mm). bool is refused too, as the implicit promotion True == 1.
• complex / masked arrays raise ValueError (real-valued slots only; silently dropping the imaginary part or peeling off the mask is refused). NaN/Inf raises ValueError on every input.
• Division by zero and its relatives are refused by name: focal length 0, radius of curvature 0, refractive index <= 0, a fully opaque aperture (all zeros, so the normalisation is 0/0), a PSF whose sum is <= 0, a Stokes vector with S0 = 0, and an object sitting at the front focal point (the image is at infinity).
• Only two ops return a non-finite value, and both state it as a contract: depth_of_field returns far_mm = inf beyond the hyperfocal distance (that is what the hyperfocal distance means), and gaussian_beam returns wavefront_radius_mm = inf at the waist (the radius of curvature of a plane wavefront). Both also return a finite companion (far_is_infinite / curvature_per_mm). Any other silent NaN/Inf is detected internally and raises ValueError — "float64 overflowed" and "the answer is infinite" are different claims, so the first is never returned wearing the face of the second.
• Size caps: generated grids are capped by optics.MAX_GRID (4096); supplied fields/PSFs/apertures by optics.MAX_FIELD_ELEMENTS (2^24); ABCD element chains by optics.MAX_SYSTEM_ELEMENTS (1024); Zernike by MAX_ZERNIKE_TERMS (512) / MAX_ZERNIKE_ORDER (40) / MAX_ZERNIKE_BASIS (2^25). This closes, fail-closed, the paths where a small argument triggers a huge internal allocation (measured: n_max=40 × 4096² needs 108 GB).
• Physically impossible states are refused too: a Stokes vector with degree of polarisation > 1, negative transmittance, negative intensity, and invalid Zernike indices such as n-|m| odd.
• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).
• Operator provenance and references — the sources of the research/methods this op family came from.
• The canonical algorithm (author, year) and its uses are named in the family usage guide above.
• poc_hyperspectral_foreign_matter — py -3.11 examples/poc_hyperspectral_foreign_matter.py
matrix as input)abcd_trace · emva_filter_distortion · mueller_apply · mueller_checks · pixel_shift_capture · pixel_shift_merge · pixel_shift_motion_mask · oct_from_spectra
spectral)blackbody_spectrum · cie_illuminant_a · led_spectrum · bandpass_spectrum · silicon_photodiode_qe · energy_to_photons · spectral_product · spectral_integral
*Provenance: spectralrad.py — OPTICS operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.