Skip to content

Commit

Permalink
Add GDACS flood event data and examples; remove outdated event JSON
Browse files Browse the repository at this point in the history
  • Loading branch information
emmanuelmathot committed Nov 26, 2024
1 parent 299b786 commit 430905d
Show file tree
Hide file tree
Showing 9 changed files with 107,983 additions and 65 deletions.
21 changes: 15 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,7 @@ The following fields are available in the object:

| Field Name | Type | Description |
| ------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| clusters | \[string] | The clusters of the hazard. The possible values are defined in [this table](./model/taxonomy.md#hazard). |
| codes | \[string] | The hazard codes of the hazards affecting the event. The hazard code follows the [UNDRR-ISC 2020 Hazard Information Profiles](https://www.preventionweb.net/drr-glossary/hips) identifier. The possible values are defined in [this table](./model/taxonomy.md#undrr-isc-2020-hazard-information-profiles). |
| max_value | number | The estimated maximum hazard intensity/magnitude/severity value, as a number, without the units. |
| max_unit | string | The unit of the max_value. |
Expand Down Expand Up @@ -148,9 +149,10 @@ This section describes the rules and best practises to apply on the STAC core fi
More detail on the fields is available in the [Montandon model analysis](./model/README.md#event).

- Examples:
- [Reference Event example](examples/item-ref-event-flood-PAR.json): Shows usage of the extension for a reference event
<!-- - [Source Collection example](examples/collection-source-event-GLIDE.json): Shows the usage of the extension in a STAC Collection representing an event data source. -->
- [Source Event example](examples/item-source-event-flood-PAR-GLIDE.json): Shows usage of the extension for a source event
- [Reference Events Collection example](examples/reference-events/reference-events.json): Shows usage of the extension in a STAC Collection of reference events.
- [Reference Event example](examples/reference-events/20241027T150000-ESP-HM-FLOOD-001-GCDB.json): Shows usage of the extension for a reference event
- [Source Collection example](examples/gdacs-events/gdacs-events.json): Shows the usage of the extension in a STAC Collection for source events.
- [Source Event example](examples/gdacs-events/1102983-1.json): Shows usage of the extension for a source event
- [JSON Schema](json-schema/schema.json)
- [Changelog](./CHANGELOG.md)

Expand All @@ -170,7 +172,7 @@ The table below describes the rules for the core fields in the representation of
The event class is the core of the Monty model. It represents a disaster event that has occured or is forecasted to occur.
The global crisis data bank records multiple instances of events that are related to a single event:

- One **unique reference** event that is used to "pair" all the instances of the event
- One **unique reference** event that is used to "[pair](model/event_paring.md)" all the instances of the event
- Multiple instances of the event that are recorded for different sources. Each source event **MUST** have the following:
- A link to the reference event with the [relationship](#relation-types) type `reference-event`
- A link to the resource from which the event was sourced with
Expand All @@ -197,8 +199,7 @@ This section describes in details the usage of the fields and links for the haza
More detail on the field definition is available in the [Montandon model analysis](./model/README.md#hazard).

- Examples:
- [Earthquake Hazard example](examples/item-hazard-eq-PAR.json): Shows usage of the extension for a earthquake hazard
- [Landslide Hazard example](examples/item-hazard-ls-PAR.json): Shows usage of the extension for a earthquake hazard
- [Flood Hazard example](examples/gdacs-hazards/1102983-1-affected.json): Shows usage of the extension for a flood hazard

The hazard class represents a process, phenomenon or human activity that may cause loss of life, injury or other health impacts,
property damage, social and economic disruption or environmental degradation. UNDRR - https://www.undrr.org/terminology/hazard.
Expand All @@ -213,6 +214,14 @@ Hazards may be linked between each others.
This linkage is called "concurrent hazard" and is linking the observed and potentially unobserved hazards together with a `*-hazard` [relationship](#relation-types).
The link may also have specific `occ-*` [attributes](#link-attributes) to describe the occurrence of the linked hazard.

### Impact

This section describes in details the usage of the fields and links for the impact object.
More detail on the field definition is available in the [Montandon model analysis](./model/README.md#impact).

- Examples:
- [Impact example](examples/item-impact-flood-PAR.json): Shows usage of the extension for a flood impact

## Contributing

All contributions are subject to the
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
"datetime": "2024-10-27T15:00:00Z",
"start_datetime": "2024-10-27T15:00:00Z",
"end_datetime": "2024-11-04T11:00:00Z",
"modified": "2024-11-08T11:10:45",
"monty:country_codes": [
"ESP"
],
Expand Down Expand Up @@ -76,7 +77,7 @@
"rel": "collection"
},
{
"href": "https://www.gdacs.org/gdacsapi/api/events/geteventdata?eventtype=FL&eventid=1102983",
"href": "https://www.gdacs.org/gdacsapi/api/events/geteventdata?eventtype=FL&eventid=1102983&episodeid=1",
"rel": "via"
},
{
Expand Down
101 changes: 101 additions & 0 deletions examples/gdacs-events/1102983-2.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
{
"stac_version": "1.0.0",
"stac_extensions": [
"https://ifrcgo.github.io/monty/v1.0.0/schema.json"
],
"type": "Feature",
"id": "1102983",
"collection": "gdacs-events",
"bbox": [
-2.6232332,
39.4177902,
-2.6232332,
39.4177902
],
"geometry": {
"type": "Point",
"coordinates": [
-2.6232332,
39.4177902
]
},
"properties": {
"title": "Flood in Spain",
"description": "Orange Flood in Spain from: 27 Oct 2024 15 to: 04 Nov 2024 11.",
"datetime": "2024-10-27T15:00:00Z",
"start_datetime": "2024-10-27T15:00:00Z",
"end_datetime": "2024-11-04T11:00:00Z",
"modified": "2024-11-21T18:35:23",
"monty:country_codes": [
"ESP"
],
"monty:hazard_codes": [
"MH0004",
"MH0005",
"MH0006",
"MH0007"
],
"monty:corr_id": "20241027T150000-ESP-HM-FLOOD-001-GCDB",
"roles": [
"event",
"source"
],
"keywords": [
"flood",
"spain",
"Coastal Flood",
"Estuarine (Coastal) Flood",
"Flash Flood",
"Fluvial (Riverine) Flood"
]
},
"assets": {
"icon": {
"href": "https://www.gdacs.org/images/gdacs_icons/maps/Red/FL.png",
"title": "Icon",
"type": "image/png",
"roles": [
"icon"
]
},
"report": {
"href": "https://www.gdacs.org/report.aspx?eventid=1102983&episodeid=1&eventtype=FL",
"title": "GDACS Report",
"type": "text/html",
"roles": [
"report"
]
}
},
"links": [
{
"href": "1102983.json",
"rel": "self"
},
{
"href": "gdacs-events.json",
"rel": "collection"
},
{
"href": "https://www.gdacs.org/gdacsapi/api/events/geteventdata?eventtype=FL&eventid=1102983&episodeid=2",
"rel": "via"
},
{
"href": "../reference-events/20241027T150000-ESP-HM-FLOOD-001-GCDB.json",
"rel": "related",
"roles": [
"event",
"reference"
],
"type": "application/json"
},
{
"href": "../glide-events/FL-2024-000199-ESP.json",
"rel": "related",
"roles": [
"event"
],
"type": "application/json"
}
]
}
59 changes: 59 additions & 0 deletions model/sources/GDACS/1102983-1-geteventdata-source.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
{
"type": "Feature",
"bbox": [
-3.4110253455683806,
38.60133168687446,
-3.4110253455683806,
38.60133168687446
],
"geometry": {
"type": "Point",
"coordinates": [
-3.4110253455683806,
38.60133168687446
]
},
"properties": {
"eventtype": "FL",
"eventid": 1102983,
"episodeid": 1,
"eventname": "",
"glide": "FL-2024-000199-ESP",
"name": "Flood in Spain",
"description": "Flood in Spain",
"htmldescription": "Red Flood in Spain from: 27 Oct 2024 15 to: 04 Nov 2024 11.",
"icon": "https://www.gdacs.org/images/gdacs_icons/maps/Red/FL.png",
"iconoverall": "https://www.gdacs.org/images/gdacs_icons/maps/Red/FL.png",
"url": {
"geometry": "https://www.gdacs.org/gdacsapi/api/polygons/getgeometry?eventtype=FL&eventid=1102983&episodeid=1",
"report": "https://www.gdacs.org/report.aspx?eventid=1102983&episodeid=1&eventtype=FL",
"details": "https://www.gdacs.org/gdacsapi/api/events/geteventdata?eventtype=FL&eventid=1102983"
},
"alertlevel": "Red",
"alertscore": 3,
"episodealertlevel": "Red",
"episodealertscore": 2.5,
"istemporary": "false",
"iscurrent": "false",
"country": "Spain",
"fromdate": "2024-10-27T15:00:00",
"todate": "2024-11-04T11:00:00",
"datemodified": "2024-11-08T11:10:45",
"iso3": "ESP",
"source": "GLOFAS",
"sourceid": "5c949dea-419b-4f50-90f0-e7271adf619d",
"polygonlabel": "Centroid",
"Class": "Point_Centroid",
"affectedcountries": [
{
"iso3": "ESP",
"countryname": "Spain"
}
],
"severitydata": {
"severity": 0.0,
"severitytext": "Magnitude 0 ",
"severityunit": ""
}
}
}
Loading

0 comments on commit 430905d

Please sign in to comment.