#lighting

Matemáticas de fotometría e iluminación como API, calculadas local y determinísticamente. El endpoint de iluminancia calcula la luz que incide sobre una superficie desde una fuente puntual, E = I·cos(θ)/d² en lux, a partir de la intensidad luminosa en candelas, la distancia en metros y el ángulo de incidencia desde la normal de la superficie — una fuente de 1000 cd directamente hacia abajo a 2 m da 250 lux. El endpoint de inverso del cuadrado escala una iluminancia conocida a una nueva distancia, E2 = E1·(d1/d2)², por lo que duplicar la distancia reduce la luz a la cuarta parte. El endpoint de flujo-intensidad convierte entre flujo luminoso en lúmenes e intensidad luminosa en candelas a través del ángulo sólido, I = Φ/Ω y Φ = I·Ω, con el ángulo sólido tomado como la esfera completa de 4π estereorradianes para una fuente isotrópica o, para un foco con ángulo de haz completo β, Ω = 2π·(1 − cos(β/2)) — así, una fuente isotrópica de 100 cd emite aproximadamente 1256.6 lm, y una lámpara de 1000 cd en un haz de 30° emite aproximadamente 214 lm. Las distancias están en metros y los ángulos en grados. Todo se calcula local y determinísticamente, por lo que es instantáneo y privado. Ideal para desarrolladores de aplicaciones de diseño de iluminación, arquitectura, fotografía, cine, luces de cultivo hortícola, escenario y AV, herramientas de planificación de lux y lúmenes y luminarias, y software de ingeniería. Cálculo local puro — sin clave, sin servicio de terceros, instantáneo. En vivo, nada se almacena. 3 endpoints. Estas son cantidades fotométricas (luz percibida); para radiometría de cuerpo negro/longitud de onda pico, use una API de Wien/radiación.

api.oanor.com/photometry-api

Matemáticas de diseño de iluminación como API, calculadas local y determinísticamente. El endpoint de sala calcula cuántos lúmenes necesita una sala a partir de su área y una iluminancia objetivo — dada directamente en lux o seleccionada de un preset de tipo de sala (sala de estar, cocina, oficina, taller y más) — y, opcionalmente, cuántos artefactos con una salida de lúmenes determinada y cuántos vatios con un tipo de lámpara determinado. El endpoint de lux convierte entre lux, bujías-pie y lúmenes sobre un área, para que puedas encontrar la iluminancia a partir de una salida de luz y un tamaño de sala o viceversa. El endpoint de eficacia relaciona lúmenes, vatios y eficacia luminosa (lúmenes por vatio): proporciona dos — o un preset de tipo de lámpara como incandescente, halógena, CFL o LED — y calcula el tercero. Todo se calcula local y determinísticamente, por lo que es instantáneo y privado. Es una estimación del método de lúmenes: los niveles objetivo son guías típicas (EN 12464 / IES) y un diseño completo agregaría factores de sala y utilización. Ideal para herramientas de iluminación y eléctricas, aplicaciones de diseño de interiores y hogar, calculadoras de retiro y ahorro de energía, y planificación de hogar inteligente. Cálculo local puro — sin clave, sin servicio de terceros, instantáneo. En vivo, nada almacenado. 3 endpoints. Esto es matemáticas de iluminación; para cantidades eléctricas de la ley de Ohm, usa una API de electrónica.

api.oanor.com/lighting-api

Convierte luz física en colores RGB — completamente local. El endpoint kelvin convierte una temperatura de color en Kelvin al color RGB de un cuerpo negro a esa temperatura: tonos cálidos de vela e incandescentes por debajo de 3000 K, blancos neutros y de luz diurna alrededor de 5000–6500 K, y luz azulada fría por encima, utilizando la aproximación ampliamente usada de Tanner Helland y devolviendo hex, una cadena rgb() y una descripción en inglés sencillo (luz de vela, blanco cálido, neutro, luz diurna, frío). El endpoint wavelength convierte una longitud de onda de luz visible en nanómetros (380–780 nm) al color RGB aproximado que percibe el ojo humano, con la caída natural de intensidad en los bordes violeta y rojo del espectro, y nombra la banda (violeta, azul, cian, verde, amarillo, naranja, rojo). Todo se calcula local y determinísticamente, por lo que es instantáneo y privado. Ideal para aplicaciones de iluminación y bombillas inteligentes, herramientas de fotografía y balance de blancos, visualización de datos de temperatura o espectros, temas y acentos de interfaz, y ciencia y educación. Cálculo local puro — sin clave, sin servicio de terceros, instantáneo. En vivo, nada almacenado. 3 endpoints. Estas son aproximaciones perceptuales, no conversiones colorimétricas CIE; para conversión hex/RGB/HSL y paletas use una API de color.

api.oanor.com/colortemp-api