Skip to content

Commit 7d8ec39

Browse files
AntonPalmqvistAntonPalmqvist
committed
- Added surfaceTension property to Materials
- Added transmissionDepth property to Materials - Updated Materials
1 parent 11d86ce commit 7d8ec39

File tree

6 files changed

+148
-18
lines changed

6 files changed

+148
-18
lines changed

‎deploy/materials.json‎

Lines changed: 23 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -83,9 +83,11 @@
8383
"roughness": 0,
8484
"ior": 1.35,
8585
"transmission": 1,
86+
"transmissionDepth": 0.08,
8687
"transmissionDispersion": 54,
8788
"density": 1060,
8889
"viscosity": 2.8,
90+
"surfaceTension": 56,
8991
"category": ["Human"],
9092
"description": "The color of blood depends on its oxygen level. When there is plenty of oxygen, the color is a brighter red. The reason is because of a protein called hemoglobin, which carries the oxygen in your blood. When hemoglobin has a full oxygen load, it has a bright red color, and when it's deoxygenated it's a darker red. For example, arterial and capillary blood is bright, and venous blood is dark.",
9193
"sources": [
@@ -98,7 +100,8 @@
98100
"https://en.wikipedia.org/wiki/Hemorheology",
99101
"https://www.frontiersin.org/articles/10.3389/fphys.2019.01329/full",
100102
"https://nextlimitsupport.atlassian.net/wiki/spaces/rf2016docs/pages/5497120/Hybrido+Viscosity+Table",
101-
"https://wiki.anton-paar.com/en/whole-blood/"
103+
"https://wiki.anton-paar.com/en/whole-blood/",
104+
"https://en.wikipedia.org/w/index.php?title=Surface_tension&oldid=1304099149#Values"
102105
],
103106
"tags": ["liquid"],
104107
"reference": [
@@ -311,11 +314,13 @@
311314
},
312315
{
313316
"name": "Coffee",
314-
"color": [0.027, 0.019, 0.018],
317+
"color": [0.447, 0.133, 0.034],
315318
"metalness": 0,
316319
"roughness": 0,
317320
"ior": 1.34,
318-
"subsurfaceRadius": [10, 5, 1],
321+
"transmission": 1,
322+
"transmissionDepth": 0.1,
323+
"transmissionDispersion": 55.78,
319324
"density": 1020,
320325
"viscosity": 1.7,
321326
"category": ["Liquid"],
@@ -360,6 +365,7 @@
360365
"transmission": 1,
361366
"density": 920,
362367
"viscosity": 46,
368+
"surfaceTension": 31,
363369
"category": ["Liquid"],
364370
"description": "",
365371
"sources": [
@@ -369,7 +375,8 @@
369375
"https://en.wikipedia.org/wiki/Density",
370376
"https://en.wikipedia.org/wiki/List_of_viscosities",
371377
"https://downloads.hindawi.com/archive/2014/234583.pdf",
372-
"https://nextlimitsupport.atlassian.net/wiki/spaces/rf2016docs/pages/5497120/Hybrido+Viscosity+Table"
378+
"https://nextlimitsupport.atlassian.net/wiki/spaces/rf2016docs/pages/5497120/Hybrido+Viscosity+Table",
379+
"https://www.tandfonline.com/doi/full/10.1080/10942912.2017.1360905"
373380
],
374381
"tags": [""],
375382
"reference": [
@@ -846,14 +853,16 @@
846853
"complexIor": [1.86932, 5.36989, 1.53811, 4.60484, 1.4963, 3.92685],
847854
"density": 13546,
848855
"viscosity": 1.552,
856+
"surfaceTension": 487,
849857
"category": ["Metal"],
850858
"description": "Mercury is the only metallic element that is known to be liquid at standard conditions.",
851859
"sources": [
852860
"https://refractiveindex.info/?shelf=3d&book=metals&page=mercury",
853861
"https://help.autodesk.com/view/ARNOL/ENU/?guid=arnold_user_guide_ac_standard_surface_ac_standard_base_html#metalness",
854862
"https://en.wikipedia.org/wiki/Density",
855863
"https://en.wikipedia.org/wiki/List_of_viscosities",
856-
"https://www.engineeringtoolbox.com/absolute-viscosity-liquids-d_1259.html"
864+
"https://www.engineeringtoolbox.com/absolute-viscosity-liquids-d_1259.html",
865+
"https://en.wikipedia.org/w/index.php?title=Surface_tension&oldid=1304099149#Values"
857866
],
858867
"tags": ["liquid"],
859868
"reference": [
@@ -870,6 +879,7 @@
870879
"density": 1030,
871880
"densityRange": [1026, 1035],
872881
"viscosity": 2,
882+
"surfaceTension": 48,
873883
"category": ["Liquid"],
874884
"description": "Cow's milk",
875885
"sources": [
@@ -880,7 +890,8 @@
880890
"https://hypertextbook.com/facts/2002/AliciaNoelleJones.shtml",
881891
"https://nextlimitsupport.atlassian.net/wiki/spaces/rf2016docs/pages/5497120/Hybrido+Viscosity+Table",
882892
"https://en.wikipedia.org/wiki/List_of_viscosities",
883-
"https://www.engineeringtoolbox.com/absolute-viscosity-liquids-d_1259.html"
893+
"https://www.engineeringtoolbox.com/absolute-viscosity-liquids-d_1259.html",
894+
"https://www.journalofdairyscience.org/article/S0022-0302(59)90760-X/pdf"
884895
],
885896
"tags": ["sss"],
886897
"reference": [
@@ -1035,14 +1046,16 @@
10351046
"density": 920,
10361047
"densityRange": [870, 1000],
10371048
"viscosity": 100,
1049+
"surfaceTension": 21,
10381050
"category": ["Liquid"],
10391051
"description": "The viscosity of crude oil is sensitive to temperature.",
10401052
"sources": [
10411053
"https://en.wikipedia.org/wiki/Petroleum",
10421054
"https://en.wikipedia.org/wiki/API_gravity",
10431055
"https://www.ncbi.nlm.nih.gov/pmc/articles/PMC9922782/",
10441056
"https://www.sciencedirect.com/science/article/abs/pii/S1350449520305636",
1045-
"https://www.sciencedirect.com/science/article/pii/S003442572200133X"
1057+
"https://www.sciencedirect.com/science/article/pii/S003442572200133X",
1058+
"https://www.scientific.net/DDF.391.106"
10461059
],
10471060
"tags": ["oil", "crude oil", "sss"],
10481061
"reference": [
@@ -1697,6 +1710,7 @@
16971710
"density": 1000,
16981711
"densityRange": [958, 1000],
16991712
"viscosity": 1.002,
1713+
"surfaceTension": 72,
17001714
"acousticAbsorption": [0.008, 0.008, 0.013, 0.015, 0.02, 0.025],
17011715
"category": ["Liquid"],
17021716
"description": "While relatively small quantities of water appear to be colorless, pure water has a slight blue color that becomes deeper as the thickness of the observed sample increases. The hue of water is an intrinsic property and is caused by selective absorption and scattering of white light. Dissolved elements or suspended impurities may give water a different color.",
@@ -1712,7 +1726,8 @@
17121726
"https://www.engineeringtoolbox.com/water-dynamic-kinematic-viscosity-d_596.html",
17131727
"https://en.wikipedia.org/wiki/List_of_viscosities",
17141728
"https://nextlimitsupport.atlassian.net/wiki/spaces/rf2016docs/pages/5497120/Hybrido+Viscosity+Table",
1715-
"https://www.researchgate.net/journal/Optics-Express-1094-4087/publication/235415649_Zoom_lens_design_using_liquid_lens_for_laparoscope/links/6609e54d10ca86798731ef50/Zoom-lens-design-using-liquid-lens-for-laparoscope.pdf"
1729+
"https://www.researchgate.net/journal/Optics-Express-1094-4087/publication/235415649_Zoom_lens_design_using_liquid_lens_for_laparoscope/links/6609e54d10ca86798731ef50/Zoom-lens-design-using-liquid-lens-for-laparoscope.pdf",
1730+
"https://en.wikipedia.org/w/index.php?title=Surface_tension&oldid=1304099149#Values"
17161731
],
17171732
"tags": [""],
17181733
"reference": [

‎deploy/v2/materials.json‎

Lines changed: 64 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -277,9 +277,11 @@
277277
"roughness": 0,
278278
"ior": 1.35,
279279
"transmission": 1,
280+
"transmissionDepth": 0.08,
280281
"transmissionDispersion": 54,
281282
"density": [1060],
282283
"viscosity": [2.35, 4, 2.78],
284+
"surfaceTension": 56,
283285
"category": ["Human"],
284286
"description": "The color of blood depends on its oxygen level. When there is plenty of oxygen, the color is a brighter red. The reason is because of a protein called hemoglobin, which carries the oxygen in your blood. When hemoglobin has a full oxygen load, it has a bright red color, and when it's deoxygenated it's a darker red. For example, arterial and capillary blood is bright, and venous blood is dark.",
285287
"tags": ["liquid"],
@@ -305,6 +307,13 @@
305307
"publisher": "Wikipedia, The Free Encyclopedia",
306308
"accessed": "2025-01-25"
307309
},
310+
{
311+
"title": "Surface tension",
312+
"author": "Wikipedia contributors",
313+
"url": "https://en.wikipedia.org/w/index.php?title=Surface_tension&oldid=1304099149#Values",
314+
"publisher": "Wikipedia, The Free Encyclopedia",
315+
"accessed": "2025-08-30"
316+
},
308317
{
309318
"title": "Refractive index database",
310319
"author": "Polyanskiy, M. N.",
@@ -1046,13 +1055,15 @@
10461055
"color": [
10471056
{
10481057
"colorSpace": "srgb-linear",
1049-
"color": [0.027, 0.019, 0.018]
1058+
"color": [0.447, 0.133, 0.034]
10501059
}
10511060
],
10521061
"metalness": 0,
10531062
"roughness": 0,
10541063
"ior": 1.34,
1055-
"subsurfaceRadius": [10, 5, 1],
1064+
"transmission": 1,
1065+
"transmissionDepth": 0.1,
1066+
"transmissionDispersion": 55.78,
10561067
"density": [1020],
10571068
"viscosity": [1.7],
10581069
"category": ["Liquid"],
@@ -1162,6 +1173,7 @@
11621173
"transmission": 1,
11631174
"density": [920],
11641175
"viscosity": [46],
1176+
"surfaceTension": 31,
11651177
"category": ["Liquid"],
11661178
"references": [
11671179
{
@@ -1209,6 +1221,17 @@
12091221
"publisher": "Next Limit Technologies",
12101222
"url": "https://nextlimitsupport.atlassian.net/wiki/spaces/rf2016docs/pages/5497120/Hybrido+Viscosity+Table",
12111223
"accessed": "2025-01-26"
1224+
},
1225+
{
1226+
"title": "Density, Viscosity, And Surface Tension Of Five Vegetable Oils At Elevated Temperatures: Measurement And Modeling",
1227+
"author": "Sahasrabudhe, S. N., Rodriguez-Martinez, V., O’Meara, Meghan., & Farkas, B. E.",
1228+
"url": "https://www.tandfonline.com/doi/full/10.1080/10942912.2017.1360905",
1229+
"publisher": "International Journal of Food Properties",
1230+
"volume": "20",
1231+
"issue": "sup2",
1232+
"pages": "1965--1981",
1233+
"year": "2017",
1234+
"doi": "https://doi.org/10.1080/10942912.2017.1360905"
12121235
}
12131236
],
12141237
"images": [
@@ -2782,6 +2805,7 @@
27822805
],
27832806
"density": [13546],
27842807
"viscosity": [1.552],
2808+
"surfaceTension": 487,
27852809
"category": ["Metal"],
27862810
"description": "Mercury is the only metallic element that is known to be liquid at standard conditions.",
27872811
"tags": ["liquid"],
@@ -2813,6 +2837,13 @@
28132837
"publisher": "Wikipedia, The Free Encyclopedia",
28142838
"accessed": "2025-01-26"
28152839
},
2840+
{
2841+
"title": "Surface tension",
2842+
"author": "Wikipedia contributors",
2843+
"url": "https://en.wikipedia.org/w/index.php?title=Surface_tension&oldid=1304099149#Values",
2844+
"publisher": "Wikipedia, The Free Encyclopedia",
2845+
"accessed": "2025-08-30"
2846+
},
28162847
{
28172848
"title": "Liquids - Dynamic Viscosities",
28182849
"url": "https://www.engineeringtoolbox.com/absolute-viscosity-liquids-d_1259.html",
@@ -2847,6 +2878,7 @@
28472878
"subsurfaceRadius": [1.842, 1.044, 0.35],
28482879
"density": [1026, 1035, 1030],
28492880
"viscosity": [2],
2881+
"surfaceTension": 48,
28502882
"category": ["Liquid"],
28512883
"description": "Cow's milk",
28522884
"tags": ["sss"],
@@ -2909,6 +2941,17 @@
29092941
"url": "https://en.wikipedia.org/w/index.php?title=List_of_viscosities&oldid=1256671906",
29102942
"publisher": "Wikipedia, The Free Encyclopedia",
29112943
"accessed": "2025-01-26"
2944+
},
2945+
{
2946+
"title": "The Surface Tension of Milk. A Review1, 2",
2947+
"author": "Whitnah, C.H.",
2948+
"url": "https://www.journalofdairyscience.org/article/S0022-0302(59)90760-X/pdf",
2949+
"publisher": "Journal of Dairy Science",
2950+
"volume": "42",
2951+
"issue": "9",
2952+
"pages": "1437--1449",
2953+
"year": "1959",
2954+
"doi": "https://doi.org/10.3168/jds.S0022-0302(59)90760-X"
29122955
}
29132956
],
29142957
"images": [
@@ -3389,6 +3432,7 @@
33893432
"subsurfaceRadius": [3, 1, 0.25],
33903433
"density": [870, 1000, 1000],
33913434
"viscosity": [100, 1000, 500],
3435+
"surfaceTension": 21,
33923436
"category": ["Liquid"],
33933437
"description": "The viscosity of crude oil is sensitive to temperature.",
33943438
"tags": ["oil", "crude oil", "sss"],
@@ -3442,6 +3486,16 @@
34423486
"url": "https://wiki.anton-paar.com/en/crude-oil/",
34433487
"publisher": "Anton Paar GmbH",
34443488
"accessed": "2025-01-26"
3489+
},
3490+
{
3491+
"title": "Measurements of Surface Tension for Mineral and Crude Oil Systems",
3492+
"author": "Busahmin, B., & Maini, B.B.",
3493+
"url": "https://www.scientific.net/DDF.391.106",
3494+
"publisher": "Defect and Diffusion Forum",
3495+
"volume": "391",
3496+
"pages": "106--113",
3497+
"year": "2019",
3498+
"doi": "https://doi.org/10.4028/www.scientific.net/DDF.391.106"
34453499
}
34463500
],
34473501
"images": [
@@ -5496,6 +5550,7 @@
54965550
"transmissionDispersion": 55.78,
54975551
"density": [958, 1000, 1000],
54985552
"viscosity": [1.002],
5553+
"surfaceTension": 72,
54995554
"acousticAbsorption": [0.008, 0.008, 0.013, 0.015, 0.02, 0.025],
55005555
"category": ["Liquid"],
55015556
"description": "While relatively small quantities of water appear to be colorless, pure water has a slight blue color that becomes deeper as the thickness of the observed sample increases. The hue of water is an intrinsic property and is caused by selective absorption and scattering of white light. Dissolved elements or suspended impurities may give water a different color.",
@@ -5534,6 +5589,13 @@
55345589
"publisher": "Wikipedia, The Free Encyclopedia",
55355590
"accessed": "2025-01-26"
55365591
},
5592+
{
5593+
"title": "Surface tension",
5594+
"author": "Wikipedia contributors",
5595+
"url": "https://en.wikipedia.org/w/index.php?title=Surface_tension&oldid=1304099149#Values",
5596+
"publisher": "Wikipedia, The Free Encyclopedia",
5597+
"accessed": "2025-08-30"
5598+
},
55375599
{
55385600
"title": "Hybrido Viscosity Table",
55395601
"author": "RealFlow 10 Documentation",

‎schemas/openapi-schema-v2.yaml‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,8 @@ openapi: 3.1.0
22
info:
33
version: 2.0-alpha
44
title: Physically Based API
5-
description: "\U0001F6A7 2.0 IS UNDER DEVELOPMENT. FOR TESTING USE ONLY. \U0001F6A7\n\nThis is a database of physically based values for CG artists.\n\nIt's 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. \n\nIdeally, the data is to be consumed by DCC applications in the form of plug-ins, or any other form that makes sense. It's also available to browse on the web at https://physicallybased.info\n\nFor additions or changes, feel free to make a Pull Request on Github at https://github.com/AntonPalmqvist/physically-based-api or send me a message through the [contact form.](https://physicallybased.info/about/)\n\nSchema: https://github.com/AntonPalmqvist/physically-based-api/blob/main/schemas/openapi-schema-v2.yaml"
5+
summary: A database of physically based values for CG artists.
6+
description: "\U0001F6A7 2.0 IS UNDER DEVELOPMENT. FOR TESTING USE ONLY. \U0001F6A7\n\n## Features\n\n- **Open Database**: Access a curated collection of physically based material values\n- **Lightweight**: The entire dataset is optimized for quick loading and integration as presets\n - materials.json ```191 KB```\n - lightsources.json ```35 KB```\n - cameras.json ```222 KB```\n - lenses.json ```1 KB```\n- **API Access**: Connect your tools to the API to get the latest updates from the database\n- **Community-Driven**: Contribute new materials or improve existing ones\n- **Free License**: All data is released under CC0 1.0\n\n## Implementations\n\nExplore the database through these implementations:\n\n- Web [Physically Based](https://physicallybased.info/) by [AntonPalmqvist](https://github.com/AntonPalmqvist)\n- Web [Three.js GPU Path Tracer](https://gkjohnson.github.io/three-gpu-pathtracer/example/bundle/materialDatabase.html) by [gkjohnson](https://github.com/gkjohnson)\n- Web [MaterialXLab](https://kwokcb.github.io/MaterialXLab/javascript/PhysicallyBasedMaterialX_out.html) by [kwokcb](https://github.com/kwokcb)\n\n\n## Contribute\n\nContributions are welcome! Whether you want to add new entries, corrections, or suggestions, your help is appreciated. See the [Github page](https://github.com/AntonPalmqvist/physically-based-api) for more info.\n\n## License\n\nThe 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.\n\nShader 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/)."
67
contact:
78
url: 'https://physicallybased.info/about'
89
name: Form
@@ -143,6 +144,9 @@ components:
143144
description: 'The approximate distance up to which light can scatter below the surface, also known as “mean free path” (MFP). Specified in centimeters.'
144145
transmission:
145146
type: number
147+
transmissionDepth:
148+
type: number
149+
description: Controls the depth into the volume at which the Transmission Color is realized.
146150
transmissionDispersion:
147151
type: number
148152
description: 'Abbe number, describing how much the index of refraction varies across wavelengths. For glass and diamonds, this is typically in the range of 10 to 70, with lower numbers giving more dispersion.'
@@ -189,6 +193,9 @@ components:
189193
maxItems: 3
190194
items:
191195
type: number
196+
surfaceTension:
197+
type: number
198+
description: Surface tension measured in millinewton per meter (mN/m) at a temperature of 20°C. 1 mN/m = 1 dyn/cm.
192199
acousticAbsorption:
193200
type: array
194201
description: 'Absorption coefficients at 125, 250, 500, 1000, 2000, and 4000 kHz.'

0 commit comments

Comments
 (0)