Material

The material determines the characteristics of the manufactured parts. Apart from physical properties, the material may be extended by process specific properties, e.g. design limits or processing rates.

Request Material by ID (GET)

Get material information.

Return Data
{
    "mat_id": "6ba40dc05533401caa9f47f014efd1f8",
    "owner_username": "arnd",
    "restriction": null,
    "mat_name": "316L",
    "oem_name": "ACME",
    "tech": "additive_manufacturing",
    "prc_acronym": "fdm",
    "raw_mat_cost": 200,
    "mat_rho": 7.8,
    "properties_am": {
        "sup_phi": 0,
        "c_wst": 0.5,
        "min_ang": 0,
        "lyr_h": 0.025,
        "bld_spd_fill": 1000000,
        "t_lim_min": 0.1,
        "t_lim_max": 30,
        "gap_lim_min": 0.3,
        "size_lim_min": null,
        "size_lim_max": null,
        "scaling_factors": {
            "x": 1.2,
            "y": 1.2,
            "z": 1.24
        }
    },
    "properties_milling": {
        "milling_rate_roughing": 900,
        "milling_rate_finishing": 2700
    },
    "default_machine_name": "Prusa i3"
}
ParameterDescriptionTypeUnitExample
mat_idMaterial UUIDstring“535ca86f28d94dc786adf32387b0c658”
owner_usernameUsername of machine ownerstring, null“arnd”
restrictionRestriction levelstring, null“owner”
mat_nameMaterial namestring“PLA”
oem_nameBrand or manufacturer namestring“Generic”
techTechnologystring“additive_manufacturing”
prc_acronymProcess acronymstring“fdm”
raw_mat_costRaw material cost (powder, filament, resin, solid block…)float20.92
mat_rhoMaterial densityfloatg/cm³1.24
mat_lvl_2_nameMaterial Typestring, null“Polyester”
mat_lvl_3_nameMaterial Groupstring, null“Thermoplastic”
mat_lvl_4_nameMaterial Categorystring, null“Polymer”
parent_materialNext known parent (Level 2-4)string, null“Polyester”
default_machine_nameName of machine used by defaultstring“RepRap Prusa i2”
Properties Additive Manufacturing (properties_am)

Note: All of the following properties may be null and auto-completed from the related process or similar materials.

ParameterDescriptionTypeUnitExample
sup_phiRelative density if support structures.float, null0.2
c_wstRatio of built material, that cannot be recycled.float, null0.1
min_angMinimal printable supportless overhang angle (horizontal-to-surface angle).float, nulldeg45
lyr_hLayer height.float, nullmm0.25
bld_spd_fillVolumetric built rate.float, nullcm³/h120
t_lim_minMinimal printable wall thickness.float, nullmm0.4
t_lim_maxMaximum printable wall thickness.float, nullmm50
gap_lim_minMinimal printable gap size.float, nullmm0.01
size_lim_minMinimal general part size.float, nullmm2.5
size_lim_maxMaximum general part size.float, nullmm120
scaling_factorsScaling factors to respect process and sintering shrinkage. list<float>, null[1.1, 1.1, 1.2]
Properties Milling (properties_milling)
ParameterDescriptionTypeUnitExample
milling_rate_roughingVolumetric roughing ratefloat, nullcm³/h900
milling_rate_finishingSurface finishing ratefloat, nullcm²/h2700

Note: All of the following properties may be null and auto-completed from the related process or similar materials.

Usage
# GET "https://platform.3dspark.de/api/v1/material/<mat_id>/"

this.axiosInstance
  .get("/api/v1/material/535ca86f28d94dc786adf32387b0c658/")
  .then((response) => {
    console.log(response.data);
  })

Create Material (POST)

Create material and related properties.

Form Data
ParameterDescriptionRequiredTypeUnitValid ValuesDefault
restrictionAccess level of this material.falsestring“owner”, “organization”, null“owner”
mat_nameDisplay nametruestring1 – 250 characters
oem_nameBrand or manufacturer nametruestring1 – 250 characters
techTechnologytruestring“additive_manufacturing”, “milling”, “casting”, “injection_molding”“additive_manufacturing”
prc_acronymAcronym of associated process typetruestring“fdm”, “sla”, “dlp”, “dls”, “sls”, “mjf”, “pjm”, “dod”, “bj”, “slm”, “ebm”, “lmm”, “waam”
raw_mat_costRaw material costtruefloat€/kg0 – 100000
mat_rhoMaterial densitytruefloatg/cm³0.1 – 20
mac_idDefault machine idfalsestring32 character uuidProcess default machine
mat_lvl_2_idMaterial group ID. If set, levels 3 and 4 are set automatically.falsestring32 character uuidnull
mat_lvl_3_idMaterial type ID. If set, level 4 is set automatically. falsestring32 character uuidnull
mat_lvl_4_idMaterial family ID. Defaults to polymer or metal, depending on density.falsestring32 character uuidPolymer or metal
Properties Additive Manufacturing
ParameterDescriptionRequiredTypeUnitValid ValuesDefault
sup_phiRelative density if support structures.falsefloat0 – 1.0process default
c_wstRatio of built material, that cannot be recycled.falsefloat0 – 1.0process default
min_angMinimal printable supportless overhang angle (horizontal-to-surface angle).falsefloatdeg0 – 90process default
lyr_hLayer height.falsefloatmm0.001 – 100000process default
bld_spd_fillVolumetric built rate.falsefloatcm³/h0.001 – 100000process default
t_lim_minMinimal printable wall thickness.falsefloatmm0.001 – 100000process default
t_lim_maxMaximum printable wall thickness.falsefloatmm0.001 – 100000process default
gap_lim_minMinimal printable gap size.falsefloatmm0.001 – 100000process default
size_lim_minMinimal printable gap size.falsefloatmm0.001 – 100000process default
size_lim_maxMaximum general part size.falsefloatmm0.001 – 100000process default
scaling_factorsScaling factors to respect process and sintering shrinkage. falselist<float>1.0 – 100000process default
Properties MiIlling
ParameterDescriptionRequiredTypeUnitValid ValuesDefault
milling_rate_roughingMilling rate for roughingfalsefloatcm³/h0.1 – 100000mat_lvl_4 rate
milling_rate_finishingMilling rate for surface finishingfalsefloatcm²/h0.1 – 100000mat_lvl_4 rate
Return Data

See ‘Request Material by ID (GET)’

Usage
# POST "https://platform.3dspark.de/api/v1/material/<mat_id>/"

let formData = {
  "tech": "additive_manufacturing",
  "mat_name": "Arnd PLA",
  "oem_name": "Polymaker",
  "prc_acronym": "fdm",
  "raw_mat_cost": 20.50,
  "mat_rho": 1.02,
  // "restriction": 'owner',
  // "mac_id": '8198096ca74d47db90f1ca42c6e186af',
  // "mat_lvl_2_id": '4bb5ef156a9f4fa6b1fdae03bbc0bce4',  // Stainless steel
  // "mat_lvl_3_id": '2e22afb155a343d5972edaf83c73237e',  // Steel
  // "mat_lvl_4_id": '287691973c9c42efaaab13fb8a64b283',  // Metal
  // "properties_am": {
  //   "sup_phi": 0,
  //   "c_wst": 0.5,
  //   "min_ang": 0,
  //   "lyr_h": 0.025,
  //   "bld_spd_fill": 100,
  //   "t_lim_min": 0.1,
  //   "t_lim_max": 30,
  //   "gap_lim_min": 0.3,
  //   "size_lim_min": 10,
  //   "size_lim_max": 200,
  //   "scaling_factors": [1.2, 1.2, 1.24]
  // },
  // "properties_milling": {
  //   "milling_rate_roughing": 10,
  //   "milling_rate_finishing": 20,
  // }
}
this.axiosInstance
  .post("/api/v1/material/6ba40dc05533401caa9f47f014efd1f7/", formData)
  .then((response) => {
    console.log(response.data);
  })

Edit Material (PUT)

Edit material and related properties.

Form Data

At least one valid parameter. See ‘Create Material (POST)’

Return Data

See ‘Request Material by ID (GET)’

Usage
# PUT "https://platform.3dspark.de/api/v1/material/<mat_id>/"

let formData = {
  "tech": "additive_manufacturing",
  "mat_name": "Arnd PLA",
  "oem_name": "Polymakerer",
  "prc_acronym": "fdm",
  "raw_mat_cost": 66.66,
  "mat_rho": 1.03,
  "restriction": 'owner',
  "mac_id": '8585687bac9a4b8c8cb79b8af307095e',
  "mat_lvl_2_id": '4bb5ef156a9f4fa6b1fdae03bbc0bce4',  // Stainless steel
  "mat_lvl_3_id": '6e602c19007a494996ede8b9549470e3',  // Steel
  "mat_lvl_4_id": '287691973c9c42efaaab13fb8a64b283',  // Metal
  "properties_am": {
    "sup_phi": 0,
    "c_wst": 0.5,
    "min_ang": 0,
    "lyr_h": 0.025,
    "bld_spd_fill": 100,
    "t_lim_min": 0.1,
    "t_lim_max": 30,
    "gap_lim_min": 0.3,
    "size_lim_min": 10,
    "size_lim_max": 200,
    "scaling_factors": [1.3, 1.2, 1.24]
  },
  "properties_milling": {
    "milling_rate_roughing": 10,
    "milling_rate_finishing": 20,
  }
}
this.axiosInstance
  .put("/api/v1/material/535ca86f28d94dc786adf32387b0c658/", formData)
  .then((response) => {
    console.log(response.data);
  })

Delete Material (DELETE)

Delete material and related properties.

Return Data

Success notification.

Usage
// DELETE "https://platform.3dspark.de/api/v1/material/<mat_id>/"


this.axiosInstance
  .delete("/api/v1/material/535ca86f28d94dc786adf32387b0c658/")
  .then((response) => {
    console.log(response.data);
  })