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

Hestia Schema

import { JSON, SchemaType } from './types';
import { Term } from './Term';
import { Property } from './Property';
import { Source } from './Source';
import { TermTermType } from './Term';
export declare enum PracticeStatsDefinition {
    cycles = "cycles",
    modelled = "modelled",
    otherObservations = "otherObservations",
    regions = "regions",
    replications = "replications",
    simulated = "simulated",
    sites = "sites",
    spatial = "spatial"
}
export declare enum PracticeOwnershipStatus {
    borrowed = "borrowed",
    owned = "owned",
    rented = "rented"
}
/**
 * Contains all the TermTermType with override on the Practice.
 * Note: it does not contain the default TermTermType on related Blank Nodes.
 */
export declare const practiceTermTermType: {
    term: TermTermType[];
    methodModel: TermTermType[];
    all: TermTermType[];
};
/**
 * A Practice used during a [Cycle] or on a [Site].
 */
export declare class Practice extends JSON<SchemaType.Practice> {
    /**
    * A reference to the [Term] describing the Practice. This can be replaced by a description instead if the Term isn't available in the [Glossary](/Glossary).
    */
    term?: Term;
    /**
    * A description of the Practice. This is a required field if [term](#term) is not provided.
    */
    description?: string;
    /**
    * If the data associated with the Practice are in key:value form, the key. E.g. to describe the composition of an animal herd, the [term](#term) would be [herdComposition](/term/herdComposition), the key would describe each animal, such as [cattleDairyHeifers](/term/cattleDairyHeifers), and the [value](#value) would be the number of each animal.
    */
    key?: Term;
    /**
    * The value associated with the Practice. If an average, it should always be the mean.
    */
    value?: (string | 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?: PracticeStatsDefinition;
    /**
    * The number of observations the descriptive statistics are calculated over, if different from the [numberOfCycles](./Cycle#numberOfCycles) specified in [Cycle] or the [numberOfSites](./Site#numberOfSites) specified in [Site].
    */
    observations?: (number | null)[];
    /**
    * A corresponding array to [value](#value), representing the dates of the Practice in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD).
    */
    dates?: (string)[];
    /**
    * The start date of the Practice (if different from the start date of the [Cycle]) in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD, YYYY-MM, or YYYY).
    */
    startDate?: string;
    /**
    * The end date of the Practice (if different from the start date of the [Cycle]) in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (YYYY-MM-DD, YYYY-MM, or YYYY).
    */
    endDate?: string;
    /**
    * The area of the Site that Practice occured on.
    */
    area?: number;
    /**
    * The price paid for this Practice. The price should be expressed per the units defined in the [term](#term). The [currency](#currency) must be specified.
    */
    price?: number;
    /**
    * The total cost of this Practice ([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;
    /**
    * For operations, the ownership status of the equipment used to perform the operation.
    */
    ownershipStatus?: PracticeOwnershipStatus;
    /**
    * A list of [Properties](./Property) of the Practice, 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 [Source] of these data, if different from the defaultSource of the [Cycle] or [Site].
    */
    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)[];
}