Glazecalc

Finds ceramic raw materials (feldspars, clays, frits, fluxes) and, if asked, colorants in Glazecalc's library by name, alias or maker. Use it to find the exact name the other tools take.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Words in the name, such as \"custer\", \"ferro 3134\" or \"kaolin\"."
    },
    "includeColorants": {
      "description": "Also search colorants and opacifiers.",
      "type": "boolean"
    },
    "category": {
      "description": "Only this category: feldspar, clay, frit, flux, silica...",
      "type": "string",
      "maxLength": 40
    },
    "region": {
      "description": "Where the potter buys materials, so suggestions are ones sold there: US, UK, EU or AU. Leave it out for any.",
      "type": "string",
      "enum": [
        "US",
        "UK",
        "EU",
        "AU"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One material from Glazecalc's library: its oxides, loss on ignition, whether it is discontinued and what replaces it, where it is sold, hazards and the data sheet it comes from.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Its name or alias."
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Works out a glaze recipe's unity (Seger) formula, oxide groups, silica to alumina ratio, fired analysis, loss on ignition and calculated thermal expansion, as the Glazecalc app does.

{
  "type": "object",
  "properties": {
    "lines": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The material, by its name in the Glazecalc library (\"Custer Spar\", \"Whiting\", \"EPK\"), or your own name when you give its analysis."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000,
            "description": "Its amount in the recipe, in any unit the other lines share (grams, parts, percent)."
          },
          "analysis": {
            "description": "Only for a material not in the library: its oxides in weight percent, as { \"SiO2\": 68.5, \"Al2O3\": 17.4 }.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 20
            },
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "loi": {
            "description": "Its loss on ignition in percent, with an analysis.",
            "type": "number",
            "minimum": 0,
            "maximum": 99.9
          }
        },
        "required": [
          "material",
          "amount"
        ]
      },
      "description": "The recipe's base materials (not colorants), at most 40 lines."
    },
    "language": {
      "description": "The language for any sentences in the answer, as a BCP 47 tag such as \"en\", \"de\" or \"ja\". Languages Glazecalc does not offer are answered in English.",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "lines"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Checks a glaze recipe for what is past a recommended limit for its firing (too much boron or alkali, too little alumina, too little or too much clay, rising expansion...) and says what the fired glaze will likely do, as the Glazecalc app does. A cone is checked in the band the recipe page gives it (low cone 06-02, mid 1-7, high 8-11); from cone 12 up (band 'top') no published limits reach, so the band's limits are not checked and limitsNote says so. With a firing, coneFit says whether the chemistry looks like that firing's, by Katz's boron rule and Hesselberth & Roy's silica and alumina whatever limit set is chosen: verdict 'cooler' or 'hotter' only when boron and silica or alumina agree on another band; 'fits' (nothing points away, not a pass); 'skipped' where the published figures do not reach (lead, lithium, much soda and potash or zinc, raku, cones 01 to 3, cooler than cone 06 or hotter than cone 10...). Cone 6 against cone 10 is told apart only roughly (strength 'soft'). These are cautions and guides from published figures, not a test and not a guarantee of food safety.

{
  "type": "object",
  "properties": {
    "lines": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The material, by its name in the Glazecalc library (\"Custer Spar\", \"Whiting\", \"EPK\"), or your own name when you give its analysis."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000,
            "description": "Its amount in the recipe, in any unit the other lines share (grams, parts, percent)."
          },
          "analysis": {
            "description": "Only for a material not in the library: its oxides in weight percent, as { \"SiO2\": 68.5, \"Al2O3\": 17.4 }.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 20
            },
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "loi": {
            "description": "Its loss on ignition in percent, with an analysis.",
            "type": "number",
            "minimum": 0,
            "maximum": 99.9
          }
        },
        "required": [
          "material",
          "amount"
        ]
      },
      "description": "The recipe's base materials (not colorants), at most 40 lines."
    },
    "firing": {
      "description": "The firing, as a cone or a temperature. Leave it out when it is not known. From cone 12 up (about 1320 °C) no published glaze limits reach, so the limits are not checked there; the cone check judges cone 06 to 10 only.",
      "type": "object",
      "properties": {
        "cone": {
          "description": "An Orton cone from 022 to 42 (\"06\", \"6\", \"10\", \"14\", a half cone as \"5.5\"), or with chart \"sk\" an SK cone (JIS R 8101) from SK 022 to SK 20 (\"6a\", \"8\", \"14\").",
          "type": "string",
          "maxLength": 10
        },
        "chart": {
          "description": "Which cones the cone is: Orton (the default) or SK (JIS R 8101).",
          "type": "string",
          "enum": [
            "orton",
            "sk"
          ]
        },
        "celsius": {
          "type": "number",
          "minimum": 500,
          "maximum": 1600
        },
        "fahrenheit": {
          "type": "number",
          "minimum": 900,
          "maximum": 2912
        }
      }
    },
    "limitSet": {
      "description": "The limits to check against: \"glazecalc\" or \"hesselberth-roy\" (Hesselberth & Roy, cone 6 and 10 only, no low-fire figures). Neither has figures from cone 12 up. Left out: the limit set saved in the account’s settings when the token may read preferences (the recipe page’s own, \"hesselberth-roy\" until changed), else \"glazecalc\".",
      "type": "string",
      "maxLength": 40
    },
    "language": {
      "description": "The language for any sentences in the answer, as a BCP 47 tag such as \"en\", \"de\" or \"ja\". Languages Glazecalc does not offer are answered in English.",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "lines"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Converts between a pyrometric cone and its temperature, and between °C and °F. Orton cones run 022 to 42: Glazecalc's figure, from 022 to 15, is Orton's older chart for large cones at 150 °C an hour, and Orton's current figures (self-supporting cones at 15, 60 and 150 °C an hour, large cones at 60 and 150, cone 022 to 14) come beside it; Orton publishes no figure above cone 14, so cones from 16 up have none. SK cones (JIS R 8101, SK 022 to SK 20) by the standard's nominal figures. Give a cone, or a temperature to find the nearest cones.

{
  "type": "object",
  "properties": {
    "cone": {
      "type": "string",
      "maxLength": 10
    },
    "chart": {
      "type": "string",
      "enum": [
        "orton",
        "sk"
      ]
    },
    "celsius": {
      "type": "number",
      "minimum": -50,
      "maximum": 2000
    },
    "fahrenheit": {
      "type": "number",
      "minimum": -60,
      "maximum": 3600
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Finds the discontinued or scarce materials in a recipe and the modern ones that replace them, then suggests amounts that keep the unity formula as near as the materials allow, as the Glazecalc app does. report.closeness says how near the new unity formula comes to the old, oxide by oxide, as match_from_materials does. Test any suggestion before using it.

{
  "type": "object",
  "properties": {
    "lines": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The material, by its name in the Glazecalc library (\"Custer Spar\", \"Whiting\", \"EPK\"), or your own name when you give its analysis."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000,
            "description": "Its amount in the recipe, in any unit the other lines share (grams, parts, percent)."
          },
          "analysis": {
            "description": "Only for a material not in the library: its oxides in weight percent, as { \"SiO2\": 68.5, \"Al2O3\": 17.4 }.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 20
            },
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "loi": {
            "description": "Its loss on ignition in percent, with an analysis.",
            "type": "number",
            "minimum": 0,
            "maximum": 99.9
          }
        },
        "required": [
          "material",
          "amount"
        ]
      },
      "description": "The recipe's base materials (not colorants), at most 40 lines."
    },
    "region": {
      "description": "Where the potter buys materials, so suggestions are ones sold there: US, UK, EU or AU. Leave it out for any.",
      "type": "string",
      "enum": [
        "US",
        "UK",
        "EU",
        "AU"
      ]
    },
    "allowLead": {
      "description": "Whether materials with lead may be suggested. Off by default.",
      "type": "boolean"
    },
    "allowMore": {
      "description": "Materials whose suggested cap to lift, as report.capped names them: raw clay is held to 20% of the batch (or the recipe's own share) where that costs the match little.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "language": {
      "description": "The language for any sentences in the answer, as a BCP 47 tag such as \"en\", \"de\" or \"ja\". Languages Glazecalc does not offer are answered in English.",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "lines"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Remakes a glaze recipe from only the materials listed in "have", keeping its unity formula as near as they allow, as Match with what I have does in the Glazecalc app. report.closeness says how near the new unity formula comes to the old, oxide by oxide: close (within 0.02, or 5% of a large amount such as silica's), off, or far (more than three times that), with a verdict (close, fair or poor) and a summary. report.miss and report.best are the solver's own scores, for comparing runs. Raw clay is held to 20% of the batch where that costs the match little (report.capped and allowMore say more). Test any suggestion before using it.

{
  "type": "object",
  "properties": {
    "lines": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The material, by its name in the Glazecalc library (\"Custer Spar\", \"Whiting\", \"EPK\"), or your own name when you give its analysis."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000,
            "description": "Its amount in the recipe, in any unit the other lines share (grams, parts, percent)."
          },
          "analysis": {
            "description": "Only for a material not in the library: its oxides in weight percent, as { \"SiO2\": 68.5, \"Al2O3\": 17.4 }.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 20
            },
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "loi": {
            "description": "Its loss on ignition in percent, with an analysis.",
            "type": "number",
            "minimum": 0,
            "maximum": 99.9
          }
        },
        "required": [
          "material",
          "amount"
        ]
      },
      "description": "The recipe's base materials (not colorants), at most 40 lines."
    },
    "have": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "description": "The library names of the materials on hand."
    },
    "mustUse": {
      "description": "Materials on hand that must stay in.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "allowMore": {
      "description": "Materials whose suggested cap to lift, as report.capped names them: raw clay is held to 20% of the batch (or the recipe's own share) where that costs the match little.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "language": {
      "description": "The language for any sentences in the answer, as a BCP 47 tag such as \"en\", \"de\" or \"ja\". Languages Glazecalc does not offer are answered in English.",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "lines",
    "have"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Works out the test tiles of a line blend between recipes a and b (2 to 11 steps), or of a triaxial blend when c is given too (2 to 6 rows, up to 21 tiles), as the Blends page of the Glazecalc app does. Each tile is a mix of the corner recipes, each taken as a percent of its base: its shares, its recipe in percent, its key unity formula figures (silica, alumina, boron, the fluxes), silica to alumina, calculated expansion, the names of the limit cautions it has, and, with a firing, whether its chemistry fits that firing (coneFit verdict). With two recipes and steps 2 it compares them oxide by oxide (differences). Give base materials only, no colorants. This is a calculation from published figures, not a test result: the tiles, fired, decide, and the cautions are guides, not a guarantee of food safety.

{
  "type": "object",
  "properties": {
    "a": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The material, by its name in the Glazecalc library (\"Custer Spar\", \"Whiting\", \"EPK\"), or your own name when you give its analysis."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000,
            "description": "Its amount in the recipe, in any unit the other lines share (grams, parts, percent)."
          },
          "analysis": {
            "description": "Only for a material not in the library: its oxides in weight percent, as { \"SiO2\": 68.5, \"Al2O3\": 17.4 }.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 20
            },
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "loi": {
            "description": "Its loss on ignition in percent, with an analysis.",
            "type": "number",
            "minimum": 0,
            "maximum": 99.9
          }
        },
        "required": [
          "material",
          "amount"
        ]
      },
      "description": "Recipe A, the first corner (the line's first tile, or the top of the triangle)."
    },
    "b": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The material, by its name in the Glazecalc library (\"Custer Spar\", \"Whiting\", \"EPK\"), or your own name when you give its analysis."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000,
            "description": "Its amount in the recipe, in any unit the other lines share (grams, parts, percent)."
          },
          "analysis": {
            "description": "Only for a material not in the library: its oxides in weight percent, as { \"SiO2\": 68.5, \"Al2O3\": 17.4 }.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 20
            },
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "loi": {
            "description": "Its loss on ignition in percent, with an analysis.",
            "type": "number",
            "minimum": 0,
            "maximum": 99.9
          }
        },
        "required": [
          "material",
          "amount"
        ]
      },
      "description": "Recipe B (the line's last tile, or the triangle's bottom left)."
    },
    "c": {
      "description": "Recipe C, the triangle's bottom right. Leave it out for a line blend between a and b.",
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The material, by its name in the Glazecalc library (\"Custer Spar\", \"Whiting\", \"EPK\"), or your own name when you give its analysis."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000,
            "description": "Its amount in the recipe, in any unit the other lines share (grams, parts, percent)."
          },
          "analysis": {
            "description": "Only for a material not in the library: its oxides in weight percent, as { \"SiO2\": 68.5, \"Al2O3\": 17.4 }.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 20
            },
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "loi": {
            "description": "Its loss on ignition in percent, with an analysis.",
            "type": "number",
            "minimum": 0,
            "maximum": 99.9
          }
        },
        "required": [
          "material",
          "amount"
        ]
      }
    },
    "steps": {
      "description": "Tiles in the line (2 to 11, default 5), or rows of the triangle when c is given (2 to 6, default 4).",
      "type": "integer",
      "minimum": 2,
      "maximum": 11
    },
    "firing": {
      "description": "The firing, as a cone or a temperature. Leave it out when it is not known. From cone 12 up (about 1320 °C) no published glaze limits reach, so the limits are not checked there; the cone check judges cone 06 to 10 only.",
      "type": "object",
      "properties": {
        "cone": {
          "description": "An Orton cone from 022 to 42 (\"06\", \"6\", \"10\", \"14\", a half cone as \"5.5\"), or with chart \"sk\" an SK cone (JIS R 8101) from SK 022 to SK 20 (\"6a\", \"8\", \"14\").",
          "type": "string",
          "maxLength": 10
        },
        "chart": {
          "description": "Which cones the cone is: Orton (the default) or SK (JIS R 8101).",
          "type": "string",
          "enum": [
            "orton",
            "sk"
          ]
        },
        "celsius": {
          "type": "number",
          "minimum": 500,
          "maximum": 1600
        },
        "fahrenheit": {
          "type": "number",
          "minimum": 900,
          "maximum": 2912
        }
      }
    },
    "limitSet": {
      "description": "The limits to check against, as check_limits takes it: \"glazecalc\" (the default) or \"hesselberth-roy\".",
      "type": "string",
      "maxLength": 40
    },
    "language": {
      "description": "The language for any sentences in the answer, as a BCP 47 tag such as \"en\", \"de\" or \"ja\". Languages Glazecalc does not offer are answered in English.",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Searches Glazecalc's plain-language guides for potters (glazing from first principles, making a glaze, safe mixing, safety at home with children and pets, firing a kiln, and a companion to John Britt's free glaze course, in English only) in the language asked for, or in English where that language has no match. Returns each matching section's title, anchor, a short excerpt, its address on the website and its resource URI, which resources/read returns in full. Use it for glaze defects, safety, firing and terms, and cite the address.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Words to look for, such as \"crawling\", \"respirator\", \"bisque schedule\" or \"specific gravity\"."
    },
    "language": {
      "description": "The language for any sentences in the answer, as a BCP 47 tag such as \"en\", \"de\" or \"ja\". Languages Glazecalc does not offer are answered in English.",
      "type": "string",
      "maxLength": 20
    },
    "guide": {
      "description": "Only this guide.",
      "type": "string",
      "enum": [
        "glazing-basics",
        "making-a-glaze",
        "safe-mixing",
        "home-safety",
        "firing",
        "learn-with-john-britt"
      ]
    },
    "cones": {
      "description": "How the potter fires, for the parts of the guides that differ: Orton cones (the default), SK cones (JIS R 8101) or by temperature.",
      "type": "string",
      "enum": [
        "orton",
        "sk",
        "temperature"
      ]
    },
    "limit": {
      "description": "At most this many sections (5 unless asked).",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}