kittycad/material-properties

Material properties database

Here you can find properties for common materials used in mechanical design. This page is a work in progress 🔨

🛠️ Units Directory 🛠️

When using our material library, reference the units directory below to know what units you are currently using. (All units are currently in English units, we will create an SI version in the future ⚙️, use our units conversion api or feel free to open a pr in the meantime 😉)

Property	JSON Key	Units
Density	den	lb/in^3
Yield Strength	yield_str	psi
Ultimate Strength	ult_str	psi
Elongation	elongation	% (unitless)
Modulus of Elasticity	moe	psi
Poisson's Ratio	pr	% (unitless)
Maximum Service Temperature	max_service_temp	°F
Coefficient of Thermal Expansion	coef_thermal_exp	μin/in
Minimum Extruder Temperature	min_extrude_temp	°F
Maximum Extruder Temperature	max_extrude_temp	°F
Minimum Bed Temperature	min_bed_temp	°F
Maximum Bed Temperature	max_bed_temp	°F

🛠️ Code Example 🛠️

Below is a Python example of how to use the library.

import json

with open('material-properties/carbonsteel.json') as aluminum_properties:
    aluminum = json.load(aluminum_properties)

AISI_1020_den = aluminum['AISI_1020']['hot']['den']

👷 Honorary Engineers (Contributors) 👷

A huge thank you to all our contributing engineers!

👷 How to Contribute 👷

If you would like to make a change, open up a PR and we will review promptly. If you would like to add or edit a value within the database, please provide a reference with your requested change.

References

[1]: Beer, F. P., Johnston, E. R., DeWolf, J. T., & Mazurek, D. F. (2012). Mechanics of Materials (Sixth). MaGraw-Hill.
[2] Filament Properties Table. Simplify3D. (n.d.). Retrieved February 24, 2023, from https://www.simplify3d.com/resources/materials-guide/properties-table/

material-properties's Issues

Add References Section to README

Create PR Template

add contributors/credits and how-to-contribute sections to readme

there's a bunch of examples in other repos

for the contributors/credits - there should be a github action we can use to auto-populate that
(tho maybe we wont need this section since i think github has added it to the right panel on repos now)

---

how-to-contribute section is still needed tho regardless of the above - and we should include a 'thanks to our contributors' line if we're not including a specific section for the above (ie the repo already has it in the ui)

Create Issue Template

Update key:value pairs in JSON files

Having the units embedded in the JSON file is useful long term. I will update the JSON files to have the following:

"den": .101

to

"den": {
    "value": 0.101, 
    "unit": {
        "numerator": ["pound"],
        "denominator" ["inch_cubed"] 
    }
}

code example in readme should be copy-able

just use the ``` blockers