diff --git a/deploy/lightsources.json b/deploy/lightsources.json index 48a3a66..cc35a16 100644 --- a/deploy/lightsources.json +++ b/deploy/lightsources.json @@ -5,6 +5,22 @@ "temperature": 5600, "temperatureRange": [2500, 7500], "intensity": 19389, + "variants": [ + { + "format": "Bare Bulb", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 90, + "intensity": 17244 + }, + { + "format": "Hyper Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 65, + "intensity": 26155 + } + ], "unit": ["lm"], "angle": 90, "type": ["spot"], @@ -235,7 +251,7 @@ "color": [1.0, 0.571, 0.259], "temperature": 3500, "intensity": 1500, - "intensityRange": [700, 2000], + "intensityRange": [1000, 2000], "unit": ["lm"], "type": ["spot"], "category": ["Artificial"], @@ -250,7 +266,7 @@ "color": [1.0, 0.943, 0.992], "temperature": 6500, "intensity": 200, - "intensityRange": [100, 2000], + "intensityRange": [100, 2500], "unit": ["cd/m2"], "sourceSize": [61, 38], "type": ["surface"], @@ -268,13 +284,29 @@ "color": [1, 1, 1], "temperature": 0, "intensity": 0.0006, + "variants": [ + { + "format": "Green", + "color": [0, 1, 0], + "intensity": 0.0006 + }, + { + "format": "Yellow", + "color": [1.0, 0.5, 0], + "intensity": 0.0006 + }, + { + "format": "Red", + "color": [1.0, 0, 0], + "intensity": 0.0006 + } + ], "unit": ["lm"], "sourceSize": [0.25], "type": ["point"], "category": ["Natural"], "description": "Fireflies produce a \"cold light\", with no infrared or ultraviolet frequencies. The light may be yellow, green, or pale red, with wavelengths from 510 to 670 nanometers. Some species such as the dimly glowing \"blue ghost\" of the Eastern US may seem to emit blueish-white light from a distance and in low light conditions, but their glow is bright green when observed up close. Their perceived blue tint may be due to the Purkinje effect.", "sources": [ - "https://what-if.xkcd.com/151/", "https://www.nature.com/articles/s41598-021-91839-3", "https://en.wikipedia.org/wiki/Firefly" ], @@ -286,6 +318,23 @@ "temperature": 5000, "intensity": 1000, "intensityRange": [500, 5000], + "variants": [ + { + "format": "2700 K", + "color": [1.0, 0.415, 0.099], + "temperature": 2700 + }, + { + "format": "4000 K", + "color": [1.0, 0.654, 0.377], + "temperature": 4000 + }, + { + "format": "6500 K", + "color": [1.0, 0.943, 0.992], + "temperature": 2700 + } + ], "unit": ["lm"], "sourceSize": [60, 1.5], "type": ["cylinder"], @@ -359,7 +408,6 @@ "https://en.wikipedia.org/wiki/Purkinje_effect", "https://chrisbrejon.com/cg-cinematography/chapter-4-light-categories/#moon", "https://iopscience.iop.org/article/10.1088/0031-9120/48/3/360", - "https://web.archive.org/web/20151005215129/http://www.cast-lighting.com/search/1/display-document/71", "https://www.physics.unlv.edu/~jeffery/astro/moon/sun_moon_angular.html" ] }, @@ -372,8 +420,7 @@ "type": ["spot"], "category": ["Artificial"], "description": "", - "sources": ["https://en.wikipedia.org/wiki/Flash_(photography)"], - "tags": ["camera"] + "sources": ["https://en.wikipedia.org/wiki/Flash_(photography)"] }, { "name": "Sky (Clear)", @@ -388,7 +435,7 @@ "https://github.com/AntonPalmqvist/physically-based-api/tree/main/data/lightsources/sky-clear/", "https://en.wikipedia.org/wiki/Color_temperature", "https://en.wikipedia.org/wiki/Daylight", - "http://web.archive.org/web/20120807211236/http://www.npl.co.uk/upload/pdf/npl_summary_report_best_blue_sky_2006.pdf" + "http://eprintspublications.npl.co.uk/3518/" ] }, { @@ -425,8 +472,8 @@ }, { "name": "Sky (Moonless Clear Night)", - "color": [1, 1, 1], - "temperature": 0, + "color": [1.0, 0.943, 0.992], + "temperature": 6500, "intensity": 0.002, "unit": ["lx"], "type": ["dome"], diff --git a/deploy/openapi-schema-v2.yaml b/deploy/openapi-schema-v2.yaml index ffc7b9b..3626dd0 100644 --- a/deploy/openapi-schema-v2.yaml +++ b/deploy/openapi-schema-v2.yaml @@ -93,9 +93,9 @@ paths: servers: - url: 'https://api.physicallybased.info/v2' tags: - - name: Cameras - - name: Light Sources - name: Materials + - name: Light Sources + - name: Cameras - name: Lenses components: schemas: @@ -211,7 +211,7 @@ components: $ref: '#/components/schemas/tags' references: type: array - description: List of references. At least one reference needed. + description: List of references. At least one reference required. minItems: 1 uniqueItems: true items: @@ -361,6 +361,43 @@ components: maxItems: 2 items: type: number + variants: + type: array + description: 'If the light source comes in different variations, they can be described here.' + minItems: 1 + uniqueItems: true + items: + type: object + additionalProperties: false + properties: + format: + type: string + description: Specifies the format. + color: + $ref: '#/components/schemas/color' + description: Color of the light source. + temperature: + type: number + description: 'Color temperature in Kelvin, if color lies on the Planckian curve.' + default: 6500 + intensity: + type: number + description: Intensity of the light emitted from the light source. + angle: + type: number + description: 'The maximum beam angle in degrees. For a directional light, this specifies angular diameter instead.' + default: 90 + sourceSize: + type: array + description: 'The size of the light source in centimeters. [Radius] if point or spot. [Width, Height] if surface. [Length, Radius] if cylinder.' + minItems: 1 + maxItems: 2 + items: + type: number + required: + - format + - color + - intensity type: type: array description: 'The type of light, for DCC applications.' @@ -386,16 +423,21 @@ components: - Natural description: $ref: '#/components/schemas/description' - sources: - $ref: '#/components/schemas/sources' tags: $ref: '#/components/schemas/tags' + references: + type: array + description: List of references. At least one reference required. + minItems: 1 + uniqueItems: true + items: + $ref: '#/components/schemas/reference' required: - name - intensity - unit - category - - sources + - references examples: - name: Household Light Bulb color: @@ -423,15 +465,6 @@ components: tags: - incandescent - tungsten - sources: - type: array - title: sources - description: Provide at least one source for the values. - minItems: 1 - uniqueItems: true - items: - type: string - format: uri Camera: type: object title: Camera @@ -488,16 +521,20 @@ components: - Mobile description: $ref: '#/components/schemas/description' - sources: - $ref: '#/components/schemas/sources' - description: Provide at least one source for the values. Source link to official manufacturer website is preferred. tags: $ref: '#/components/schemas/tags' + references: + type: array + description: List of references. At least one reference required. + minItems: 1 + uniqueItems: true + items: + $ref: '#/components/schemas/reference' required: - name - sensorSize - category - - sources + - references examples: - name: Arri Alexa 35 sensorSize: @@ -645,14 +682,18 @@ components: description: Shortest distance from the sensor to the subject that the lens can achieve focus. Specified in centimeters. description: $ref: '#/components/schemas/description' - sources: - $ref: '#/components/schemas/sources' - description: Provide at least one source for the values. Source link to official manufacturer website is preferred. tags: $ref: '#/components/schemas/tags' + references: + type: array + description: List of references. At least one reference required. + minItems: 1 + uniqueItems: true + items: + $ref: '#/components/schemas/reference' required: - name - focalLength - aperture - blades - - sources + - references diff --git a/deploy/v2/lightsources.json b/deploy/v2/lightsources.json index 0ec63ea..1c9cc56 100644 --- a/deploy/v2/lightsources.json +++ b/deploy/v2/lightsources.json @@ -1,22 +1,44 @@ [ { "name": "Aputure amaran 300c", - "color": [1.0, 0.859, 0.778], "temperature": [2500, 7500], - "intensity": [19389, 19389], + "variants": [ + { + "format": "Bare Bulb", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 90, + "intensity": 17244 + }, + { + "format": "Hyper Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 65, + "intensity": 26155 + } + ], "unit": ["lm"], - "angle": 90, "type": ["spot"], "category": ["Artificial"], - "description": "", - "sources": [ - "https://www.aputure.com/products/amaran-300c/#specifications", - "https://docs.aputure.com/hubfs/Knowledge%20Base/amaran/150c-300c/All%20Files/amaran%20300c%20Product%20Manual%20.pdf?_gl=1*53mffx*_gcl_au*MTAzNTY3Nzg5Ny4xNzAzNzk4MTc1" + "references": [ + { + "title": "Aputure amaran 300c Product Page", + "publisher": "Aputure Inc.", + "url": "https://www.aputure.com/products/amaran-300c/#specifications", + "accessed": "2025-02-22" + }, + { + "title": "amaran 300c Product Manual", + "publisher": "Aputure Inc.", + "url": "https://docs.aputure.com/hubfs/Knowledge%20Base/amaran/150c-300c/All%20Files/amaran%20300c%20Product%20Manual%20.pdf?_gl=1*53mffx*_gcl_au*MTAzNTY3Nzg5Ny4xNzAzNzk4MTc1", + "accessed": "2025-02-22" + } ] }, { "name": "Aputure amaran P60c", - "color": [1.0, 0.859, 0.778], + "color": [0.828, 0.841, 1.0], "temperature": [2500, 7500], "intensity": [3000, 3000], "unit": ["lm"], @@ -24,32 +46,240 @@ "sourceSize": [27, 21], "type": ["surface"], "category": ["Artificial"], - "description": "", - "sources": [ - "https://www.aputure.com/products/amaran-p60c/#specifications", - "https://docs.aputure.com/hubfs/Knowledge%20Base/amaran/p60x%20and%20p60c/All%20files/amaran-P60c-Product-Manual-EN_211211-.pdf" + "references": [ + { + "title": "Aputure amaran P60c Photometrics & Technical Specifications", + "publisher": "Aputure Inc.", + "url": "https://help.aputure.com/en/amaran-p60c-p60x/photometrics-and-technical-specifications", + "accessed": "2025-02-22" + }, + { + "title": "amaran P60c Product Manual", + "publisher": "Aputure Inc.", + "url": "https://docs.aputure.com/hubfs/Knowledge%20Base/amaran/p60x%20and%20p60c/All%20files/amaran-P60c-Product-Manual-EN_211211-.pdf", + "accessed": "2025-02-22" + } ] }, { - "name": "Arri SkyPanel X", + "name": "Aputure STORM 1000c", "color": [1.0, 0.859, 0.778], + "temperature": [1800, 20000], + "variants": [ + { + "format": "No Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 65, + "intensity": 61250 + }, + { + "format": "15º Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 15, + "intensity": 600000 + }, + { + "format": "30º Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 30, + "intensity": 250000 + }, + { + "format": "45º Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 45, + "intensity": 125000 + } + ], + "unit": ["lx"], + "type": ["spot"], + "category": ["Artificial"], + "references": [ + { + "title": "Aputure STORM 1000c Product Page", + "publisher": "Aputure Inc.", + "url": "https://aputure.com/products/storm-1000c", + "accessed": "2025-02-22" + }, + { + "title": "Aputure STORM 1000c Product Manual", + "publisher": "Aputure Inc.", + "url": "https://docs.aputure.com/hubfs/Knowledge%20Base/Aputure/STORM%201000c/Manuals/Aputure%20-%20STORM%201000C%20Manual%20-%20EN%20-%20V1.0.pdf", + "accessed": "2025-02-22" + } + ] + }, + { + "name": "Aputure STORM 1200x", + "color": [1.0, 0.859, 0.778], + "temperature": [2500, 10000], + "variants": [ + { + "format": "No Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 70, + "intensity": 76400 + }, + { + "format": "15º Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 15, + "intensity": 864900 + }, + { + "format": "30º Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 30, + "intensity": 376200 + }, + { + "format": "45º Reflector", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 45, + "intensity": 202500 + } + ], + "unit": ["lx"], + "type": ["spot"], + "category": ["Artificial"], + "references": [ + { + "title": "Aputure STORM 1200x Product Page", + "publisher": "Aputure Inc.", + "url": "https://aputure.com/EN-US/products/storm-1200x", + "accessed": "2025-02-22" + }, + { + "title": "Aputure STORM 1200x Feature Sheet", + "publisher": "Aputure Inc.", + "url": "https://24055135.fs1.hubspotusercontent-na1.net/hubfs/24055135/Aputure_Storm_1200x_One_Sheet_2024-09-09a.pdf", + "accessed": "2025-02-22" + } + ] + }, + { + "name": "Arri M-Series M8", + "color": [1.0, 0.899, 0.875], + "temperature": [6000, 6000], + "variants": [ + { + "format": "Flood", + "angle": 60, + "intensity": 41300 + }, + { + "format": "Medium", + "angle": 40, + "intensity": 76100 + }, + { + "format": "Spot", + "angle": 15, + "intensity": 405000 + } + ], + "sourceSize": [100], + "unit": ["lx"], + "type": ["spot"], + "category": ["Artificial"], + "references": [ + { + "title": "ARRI M8 Product Page", + "publisher": "ARRI GmbH.", + "url": "https://www.arri.com/en/lighting/daylight/m-series/m8", + "accessed": "2025-02-22" + }, + { + "title": "ARRI M8 Data Sheet", + "publisher": "ARRI GmbH.", + "url": "https://www.arri.com/resource/blob/31482/8764688fa9ce88b33bf3f4f48e2fb52a/arri-m-series-m8-data-sheet-en-sep2018-data.pdf", + "accessed": "2025-02-22" + } + ] + }, + { + "name": "Arri SkyPanel S60 Pro", + "color": [1.0, 0.859, 0.778], + "temperature": [2800, 10000], + "intensity": [41100, 41100], + "sourceSize": [64.5, 30.0], + "angle": 103, + "unit": ["lm"], + "type": ["surface"], + "category": ["Artificial"], + "references": [ + { + "title": "ARRI SkyPanel S60 Pro Tech Data", + "publisher": "ARRI GmbH.", + "url": "https://www.arri.com/en/lighting/led-panel-lights/skypanel-pro/tech-data", + "accessed": "2025-02-22" + }, + { + "title": "ARRI SkyPanel S60 Pro Data Sheet", + "publisher": "ARRI GmbH.", + "url": "https://www.arri.com/resource/blob/384436/68055e513496ca273128f1741cc04f92/arri-s60-pro-data-sheet-en-data.pdf", + "accessed": "2025-02-22" + } + ] + }, + { + "name": "Arri SkyPanel X", "temperature": [1500, 20000], - "angle": 121, - "intensity": [51809, 51809], - "variants": { - "format": "Open-Face", - "color": [1.0, 0.859, 0.778], - "temperature": [1500, 20000], - "angle": 121, - "intensity": 51809 - }, + "variants": [ + { + "format": "Open-Face", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 121, + "intensity": 48000 + }, + { + "format": "Dome", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 107, + "intensity": 42700 + }, + { + "format": "S60 Adapter", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 101, + "intensity": 35400 + }, + { + "format": "HyPer Optic", + "color": [1.0, 0.859, 0.778], + "temperature": 5600, + "angle": 11, + "intensity": 22000 + } + ], + "sourceSize": [64.8, 30.3], "unit": ["lm"], "type": ["surface"], "category": ["Artificial"], - "description": "", - "sources": [ - "https://www.arri.com/en/lighting/led/skypanel/x-series/tech-data", - "https://www.arri.com/resource/blob/341262/e55242c6535912778f7f39d38f490c90/arri-skypanel-x-data-sheet-en-data.pdf" + "references": [ + { + "title": "Arri SkyPanel X Tech Data", + "publisher": "ARRI GmbH.", + "url": "https://www.arri.com/en/lighting/led-panel-lights/skypanel-x/tech-data", + "accessed": "2025-02-22" + }, + { + "title": "Arri SkyPanel X Data Sheet", + "publisher": "ARRI GmbH.", + "url": "https://www.arri.com/resource/blob/341262/e55242c6535912778f7f39d38f490c90/arri-skypanel-x-data-sheet-en-data.pdf", + "accessed": "2025-02-22" + } ] }, { @@ -61,72 +291,203 @@ "sourceSize": [1], "type": ["point"], "category": ["Natural"], - "description": "", - "sources": [ - "https://en.wikipedia.org/wiki/Candle#Characteristics", - "https://en.wikipedia.org/wiki/Color_temperature" + "references": [ + { + "title": "Candle", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Candle&oldid=1272665821#Characteristics", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Color Temperature", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Color_temperature&oldid=1272808359", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } ] }, { "name": "Car Headlight (Halogen)", "color": [1.0, 0.571, 0.259], - "temperature": [3500, 3500], - "intensity": [700, 2000], + "temperature": [3400, 4000], + "intensity": [1000, 2000], "unit": ["lm"], "type": ["spot"], "category": ["Artificial"], "description": "Tungsten-halogen bulbs, commonly just called halogen, are the most widely used bulbs in car headlights. High beam is approximately double the intensity of a low beam.", - "sources": [ - "https://www.bulbfacts.com/halogen-bulbs/chart/", - "https://en.wikipedia.org/wiki/Headlamp#Light_sources" + "references": [ + { + "title": "Lab Tested Halogen Bulbs Chart", + "url": "https://www.bulbfacts.com/halogen-bulbs/chart/", + "publisher": "Bulb Facts LLC.", + "accessed": "2025-02-27" + }, + { + "title": "Light Sources", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Headlamp&oldid=1274156171#Light_sources", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } + ] + }, + { + "name": "Car Headlight (LED)", + "color": [1.0, 0.571, 0.259], + "temperature": [5000, 6000], + "intensity": [2000, 5000], + "unit": ["lm"], + "type": ["spot"], + "category": ["Artificial"], + "references": [ + { + "title": "Lab Tested Aftermarket LED Kits Chart", + "url": "https://www.bulbfacts.com/led-kits/chart/", + "publisher": "Bulb Facts LLC.", + "accessed": "2025-02-27" + }, + { + "title": "Light Sources", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Headlamp&oldid=1274156171#Light_sources", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } ] }, { "name": "Digital Display", "color": [1.0, 0.943, 0.992], "temperature": [6500, 6500], - "intensity": [100, 2000], + "intensity": [100, 2500], "unit": ["cd/m2"], + "sourceSize": [61, 38], "type": ["surface"], "category": ["Artificial"], "description": "Displays like computer monitors, TVs, signage, etc. Typically they have a temperature of 6500K but it can vary. The sRGB spec for monitors targets 80 cd/m2. Typically, monitors calibrated for broadcast or studio color grading should have a brightness of 100 cd/m2 in Japan and in the United States, or 120 cd/m2 in the European Union. This is however considered quite dark for normal use, so consumer monitors tend to be brighter.", - "sources": [ - "https://www.digitalview.com/blog/lcd-panels-backlights-brightness/", - "https://en.wikipedia.org/wiki/Color_temperature", - "https://en.wikipedia.org/wiki/Candela_per_square_metre" + "references": [ + { + "title": "LCD Panels - Backlights & Brightness", + "url": "https://www.digitalview.com/blog/lcd-panels-backlights-brightness/", + "publisher": "Digital View ", + "accessed": "2025-02-27" + }, + { + "title": "Color temperature", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Color_temperature&oldid=1272808359", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Candela per square metre", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Candela_per_square_metre&oldid=1252119661", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } ], "tags": ["computer", "monitor", "lcd", "oled", "screen"] }, { "name": "Firefly", - "color": [1, 1, 1], - "temperature": [0, 0], "intensity": [0.0006, 0.0006], + "variants": [ + { + "format": "Green", + "color": [0, 1, 0], + "intensity": 0.0006 + }, + { + "format": "Yellow", + "color": [1.0, 0.5, 0], + "intensity": 0.0006 + }, + { + "format": "Red", + "color": [1.0, 0, 0], + "intensity": 0.0006 + } + ], "unit": ["lm"], "sourceSize": [0.25], "type": ["point"], "category": ["Natural"], "description": "Fireflies produce a \"cold light\", with no infrared or ultraviolet frequencies. The light may be yellow, green, or pale red, with wavelengths from 510 to 670 nanometers. Some species such as the dimly glowing \"blue ghost\" of the Eastern US may seem to emit blueish-white light from a distance and in low light conditions, but their glow is bright green when observed up close. Their perceived blue tint may be due to the Purkinje effect.", - "sources": [ - "https://what-if.xkcd.com/151/", - "https://www.nature.com/articles/s41598-021-91839-3", - "https://en.wikipedia.org/wiki/Firefly" + "references": [ + { + "title": "The Brightness of the Light of the West Indian Elaterid Beetle, Pyrophorus", + "author": "Harvey, E. N., & Stevens, K. P.", + "url": "https://rupress.org/jgp/article-abstract/12/2/269/11178/THE-BRIGHTNESS-OF-THE-LIGHT-OF-THE-WEST-INDIAN", + "publisher": "Journal of General Physiology", + "volume": "12", + "issue": "2", + "pages": "269--272", + "year": "1928", + "doi": "https://doi.org/10.1085/jgp.12.2.269" + }, + { + "title": "Light from a Firefly at Temperatures Considerably Higher and Lower than Normal", + "author": "Rabha, M. M., Sharma, U., & Barua, A. G.", + "url": "https://www.nature.com/articles/s41598-021-91839-3", + "publisher": "Scientific Reports", + "volume": "11", + "issue": "1", + "pages": "12498", + "year": "2021", + "doi": "https://doi.org/10.1038/s41598-021-91839-3" + }, + { + "title": "Firefly", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Firefly&oldid=1277382557", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } ], "tags": ["bioluminescence"] }, { "name": "Fluorescent Tube Light", - "color": [1.0, 0.792, 0.628], - "temperature": [5000, 5000], + "temperature": [2700, 6500], "intensity": [500, 5000], + "variants": [ + { + "format": "2700 K", + "color": [1.0, 0.415, 0.099], + "temperature": 2700 + }, + { + "format": "4000 K", + "color": [1.0, 0.654, 0.377], + "temperature": 4000 + }, + { + "format": "6500 K", + "color": [1.0, 0.943, 0.992], + "temperature": 2700 + } + ], "unit": ["lm"], "sourceSize": [60, 1.5], "type": ["cylinder"], "category": ["Artificial"], - "description": "", - "sources": [ - "https://en.wikipedia.org/wiki/Fluorescent_lamp", - "https://www.homedepot.com/b/Lighting-Light-Bulbs-Tube-Lights-Fluorescent-Tube-Lights/N-5yc1vZ2fkol29" + "references": [ + { + "title": "Fluorescent lamp", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Fluorescent_lamp&oldid=1273912390", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Fluorescent Tube Lights", + "url": "https://www.homedepot.com/b/Lighting-Light-Bulbs-Tube-Lights-Fluorescent-Tube-Lights/N-5yc1vZ2fkol29", + "publisher": "Home Depot", + "accessed": "2025-02-28" + } ] }, { @@ -137,10 +498,44 @@ "unit": ["lm"], "type": ["point"], "category": ["Natural"], - "description": "", - "sources": [ - "https://en.wikipedia.org/wiki/Kerosene_lamp#Performance", - "https://en.wikipedia.org/wiki/Color_temperature" + "references": [ + { + "title": "Color temperature", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Color_temperature&oldid=1272808359", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Kerosene lamp", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Kerosene_lamp&oldid=1274278708#Performance", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } + ] + }, + { + "name": "Kino Flo MIMIK 120", + "temperature": [2700, 6500], + "intensity": [10000, 10000], + "sourceSize": [120, 60], + "unit": ["cd/m2"], + "type": ["surface"], + "category": ["Artificial"], + "references": [ + { + "title": "Kino Flo MIMIK 120 Product Specifications", + "url": "https://kinoflo.com/mimik-120/#productspecs", + "publisher": "Kino Flo, Inc.", + "accessed": "2025-02-27" + }, + { + "title": "Kino Flo MIMIK 120 Cutsheet", + "url": "https://kinoflo.com/wp-content/uploads/2023/02/Mimik-120-Cutsheet.pdf", + "publisher": "Kino Flo, Inc.", + "accessed": "2025-02-27" + } ] }, { @@ -153,9 +548,21 @@ "type": ["point"], "category": ["Artificial"], "description": "Today's household lightbulbs has a LED light source whereas older light bulbs were using a glowing tungsten filament. LED:s are much much more energy efficient and makes the use of wattage, as a measure of intensity, not very useful. This is why lumen is preferred.", - "sources": [ - "https://en.wikipedia.org/wiki/Incandescent_light_bulb", - "https://en.wikipedia.org/wiki/LED_lamp" + "references": [ + { + "title": "Incandescent light bulb", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Incandescent_light_bulb&oldid=1277426941", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "LED lamp", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=LED_lamp&oldid=1269221959", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } ], "tags": ["incandescent", "tungsten"] }, @@ -165,18 +572,55 @@ "temperature": [4100, 4100], "intensity": [0.05, 0.32], "unit": ["lx"], - "angle": 0.53, + "angle": 0.5286, "type": ["directional"], "category": ["Natural"], "description": "Technically not a light source, since the light from the moon is simply reflected sunlight. Moonlight is warmer than sunlight due to the surface material of the moon shifting it towards a redder color. Just as sunlight, moonlight is also subject to atmospheric scattering known as Rayleigh scattering, where it goes more towards red during moonrise and moonset. Moonlight is often mistaken to be bluish due to the Purkinje effect.", - "sources": [ - "https://en.wikipedia.org/wiki/Moonlight", - "https://en.wikipedia.org/wiki/Moon", - "https://en.wikipedia.org/wiki/Purkinje_effect", - "https://chrisbrejon.com/cg-cinematography/chapter-4-light-categories/#moon", - "https://iopscience.iop.org/article/10.1088/0031-9120/48/3/360", - "https://web.archive.org/web/20151005215129/http://www.cast-lighting.com/search/1/display-document/71", - "https://www.physics.unlv.edu/~jeffery/astro/moon/sun_moon_angular.html" + "references": [ + { + "title": "Moonlight", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Moonlight&oldid=1276297475", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Moon", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Moon&oldid=1278171486", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Purkinje effect", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Purkinje_effect&oldid=1243343221", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "CG Cinematography - Chapter 4: Light Categories", + "author": "Brejon de Lavergnée, C.", + "url": "https://chrisbrejon.com/cg-cinematography/chapter-4-light-categories/#moon", + "accessed": "2025-02-27" + }, + { + "title": "By the Light of the Silvery Moon: Fact and Fiction", + "author": "Ciocca, M., & Wang, J.", + "url": "https://iopscience.iop.org/article/10.1088/0031-9120/48/3/360", + "publisher": "Physics Education", + "volume": "48", + "issue": "3", + "pages": "360", + "year": "2013", + "doi": "https://doi.org/10.1088/0031-9120/48/3/360" + }, + { + "title": "The Great Coincidence", + "author": "Jeffery, D.", + "url": "https://www.physics.unlv.edu/~jeffery/astro/moon/sun_moon_angular.html", + "accessed": "2025-02-27" + } ] }, { @@ -187,9 +631,15 @@ "unit": ["lm"], "type": ["spot"], "category": ["Artificial"], - "description": "", - "sources": ["https://en.wikipedia.org/wiki/Flash_(photography)"], - "tags": ["camera"] + "references": [ + { + "title": "Flash (photography)", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Flash_(photography)&oldid=1277151573", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } + ] }, { "name": "Sky (Clear)", @@ -200,27 +650,122 @@ "type": ["dome"], "category": ["Natural"], "description": "Shade illuminated by entire clear blue sky at midday", - "sources": [ - "https://github.com/AntonPalmqvist/physically-based-api/tree/main/data/lightsources/sky-clear/", - "https://en.wikipedia.org/wiki/Color_temperature", - "https://en.wikipedia.org/wiki/Daylight", - "http://web.archive.org/web/20120807211236/http://www.npl.co.uk/upload/pdf/npl_summary_report_best_blue_sky_2006.pdf" + "references": [ + { + "title": "Illuminance Meter Measurement", + "author": "Palmqvist, A.", + "url": "https://github.com/AntonPalmqvist/physically-based-api/tree/main/data/lightsources/sky-clear/", + "publisher": "Physically Based Database", + "accessed": "2025-03-01" + }, + { + "title": "Color temperature", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Color_temperature&oldid=1272808359", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Daylight", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Daylight&oldid=1254565053", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Expedia's Best Blue Sky: Experiment and Results.", + "author": "Pegrum, H. M., Montgomery, R., Fox, N. P., Mountford, J. R., Salim, S., Woolliams, P. D., Pointer, M. R., Crane, L., & Chapman, M.", + "url": "http://eprintspublications.npl.co.uk/3518/", + "publisher": "NPL Report", + "year": "2006" + } ] }, + { + "name": "ROE Carbon Carbon CB5 MKII RGBCA", + "temperature": [3200, 6500], + "intensity": [4400, 4400], + "sourceSize": [60, 120], + "unit": ["cd/m2"], + "type": ["surface"], + "category": ["Artificial"], + "references": [ + { + "title": "Carbon Full Spectrum LED Panels Specifications", + "url": "https://www.roevisual.com/en/products/carbon-full-spectrum-led-panels", + "publisher": "ROE Visual", + "accessed": "2025-03-01" + }, + { + "title": "Carbon Full Spectrum LED Panels Brochure", + "url": "https://www.roevisual.com/assets/components/roevisual/connector.php?action=api/web/download/136", + "publisher": "ROE Visual", + "accessed": "2025-03-01" + } + ], + "tags": ["CB5MKII"] + }, + { + "name": "ROE Carbon Carbon CB5 MKII RGBW", + "temperature": [2700, 6500], + "intensity": [3200, 3200], + "sourceSize": [60, 120], + "unit": ["cd/m2"], + "type": ["surface"], + "category": ["Artificial"], + "references": [ + { + "title": "Carbon Full Spectrum LED Panels Specifications", + "url": "https://www.roevisual.com/en/products/carbon-full-spectrum-led-panels", + "publisher": "ROE Visual", + "accessed": "2025-03-01" + }, + { + "title": "Carbon Full Spectrum LED Panels Brochure", + "url": "https://www.roevisual.com/assets/components/roevisual/connector.php?action=api/web/download/136", + "publisher": "ROE Visual", + "accessed": "2025-03-01" + } + ], + "tags": ["CB5MKII"] + }, { "name": "Sky (Moonless Clear Night)", - "color": [1, 1, 1], - "temperature": [0, 0], + "color": [1.0, 0.943, 0.992], + "temperature": [6500, 6500], "intensity": [0.002, 0.002], "unit": ["lx"], "type": ["dome"], "category": ["Natural"], "description": "Even a moonless sky casts some light on earth. A phenomenon called airglow, and also starlight, contributes to this. The color of airglow varies", - "sources": [ - "http://stjarnhimlen.se/comp/radfaq.html#10", - "https://en.wikipedia.org/wiki/Airglow", - "https://en.wikipedia.org/wiki/Starlight", - "https://sciencenotes.org/what-is-airglow/" + "references": [ + { + "title": "Radiometry and Photometry in Astronomy", + "author": "Schlyter, P.", + "url": "http://stjarnhimlen.se/comp/radfaq.html#10", + "accessed": "2025-03-01" + }, + { + "title": "Airglow", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Airglow&oldid=1273412803", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Starlight", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Starlight&oldid=1234975010", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "What Is Airglow? Why the Night Sky Is Never Truly Dark", + "author": "Helmenstine, A.", + "url": "https://sciencenotes.org/what-is-airglow/", + "publisher": "Science Notes", + "accessed": "2025-03-01" + } ], "tags": ["airglow"] }, @@ -232,11 +777,28 @@ "unit": ["lx"], "type": ["dome"], "category": ["Natural"], - "description": "", - "sources": [ - "https://en.wikipedia.org/wiki/Color_temperature", - "https://en.wikipedia.org/wiki/Daylight", - "https://en.wikipedia.org/wiki/Lux" + "references": [ + { + "title": "Color temperature", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Color_temperature&oldid=1272808359", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Daylight", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Daylight&oldid=1254565053", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Lux", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Lux&oldid=1255787364", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + } ] }, { @@ -247,9 +809,20 @@ "type": ["spot"], "category": ["Artificial"], "description": "The type of yellow light typically used in street lighting is usually a sodium-vapor light. To simulate a sodium-vapor light faithfully you would need a spectral renderer where you can specify the very narrow wavelength range of 589.0 - 589.6 nm in order to get its bespoke monochromatic look.", - "sources": [ - "https://en.wikipedia.org/wiki/Sodium-vapor_lamp", - "https://www.1000bulbs.com/fil/categories/high-pressure-sodium-lamps" + "references": [ + { + "title": "Sodium-vapor lamp", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Sodium-vapor_lamp&oldid=1275815249", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "HPS (High Pressure Sodium) Light Bulbs", + "url": "https://www.1000bulbs.com/fil/categories/high-pressure-sodium-lamps", + "publisher": "1000Bulbs.com", + "accessed": "2025-02-27" + } ], "tags": ["sodium", "vapor"] }, @@ -259,17 +832,58 @@ "temperature": [5778, 5778], "intensity": [400, 100000], "unit": ["lx"], - "angle": 0.53, + "angle": 0.5332, "type": ["directional"], "category": ["Natural"], "description": "The changing color of the Sun over the course of the day is mainly a result of the scattering of sunlight and is not due to changes in black-body radiation. The solar illuminance constant is equal to 128 000 lux, but atmospheric extinction brings the number of lux down to around 100 000 lux.", - "sources": [ - "https://github.com/AntonPalmqvist/physically-based-api/tree/main/data/lightsources/sun/", - "https://en.wikipedia.org/wiki/Color_temperature#The_Sun", - "https://en.wikipedia.org/wiki/Sunlight#Measurement", - "https://en.wikipedia.org/wiki/Daylight", - "http://stjarnhimlen.se/comp/radfaq.html#10", - "https://nssdc.gsfc.nasa.gov/planetary/factsheet/sunfact.html" + "references": [ + { + "title": "Illuminance Meter Measurement", + "author": "Palmqvist, A.", + "url": "https://github.com/AntonPalmqvist/physically-based-api/tree/main/data/lightsources/sun/", + "publisher": "Physically Based Database", + "accessed": "2025-03-01" + }, + { + "title": "Color temperature", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Color_temperature&oldid=1272808359#The_Sun", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Sunlight", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Sunlight&oldid=1261635666#Measurement", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Daylight", + "author": "Wikipedia contributors", + "url": "https://en.wikipedia.org/w/index.php?title=Daylight&oldid=1254565053", + "publisher": "Wikipedia, The Free Encyclopedia", + "accessed": "2025-02-27" + }, + { + "title": "Radiometry and Photometry in Astronomy", + "author": "Schlyter, P.", + "url": "http://stjarnhimlen.se/comp/radfaq.html#10", + "accessed": "2025-03-01" + }, + { + "title": "Sun Fact Sheet", + "author": "Williams, D. R.", + "url": "https://nssdc.gsfc.nasa.gov/planetary/factsheet/sunfact.html", + "publisher": "NASA", + "accessed": "2025-03-01" + }, + { + "title": "The Great Coincidence", + "author": "Jeffery, D.", + "url": "https://www.physics.unlv.edu/~jeffery/astro/moon/sun_moon_angular.html", + "accessed": "2025-02-27" + } ] } ] diff --git a/schemas/schema-lightsources-v2.json b/schemas/schema-lightsources-v2.json index 0b6d0a2..5b4ff5d 100644 --- a/schemas/schema-lightsources-v2.json +++ b/schemas/schema-lightsources-v2.json @@ -41,17 +41,8 @@ "minItems": 2, "maxItems": 2 }, - "intensityRange": { - "description": "The typical range of intensity for this specific light source.", - "type": "array", - "items": { - "type": "number" - }, - "default": [0, 1], - "minItems": 2, - "maxItems": 2 - }, "unit": { + "description": "The unit of measurement of the intensity of the light.", "type": "array", "items": { "enum": ["lm", "lx", "cd/m2"] @@ -73,9 +64,25 @@ "minItems": 1, "maxItems": 2 }, + "type": { + "description": "The type of light, for DCC applications.", + "type": "array", + "items": { + "enum": [ + "directional", + "surface", + "spot", + "point", + "cylinder", + "dome" + ] + }, + "minItems": 1, + "maxItems": 1 + }, "variants": { "description": "If the light source comes in different variations, they can be described here.", - "type": "object", + "type": "array", "minItems": 1, "items": { "additionalProperties": false, @@ -86,45 +93,43 @@ "type": "string", "default": "Default" }, - "intensity": { - "description": "Intensity of the light emitted from the light source.", + "color": { + "description": "Color of the light source.", "type": "array", "items": { "type": "number" }, - "default": [0, 0], - "minItems": 2, - "maxItems": 2 + "default": [1, 1, 1], + "minItems": 3, + "maxItems": 3 + }, + "temperature": { + "description": "Color temperature in Kelvin, if color lies on the Planckian curve.", + "type": "number", + "default": 6500 + }, + "intensity": { + "description": "Intensity of the light emitted from the light source.", + "type": "number", + "default": 0 }, "angle": { "description": "The maximum beam angle in degrees. For a directional light, this specifies angular diameter instead.", "type": "number", "default": 90 }, - "temperature": { - "description": "Color temperature in Kelvin, if color lies on the Planckian curve.", - "type": "number", - "default": 6500 + "sourceSize": { + "description": "The size of the light source in centimeters. [Radius] if point or spot. [Width, Height] if surface. [Length, Radius] if cylinder.", + "type": "array", + "items": { + "type": "number" + }, + "minItems": 1, + "maxItems": 2 } - }, - "required": ["format", "intensity", "angle", "temperature"] - } - }, - "type": { - "description": "The type of light, for DCC applications.", - "type": "array", - "items": { - "enum": [ - "directional", - "surface", - "spot", - "point", - "cylinder", - "dome" - ] + } }, - "minItems": 1, - "maxItems": 1 + "required": ["format", "color", "intensity"] }, "category": { "type": "array", @@ -139,12 +144,57 @@ "type": "string", "maxLength": 500 }, - "sources": { - "description": "Provide at least one source for the values.", + "references": { + "description": "List of references. At least one reference needed.", "type": "array", "items": { - "type": "string", - "minLength": 1 + "additionalProperties": false, + "type": "object", + "properties": { + "title": { + "description": "Title of book, journal article, or website.", + "type": "string" + }, + "author": { + "description": "Name(s) of the authors of a book or journal article, or in the case of a webpage, the person or company that created the webpage. For editors, add \"(Ed.)\"", + "type": "string" + }, + "url": { + "description": "Link to website, or other web resource where the information was found. For books and journals, this URL should be the one that the DOI is linking to.", + "type": "string" + }, + "publisher": { + "description": "Name of publisher or journal where published.", + "type": "string" + }, + "volume": { + "description": "Volume number. In relation to periodicals, volume refers to all the issues of a specific journal or magazine for a limited time period, usually one year. For books, volume indicates the order of a book in a series or set.", + "type": "string" + }, + "issue": { + "description": "Issue number. The issue number refers to the number of individual publications during the year.", + "type": "string" + }, + "pages": { + "description": "Pages in book or journal article, separated by double-hyphens. Can also be article number.", + "type": "string" + }, + "year": { + "description": "Year of publication. For webpages, use \"accessed\" instead.", + "type": "string" + }, + "doi": { + "description": "Link to Digital Object Identifier (DOI).", + "type": "string" + }, + "accessed": { + "description": "Date the webpage was accessed.", + "type": "string", + "format": "date", + "example": "2025-01-31" + } + }, + "required": ["url", "title"] }, "minItems": 1, "uniqueItems": true @@ -158,14 +208,14 @@ "uniqueItems": true } }, - "required": [ - "name", - "color", - "intensity", - "unit", - "category", - "description", - "sources" - ] + "anyOf": [ + { + "required": ["color", "intensity"] + }, + { + "required": ["variants"] + } + ], + "required": ["name", "unit", "category", "references"] } }