{
  "$id": "https://www.hestia.earth/schema-data/json-schema/Completeness.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$comment": "Schema version 39.0.1",
  "title": "Completeness",
  "description": "How complete the data describing the [Inputs](/schema/Input), [Products](/schema/Product), [Animals](/schema/Animal), and key [Practices](/schema/Practice) are. Each field in Completeness corresponds to one or more <code>[termTypes](/schema/Term#termType)</code> in the Glossary. If an area is marked complete, this means that the types and quantities of all the items within the <code>termType(s)</code> covered by the Completeness area are recorded and if they are not recorded, this means they were not present. Use of all data in the HESTIA format must therefore be interpreted in light of completeness: if completeness is <code>true</code> for a <code>termType</code>, but no data are provided for a term in that <code>termType</code>, that means the quantity of that item was zero. For quantity, completeness can be marked as <code>true</code> if either the total quantity is provided or both the minimum and maximum are provided.\n",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "type": {
      "type": "string",
      "description": "Type of the Node",
      "default": "Completeness",
      "enum": [
        "Completeness"
      ]
    },
    "@type": {
      "type": "string",
      "description": "Type of the Node",
      "default": "Completeness",
      "enum": [
        "Completeness"
      ],
      "extend": true
    },
    "animalFeed": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all animal feed used during the Cycle, including hay and silage, are specified. Note that fresh forage has its own completeness field. | Set to true |\n| No animal feed was used during the Cycle. | Set to true |\n| Animal feed was used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "animalProduct",
            "crop",
            "processedFood"
          ]
        }
      ]
    },
    "animalPopulation": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all live animals or live aquatic species that were present during the Cycle are specified in the animal node. | Set to true |\n| No live animals were present during Cycle. | Set to true |\n| Live animals were present during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "schemaMapping": [
        {
          "animal.term.termType": [
            "liveAnimal",
            "animalProduct",
            "liveAquaticSpecies"
          ]
        }
      ]
    },
    "cropResidue": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The quantity of above and below ground crop residue created and its management are recorded. | Set to true |\n| No crop residue was created or managed during the Cycle. | Set to true |\n| Crop residue was created during the Cycle, but the quantities and management are not fully recorded. | Set to false |\n",
      "examples": [],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop"
      ],
      "schemaMapping": [
        {
          "product.term.termType": [
            "cropResidue"
          ]
        },
        {
          "practice.term.termType": [
            "cropResidueManagement"
          ]
        }
      ]
    },
    "electricityFuel": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all electricity and fuel used during the Cycle, excluding during the transport phase, are recorded. | Set to true |\n| Electricity and fuel were not used during the Cycle. | Set to true |\n| Electricity and/or fuel were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop",
        "processedFood",
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "electricity",
            "fuel"
          ]
        }
      ]
    },
    "excreta": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of excreta created and its management are specified. | Set to true |\n| No excreta was created or managed during the Cycle. | Set to true |\n| Excreta was created during the Cycle, but the quantities and management are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "practice.term.termType": [
            "excretaManagement"
          ]
        },
        {
          "product.term.termType": [
            "excreta"
          ]
        },
        {
          "transformation.term.termType": [
            "excretaManagement"
          ]
        }
      ]
    },
    "fertiliser": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all organic fertiliser and inorganic fertiliser, or the quantity of each fertiliser brand name, used during the Cycle are recorded. | Set to true |\n| No fertilisers were used during the Cycle. | Set to true |\n| Fertilisers were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "fertiliserBrandName",
            "inorganicFertiliser",
            "organicFertiliser"
          ]
        }
      ]
    },
    "freshForage": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all fresh forage fed to, or grazed by, animals during the Cycle are recorded. | Set to true |\n| No fresh forage was consumed during the Cycle. | Set to true |\n| Fresh forage was consumed during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "forage"
          ]
        }
      ]
    },
    "ingredient": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| For feed or food processing Cycles, the type and quantities of all feed or food ingredients used, such as crop products, animal products, processed foods, and/or feed or food additives are recorded. | Set to true |\n| No feed or food ingredients were used during the Cycle. | Set to true |\n| Food or feed ingredients were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "processedFood",
        "animalProduct"
      ],
      "schemaMapping": [
        {
          "if": {
            "product.term.termType": "processedFood"
          },
          "then": [
            {
              "input.term.termType": [
                "animalProduct",
                "crop",
                "feedFoodAdditive",
                "processedFood"
              ]
            }
          ]
        }
      ]
    },
    "liveAnimalInput": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all live animals or live aquatic species which were Inputs into the Cycle are specified. For example, piglets might be an Input into a pig fattening Cycle. | Set to true |\n| No live animals were Inputs into the Cycle. | Set to true |\n| Live animals were Inputs into the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "liveAnimal",
        "animalProduct",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "liveAnimal",
            "animalProduct",
            "liveAquaticSpecies"
          ]
        }
      ]
    },
    "material": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all material and substrate Inputs, which includes capital equipment depreciated over the Cycle, are recorded. | Set to true |\n| No material inputs were used during the Cycle. | Set to true |\n| Material inputs were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [],
      "exportDefaultCSV": true,
      "searchable": true,
      "schemaMapping": [
        {
          "input.term.termType": [
            "material",
            "substrate"
          ]
        }
      ]
    },
    "operation": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types of all mechanical operation performed during the Cycle and either their duration or the percentage of area they covered are recorded. | Set to true |\n| No mechanical operations were performed during the Cycle. | Set to true |\n| Mechanical operations were performed during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [],
      "exportDefaultCSV": true,
      "searchable": true,
      "schemaMapping": [
        {
          "practice.term.termType": [
            "operation"
          ]
        }
      ]
    },
    "otherChemical": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all other chemicals (including processing aids, other inorganic chemicals, and other organic chemicals) used during the Cycle are recorded. | Set to true |\n| No processing aids or other chemicals were used during the Cycle. | Set to true |\n| Processing aids and/or other chemicals were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop",
        "processedFood",
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "otherInorganicChemical",
            "otherOrganicChemical",
            "processingAid"
          ]
        }
      ]
    },
    "pesticideVeterinaryDrug": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all pesticides (either as active ingredients or brand names) and veterinary drugs used during the Cycle are recorded. | Set to true |\n| No pesticides or veterinary drugs were used during the Cycle. | Set to true |\n| Pesticides and/or veterinary drugs were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop",
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "biologicalControlAgent",
            "pesticideAI",
            "pesticideBrandName",
            "veterinaryDrug"
          ]
        }
      ]
    },
    "product": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all crop, live animal, live aquatic species, animal product, and processed food produced during the Cycle are recorded. In the case where Products were intended to be produced but no production occurred (e.g., if crops fail due to disease) the types of products should still be recorded and the quantity set to zero. | Set to true |\n| No Products were produced (or intended to be produced) during the Cycle. | Set to true |\n| Products were produced during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop",
        "processedFood",
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "product.term.termType": [
            "animalProduct",
            "aquaticCrop",
            "crop",
            "electricity",
            "feedFoodAdditive",
            "forage",
            "fuel",
            "landCover",
            "liveAnimal",
            "liveAquaticSpecies",
            "organicFertiliser",
            "inorganicFertiliser",
            "biochar",
            "processingAid",
            "processedFood",
            "seed",
            "soilAmendment",
            "substrate",
            "material"
          ]
        }
      ]
    },
    "seed": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all seed Inputs, such as seed,saplings, or semen are recorded. | Set to true |\n| No seed Inputs were used during the Cycle. | Set to true |\n| Seed Inputs were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop",
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "seed"
          ]
        }
      ]
    },
    "soilAmendment": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all soil amendments and biochar used during the Cycle are recorded. | Set to true |\n| No soil amendments were used during the Cycle. | Set to true |\n| Soil amendments were used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "schemaMapping": [
        {
          "input.term.termType": [
            "soilAmendment",
            "biochar"
          ]
        }
      ]
    },
    "transport": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The transport modes and distances for each Input to the Site are recorded. If Products were also Transported during this Cycle, the distances and modes are specified. | Set to true |\n| No Inputs were transported to the Site and no Products were transported during the Cycle. | Set to true |\n| Inputs and/or Products were transported, but data on the modes and distances are not fully recorded. | Set to false |\n",
      "examples": [],
      "exportDefaultCSV": true,
      "searchable": true,
      "schemaMapping": [
        {
          "transport.term.termType": [
            "transport"
          ]
        }
      ]
    },
    "waste": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities all waste streams, their and management, and their transport to where they are managed are specified (note that crop residue and excreta waste streams and management have their own completeness fields). Examples of waste streams include dead animals or plastic films for greenhouses. Examples of management include disposal into a water body or bio-digestion. Examples of transport include taking waste to a disposal center. | Set to true |\n| No waste streams were created or managed during the Cycle. | Set to true |\n| Waste was created or managed during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [],
      "exportDefaultCSV": true,
      "searchable": true,
      "schemaMapping": [
        {
          "input.term.termType": [
            "waste"
          ]
        },
        {
          "product.term.termType": [
            "waste"
          ]
        },
        {
          "practice.term.termType": [
            "wasteManagement"
          ]
        },
        {
          "transformation.term.termType": [
            "wasteManagement"
          ]
        }
      ]
    },
    "water": {
      "type": "boolean",
      "description": "| | || --- | --- |\n| The types and quantities of all water used during the Cycle are recorded. | Set to true |\n| No water was used during the Cycle or only very small quantities were used but not recorded (e.g., water mixed with fertilisers or pesticides for spraying). | Set to true |\n| Water was used during the Cycle, but the types and quantities are not fully recorded. | Set to false |\n",
      "examples": [
        true
      ],
      "exportDefaultCSV": true,
      "searchable": true,
      "aggregatedQualityScoreIncluded": [
        "crop",
        "aquaticCrop",
        "processedFood",
        "animalProduct",
        "liveAnimal",
        "liveAquaticSpecies"
      ],
      "schemaMapping": [
        {
          "input.term.termType": [
            "water"
          ]
        }
      ]
    },
    "schemaVersion": {
      "type": "string",
      "description": "The version of the schema when these data were created.",
      "examples": [],
      "internal": true
    },
    "added": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of fields that have been added to the original dataset.",
      "examples": [],
      "internal": true
    },
    "addedVersion": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of versions of the model used to add these fields.",
      "examples": [],
      "internal": true
    },
    "updated": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of fields that have been updated on the original dataset.",
      "examples": [],
      "internal": true
    },
    "updatedVersion": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of versions of the model used to update these fields.",
      "examples": [],
      "internal": true
    }
  },
  "oneOf": [
    {
      "required": [
        "@type"
      ]
    },
    {
      "required": [
        "type"
      ]
    }
  ],
  "required": [
    "animalFeed",
    "animalPopulation",
    "cropResidue",
    "electricityFuel",
    "excreta",
    "fertiliser",
    "freshForage",
    "ingredient",
    "liveAnimalInput",
    "material",
    "operation",
    "otherChemical",
    "pesticideVeterinaryDrug",
    "product",
    "seed",
    "soilAmendment",
    "transport",
    "waste",
    "water"
  ]
}