Humanitarian eXchange Language (HXL) Situation and Response Standard


This version:
http://carsten.io/hxl/ns-2012-02-22
Latest version:
http://hxl.humanitarianresponse.info/
Previous version:
http://carsten.io/hxl/ns-2012-02-12
Revision:
February 22, 2012
Authors:
Carsten Keßler
CJ Hendrix
Further information:
For further information about the HXL project, see https://sites.google.com/site/hxlproject/.
Formats:
Besides this human-readable form, the HXL vocabulary specification is also available in various machine-readble RDF serializations: RDF/XML | Turtle | N-Triples.

The XML Namespace URI that should be used by implementations of this version of the specification is: http://carsten.io/hxl/ns-2012-02-22.

The preferred prefix for the vocabulary is hxl.

Table of contents

  1. Introduction
  2. The HXL vocabulary at a glance
  3. Cross-reference for core HXL classes and properties by section
    1. Date/Time Section
    2. Geolocation Section
    3. Metadata Section
    4. Response Section
    5. Shelter Cluster Section
    6. Situation Section
  4. Integrated graph overview of the complete HXL vocabulary
  5. License
  6. Change log

1. Introduction

Draft specification of the Humanitarian eXchange Language (HXL) standard. This vocabulary specification is currently under development and may change at any time without notice.

The porpuse of HXL is to facilitate data exchange within the humanitarian domain. It provides a core domain model that has been created bottom-up by inspecting a broad range of systems in use with different humanitarian organisations. As needs vary widely across organisations in this domain, this vocabulary does not intend to be complete; in fact, it is the smallest common denominator. Any organisations that wish to publish full exports of their data can do so by extending this domain model with application- or organisation-specific models that reflect their internal data models (which may already be formalised in an XML schema or database schema).

The Humanitarian eXchange Language is defined as a set of classes and properties, using the Resource Description Framework (RDF) as underlying technology. This enables HXL to publish humanitarian data as part of the Linked Open Data cloud. We recommend Tim Berners-Lee's TED Talk as a quick introduction to Linked Data and RDF, and the Linked Data book by Tom Heath and Chris Bizer as a more in-depth, technical primer to the topic.

The following series of figures illustrates the basics of RDF and Linked Data that are required to understand this document.

RDF is based on statements of the form subject - predicate - object. Subject and object are illustrated as ellipses, the prediacte – or property – connects them and points from subject to object.

URLs act as unique identifiers for subjects, properties and objects, as shown here. This way, more information about these can be found out by visiting the URLs. In case of the property, it should return its definition – again in RDF.

Namespace declarations can be used to make the URLs more compact. In this standard, we only show the namespace prefix if the class or property has been defined in an external standard. Moreover, the object of a statement (or triple) can also be a literal, such as a string or a number. Literals are visualized as boxes.

Any subjects and (non-literal) objects should be typed. The classes defined in this standard declare the types that can be used for this purpose.

The definitions of these classes are based on subclass hierarchies, indicated by a dotted red line in the figure. Emergency is a subclass of Situation, for example. Subclasses inherit from their superclasses, most importantly in terms of the domain and range of properties.

The domain and range define the types of things between which a property can be used. Consider the property hasObjective, whose domain is defined as Humanitarian Activity. This states that whenever we see a statement using hasObjective as property, we can infere that the subject of this triple is a Humanitarian Activity. Likewise, its range is defined as Objective, so that we can infere that the object in any statement using hasObjective is an Objective. In the graphs shown in this standard, the property arrows point from domain to range (i.e., from kinds of subjects to kinds of objects).

2. The HXL vocabulary at a glance

An alphabetical index of all terms from the HXL vocabulary, by class and by property, is given below for quick reference. Click the terms for a more detailed description.

Classes | Humanitarian Activity | Administrative Unit | Administrative Unit Level | Affected Population | Age Group | Approval level | Bladder | Blanket | Bounding Box | Bucket | Bucket / Jerry Can | Casualty | Cluster | Community tool kit | Cot | Data container | Dead | Displaced | Distributing partner | Distribution | Emergency | Tent (family) | Family tool kit | Feature | Female | GLIDE number | Geometry | Hygiene kit | Internally Displaced Person | Impact planned | Indicator | Individual item | Injured | Jerry Can | Kit | Kitchen set | Tent (large) | Line String | Male | Mat | Missing | MosquitoNet | Need | Non-Displaced | Non-food item | Objective | Organisation | Internally Displaced Person | Outcome planned | Outcome to date | Output planned | Output to date | Point | Pole | Polygon | Populated Place | Population | Priority | Refugees and Asylum Seekers | Reporting Period | Response | Rope | Sex | Sheet | Shelter kit | Situation | Status | Supplying agency | Tarpaulin | Tent | Tool kit | Total Population | Water filter | http://purl.org/dc/terms/PeriodOfTime | http://xmlns.com/foaf/0.1/Agent | http://xmlns.com/foaf/0.1/Group | http://xmlns.com/foaf/0.1/Organisation |

Properties | actual end | actual start | addresses | affected by | approved at level | approved by | as WKT | at level | atLocation | based on | common title | completed outcome of | completed output of | contains | contains item | contains primary data | contains secondary data | count | crosses | data collection process | distributes | duration | end | equals | extends | for emergency | from age | funded by | has beneficiary | has GLIDE number | has geometry | has objective | has part | has priority | has standard | has status | has value | identified at | implemented by | in administrative unit | intersects | involved in | measurement of | measures | near | overlaps | planned end | planned start | provenance Information | provides | reaches | reported by | start | supplies | to age | touches | within | http://purl.org/dc/terms/date | http://purl.org/dc/terms/description |

3. Cross-reference for all HXL classes and properties

The cross-reference is organized into thematic sections. Each section is illustrated by a graph of the respective classes and properties. The ellipses in the graph represent classes, whereas the arrows represent properties. Dashed lines indicate a subclass relationship (e.g. Camp is a subclass of Site). Solid lines are labeled with the property that connects these two classes. Grey ellipses indicate adjacent classes that are defined in a different section.

Jump directly to the different sections: | Date/Time Section | Geolocation Section | Metadata Section | Response Section | Shelter Cluster Section | Situation Section |

Date/Time Section

This section of the vocabulary defines the date/time standard. The draft HXL date/time standard contains a detailed description of how to use the classes and properties.

Alphabetical index of all classes and properties in the Date/Time Section:

Extended graph visualization of the Date/Time Section, including adjacent classes defined in a different section (in grey).

[click to enlarge]

Classes:

Class: Reporting Period

The time frame that a report covers.
Term origin: Sigmah DB.

Identifier: ReportingPeriod
Subclass of: http://purl.org/dc/terms/PeriodOfTime

[back to overview]


Class: dc:PeriodOfTime

Identifier: http://purl.org/dc/terms/PeriodOfTime
Subclasses: Reporting Period |
Domain of: duration | end | start |

[back to overview]


Properties:

Property: actual end

Specifies the actual end of an activity.

Identifier: actualEnd
Domain: Humanitarian Activity
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: actual start

Specifies the actual start of an activity.

Identifier: actualStart
Domain: Humanitarian Activity
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: duration

Specifies the duration of a period of time; if the duration is given, start and/or end may be omitted.

Identifier: duration
Domain: http://purl.org/dc/terms/PeriodOfTime
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: end

Specifies the end of activities, projects, etc.

Identifier: end
Domain: http://purl.org/dc/terms/PeriodOfTime
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: planned end

Specifies the planned end of an activity.

Identifier: plannedEnd
Domain: Humanitarian Activity
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: planned start

Specifies the planned start of an activity.

Identifier: plannedStart
Domain: Humanitarian Activity
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: start

Specifies the start of time periods.

Identifier: start
Domain: http://purl.org/dc/terms/PeriodOfTime
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: dc:date

Generic property for date/time stamps at arbitrary granularity.

Identifier: http://purl.org/dc/terms/date
Domain: Outcome to date Output to date
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Geolocation Section

This section of the vocabulary defines the geolocation standard. The draft HXL geolocation standard contains a detailed description of how to use the classes and properties.

Alphabetical index of all classes and properties in the Geolocation Section:

Extended graph visualization of the Geolocation Section, including adjacent classes defined in a different section (in grey).

[click to enlarge]

Classes:

Class: Administrative Unit

Administrative units can include coutries, regions, cities, etc. The hierarchy of administrative units can vary from country to country.

Identifier: AdminUnit
Subclass of: Feature
Subclasses: Populated Place |
Domain of: at level | in administrative unit |
Range of: in administrative unit |

[back to overview]


Class: Administrative Unit Level

The specific administrative unit levels can vary from country to country. Administrative Unit Level 0 is a country – in this case, hxl:Country should be used.

Identifier: AdminUnitLevel
Range of: at level |

[back to overview]


Class: Bounding Box

A BoundingBox is a Polygon defined by 1 exterior boundary and 0 interior boundaries. The exterior boundary consists of 4 points arranged as a rectangle.

Identifier: BoundingBox
Subclass of: Polygon

[back to overview]


Class: Feature

Any real-word phenomenon with spatial extent, i.e. size, shape, or position.

Identifier: Feature
Subclass of: http://www.w3.org/2003/01/geo/wgs84_pos#SpatialThing
Subclasses: Administrative Unit |
Domain of: has geometry |
Range of: atLocation |

[back to overview]


Class: Geometry

Abstract root class of the geometry. This class should not be instantiated; use any of the subclasses when creating actual geometries.

Identifier: Geometry
Subclasses: Line String | Point | Polygon |
Domain of: as WKT | contains | crosses | equals | intersects | near | overlaps | touches | within |
Range of: contains | crosses | equals | has geometry | intersects | near | overlaps | touches | within |

[back to overview]


Class: Line String

A LineString is a Curve with linear interpolation between Points. Each consecutive pair of Points defines a Line segment.

Identifier: Line
Subclass of: Geometry

[back to overview]


Class: Point

A Point is a 0-dimensional geometric object and represents a single location in a two- or three-dimensional coordinate space.

Identifier: Point
Subclass of: Geometry

[back to overview]


Class: Polygon

A Polygon is a planar Surface defined by 1 exterior boundary and 0 or more interior boundaries. Each interior boundary defines a hole in the Polygon.

Identifier: Polygon
Subclass of: Geometry
Subclasses: Bounding Box |

[back to overview]


Class: Populated Place

Lowest-level administrative unit, such as a town or settlement.

Identifier: PopulatedPlace
Subclass of: Administrative Unit

[back to overview]


Properties:

Property: as WKT

A geometry serialised as WKT. Note that the WKT serialisation contains the spatial reference system (SRS), as specified in the OGC Simple Feature standard. If no SRS is given, HXL uses WGS 84 as the standard SRS.

Identifier: asWKT
Domain: Geometry
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: at level

Specifies the level for an administrative unit.

Identifier: atLevel
Domain: Administrative Unit
Range: Administrative Unit Level
Inverse property: levelOf

[back to overview]


Property: atLocation

Specififes the location for things like emergencies, projects, or camps.

Identifier: atLocation
Domain: Emergency Situation Humanitarian Activity
Range: Feature
Inverse property: locationOf

[back to overview]


Property: contains

Topological relation. States that one geometry contains another one.

Identifier: contains
Domain: Geometry
Range: Geometry

[back to overview]


Property: crosses

Topological relation. States that one geometry crosses another one.

Identifier: crosses
Domain: Geometry
Range: Geometry

[back to overview]


Property: equals

Topological relation. States that two geometries are equal.

Identifier: equals
Domain: Geometry
Range: Geometry

[back to overview]


Property: has geometry

Relates a feature to its geometry.

Identifier: hasGeometry
Domain: Feature
Range: Geometry
Inverse property: isGeometryOf

[back to overview]


Property: in administrative unit

Specifies direct containment between two administrative units. This property should only be used between administrative units that directly contain each other, i.e., when the administrative unit level of the containing unit is the level of the contained unit plus 1.

Identifier: inAdminUnit
Domain: Administrative Unit
Range: Administrative Unit

[back to overview]


Property: intersects

Topological relation. States that one geometry intersects another one.

Identifier: intersects
Domain: Geometry
Range: Geometry

[back to overview]


Property: near

Topological relation. States that one geometry is near another one.

Identifier: near
Domain: Geometry
Range: Geometry

[back to overview]


Property: overlaps

Topological relation. States that one geometry overlaps another one.

Identifier: overlaps
Domain: Geometry
Range: Geometry

[back to overview]


Property: touches

Topological relation. States that one geometry touches another one.

Identifier: touches
Domain: Geometry
Range: Geometry

[back to overview]


Property: within

Topological relation. States that one geometry is within another one.

Identifier: within
Domain: Geometry
Range: Geometry

[back to overview]


Metadata Section

This section of the vocabulary defines the standards for metadata about a set of HXL data that is being exchanged.

Alphabetical index of all classes and properties in the Metadata Section:

Extended graph visualization of the Metadata Section, including adjacent classes defined in a different section (in grey).

[click to enlarge]

Classes:

Class: Approval level

Instance of this class define fixed levels of approval. E.g. in the WHO system, there could be three levels: region, country, and world.

Identifier: ApprovalLevel
Range of: approved at level |

[back to overview]


Class: Data container

This is the container element for to attach any metadata to. Any HXL file has to include exactly one data container element and make all metadata statements about this container. When loading the file into the triple store, a new named graph will be created that inherits the metadata from this container.

Identifier: DataContainer
Domain of: approved at level | approved by | contains primary data | contains secondary data | data collection process | reported by |

[back to overview]


Properties:

Property: approved at level

A container can have approval at different levels, which may in turn indicate for which kind of analyses the data in this container is fit.

Identifier: approvedAtLevel
Domain: Data container
Range: Approval level

[back to overview]


Property: approved by

Link from a container to the person or organisation who has 'lifted' it to the current approvalLevel.

Identifier: approvedBy
Domain: Data container
Range: http://xmlns.com/foaf/0.1/Agent

[back to overview]


Property: contains primary data

A container can contain primary data, secondary data, or both.

Identifier: containsPrimaryData
Domain: Data container
Range: http://www.w3.org/2001/XMLSchema#boolean

[back to overview]


Property: contains secondary data

A container can contain primary data, secondary data, or both.

Identifier: containsSecondaryData
Domain: Data container
Range: http://www.w3.org/2001/XMLSchema#boolean

[back to overview]


Property: data collection process

Links a container to a description of the data collection process. We'll have to discuss this – is there a set fixed procedures (such as MIRA) so that it would make sense to have a class DataCollectionProcess?

Identifier: dataCollectionProcess
Domain: Data container
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: reported by

The reporting person or organization is not necessarily involved in the aid activity itself, though in practice it often will be a donor or appealing agency.
Term origin: IATI.

Identifier: reportedBy
Domain: Data container
Range: http://xmlns.com/foaf/0.1/Agent

[back to overview]


Response Section

This section of the vocabulary defines the standards for response activities.

Alphabetical index of all classes and properties in the Response Section:

Extended graph visualization of the Response Section, including adjacent classes defined in a different section (in grey).

[click to enlarge]

Classes:

Class: Humanitarian Activity / Project / Intervention

An Activity generally addresses some kind of need given in a Humanitarian Situation. Synonyms: Project, intervention.
Term origin: IATI, CAP OPS, Pakistan SRF, Sahana Project, Sigmah DB

Identifier: Activity
Subclasses: Distribution |
Domain of: actual end | actual start | addresses | atLocation | funded by | has beneficiary | has objective | has part | has priority | has status | implemented by | planned end | planned start |
Range of: has part | involved in |

[back to overview]


Class: Cluster

An organizational unit responsible for one or more sectors during an emergency.
Term origin: CAP OPS, CCDI.

Identifier: Cluster

[back to overview]


Class: Impact planned

The positive and negative, primary and secondary long-term effects produced by a humanitarian action, directly or indirectly. Example: reduction in child mortality. See CAP Guidelines 2012.

Identifier: ImpactPlanned
Subclass of: Objective

[back to overview]


Class: Objective

An objective states part of your humanitarian strategy in terms of the expected outputs, outcomes and impact, supported by a convincing description of how you will attain them in the face of limited resources, imperfect access and other impediments. Every objective should be SMART: specific, measurable (when matched with relevant indicators), achievable, relevant and time-bound. (CAP 2012 Guidelines)
Term origin: Sahana Project, CERF

Identifier: Objective
Subclasses: Impact planned | Outcome planned | Output planned |
Range of: has objective | measures |

[back to overview]


Class: Organisation

A humanitarian organisation.
Term origin: IATI, CAP OPS, Pakistan SRF, EIMS Report, Shelter Cluster, Sigmah DB.

Identifier: Organisation
Subclass of: http://xmlns.com/foaf/0.1/Organisation
Subclasses: Distributing partner | Supplying agency |
Domain of: involved in |
Range of: extends | funded by | has beneficiary | implemented by |

[back to overview]


Class: Outcome planned

Planned outcome. An outcome is the short-term or medium-term effect of a humanitarian action on the affected population. Outcomes often are the results of multiple outputs; each outcome in your planning may therefore correspond to more than one output. Example: increase in household consumption of potable water. See CAP Guidelines 2012.

Identifier: OutcomePlanned
Subclass of: Objective
Range of: completed outcome of |

[back to overview]


Class: Outcome to date / Outcome achieved

The state of this outcome at a certain point in time. An outcome is the short-term or medium-term effect of a humanitarian action on the affected population. Outcomes often are the results of multiple outputs; each outcome in your planning may therefore correspond to more than one output. Example: increase in household consumption of potable water. See CAP Guidelines 2012.

Identifier: OutcomeToDate
Domain of: completed outcome of | measurement of | http://purl.org/dc/terms/date |

[back to overview]


Class: Output planned

Planned output. The outputs are the products, goods or services that are the direct results of a humanitarian action. Example: NFI kits in the hands of affected households; functioning water points; latrines; distributed food rations; therapeutic feeding treatments. See CAP Guidelines 2012.

Identifier: OutputPlanned
Subclass of: Objective
Range of: completed output of |

[back to overview]


Class: Output to date / Output achieved

The state of this outcome at a certain point in time. The outputs are the products, goods or services that are the direct results of a humanitarian action. Example: NFI kits in the hands of affected households; functioning water points; latrines; distributed food rations; therapeutic feeding treatments. See CAP Guidelines 2012. See CAP Guidelines 2012.

Identifier: OutputToDate
Domain of: completed output of | measurement of | http://purl.org/dc/terms/date |

[back to overview]


Class: Priority

The priority for a project or activity. Individuals of this class should be created whenever a fixed scale for priorities is in use.
Term origin: CAP OPS, UNHCR Camp DB, Sahana Project, MIRA, HPM Ethiopia.

Identifier: Priority
Range of: has priority |

[back to overview]


Class: Response

Generic term for the collection of all activities that address the needs araising from an emergency.
Term origin: ACAPS DSS, ACAPS DSS, MIRA, EDXL, CCDI (Humanitarian Response), CERF (Humanitarian Response)

Identifier: Response
Domain of: addresses | for emergency | has part |

[back to overview]


Class: Status

Status of an activity. Can be instantiated by organisations that use standardised status codes.
Term origin: Sahana Project CCDI, CERF, EDXL.

Identifier: Status
Range of: has status |

[back to overview]


Class: foaf:Organisation

Identifier: http://xmlns.com/foaf/0.1/Organisation
Subclass of: http://xmlns.com/foaf/0.1/Agent
Subclasses: Organisation |

[back to overview]


Properties:

Property: addresses

States that a certain activity addresses a need.

Identifier: addresses
Domain: Response Humanitarian Activity
Range: Need
Inverse property: addressedBy

[back to overview]


Property: completed outcome of

Relates the outcome to date to the outcome planned.

Identifier: completedOutcomeOf
Domain: Outcome to date
Range: Outcome planned

[back to overview]


Property: completed output of

Relates the output to date to the output planned.

Identifier: completedOutputOf
Domain: Output to date
Range: Output planned

[back to overview]


Property: extends

The subunit of the funding country or organisation, financing the activity from its own budget (e.g. a government agency or department).
Term origin: IATI.

Identifier: extends
Domain:
Range: Organisation

[back to overview]


Property: for emergency

States that a certain activity has been initiated for an emergency.

Identifier: forEmergency
Domain: Response
Range: Emergency
Inverse property: emergencyOf

[back to overview]


Property: funded by

Relates an activity to the organisation providing money or any kind of funding.
Term origin: IATI.

Identifier: fundedBy
Domain: Humanitarian Activity
Range: Organisation

[back to overview]


Property: has beneficiary

An organisation receiving funding for this activity and ultimately carrying it out.
Term origin: IATI.

Identifier: hasBeneficiary
Domain: Humanitarian Activity
Range: Organisation

[back to overview]


Property: has objective

Defines the objectives for an activity or project.

Identifier: hasObjective
Domain: Humanitarian Activity
Range: Objective
Inverse property: isObjectiveOf

[back to overview]


Property: has part

Specifies part-whole relationships; e.g., a specific project can have sub-projects or specific activities.

Identifier: hasPart
Domain: Response Humanitarian Activity
Range: Humanitarian Activity
Inverse property: partOf

[back to overview]


Property: has priority

Defines the priority for an activity or project.

Identifier: hasPriority
Domain: Humanitarian Activity
Range: Priority
Inverse property: isPriorityOf

[back to overview]


Property: has status

Sets the current status for an activity.

Identifier: hasStatus
Domain: Humanitarian Activity
Range: Status
Inverse property: statusOf

[back to overview]


Property: implemented by

Property for external organisations / partners implenting (parts) of a project for an agency.
Term origin: IATI, CAP OPS, Pakistan SRF, HPM Ethiopia (Partner), Sigmah DB (Partner).

Identifier: implementedBy
Domain: Humanitarian Activity
Range: Organisation

[back to overview]


Property: involved in

Indicates an organisation's involvement in an activity.

Identifier: involvedIn
Domain: Organisation
Range: Humanitarian Activity
Inverse property: involvedOrganisation

[back to overview]


Property: measurement of

Defines what impact an output / outcome to date measures.

Identifier: measurementOf
Domain: Output to date Outcome to date
Range: Indicator

[back to overview]


Property: measures

Specififes the need or objective that a certain indicator addresses or measures. Eventually create second property for objectives?

Identifier: measures
Domain: Indicator
Range: Objective
Inverse property: measuredBy

[back to overview]


Shelter Cluster Section

This section of the vocabulary defines the standards for the shelter cluster.

Alphabetical index of all classes and properties in the Shelter Cluster Section:

Extended graph visualization of the Shelter Cluster Section, including adjacent classes defined in a different section (in grey).

[click to enlarge]

Classes:

Class: Bladder

Term origin: Shelter Cluster.

Identifier: Bladder
Subclass of: Non-food item

[back to overview]


Class: Blanket

Term origin: Shelter Cluster.

Identifier: Blanket
Subclass of: Non-food item

[back to overview]


Class: Bucket

Term origin: Shelter Cluster.

Identifier: Bucket
Subclass of: Bucket / Jerry Can

[back to overview]


Class: Bucket / Jerry Can

Term origin: Shelter Cluster.

Identifier: BucketJerryCan
Subclass of: Non-food item
Subclasses: Bucket | Jerry Can |

[back to overview]


Class: Community tool kit

Term origin: Shelter Cluster.

Identifier: CommunityToolKit
Subclass of: Tool kit

[back to overview]


Class: Cot

Term origin: Shelter Cluster.

Identifier: Cot
Subclass of: Non-food item

[back to overview]


Class: Distributing partner

Term origin: Shelter Cluster.

Identifier: DistributingPartner
Subclass of: Organisation
Domain of: distributes |

[back to overview]


Class: Distribution

Do we need a distribution point?Term origin: Shelter Cluster.

Identifier: Distribution
Subclass of: Humanitarian Activity
Domain of: provides | reaches |

[back to overview]


Class: Tent (family) / Family tent

Term origin: Shelter Cluster.

Identifier: FamilyTent
Subclass of: Tent

[back to overview]


Class: Family tool kit

Term origin: Shelter Cluster.

Identifier: FamilyToolKit
Subclass of: Tool kit

[back to overview]


Class: Hygiene kit

Term origin: Shelter Cluster.

Identifier: HygieneKit
Subclass of: Kit

[back to overview]


Class: Individual item

Term origin: Shelter Cluster.

Identifier: IndividualItem
Subclass of: Non-food item

[back to overview]


Class: Jerry Can

Term origin: Shelter Cluster.

Identifier: JerryCan
Subclass of: Bucket / Jerry Can

[back to overview]


Class: Kit

Term origin: Shelter Cluster.

Identifier: Kit
Subclasses: Hygiene kit | Shelter kit | Tool kit |
Domain of: contains item |
Range of: distributes | provides | supplies |

[back to overview]


Class: Kitchen set

Is this a Kit?Term origin: Shelter Cluster.

Identifier: KitchenSet
Subclass of: Non-food item

[back to overview]


Class: Tent (large) / Large tent

Term origin: Shelter Cluster.

Identifier: LargeTent
Subclass of: Tent

[back to overview]


Class: Mat

Term origin: Shelter Cluster.

Identifier: Mat
Subclass of: Non-food item

[back to overview]


Class: MosquitoNet

Term origin: Shelter Cluster.

Identifier: MosquitoNet
Subclass of: Non-food item

[back to overview]


Class: Non-food item / NFI

Term origin: Shelter Cluster.

Identifier: NonFoodItem
Subclasses: Bladder | Blanket | Bucket / Jerry Can | Cot | Individual item | Kitchen set | Mat | MosquitoNet | Pole | Rope | Sheet | Tarpaulin | Tent | Water filter |
Range of: contains item | distributes | provides | supplies |

[back to overview]


Class: Pole

Term origin: Shelter Cluster.

Identifier: Pole
Subclass of: Non-food item

[back to overview]


Class: Rope

Term origin: Shelter Cluster.

Identifier: Rope
Subclass of: Non-food item

[back to overview]


Class: Sheet

Term origin: Shelter Cluster.

Identifier: Sheet
Subclass of: Non-food item

[back to overview]


Class: Shelter kit

Term origin: Shelter Cluster.

Identifier: ShelterKit
Subclass of: Kit

[back to overview]


Class: Supplying agency

Term origin: Shelter Cluster.

Identifier: SupplyingAgency
Subclass of: Organisation
Domain of: supplies |

[back to overview]


Class: Tarpaulin / Tarp

Term origin: Shelter Cluster.

Identifier: Tarpaulin
Subclass of: Non-food item

[back to overview]


Class: Tent

Term origin: Shelter Cluster.

Identifier: Tent
Subclass of: Non-food item
Subclasses: Tent (family) | Tent (large) |

[back to overview]


Class: Tool kit

Term origin: Shelter Cluster.

Identifier: ToolKit
Subclass of: Kit
Subclasses: Community tool kit | Family tool kit |

[back to overview]


Class: Water filter

Term origin: Shelter Cluster.

Identifier: WaterFilter
Subclass of: Non-food item

[back to overview]


Properties:

Property: contains item

Used to specify the items contained in a kit.

Identifier: containsItem
Domain: Kit
Range: Non-food item

[back to overview]


Property: distributes

Specifies with items or kits a distributing partner is resposible for.

Identifier: distributes
Domain: Distributing partner
Range: Non-food item Kit

[back to overview]


Property: provides

Links the items and kits to a distribution.

Identifier: provides
Domain: Distribution
Range: Non-food item Kit

[back to overview]


Property: reaches

Links the items and kits to a population.

Identifier: reaches
Domain: Distribution
Range: Population

[back to overview]


Property: supplies

Links the items and kits to the supplying agency.

Identifier: supplies
Domain: Supplying agency
Range: Non-food item Kit

[back to overview]


Situation Section

This section of the vocabulary defines the standards for situations and emergencies.

Alphabetical index of all classes and properties in the Situation Section:

Extended graph visualization of the Situation Section, including adjacent classes defined in a different section (in grey).

[click to enlarge]

Classes:

Class: Affected Population

The population affected by an emergency.
Term origin: Humanitarian Profile (Affected);

Identifier: AffectedPopulation
Subclass of: Population
Subclasses: Casualty | Displaced | Non-Displaced |
Domain of: affected by |

[back to overview]


Class: Age Group

Generic class for age groups; instances should be created for actual age groups (e.g. children under 5).

Identifier: AgeGroup
Subclass of: Population
Domain of: from age | to age |

[back to overview]


Class: Casualty

E.g. injured or dead.
Term origin: ACAPS DSS, Humanitarian Profile.

Identifier: Casualty
Subclass of: Affected Population
Subclasses: Dead | Injured | Missing |

[back to overview]


Class: Dead / Death

A (reported) death.
Term origin: ACAPS DSS, HPM Ethiopia, Shelter Cluster, Humanitarian Profile (Dead).

Identifier: Dead
Subclass of: Casualty

[back to overview]


Class: Displaced / Displacement

Refers to internally displaced persons, refugees, and others of concern.
Term origin: Humanitarian Profile, ACAPS DSS (Displacement)

Identifier: Displaced
Subclass of: Affected Population
Subclasses: Internally Displaced Person | Internally Displaced Person | Refugees and Asylum Seekers |

[back to overview]


Class: Emergency

Any situation in which ... life or well-being ... will be threatened unless immediate and appropriate action is taken, and which demands an extraordinary response and exceptional measures” (UNHCR Handbook for Emergencies)

A sudden crisis situation or event requiring immediate action (WART)

Any situation in which there is an exceptional and widespread threat to life, health or basic subsistence, that is beyond the coping capacity of individuals and the community” (Oxfam GB Emergency Response Manual).

Where and when a disaster provokes an immediate, exceptional and widespread threat to life, health or basic subsistence, which overwhelms the coping capacity of individual and community, implying need of external assistance” (source: ACFIN Emergency module)

Term origin: CAP OPS, Pakistan SRF, ACAPS DSS, CERF, MIRA.
Identifier: Emergency
Subclass of: Situation
Domain of: atLocation | has GLIDE number |
Range of: affected by | for emergency |

[back to overview]


Class: Female

A woman/girl or group of women/girls.
Term origin: CERF, EIMS Report.

Identifier: Female
Subclass of: http://xmlns.com/foaf/0.1/Agent

[back to overview]


Class: GLIDE number

Globally common Unique ID code for disasters. See about GLIDE.

Identifier: GLIDEnumber
Range of: has GLIDE number |

[back to overview]


Class: Internally Displaced Person / IDP

A group of internally displaced persons (IDPs).
Term origin: Humanitarian Profile, CERF, HPM Ethiopia

Identifier: IDP
Subclass of: Displaced

[back to overview]


Class: Indicator

Concrete measurable reference for a concrete need; e.g., 5 litres of clean water per person and day.
Term origin: Pakistan SRF, ACAPS DSS, CCDI, CERF, HPM Ethiopia, Sigmah DB

Identifier: Indicator
Domain of: has standard | has value | measures |
Range of: based on | measurement of |

[back to overview]


Class: Injured

Injured part of the population.
Term origin: ACAPS DSS, Humanitarian Profile, Shelter Cluster, HERAMS Checklist (Injury)

Identifier: Injured
Subclass of: Casualty

[back to overview]


Class: Male

A man/boy or group of men/boys.
Term origin: CERF, EIMS Report.

Identifier: Male
Subclass of: http://xmlns.com/foaf/0.1/Agent

[back to overview]


Class: Missing

Missing population.
Term origin: Humanitarian Profile.

Identifier: Missing
Subclass of: Casualty

[back to overview]


Class: Need / Gap / Lack

A concrete need, lack, or gap, e.g. a shortage of food. Can be based on the application of relevant norms (usually a minimum requirement or a pre-existing ‘normal’ situation); and an assessment of how the reality differs. Identifying and measuring deficits, either actual or predicted.
Term origin: CAP OPS, ACAPS DSS (also: Humanitarian Need), CCDI (Humanitarian Need), CCDI Shelter Cluster (Gap), HPM Ethiopia (Gap).

Identifier: Need
Domain of: based on | identified at |
Range of: addresses |

[back to overview]


Class: Non-Displaced

Refers to the part of the affected population that is not displaced (i.e., host or non-host);.
Term origin: Humanitarian Profile.

Identifier: NonDisplaced
Subclass of: Affected Population

[back to overview]


Class: Internally Displaced Person / Others of Concern

A group of displaced persons that does neither fit the IDP nor Refugees/Asylum Seekers classes.
Term origin: Humanitarian Profile

Identifier: Others
Subclass of: Displaced

[back to overview]


Class: Population

Generic class for any kind of population (e.g. total, affected, etc.); use the subclasses for the data annotation.

Identifier: Population
Subclass of: http://xmlns.com/foaf/0.1/Group
Subclasses: Affected Population | Age Group | Total Population |
Domain of: count | provenance Information |
Range of: reaches |

[back to overview]


Class: Refugees and Asylum Seekers

A group of refugees and asylum seekers.
Term origin: Humanitarian Profile

Identifier: RefugeesAsylumSeekers
Subclass of: Displaced

[back to overview]


Class: Sex

Class to describe sex-specific issues, either at individual or group level.
Term origin: MIRA, CCDI

Identifier: Sex
Subclasses: Female | Male |

[back to overview]


Class: Situation

Generic situation.

Identifier: Situation
Subclasses: Emergency |
Domain of: atLocation | common title | http://purl.org/dc/terms/description |

[back to overview]


Class: Total Population

Total population for a given administrative unit or geographic area. Instances can be created to make statements about this population.

Identifier: TotalPopulation
Subclass of: Population

[back to overview]


Class: foaf:Group

Identifier: http://xmlns.com/foaf/0.1/Group
Subclass of: http://xmlns.com/foaf/0.1/Agent
Subclasses: Population |

[back to overview]


Properties:

Property: affected by

States that a Population is affacted by an Emergency.

Identifier: affectedBy
Domain: Affected Population
Range: Emergency
Inverse property: affects

[back to overview]


Property: based on

Specififes that a gap for a certain need has been identified based on a specific indicator.

Identifier: basedOn
Domain: Need
Range: Indicator
Inverse property: indicates

[back to overview]


Property: common title

A commonly use title/name for an emergency.

Identifier: commonTitle
Domain: Situation
Range: http://www.w3.org/2001/XMLSchema#string

[back to overview]


Property: count

Assigns numbers to populations. The range is intentionally not restricted to numeric values, so that rough numbers or estimates are supported.

Identifier: count
Domain: Population
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: from age

Specifies the bottom of an age range for an AgeGroup (in years).

Identifier: fromAge
Domain: Age Group
Range: http://www.w3.org/2001/XMLSchema#int

[back to overview]


Property: has GLIDE number

Assigns the GLIDE number to an Emergency.

Identifier: hasGLIDEnumber
Domain: Emergency
Range: GLIDE number

[back to overview]


Property: has standard

A reference against which the measured value can be compared to know if it requires intervention.

Identifier: hasStandard
Domain: Indicator
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: has value

The measured value of this indicator.

Identifier: hasValue
Domain: Indicator
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: identified at

Specifies when a specific need has been identified.

Identifier: identifiedAt
Domain: Need
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: provenance Information

Free-text description of how the information about the demographic methodology, where the data came from, etc.

Identifier: provenanceInfo
Domain: Population
Range: http://www.w3.org/2000/01/rdf-schema#Literal

[back to overview]


Property: to age

Specifies the top of an age range for an AgeGroup (in years).

Identifier: toAge
Domain: Age Group
Range: http://www.w3.org/2001/XMLSchema#int

[back to overview]


4. Integrated graph overview of the complete HXL vocabulary

The following figure gives an overview of all classes and properties defined by HXL, and how they are connected. The ellipses represent classes, whereas the arrows represent properties: Dashed lines indicate a subclass relationship (e.g. Camp is a subclass of Site). Solid lines are labeled with the property that connects these two classes.

[click to enlarge]

5. License

We still need to decide under which license this vocabulary should be published.

Valid XHTML + RDFa This Vocabulary Specification relies on W3C's RDF technology, an open Web standard that can be freely used by anyone.

This visual layout and structure of the specification was adapted from the Open Provenance Model Vocabulary edited by Jun Zhao, SIOC Core Ontology Specification edited by Uldis Bojars and John G. Breslin and the Provenance Vocabulary Core Ontology Specification edited by Olaf Hartig and Jun Zhao.

6. Change log

Changes compared to the previous version of the vocabulary:

Changes compared to the previous version:

  1. Metadata section added.
  2. Distribution is now a subclass of Activity.
  3. Subclasses of Organization have been turned into properties.
  4. Class Shelter Cluster has been removed. This will be a resource (i.e., an instance of class Cluster) in our list of reference resources.
  5. Property identified at has been added.
  6. Gender has been replaced by Sex.
  7. Property duration has been added to the class TimePeriod in order to allow for time periods without a specific start or end such as recurring time periods or for statements such as '5kg of rice per week'.