Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Contributing to Physically Based

Contributions of all kinds are welcome such as pull requests and issues!
Contributions of all kinds are welcome, such as pull requests and issues!

If you have any questions or need guidance in addition to the guidelines outlined in this document, feel free to use the contact form at: [https://physicallybased.info/about/](https://physicallybased.info/about/)

Expand Down
51 changes: 35 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,47 @@
# Physically Based API

A database of physically based values for CG artists.

<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://physicallybased.info/images/meta/database-dark.jpg">
<img alt="Screenshot of the web implementation" src="https://physicallybased.info/images/meta/database.jpg">
<source media="(prefers-color-scheme: dark)" srcset="https://physicallybased.info/images/meta/database-dark.webp">
<img alt="Screenshot of the web implementation" src="https://physicallybased.info/images/meta/database.webp">
</picture>
A database of physically based values for CG artists
</p>

## API
## Features

- Open Database: Access a curated collection of physically based material values
- Lightweight: The entire dataset is optimized for quick loading and integration as presets
- [materials.json](deploy/v2/materials.json) `191 KB`
- [lightsources.json](deploy/v2/lightsources.json) `35 KB`
- [cameras.json](deploy/v2/cameras.json) `222 KB`
- [lenses.json](deploy/v2/lenses.json) (coming in v2)
- API Access: Connect your tools to the API to get the latest updates from the database
- Community-Driven: Contribute new materials or improve existing ones
- Free License: All data is released under [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/legalcode)

## Getting Started

Access the API and documentation at [https://api.physicallybased.info](https://api.physicallybased.info)

### Implementations

Explore the database through these implementations:

Access the API here: [https://api.physicallybased.info](https://api.physicallybased.info)
- Web [Physically Based](https://physicallybased.info) by [AntonPalmqvist](https://github.com/AntonPalmqvist)
- Web [Three.js GPU Path Tracer](https://gkjohnson.github.io/three-gpu-pathtracer/example/bundle/materialDatabase.html) by [gkjohnson](https://github.com/gkjohnson)
- Web [MaterialXLab](https://kwokcb.github.io/MaterialXLab/javascript/PhysicallyBasedMaterialX_out.html) by [kwokcb](https://github.com/kwokcb)

Read about how to contribute here: [CONTRIBUTING.md](CONTRIBUTING.md)
### Contribute

## Implementations
Contributions are welcome! Whether you want to add new entries, corrections, or suggestions, your help is appreciated. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

- Web [https://physicallybased.info](https://physicallybased.info) by [AntonPalmqvist](https://github.com/AntonPalmqvist)
- Web [https://gkjohnson.github.io/three-gpu-pathtracer/example/bundle/materialDatabase.html](https://gkjohnson.github.io/three-gpu-pathtracer/example/bundle/materialDatabase.html) by [gkjohnson](https://github.com/gkjohnson)
- Web [https://kwokcb.github.io/MaterialXLab/javascript/PhysicallyBasedMaterialX_out.html](https://kwokcb.github.io/MaterialXLab/javascript/PhysicallyBasedMaterialX_out.html) by [kwokcb](https://github.com/kwokcb)
### License

The database is made available under the [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/legalcode) license, which means you are free to use, modify, and distribute its content without any restrictions, even for commercial purposes.

Shader ball used for renders is from [ASWF USD WG](https://github.com/usd-wg/assets/tree/main/full_assets/StandardShaderBall) and is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)

<!-- ## Shader Ball

Expand All @@ -41,9 +66,3 @@ The shaderball scene used to render the images is available to download below.
</td>
</tr>
</table> -->

## License Information

The database is made available under the [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/legalcode) license, which means you are free to use, modify, and distribute its content without any restrictions, even for commercial purposes.

Shader ball used for renders is from [ASWF USD WG](https://github.com/usd-wg/assets/tree/main/full_assets/StandardShaderBall) licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
31 changes: 16 additions & 15 deletions deploy/lightsources.json
Original file line number Diff line number Diff line change
Expand Up @@ -63,31 +63,31 @@
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 65,
"intensity": 61250
"intensity": 78096
},
{
"format": "15º Reflector",
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 15,
"intensity": 600000
"intensity": 32671
},
{
"format": "30º Reflector",
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 30,
"intensity": 250000
"intensity": 56389
},
{
"format": "45º Reflector",
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 45,
"intensity": 125000
"intensity": 67377
}
],
"unit": ["lx"],
"unit": ["lm"],
"type": ["spot"],
"category": ["Artificial"],
"description": "",
Expand All @@ -106,31 +106,31 @@
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 70,
"intensity": 76400
"intensity": 117678
},
{
"format": "15º Reflector",
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 15,
"intensity": 864900
"intensity": 47095
},
{
"format": "30º Reflector",
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 30,
"intensity": 376200
"intensity": 84854
},
{
"format": "45º Reflector",
"color": [1.0, 0.859, 0.778],
"temperature": 5600,
"angle": 45,
"intensity": 202500
"intensity": 109150
}
],
"unit": ["lx"],
"unit": ["lm"],
"type": ["spot"],
"category": ["Artificial"],
"description": "",
Expand All @@ -148,21 +148,21 @@
{
"format": "Flood",
"angle": 60,
"intensity": 41300
"intensity": 43249
},
{
"format": "Medium",
"angle": 40,
"intensity": 76100
"intensity": 31671
},
{
"format": "Spot",
"angle": 15,
"intensity": 405000
"intensity": 22053
}
],
"sourceSize": [11.5],
"unit": ["lx"],
"unit": ["lm"],
"type": ["spot"],
"category": ["Artificial"],
"description": "",
Expand Down Expand Up @@ -580,7 +580,8 @@
"https://en.wikipedia.org/wiki/Daylight",
"http://stjarnhimlen.se/comp/radfaq.html#10",
"https://nssdc.gsfc.nasa.gov/planetary/factsheet/sunfact.html",
"https://www.physics.unlv.edu/~jeffery/astro/moon/sun_moon_angular.html"
"https://www.physics.unlv.edu/~jeffery/astro/moon/sun_moon_angular.html",
"https://jila.colorado.edu/~ajsh/colour/Tspectrum.html"
]
}
]
34 changes: 20 additions & 14 deletions deploy/v2/lightsources.json
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@
],
"temperature": 5600,
"angle": 15,
"intensity": 600000
"intensity": 32671
},
{
"format": "30º Reflector",
Expand All @@ -110,7 +110,7 @@
],
"temperature": 5600,
"angle": 30,
"intensity": 250000
"intensity": 56389
},
{
"format": "45º Reflector",
Expand All @@ -122,7 +122,7 @@
],
"temperature": 5600,
"angle": 45,
"intensity": 125000
"intensity": 67377
},
{
"format": "No Reflector",
Expand All @@ -134,10 +134,10 @@
],
"temperature": 5600,
"angle": 65,
"intensity": 61250
"intensity": 78096
}
],
"unit": ["lx"],
"unit": ["lm"],
"type": ["spot"],
"category": ["Artificial"],
"references": [
Expand Down Expand Up @@ -176,7 +176,7 @@
],
"temperature": 5600,
"angle": 15,
"intensity": 864900
"intensity": 47095
},
{
"format": "30º Reflector",
Expand All @@ -188,7 +188,7 @@
],
"temperature": 5600,
"angle": 30,
"intensity": 376200
"intensity": 84854
},
{
"format": "45º Reflector",
Expand All @@ -200,7 +200,7 @@
],
"temperature": 5600,
"angle": 45,
"intensity": 202500
"intensity": 109150
},
{
"format": "No Reflector",
Expand All @@ -212,10 +212,10 @@
],
"temperature": 5600,
"angle": 70,
"intensity": 76400
"intensity": 117678
}
],
"unit": ["lx"],
"unit": ["lm"],
"type": ["spot"],
"category": ["Artificial"],
"references": [
Expand Down Expand Up @@ -253,7 +253,7 @@
],
"temperature": 6000,
"angle": 15,
"intensity": 405000
"intensity": 22053
},
{
"format": "Medium",
Expand All @@ -265,7 +265,7 @@
],
"temperature": 6000,
"angle": 40,
"intensity": 76100
"intensity": 31671
},
{
"format": "Flood",
Expand All @@ -277,11 +277,11 @@
],
"temperature": 6000,
"angle": 60,
"intensity": 41300
"intensity": 43249
}
],
"sourceSize": [11.5],
"unit": ["lx"],
"unit": ["lm"],
"type": ["spot"],
"category": ["Artificial"],
"references": [
Expand Down Expand Up @@ -1167,6 +1167,12 @@
"author": "Jeffery, D.",
"url": "https://www.physics.unlv.edu/~jeffery/astro/moon/sun_moon_angular.html",
"accessed": "2025-02-27"
},
{
"title": "What Colour Is The Sun",
"author": "Hamilton, A.",
"url": "https://jila.colorado.edu/~ajsh/colour/Tspectrum.html",
"accessed": "2025-08-23"
}
]
}
Expand Down
Loading