>Contributing Data>Special Upload Cases

Special Upload Cases


The following sections describe how to handle non-standard upload scenarios.

Multiple cropping

  • If there are multiple harvests during the same year (excluding the case of successive gathering), a new Cycle should be created for each harvest. This is in line with the FAO's approach.

Successive gathering

  • If there is successive gathering from a crop during a year, only one Cycle should be created with one Product for that crop. This again follows the FAO's approach.
  • The value for the Product can either be the sum of the total harvest in the year, or an array in which each value in the array represents a gathering event.

Failed or unharvested crops

  • If crops are not harvested, e.g., due to crop disease or changing market conditions, the Site area should not change and is recorded as normal, and this represents the area cultivated or sown.
  • Area harvested should also be specified, as this will either be zero in cases of no harvest or less than area under cultivation in cases of partial harvest. Crop yield should be specified and set to zero if the crop failed completely or was not harvested. This also follows the FAO's approach.

Short fallows and similar cases

  • Periods between the harvest of one crop and sowing of another which last less than a year should not have their own Cycle. This follows FAOSTAT conventions. Instead any Inputs or Practices related to these periods should be included in the Cycle of the main crop that follows. This means Cycles cover the period from the harvest of the preceding crop to the harvest of the current crop, which is our recommendation for all temporary crop Cycles.
  • The land cover during this period can either be specified by adding a Management blank node to the Site, or by creating a Product in the Cycle. Any term from the land cover glossary can be used. A Property should be added to each Management node or Product to state whether the land cover is either a Cover crop, Catch crop, Ground cover crop, or Short fallow crop.
  • Add the duration of the short fallow period if available by using the startDate and endDate fields on Management or Product.
  • Note that long fallow periods, lasting greater than one year, should have their own Cycle. This follows FAOSTAT conventions.

Multiple types of seed

  • In HESTIA, we do not directly differentiate seed, saplings, or other immature plants by the species of plant. When uploading, each Input must be unique.
  • If seed, saplings, etc. from different species or varieties of plant were Inputs into the same Cycle, e.g., in the case of intercropping, create an Impact Assessment for each species and link it to the Input. Additionally, add a description to the Input to provide more information.

Animal feed

  • The study may give data for the specific constituents of a feed blend fed to animals. If so, create a separate Cycle to represent the blending of multiple feed ingredients into a single concentrate feed. The Inputs to this Cycle can be crops, animal products, or other blended feeds, and the Product is the feed blend. Create an impactAssessment.id for the concentrate feed blend. This can then be linked to the feed blend Input of the animal production Cycle using the impactAssessment.id.

Cycles across multiple Sites

  • A Cycle may occur on multiple Sites (e.g., if animals move between pasture and housing). In this case, create two or more Sites and link them to the Cycle using cycle.site.id and cycle.otherSites.id. The duration which animals spend on each Site can be indicated through the cycle.siteDuration and cycle.otherSitesDuration.

Cropping Cycles across multiple years

  • Sometimes, crop production data in a research article or database are averaged across multiple Cycles.
  • Following FAOSTAT conventions, for annual crops, a Cycle should be the period from harvest of the previous crop to harvest of the current crop. For permanent crops, Cycles should last one year. We will raise an error on any uploads with cycleDuration that does not match this. Animal or other production Cycles do not need to adhere to these conventions.
  • To handle this in your upload:
    • Ideally split the Cycle up into a Cycle for each harvest to harvest period or each year using the underlying data.
    • If this is not possible, upload a Cycle representing the period from harvest to harvest which is an average over the data. Set the dates as the average date. Set the cycleDuration as an average over the Cycles. Use the uploadNotes field to document this.
    • If this is not possible, duplicate the Cycle for each year. For example, if your data are an average over three harvests, duplicate the Cycle three times and change the startDate, endDate, and cycleDuration to reflect three separate periods from harvest to harvest. Use the uploadNotes field to document this.

Hot carcass weight

  • Sometimes, production quantities of animal products are provided in terms of hot carcass weight, whereas the terms in the Glossary are in cold carcass weight.
  • To handle this, convert the data from hot carcass weight to cold carcass weight using a sensible assumption (e.g., 2% to 5% mass loss). Upload the data using the terms in kg cold carcass weight. Then add the Property Processing conversion, hot carcass weight to cold carcass weight to the Input or Product defining the conversion you used.

Cover crop

  • Cover crops should be added in the Practice node of a Cycle using the landCover term corresponding to the plant (for example, Alfalfa plant), with the value being the percentage area of your Site covered by the cover crop.
  • A Property should be added to them to clarify that they are cover crops. There are four different terms in the Glossary relating to cover crops: Cover crop, Catch crop, Ground cover, and Short fallow crop (the difference between each term is explained in the term's definition in the Glossary). These terms are Properties and can be added to a crop, forage, or landCover term with value = true to specify that the term is a cover crop.
  • If the cover crop is harvested (this is only possible for Catch crop) or if the amount of biomass generated by the cover crop is known, the crop or forage term corresponding to the plant (for example, Rye, grain) should also be added in the Product node of a Cycle (in addition to the landCover term in the Practice node), with the value being the harvested yield or biomass created.
  • If you have further information about cover crops for years preceding the first Cycle taking place on your Site, you can add this information in the Management node of your Site using terms from the landCover glossary.
  • It is good practice to add a startDate and endDate specifying the time interval during which a cover crop is on the ground when landCover terms are used (when crop or forage terms are used in Product nodes, the startDate and endDate relate to the crop's harvest, not to the actual period during which the crop is on the ground).

You can download a simple example here.

Sites with multiple cycles

  • Sometimes, multiple cycles occur on the same site.
  • To handle this in your upload, ideally change the endDate for each Cycle. If this is not possible, duplicate the Site for each Cycle. If the Site has an area, divide the area between the number of Cycles on that Site. For example, if your data consists of three cycles, with no specific calendar year associated with each of them, duplicate the Site three times and change the area to be a third of its original value, keeping the startDate, endDate, and cycleDuration of all three Cycles the same. Use the uploadNotes field to document this.