---
# System prepended metadata

title: Clade

---

### key
#### type
* `Type`: either a native type like string, number, etc, or defined objects
* `[Type]`: array of Type
#### prority
* **M**: Must
* **S**: Should
* **C**: Could
* **W**: Would

# Clade

|          | Field                | Type                              | Priority |
| -------- | -------------------- | --------------------------------- |:--------:|
| meta     | created_on           | `Time`                            |  **M**   |
| meta     | created_by           | `User`                            |  **M**   |
| meta     | parent               | `Clade`                           |  **M**   |
| meta     | depth                | `Number`                          |  **C**   |
| meta     | children             | `[Clade]`                         |  **M**   |
| meta     | no_children          | `Number`                          |  **S**   |
| meta     | no_descendant_clades | `Number`                          |  **S**   |
| meta     | no_species           | `Number`                          |  **S**   |
|          |                      |                                   |          |
|          | name                 | `String`                          |  **M**   |
|          | name_meaning         | `String`                          |  **M**   |
|          | other_names          | `[String]`                        |  **S**   |
|          | common_names         | `[String]`                        |  **M**   |
|          | description          | `String`                          |  **M**   |
|          | rank                 | `String`                          |  **S**   |
|          | attribution          | [`Attribution` ](#Attribution)    |  **M**   |
|          |                      |                                   |          |
| biology  | extant               | `Boolean`                         |  **M**   |
| biology  | conservation_status  | `String`                          |  **S**   |
| biology  | synapomorphies       | [`[Synapomorphy]`](#Synapomorphy) |  **M**   |
| biology  | colours              | `[Strings]`                       |  **S**   |
|          |                      |                                   |          |
| stats    | life_expectancy      | `Number`                          |  **C**   |
| stats    | gestation            | `Number`                          |  **C**   |
| stats    | population           | `Number`                          |  **C**   |
| stats    | no_flagella          | `Number`                          |  **C**   |
| stats    | no_feet              | `Number`                          |  **C**   |
| stats    | no_bones             | `Number`                          |  **C**   |
| stats    | no_teeth             | `Number`                          |  **C**   |
| stats    | metabolic_rate       | `Number`                          |  **C**   |
|          |                      |                                   |          |
| computed | computed_stats       | [`ComputedStats`](#ComputedStats) |  **M**   |
|          |                      |                                   |          |
| assets   | media                | `[Media]`                         |  **S**   |
| assets   | data                 | [`[Datum]`](#Datum)               |  **C**   |
| assets   | articles             | `[Article]`                       |  **C**   |
| assets   | maps                 | `[Map]`                           |  **C**   |

### example
```json
{
    "created_on": 1580929460,
    "created_by": {"id": 1, ...},
    "parent": {"id": 1, ...},
    "depth": 2,
    "children": [{"id": 8, ...}, {"id": 9, ...}, ...],
    "no_children": 2,
    "no_descendant_clades": 4125372,
    "no_species": 2148125,
    "name": "Eukaryota",
    "name_meaning": "Greek εὖ (eu, 'well' or 'true') + κάρυον (karyon, 'nut' or 'kernel')",
    "other_names": ["Eukarya", "Eucaryotae"],
    "common_names": ["Eukaryotes"],
    "description": "Eukaryotes (/juːˈkærioʊt, -ət/) are organisms whose cells have a nucleus enclosed within membranes, unlike prokaryotes (Bacteria and Archaea), which have no membrane-bound organelles...",
    "rank": "Domain",
    "citation": {"name": "Whittaker & Margulis", ...},
    "extant": true,
    "conservation_status": "Least concern",
    "synapomorphies": [{"name": "Biomembrane", ...}, ...],
    "computed_stats": {"temporal_range": {"start": {"name": "Orosirian", ...}, ...}, ...}
}
```

# Attribution
| Field | Type     | Priority | Options                             |
| ----- | -------- |:--------:| ----------------------------------- |
| name  | `String` |  **M**   |                                     |
| year  | `Number` |  **M**   |                                     |
| link  | `String` |  **M**   |                                     |
| type  | `String` |  **S**   | Original, Vide, Sensu, Non, Emended |

### example
```json
{
    "name": "Whittaker & Margulis",
    "year": 1978,
    "link": "http://...",
}
```

# ComputedStats
| Field                 | Type                              | Priority |
| --------------------- | --------------------------------- |:--------:|
| temporal_range        | [`TemporalRange`](#TemporalRange) |  **M**   |
| geographic_range      | [`[GeoData]`](#GeoData)           |  **M**   |
| height_range          | [`StatRange`](#StatRange)         |  **S**   |
| width_range           | [`StatRange`](#StatRange)         |  **S**   |
| length_range          | [`StatRange`](#StatRange)         |  **S**   |
| mass_range            | [`StatRange`](#StatRange)         |  **S**   |
| life_expectancy_range | [`StatRange`](#StatRange)         |  **S**   |
| gestation_range       | [`StatRange`](#StatRange)         |  **S**   |

### example
```json
{
    "temporal_range": {"start": {"name": "Orosirian", ...}, ...}
    "geographic_range": [{"name": "Bitter Springs Group", ...}, ...],
    "length_range": null,
    "mass_range": {"max": 4331, "min": 0.00023},
}
```

# Synapomorphy
| Field       | Type     | Priority |
| ----------- | -------- |:--------:|
| name        | `String` |  **M**   |
| description | `String` |  **M**   |
| group       | `String` |  **M**   |

### example
```json
{
    "name": "Biomembrane",
    "description": "A biological membrane or biomembrane is an enclosing or separating membrane that acts as a selectively permeable barrier within living things.",
    "group": "Cell structure",
},
{
    "name": "Flight",
    "description": "Powered flight has evolved only four times: first in the insects, then in pterosaurs, next in birds, and last in bats. Powered flight uses muscles to generate aerodynamic force, which allows the animal to produce lift and thrust. The animal may ascend without the aid of rising air.",
    "group": "Aerial locomotion",
}
```

# TemporalRange
| Field | Type                        | Priority |
| ----- | --------------------------- |:--------:|
| start | [`ChronoData`](#ChronoData) |  **M**   |
| end   | [`ChronoData`](#ChronoData) |  **M**   |

### example
```json
{
    "start": {"name": "Orosirian", ...},
    "end": {"name": "Meghalayan", ...},
}
```

# ChronoData
| Field | Type     | Priority |
| ----- | -------- |:--------:|
| name  | `String` |  **M**   |
| type  | `String` |  **M**   |
| start | `String` |  **M**   |
| end   | `String` |  **M**   |

### example
```json
{
    "name": "Orosirian",
    "type": "Period",
    "start": "2050 Mya",
    "end": "1800 Mya",
}
{
    "name": "Meghalayan",
    "type": "Epoch",
    "start": "0.0042 Mya",
    "end": "0 Mya",
}
```

# StatRange
| Field | Type  | Priority |
| ----- | ----- |:--------:|
| max   | Float |  **M**   |
| min   | Float |  **M**   |

### example
```json
{
    "max": 0.435,
    "min": 4.6,
}
```

# GeoData
| Field               | Type           | Priority |
| ------------------- | -------------- |:--------:|
| name                | `String`       |  **M**   |
| country             | `Country`      |  **M**   |
| lat                 | `String`       |  **S**   |
| long                | `String`       |  **S**   |
| stratigraphic_range | `[ChronoData]` |  **C**   |

### example
```json
{
    "name": "Bitter Springs Group",
    "country": {"id": 5442,"code": "AUS", ...},
    "lat": "23°32′34″S",
    "long": "134°27′26″E",
}
```

# Datum
| Field        | Type         | Priority |
| ------------ | ------------ |:--------:|
| type         | `String`     |  **C**   |
| clade        | `Clade`      |  **C**   |
| observed_on  | `Date`       |  **C**   |
| location     | `GeoData`    |  **C**   |
| dated        | `ChronoData` |  **C**   |
| dated_year   | `Number`     |  **C**   |
| completeness | `Float`      |  **C**   |
| height       | `Float`      |  **C**   |
| width        | `Float`      |  **C**   |
| length       | `Float`      |  **C**   |
| mass         | `Float`      |  **C**   |
| colours      | `[String]`   |  **C**   |
| source       | `String`     |  **C**   |
| link         | `String`     |  **C**   |


### example
```json
{
    "type": "fossil",
    "clade": {"name": "Harrius Potterus"},
    "observed_on": 1580929460,
    "location": {"name": "Colorado", ...},
    "dated": {"name": "Ordovician", ...},
    "dated_year": 247000000,
    "completeness": 0.34,
    "height": null,
    "width": 0.0064,
    "length": 0.0064,
    "mass": 0.00067,
    "source": "http://...",
    "link": "http://...",
}
{
    "type": "observation",
    "clade": {"name": "Equus ferus caballus"},
    "observed_on": 1580929460,
    "location": {"name": "London", ...},
    "dated": null,
    "dated_year": null,
    "completeness": null,
    "height": 2.4,
    "width": 1,
    "length": 3.6,
    "mass": 305,
    "source": "http://...",
    "link": "http://...",
}
```






