human_specific.json

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "description": "Information specific to a donor that is a human (Homo sapiens).",
    "additionalProperties": false,
    "dependencies": {
      "ethnicity_question": [
        "ethnicity"
        ],
      "ancestry_genetic_datatype": [
        "ancestry_genetic"
        ],
      "ancestry_genetic_pipeline": [
        "ancestry_genetic"
        ]
      },
    "title": "Human-specific",
    "name": "human_specific",
    "type": "object",
    "properties": {
        "describedBy":  {
            "description": "The URL reference to the schema.",
            "type": "string",
            "pattern" : "^(http|https)://schema.(.*?)humancellatlas.org/module/biomaterial/(([0-9]{1,}.[0-9]{1,}.[0-9]{1,})|([a-zA-Z]*?))/human_specific"
        },
        "schema_version": {
            "description": "The version number of the schema in major.minor.patch format.",
            "type": "string",
            "pattern": "^[0-9]{1,}.[0-9]{1,}.[0-9]{1,}$",
            "example": "4.6.1"
        },
        "body_mass_index": {
            "description": "The body mass index of the donor.",
            "type": "number",
            "maximum": 100,
            "minimum": 5,
            "example": 36.4,
            "user_friendly": "Body mass index"
        },
        "ethnicity": {
            "description": "Ethnicity of the donor.",
            "type": "array",
            "items": {
                "$ref": "module/ontology/ethnicity_ontology.json"
            },
            "user_friendly": "Ethnicity",
            "guidelines": "Enter one or more ethnicities, separated by a comma."
        },
        "ethnicity_question": {
            "description": "Question and response options posed to donors for collecting metadata on donor self-reported ethnicity and / or tribe and / or dialect group and / or race etc.",
            "type": "string",
            "user_friendly": "Ethnicity question",
            "example": "What is your ethnicity?; Are you Hispanic/Latino?; Which categories describe you? Select all that apply. Note You may select more than one group. 1. American Indian or Alaska Native (for example, Aztec, Blackfeet Tribe, Mayan, Navajo Nation, Native Village of Barrow (Utqiagvik) Inupiat Traditional Government, Nome Eskimo Community, etc.), 2 - Asian (for example, Asian Indian, Chinese, Filipino, Japanese, Korean, Vietnamese, etc.), 3 - Black, African American, or African (for example, African American, Ethiopian, Haitian, Jamaican, Nigerian, Somali, etc.), 4 - Hispanic, Latino, or Spanish (for example, Columbian, Cuban, Dominican, Mexican or Mexican American, Puerto Rican, Salvadoran, etc.), 5 - Middle Eastern or North African (for example, Algerian, Egyptian, Iranian, Lebanese, Moroccan, Syrian, etc.), 6 - Native Hawaiian or other Pacific Islander (for example, Chamorro, Fijian, Marshallese, Native Hawaiian, Tongan, etc.), 7 - White (for example, English, European, French, German, Irish, Italian, Polish, etc.), 8 - None of these fully describe me (optional free text answer), 9 - Prefer not to answer",
            "bionetworks": ["genetic diversity"]
        },
        "ethnicity_parents": {
            "description": "Ethnicity(-ies) of the donor's parents.",
            "type": "array",
            "items": {
                "$ref": "module/ontology/ethnicity_ontology.json"
            },
            "user_friendly": "Parents ethnicity",
            "guidelines": "Enter one or more ethnicities, separated by a comma.",
            "bionetworks": ["genetic diversity"]
        },
        "ancestry_genetic": {
            "description": "A quantitative measure of genetic ancestry. For instance Establish common coordinates across all studies, based on a reference comprising the 1000 Genomes Project and Human Genome Diversity Project datasets. Project donor data (genotype data, single-cell genomics data) against reference datasets. Report coordinates in principal component analysis (PCA) space relative to reference datasets.",
            "type": "array",
            "items": {
                "type": "string"
            },
            "user_friendly": "Genetic ancestry",
            "example": "PCA1: 0.1234; PCA2: -0.5678 or CENTRAL_SOUTH_ASIA: 0.0505; AMERICA: -0.1234",
            "guidelines": "Separate components with double pipe character \\|\\|.",
            "bionetworks": ["genetic diversity"]
        },
        "ancestry_genetic_datatype": {
            "description": "Data type (genotyping array, whole-genome sequence, single-cell genomics data) used for inference of genetic ancestry.",
            "type": "string",
            "user_friendly": "Genetic ancestry datatype",
            "example": "singlecellFASTQ; IlluminaGSAv3; WGS",
            "bionetworks": ["genetic diversity"]
        },
        "ancestry_genetic_pipeline": {
            "description": "Pipeline name used for inference of genetic ancestry.",
            "type": "string",
            "user_friendly": "Genetic ancestry pipeline",
            "example": "scadmix; HCA; local",
            "bionetworks": ["genetic diversity"]
        },
        "primary_language": {
            "description": "Primary language(s), spoken by donor. Can include dialects (for example, Hokkien).",
            "type": "array",
            "items": {
                "type": "string"
            },
            "user_friendly": "Donor primary language",
            "example": "Mandarin Chinese; Hokkien; Bahasa Melayu",
            "bionetworks": ["genetic diversity"]
        },
        "mother_father_language": {
            "description": "Ancestral language(s), spoken by parents (“mother tongue” and / or “father tongue”) and / or grandparents. Can include dialects (for example, Hokkien).",
            "type": "array",
            "items": {
                "type": "string"
            },
            "user_friendly": "Mother/ Father Tongue",
            "example": "Mandarin Chinese; Hokkien; Bahasa Melayu",
            "bionetworks": ["genetic diversity"]
        },
        "current_residence_location_country": {
            "description": "Country and state of donor's current residence at time of sample collection.",
            "type": "string",
            "user_friendly": "Country of current residence",
            "example": "Singapore; United Kingdom; Massachusetts USA; New South Wales Australia; Nassau Bahamas",
            "guidelines": "Enter the country and state if available.",
            "bionetworks": ["genetic diversity"]
        },
        "current_residence_location_granular": {
            "description": "Nearest city, town, or village to location of donor's current residence at time of sample collection.",
            "type": "string",
            "user_friendly": "Location of current residence",
            "example": "Singapore; Cambridge; Boston; Kingston",
            "bionetworks": ["genetic diversity"]
        },
        "current_residence_duration": {
            "description": "Duration of residence, in years, rounded up to the nearest whole number, at time of sample collection.",
            "type": "string",
            "pattern": "^[0-9]+-?[0-9]*$",
            "user_friendly": "Duration of current residence",
            "example": "20; 45-65",
            "guidelines": "Enter either a single value or a range of values. Indicate a range using a hyphen.",
            "bionetworks": ["genetic diversity"]
        },
        "current_residence_urbanrural": {
            "description": "Urban, suburban, or rural descriptor of current residence.",
            "type": "string",
            "enum": [
                "urban",
                "suburban",
                "rural"
            ],
            "user_friendly": "Area type of current residence",
            "example": "urban; suburban; rural",
            "guidelines": "Should be one of: urban; suburban; rural",
            "bionetworks": ["genetic diversity"]
        },
        "place_of_birth_location_country": {
            "description": "Country and state of place of birth.",
            "type": "string",
            "user_friendly": "Country of birth",
            "example": "Singapore; United Kingdom; Massachusetts USA; New South Wales Australia; Nassau Bahamas",
            "guidelines": "Enter the country and state if available.",
            "bionetworks": ["genetic diversity"]
        },
        "place_of_birth_location_granular": {
            "description": "Nearest city, town, or village to location of place of birth.",
            "type": "string",
            "user_friendly": "Location of birth",
            "example": "Singapore; Cambridge; Boston; Kingston",
            "bionetworks": ["genetic diversity"]
        },
        "place_of_birth_duration": {
            "description": "Duration of residence, in years, rounded up to the nearest whole number.",
            "type": "string",
            "pattern": "^[0-9]+-?[0-9]*$",
            "user_friendly": "Duration in place of birth",
            "example": "20; 45-65",
            "guidelines": "Enter either a single value or a range of values. Indicate a range using a hyphen.",
            "bionetworks": ["genetic diversity"]
        },
        "place_of_birth_urbanrural": {
            "description": "Urban, suburban, or rural descriptor of place of birth.",
            "type": "string",
            "enum": [
                "urban",
                "suburban",
                "rural"
            ],
            "user_friendly": "Area type of place of birth",
            "example": "urban; suburban; rural",
            "guidelines": "Should be one of: urban; suburban; rural",
            "bionetworks": ["genetic diversity"]
        }
    }
}