{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://treeallometry.org/data/equations.schema.json","title":"Tree Allometrics: equations.json","description":"Every equation in Tree Allometrics (https://treeallometry.org/data/equations.json). sources.json (https://treeallometry.org/data/sources.json) is an array of $defs/source. /data/equations/{id}.json is one equation with its source object in place of the source id. Data CC BY 4.0.","type":"array","items":{"$ref":"#/$defs/equation"},"$defs":{"equation":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9-]+$","description":"Stable id: the source id plus a short slug. The page is /equations/{id}/."},"source":{"type":"string","pattern":"^[a-z0-9-]+$","description":"Id of the source in sources.json that published the equation."},"name":{"type":"string","minLength":3,"description":"Short name of the equation, usually with the paper's own equation or model number."},"output":{"type":"object","properties":{"quantity":{"type":"string","enum":["agb","stem_biomass","branch_biomass","foliage_biomass","bgb","total_biomass","stem_volume","total_volume","height","root_shoot_ratio"],"description":"What the equation predicts, in the units of the canonical expression: agb = Aboveground biomass (kg); stem_biomass = Stem biomass (kg); branch_biomass = Branch biomass (kg); foliage_biomass = Foliage biomass (kg); bgb = Root biomass (kg); total_biomass = Total biomass (kg); stem_volume = Stem volume (m³); total_volume = Total volume (m³); height = Height (m); root_shoot_ratio = Root:shoot ratio."},"excludes":{"type":"array","items":{"type":"string","enum":["foliage"]},"description":"Parts the paper leaves out of its total, such as foliage (leaves)."}},"required":["quantity"],"additionalProperties":false,"description":"What the equation predicts."},"expression":{"type":"string","description":"The equation in canonical units, with any back-transformation correction factor applied. Variables: D = Diameter at breast height (1.3 m) (cm); H = Total tree height (m); rho = Wood density (oven-dry mass / green volume) (g/cm³); E = Environmental stress index (Chave et al. 2014); D30 = Stem diameter at 30 cm (cm); D50 = Stem diameter at 50 cm (cm); DRC = Root collar / stem base diameter (cm); Hstem = Palm stem height, ground to the lowest leaf (m); CD = Crown diameter (m); AGB = Aboveground dry biomass of the tree (kg). Grammar: numbers, + - * / ^ (power), parentheses, ln(), log10(), exp(), sqrt()."},"published":{"type":"object","properties":{"expression":{"type":"string","description":"The equation in the paper's own units and variable names, in the same grammar as expression."},"units":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Unit of each variable in published.expression."},"variables":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["D","H","rho","E","D30","D50","DRC","Hstem","CD","AGB"]},"description":"Paper variable name to canonical variable name, where they differ."},"output_unit":{"type":"string","description":"Unit of the result of published.expression."}},"required":["expression","units","output_unit"],"additionalProperties":false,"description":"The same equation in the paper's own units and variable names."},"taxon":{"type":"object","properties":{"level":{"type":"string","enum":["species","genus","family","mixed"],"description":"species, genus or family, or mixed for a multi-species equation."},"name":{"type":"string","description":"Scientific name for a species, genus or family; a description for mixed."},"family":{"type":"string","description":"Botanical family, when known."},"group":{"type":"string","enum":["broadleaf","conifer","palm","bamboo","mangrove","shrub","mixed"],"description":"Broad plant group: broadleaf, conifer, palm, bamboo, mangrove, shrub or mixed."}},"required":["level","name","group"],"additionalProperties":false,"description":"The trees the equation was fitted on."},"region":{"type":"object","properties":{"scope":{"type":"string","enum":["global","pantropical","continental","national","regional","site"],"description":"How wide an area the data covers: global, pantropical, continental, national, regional or site."},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"description":"ISO 3166-1 alpha-2 codes of the countries the data comes from; usually empty for global, pantropical and continental scopes."},"place":{"type":"string","description":"Where the trees were measured, in words."},"biomes":{"type":"array","items":{"type":"string","enum":["tropical","subtropical","temperate","boreal","montane","dryland","mangrove"]},"description":"Biomes the data covers."}},"required":["scope","countries","biomes"],"additionalProperties":false,"description":"Where the trees were measured."},"stand":{"type":"string","enum":["natural","plantation","agroforestry","urban","mixed"],"description":"Kind of stand: natural, plantation, agroforestry, urban or mixed."},"fit":{"default":{},"type":"object","properties":{"n_trees":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Number of trees the model was fitted on."},"dbh_min_cm":{"type":"number","minimum":0,"description":"Smallest DBH the source states for the model, cm: the fitting data, or its stated validity or domain limit (see notes)."},"dbh_max_cm":{"type":"number","exclusiveMinimum":0,"description":"Largest DBH the source states for the model, cm: the fitting data, or its stated validity or domain limit (see notes)."},"h_min_m":{"type":"number","minimum":0,"description":"Smallest tree height the source states for the model, m: the fitting data, or its stated validity or domain limit (see notes)."},"h_max_m":{"type":"number","exclusiveMinimum":0,"description":"Largest tree height the source states for the model, m: the fitting data, or its stated validity or domain limit (see notes)."},"r2":{"type":"number","minimum":0,"maximum":1,"description":"Coefficient of determination as the paper reports it."},"rse":{"type":"number","minimum":0,"description":"Residual standard error, on the log scale for log-log models."},"cf":{"type":"number","exclusiveMinimum":0,"description":"Back-transformation correction factor, already applied in expression."},"method":{"type":"string","description":"How the model was fitted, in words."}},"additionalProperties":false,"description":"What the model was fitted on, as the source states it. A missing field is one the source doesn't state, or that we haven't recorded; it is never estimated."},"evidence":{"minItems":1,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"The field this quote backs, as a path (expression, fit.n_trees, …)."},"quote":{"type":"string","minLength":1,"description":"Exact text from the source, or the equation exactly as printed."},"locator":{"type":"string","minLength":1,"description":"Where in the source: table, equation number, section or page."}},"required":["field","quote","locator"],"additionalProperties":false},"description":"Short verbatim quotes from the source backing each fact."},"check":{"minItems":1,"type":"array","items":{"type":"object","properties":{"inputs":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Canonical inputs (D in cm, H in m, rho in g/cm³, …)."},"expected":{"type":"number","description":"Expected result in the canonical output unit."},"origin":{"type":"string","enum":["published","computed"],"description":"published: the paper prints this value; computed: computed from the printed form."},"note":{"type":"string","description":"Where the value comes from or how it was computed."}},"required":["inputs","expected","origin"],"additionalProperties":false},"description":"Worked examples. On every build, expression and published.expression must both reproduce each expected value within 1%."},"verification":{"type":"string","enum":["original_read","secondary"],"description":"original_read: read in the original source; secondary: only a secondary source (another paper, brief or compilation) could be read (see secondary_url)."},"secondary_url":{"type":"string","format":"uri","description":"The secondary source (another paper, brief or compilation) the equation was read from, when verification is secondary."},"checked_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date (YYYY-MM-DD) the equation was last read and checked against its source."},"notes":{"type":"string","description":"Our notes: caveats, misprints, how the paper's form was converted."},"contributed_by":{"minItems":1,"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Ids of the people or organisations who sent us this equation, credited on its page (see /contribute/)."}},"required":["id","source","name","output","expression","published","taxon","region","stand","fit","evidence","check","verification","checked_at"],"additionalProperties":false,"description":"One allometric equation or default ratio applied per tree, taken from one source."},"source":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9-]+$","description":"Stable id, e.g. chave-2014. The page is /sources/{id}/."},"citation":{"type":"string","minLength":20,"description":"Full reference."},"title":{"type":"string","description":"Title of the work."},"authors":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Authors; long lists may be truncated."},"year":{"type":"integer","minimum":1900,"maximum":2100,"description":"Year of publication."},"venue":{"type":"string","description":"Journal or publisher."},"doi":{"type":"string","pattern":"^10\\.\\S+$","description":"DOI, without the https://doi.org/ prefix."},"url":{"type":"string","format":"uri","description":"Link to the work (the DOI link when there is one)."},"read_url":{"type":"string","format":"uri","description":"The copy that was actually read, when it is not url."},"access":{"type":"string","enum":["open","paywalled"],"description":"open or paywalled."},"license":{"type":"string","description":"Licence of the work, when it states one."},"checked_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date (YYYY-MM-DD) the record was last checked: the DOI on Crossref, or the link when there is no DOI."},"status":{"default":"current","type":"string","enum":["current","corrected","retracted"],"description":"current, or corrected or retracted when the publisher has posted a notice (checked weekly on Crossref when the source has a DOI)."},"notes":{"type":"string","description":"Our notes on the source."},"contributed_by":{"minItems":1,"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Ids of the people or organisations who sent us this source, credited on the pages of its equations (see /contribute/)."}},"required":["id","citation","title","authors","year","url","access","checked_at","status"],"additionalProperties":false,"description":"One paper, report or dataset."}}}