@hestia-earth/schema/Input.d.ts

Hestia Schema

import { JSON, SchemaType } from './types';
import { Term } from './Term';
import { Property } from './Property';
import { ImpactAssessment } from './ImpactAssessment';
import { Source } from './Source';
import { TermTermType } from './Term';
export declare enum InputStatsDefinition {
    cycles = "cycles",
    modelled = "modelled",
    otherObservations = "otherObservations",
    regions = "regions",
    replications = "replications",
    simulated = "simulated",
    sites = "sites",
    spatial = "spatial"
}
/**
 * Contains all the TermTermType with override on the Input.
 * Note: it does not contain the default TermTermType on related Blank Nodes.
 */
export declare const inputTermTermType: {
    term: TermTermType[];
    methodModel: TermTermType[];
    operation: TermTermType[];
    country: TermTermType[];
    all: TermTermType[];
};
/**
 * An Input used during the [Cycle].
 */
export declare class Input extends JSON<SchemaType.Input> {
    /**
    * A reference to the [Term] describing the Input.
    */
    term?: Term;
    /**
    * A description of the Input.
    */
    description?: string;
    /**
    * The quantity of the Input. If an average, it should always be the mean. Can be a single number (array of length one) or an array of numbers with associated [dates](#dates) (e.g. representing an application schedule).
    */
    value?: (number | null)[];
    /**
    * The standard deviation of value.
    */
    sd?: (number | null)[];
    /**
    * The minimum of value.
    */
    min?: (number | null)[];
    /**
    * The maximum of value.
    */
    max?: (number | null)[];
    /**
    * What the descriptive statistics (sd, min, max, and value) are calculated across, or whether they are simulated or the output of a model. Spatial is descriptive statistics calculated across spatial units (e.g., pixels) within a region or country.
    */
    statsDefinition?: InputStatsDefinition;
    /**
    * The number of observations the descriptive statistics are calculated over, if different from the [numberOfCycles](./Cycle#numberOfCycles) specified in [Cycle].
    */
    observations?: (number | null)[];
    /**
    * A corresponding array to [value](#value), representing the dates of the Inputs in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD, YYYY-MM, YYYY, --MM-DD, or --MM).
    */
    dates?: (string)[];
    /**
    * For Inputs over periods different to [Cycle], the start date of the Input (if different from the start date of the [Cycle]) in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD).
    */
    startDate?: string;
    /**
    * For Inputs over periods different to [Cycle], the end date of the Input (if different from the start date of the [Cycle]) in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD).
    */
    endDate?: string;
    /**
    * The duration of the Input in days.
    */
    inputDuration?: number;
    /**
    * The price paid for this Input. The price should be expressed per the units defined in the [term](#term), for example per "kg active ingredient". The [currency](#currency) must be specified.
    */
    price?: number;
    /**
    * The total cost of this Input ([price](#price) x [quantity](#value)), expressed as a positive value. The [currency](#currency) must be specified.
    */
    cost?: number;
    /**
    * The three letter currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format.
    */
    currency?: string;
    /**
    * A list of [Properties](./Property) of the Input, which would override any default properties specified in [term](#term).
    */
    properties?: Property[];
    /**
    * An assessment of the reliability of these data following the pedigree matrix approach detailed by [Edelen & Ingwersen (2019)](https://cfpub.epa.gov/si/si_public_file_download.cfm?p_download_id=528687). (1) Verified (e.g. by on site checks, recalculation, or mass balance estimation) data based on measurements; (2) Verified data based on a calculation or non-verified data based on measurements; (3) Non-verified data based on a calculation; (4) Documented estimate; (5) Undocumented estimate. In different language, (1-2) can be considered primary data and (3-5) secondary.
    */
    reliability?: number;
    /**
    * A reference to the [Term] describing the method or model for acquiring or estimating these data.
    */
    methodModel?: Term;
    /**
    * A free text field, describing the method or model used for acquiring or estimating these data.
    */
    methodModelDescription?: string;
    /**
    * A reference to the [Term] describing the operation associated with this input (e.g. for the Input [diesel](/term/diesel) the operation could be [Soil decompaction, machine unspecified](/term/soilDecompactionMachineUnspecified)).
    */
    operation?: Term;
    /**
    * The [country](/glossary?termType=region) where this Input came from.
    */
    country?: Term;
    /**
    * The [region](/glossary?termType=region) where this Input came from.
    */
    region?: Term;
    /**
    * A reference to the node containing environmental impact data related to producing this product and transporting it to the [Site].
    */
    impactAssessment?: ImpactAssessment;
    /**
    * A reference to the [Source] of these data, if different from the [defaultSource](Cycle#defaultSource) of the [Cycle].
    */
    source?: Source;
    /**
    * The version of the schema when these data were created.
    */
    schemaVersion?: string;
    /**
    * A list of fields that have been added to the original dataset.
    */
    added?: (string)[];
    /**
    * A list of versions of the model used to add these fields.
    */
    addedVersion?: (string)[];
    /**
    * A list of fields that have been updated on the original dataset.
    */
    updated?: (string)[];
    /**
    * A list of versions of the model used to update these fields.
    */
    updatedVersion?: (string)[];
    /**
    * A list of fields that have been 'aggregated' using data from multiple [Cycles](./Cycle).
    */
    aggregated?: (string)[];
    /**
    * A list of versions of the aggregation engine corresponding to each aggregated field.
    */
    aggregatedVersion?: (string)[];
}