Sheet reference¶
Where this page fits
This is the column-by-column reference for temPlato, PLATO’s spreadsheet template. If you are new to it, start with Organising data in spreadsheets, which explains the ten sheets and the rules that apply to all of them, and where to download the template.
Spreadsheets are one of several formats that comply with PLATO. The same data can be written as PLATO JSON or as linked data (RDF), and PLATO tools converts between them, and to and from Linked Places Format.
Every column of every sheet: whether it is needed, what to put in it, an example, and the values it accepts. This page is generated from the table definitions, so it always matches them.
In every sheet except about, places, sources and identities, each row becomes one
PLATO attestation, and these columns are shared: place_id, date, from,
to, source_id, locator, attribution, citation_function,
certainty, certainty_level, denied, stance and notes.
about¶
One row describing the dataset as a whole: its title, who made it, its licence, what it covers, and the base of its web addresses. It is what makes the dataset findable and citable (the FAIR principles). Exactly one row. Only the title is required, and the licence too once status is ‘published’. The creator_name column is deprecated: names go in creator, which takes a name, a web address, or a name with its address.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
The dataset’s title. |
|
|
|
optional |
What the dataset is, in a sentence or two: where it comes from and what it covers. Optional. |
||
|
optional |
The people or organisations to cite as its authors, separated by ‘;’. Write each as a name and its web address together, the address in angle brackets (Josiah Carberry <https://orcid.org/0000-0002-1825-0097>), or as a web address alone, or as a name alone. Optional; give an ORCID where you can. In the tables each author is recorded as text, as written; converting with PLATO tools turns the address into a link and gives it the name. |
|
A name, a web address, or a name then its address in angle brackets; several allowed, separated by |
|
optional |
Deprecated: write these names in creator instead, which now takes a name alone as well as a name with its address. The names of authors who have no web address, separated by ‘;’. Optional. Kept for one release, and to be withdrawn after it. |
|
several allowed, separated by |
|
optional |
The web address of the person or organisation that owns or maintains the dataset, if not its author. Optional. |
A web address |
|
|
optional |
The web address of the dataset’s licence, such as https://creativecommons.org/licenses/by/4.0/. Required once status is ‘published’. |
|
A web address |
|
optional |
The dataset’s version, in any form you use: ‘1.2’, ‘2026-09’. Optional. |
|
|
|
optional |
‘draft’ while it may still change, or ‘published’ once others may cite it. Once published, its evidence is only ever added to, never changed. Optional. |
|
One of: |
|
optional |
Words a catalogue can find it by, separated by ‘;’. Optional. |
|
several allowed, separated by |
|
optional |
The area it covers, as web addresses (a Wikidata or GeoNames region), separated by ‘;’. Optional. In the tables these are recorded as web addresses in text form; converting with PLATO tools turns them into links. |
|
A web address; several allowed, separated by |
|
optional |
The earliest year or date the dataset covers, with at least four digits. Optional. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
The latest year or date it covers, in the same form. Optional. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
The web page where people find and download the dataset. Optional. |
A web address |
|
|
optional |
The dataset’s own permanent web address, if it has one: the address that names the dataset itself when it is converted. Optional; if it is empty, the dataset is named by the base of its addresses (base_uri). |
A web address |
|
|
optional |
The base of the web addresses of the dataset’s places and sources, such as https://w3id.org/my-project/: choose one you control and will keep. Each place’s address is this base, then place/, then its place_id (https://w3id.org/my-project/place/bristol), and each source’s is the base, then source/, then its source_id. Use only letters, digits and - . _ ~ in the identifiers, or they are percent-encoded in the address. A base given when converting (in PLATO tools, ‘Web address for your identifiers’) is used instead of this one. Optional, but give it before publishing: without it the addresses are not permanent. |
|
A web address |
places¶
One row per place, or other spatial entity, that your data is about: a settlement, a region, a river, a road, an administrative unit. Each row becomes a plato:SpatialEntity. Everything else about a place (its names, locations, types) goes in the other sheets, where it can carry a date and a source.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
A short identifier for the place, unique in this sheet. Use letters, digits and - . _ ~ only (‘bristol’, ‘p1’): any other character is percent-encoded in the place’s web address. The other sheets use it to refer to this row. It is also kept in the data as the place’s identifier, so a record can be traced back to your row, and it ends the place’s web address: the about sheet’s base_uri, then place/, then this (https://w3id.org/my-project/place/bristol), or the base given when converting, if one is. So keep it once the dataset is published. |
|
|
|
required |
The name you want the place to be listed under. This is a display label only: the names the place has in your sources go in the names sheet. |
|
|
|
optional |
Two-letter ISO codes of the modern countries whose territory contains or overlaps the place, separated by ‘;’. A finding aid for search and matching, not evidence. Optional. |
|
several allowed, separated by |
sources¶
One row per source you cite: a document, a map, a book, a dataset. Each row becomes a plato:Source. Every row in the attestation sheets names one of these in its source_id column.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
A short identifier for the source, unique in this sheet (‘domesday’, ‘s1’), in letters, digits and - . _ ~ only: any other character is percent-encoded in the address. It ends the source’s web address: the about sheet’s base_uri (or the base given when converting), then source/, then this (https://w3id.org/my-project/source/domesday). So keep it once the dataset is published. |
|
|
|
required |
A short title for the source, as you would refer to it (‘Domesday Book’). |
|
|
|
optional |
A full bibliographic citation, in any style. Optional. |
|
|
|
optional |
A web address for the source, if it has one. Optional. |
|
A web address |
|
required |
When the source itself was made: written, copied, printed or published, as the source or catalogue gives it. Write ‘undated’ if unknown. Required. |
|
|
|
optional |
Earliest year or date the source can have been made, with at least four digits, or YYYY-MM-DD. Optional. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
Latest year or date the source can have been made. Optional. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
If this source is a copy, transcript or edition of another source in this sheet, that source’s source_id. Optional. |
|
|
|
optional |
The web address of the licence of the source as you cite it (the edition or copy), for example https://creativecommons.org/licenses/by/4.0/. Optional. |
|
A web address |
names¶
One row for each time a source gives a name for a place. Each row becomes a plato:Attestation of one plato:Name, with its date and source.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
The place this row is about: a place_id from the places sheet. |
|
|
|
required |
The name, spelt exactly as the source gives it. |
|
|
|
optional |
The language of the name, as a language code (‘en’, ‘la’, ‘enm’ for Middle English). Optional. |
|
|
|
optional |
The writing system, as a four-letter code (‘Latn’, ‘Arab’, ‘Grek’). Optional. |
|
|
|
optional |
The name in Latin letters, if the source uses another script. Optional. |
|
|
|
optional |
What the name names, if not a place: ‘toponym’ (the default), ‘hydronym’ (a river or lake), ‘odonym’ (a street), ‘ethnonym’, ‘demonym’, ‘chrononym’. Several may be separated by ‘;’. Optional. |
|
several allowed, separated by |
|
optional |
What kind of form this is: ‘Attested’ (read in the source; the default), ‘Headword’ (the form an editor files the entry under), ‘Normalised’ (a spelling made up for searching), ‘Reconstructed’ (inferred, not found), ‘Preferred’ (the form your project prefers for display and search, which the source may not show), ‘Editorial’ (written by the editors of the edition you cite, in their commentary or notes, not in the text they edit). Leave empty for an ordinary reading. |
|
One of: |
|
optional |
How the name occurs: ‘InPersonalName’ if it appears only inside a person’s name (‘Willelmus de Bonestou’), ‘InFieldName’ if only inside a later minor name. Leave empty for an ordinary mention. |
|
One of: |
|
optional |
How many times the name occurs in the passage cited, if more than once. Optional. |
|
A whole number |
|
optional |
How faithfully the name renders what the source shows: ‘Accurate’, ‘Inaccurate’ (misread), or ‘False’ (a ghost form not in the source). Optional. |
|
One of: |
|
optional |
Whether the name is whole: ‘Complete’, ‘Reconstructable’ (part lost, but it can be supplied), or ‘NonReconstructable’. Optional. |
|
One of: |
|
required |
The date as your source gives it, in any form: ‘1086’, ‘c. 925’, ‘1480-1485’, ‘a. 1300’. Write ‘undated’ if the source gives no date. Required on every row. |
|
|
|
optional |
Earliest year or date the row can refer to, with at least four digits (0921, not 921; -12000 for 12,000 BCE) or YYYY-MM-DD. Optional; leave empty if you cannot say. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
Latest year or date the row can refer to, in the same form as ‘from’. For a single year, put it in both ‘from’ and ‘to’. Leave empty if the end is unknown. |
|
Year of at least four digits, or YYYY-MM-DD |
|
required |
The source this comes from: a source_id from the sources sheet. |
|
|
|
optional |
Where in the source: a page, folio, column or entry, written as the source numbers it (‘p. 25’, ‘f. 12v’). Optional. |
|
|
|
optional |
‘Inferred’ if the source was given as ‘ibid.’ or ‘idem’ and an editor worked out which source was meant. Leave empty otherwise. |
|
One of: |
|
optional |
Why the source is cited, as a term of CiTO, the Citation Typing Ontology: ‘citesAsEvidence’ (the source is the evidence), ‘citesAsDataSource’, ‘citesAsRelated’, ‘citesForInformation’ and so on. Optional; leave empty if your data does not say. |
|
One of: |
|
optional |
How sure you are of this row, from 0 (not at all) to 1 (certain). Optional: if your source or your judgement gives certainty in words, use certainty_level instead, rather than inventing a number. |
|
A number from 0 to 1 |
|
optional |
Certainty in words: ‘Certain’, ‘LessCertain’ or ‘Uncertain’, the three levels of Linked Places Format. Optional; may be given with or instead of certainty. |
|
One of: |
|
optional |
‘yes’ if the source says this is not so: no market here, a grant refused. The row then records a denial, not an assertion, so give only the one thing the source denies. Leave empty for an ordinary row. |
|
One of: |
|
optional |
How firmly the source itself says it: ‘Reported’ if the source passes it on without vouching for it (‘it is said’), ‘Tentative’ if it hedges, ‘Doubted’ if it raises it but will not decide (that is not a denial: use denied for that), or ‘Asserted’. Leave empty where the source simply states it. This is the source’s stance, not how sure you are, which is certainty. |
|
One of: |
|
optional |
Anything else worth saying about this row, in your own words. Optional. |
locations¶
One row for each location a source gives for a place. Each row becomes a plato:Attestation of one plato:Geometry. Give a point as latitude and longitude; add a shape as WKT if you have one.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
The place this row is about: a place_id from the places sheet. |
|
|
|
required |
Latitude in decimal degrees, WGS 84 (as in most web maps). |
|
A number from -90 to 90 |
|
required |
Longitude in decimal degrees, WGS 84. West of Greenwich is negative. |
|
A number from -180 to 180 |
|
optional |
A shape (line or polygon) as Well-Known Text, if you have one. Optional. |
|
Well-Known Text |
|
optional |
What the location marks: ‘Extent’ (the whole place), ‘FeaturePoint’ (a particular feature, such as the church), ‘RepresentativePoint’ (a point standing in for the place, as a symbol on a map usually is), ‘LabelAnchor’, ‘Itinerary’. Optional. |
|
One of: |
|
optional |
How far out the location might be, in kilometres. Optional. |
|
A number, at least 0 |
|
required |
The date as your source gives it, in any form: ‘1086’, ‘c. 925’, ‘1480-1485’, ‘a. 1300’. Write ‘undated’ if the source gives no date. Required on every row. |
|
|
|
optional |
Earliest year or date the row can refer to, with at least four digits (0921, not 921; -12000 for 12,000 BCE) or YYYY-MM-DD. Optional; leave empty if you cannot say. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
Latest year or date the row can refer to, in the same form as ‘from’. For a single year, put it in both ‘from’ and ‘to’. Leave empty if the end is unknown. |
|
Year of at least four digits, or YYYY-MM-DD |
|
required |
The source this comes from: a source_id from the sources sheet. |
|
|
|
optional |
Where in the source: a page, folio, column or entry, written as the source numbers it (‘p. 25’, ‘f. 12v’). Optional. |
|
|
|
optional |
‘Inferred’ if the source was given as ‘ibid.’ or ‘idem’ and an editor worked out which source was meant. Leave empty otherwise. |
|
One of: |
|
optional |
Why the source is cited, as a term of CiTO, the Citation Typing Ontology: ‘citesAsEvidence’ (the source is the evidence), ‘citesAsDataSource’, ‘citesAsRelated’, ‘citesForInformation’ and so on. Optional; leave empty if your data does not say. |
|
One of: |
|
optional |
How sure you are of this row, from 0 (not at all) to 1 (certain). Optional: if your source or your judgement gives certainty in words, use certainty_level instead, rather than inventing a number. |
|
A number from 0 to 1 |
|
optional |
Certainty in words: ‘Certain’, ‘LessCertain’ or ‘Uncertain’, the three levels of Linked Places Format. Optional; may be given with or instead of certainty. |
|
One of: |
|
optional |
‘yes’ if the source says this is not so: no market here, a grant refused. The row then records a denial, not an assertion, so give only the one thing the source denies. Leave empty for an ordinary row. |
|
One of: |
|
optional |
How firmly the source itself says it: ‘Reported’ if the source passes it on without vouching for it (‘it is said’), ‘Tentative’ if it hedges, ‘Doubted’ if it raises it but will not decide (that is not a denial: use denied for that), or ‘Asserted’. Leave empty where the source simply states it. This is the source’s stance, not how sure you are, which is certainty. |
|
One of: |
|
optional |
Anything else worth saying about this row, in your own words. Optional. |
types¶
One row for each time a source says what kind of place something is: a town, a parish, a port. Each row becomes a plato:Attestation of one plato:Type.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
The place this row is about: a place_id from the places sheet. |
|
|
|
required |
The kind of place, in the source’s words or yours (‘port’, ‘hundred’). |
|
|
|
optional |
The matching concept’s full web address in a published vocabulary, such as the Getty AAT, if you know it: not a bare code. For an OpenStreetMap tag, include its key (https://wiki.openstreetmap.org/wiki/Tag:waterway=stream). Leave it empty for a category of your source’s own that no vocabulary holds. Optional. |
|
A web address |
|
optional |
The web address of the vocabulary the type comes from, if type_uri does not already make it plain: for Köppen codes, WWF ecoregions or your project’s own list. Optional. |
|
A web address |
|
optional |
The version of that vocabulary you used, where its terms change meaning between versions (‘2017’). Optional. |
|
|
|
required |
The date as your source gives it, in any form: ‘1086’, ‘c. 925’, ‘1480-1485’, ‘a. 1300’. Write ‘undated’ if the source gives no date. Required on every row. |
|
|
|
optional |
Earliest year or date the row can refer to, with at least four digits (0921, not 921; -12000 for 12,000 BCE) or YYYY-MM-DD. Optional; leave empty if you cannot say. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
Latest year or date the row can refer to, in the same form as ‘from’. For a single year, put it in both ‘from’ and ‘to’. Leave empty if the end is unknown. |
|
Year of at least four digits, or YYYY-MM-DD |
|
required |
The source this comes from: a source_id from the sources sheet. |
|
|
|
optional |
Where in the source: a page, folio, column or entry, written as the source numbers it (‘p. 25’, ‘f. 12v’). Optional. |
|
|
|
optional |
‘Inferred’ if the source was given as ‘ibid.’ or ‘idem’ and an editor worked out which source was meant. Leave empty otherwise. |
|
One of: |
|
optional |
Why the source is cited, as a term of CiTO, the Citation Typing Ontology: ‘citesAsEvidence’ (the source is the evidence), ‘citesAsDataSource’, ‘citesAsRelated’, ‘citesForInformation’ and so on. Optional; leave empty if your data does not say. |
|
One of: |
|
optional |
How sure you are of this row, from 0 (not at all) to 1 (certain). Optional: if your source or your judgement gives certainty in words, use certainty_level instead, rather than inventing a number. |
|
A number from 0 to 1 |
|
optional |
Certainty in words: ‘Certain’, ‘LessCertain’ or ‘Uncertain’, the three levels of Linked Places Format. Optional; may be given with or instead of certainty. |
|
One of: |
|
optional |
‘yes’ if the source says this is not so: no market here, a grant refused. The row then records a denial, not an assertion, so give only the one thing the source denies. Leave empty for an ordinary row. |
|
One of: |
|
optional |
How firmly the source itself says it: ‘Reported’ if the source passes it on without vouching for it (‘it is said’), ‘Tentative’ if it hedges, ‘Doubted’ if it raises it but will not decide (that is not a denial: use denied for that), or ‘Asserted’. Leave empty where the source simply states it. This is the source’s stance, not how sure you are, which is certainty. |
|
One of: |
|
optional |
Anything else worth saying about this row, in your own words. Optional. |
relations¶
One row for each time a source relates a place to something else: a parish lying in a hundred, a station on a road, a stop on a journey, one place leading to another, a place where a person was born. Each row becomes a plato:Attestation relating the place in place_id either to another place, in related_place_id, or to something described elsewhere (a person, an object, an event), in related_uri. Fill in one of the two, never both; or neither, when the source only names the other thing, in related_label. CSVW cannot state that rule, so PLATO tools checks it.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
The place this row is about: a place_id from the places sheet. |
|
|
|
required |
How they are related. Places within places: ‘ContainedIn’ (the place in place_id lies within the other). Routes, journeys and networks: ‘MemberOf’ (the place is a station, stop or member of the route, journey or network in related_place_id; give its position in sequence), ‘ConnectedTo’ (directly connected, either way), ‘LeadsTo’ (connected one way, from place_id to the other), ‘BeginsAt’ and ‘EndsAt’ (a segment, such as a leg of a road, begins or ends at the other place), ‘HasEnd’ (the other place is one end of a segment with no direction; give it for both ends). People, objects and events, in related_uri: ‘BirthplaceOf’, ‘DeathplaceOf’, ‘ResidenceOf’, ‘FindspotOf’, ‘SettingOf’, ‘WorkplaceOf’. Images and records about a place, in related_uri: ‘DepictedIn’ (a photograph, map or drawing shows it), ‘SubjectOf’ (an archival file, report or publication is about it). A people’s land: ‘HomelandOf’ (the place is land the people lived in or held; name the people in related_label, and give its address in related_uri where it has one). Only PLATO’s own relation types can be used here; a project’s own (declared in JSON or RDF with broader_relation) cannot, and further types are added to PLATO’s vocabulary on request. |
|
One of: |
|
optional |
The other place: a place_id from the places sheet. Leave empty if the row relates the place to something that is not a place, in related_uri, or only names it, in related_label. |
|
|
|
optional |
The web address of what the place is related to, when it is not a place in your places sheet: a person, an object or an event described elsewhere, such as http://www.wikidata.org/entity/Q9441 for the Buddha. Leave empty if you filled in related_place_id. Leave both empty when the source only names the other thing, without anything to point at: then give the name in related_label. |
|
A web address |
|
optional |
A name for what related_uri points to (‘the Buddha’), so that it can be shown without looking the address up. Give it whenever you fill in related_uri. On its own, it names something the source gives no address for (‘in the Delta’); a unit that recurs, such as a province, is better added to the places sheet. |
|
|
|
optional |
For MemberOf: the place’s position on the route or journey, as your source orders it (1, 2, 3 …). Two places with the same number are alternatives. Leave empty if the source gives no order. |
|
|
|
required |
The date as your source gives it, in any form: ‘1086’, ‘c. 925’, ‘1480-1485’, ‘a. 1300’. Write ‘undated’ if the source gives no date. Required on every row. |
|
|
|
optional |
Earliest year or date the row can refer to, with at least four digits (0921, not 921; -12000 for 12,000 BCE) or YYYY-MM-DD. Optional; leave empty if you cannot say. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
Latest year or date the row can refer to, in the same form as ‘from’. For a single year, put it in both ‘from’ and ‘to’. Leave empty if the end is unknown. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
How long, where the source says so without dates, or as well as them: a stay at a stop on a journey (‘P42D’ for six weeks, ‘P1D’ for a day, ‘PT12H’ for twelve hours). Write it in this form, with weeks as days; put the source’s own words in date. Optional. |
|
|
|
required |
The source this comes from: a source_id from the sources sheet. |
|
|
|
optional |
Where in the source: a page, folio, column or entry, written as the source numbers it (‘p. 25’, ‘f. 12v’). Optional. |
|
|
|
optional |
‘Inferred’ if the source was given as ‘ibid.’ or ‘idem’ and an editor worked out which source was meant. Leave empty otherwise. |
|
One of: |
|
optional |
Why the source is cited, as a term of CiTO, the Citation Typing Ontology: ‘citesAsEvidence’ (the source is the evidence), ‘citesAsDataSource’, ‘citesAsRelated’, ‘citesForInformation’ and so on. Optional; leave empty if your data does not say. |
|
One of: |
|
optional |
How sure you are of this row, from 0 (not at all) to 1 (certain). Optional: if your source or your judgement gives certainty in words, use certainty_level instead, rather than inventing a number. |
|
A number from 0 to 1 |
|
optional |
Certainty in words: ‘Certain’, ‘LessCertain’ or ‘Uncertain’, the three levels of Linked Places Format. Optional; may be given with or instead of certainty. |
|
One of: |
|
optional |
‘yes’ if the source says this is not so: no market here, a grant refused. The row then records a denial, not an assertion, so give only the one thing the source denies. Leave empty for an ordinary row. |
|
One of: |
|
optional |
How firmly the source itself says it: ‘Reported’ if the source passes it on without vouching for it (‘it is said’), ‘Tentative’ if it hedges, ‘Doubted’ if it raises it but will not decide (that is not a denial: use denied for that), or ‘Asserted’. Leave empty where the source simply states it. This is the source’s stance, not how sure you are, which is certainty. |
|
One of: |
|
optional |
Anything else worth saying about this row, in your own words. Optional. |
connections¶
One row for each figure a source gives about a connection between two places: the number of letters sent from one city to another, a journey time, a toll, a cargo. Each row becomes a plato:Attestation relating the place in place_id to the place in related_place_id, with one plato:PropertyValue. Several figures about one connection are several rows. A connection with no figures goes in the relations sheet; a physical link with its own existence, such as a leg of a road, is better entered as a place of its own, with its figures in the properties sheet.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
The place this row is about: a place_id from the places sheet. |
|
|
|
required |
‘ConnectedTo’ (connected, either way) or ‘LeadsTo’ (one way, from place_id to the other: letters sent from it, water flowing from it). |
|
One of: |
|
required |
The other place: a place_id from the places sheet. |
|
|
|
required |
What the figure is, as the web address of a property in a published vocabulary. |
|
A web address |
|
optional |
What is being stated, in words (‘population’). Optional. |
|
|
|
required |
The figure, as the source gives it or as a number. |
|
|
|
optional |
The unit, as the web address of a unit in a published vocabulary, if the value has one. Optional. |
A web address |
|
|
required |
The date as your source gives it, in any form: ‘1086’, ‘c. 925’, ‘1480-1485’, ‘a. 1300’. Write ‘undated’ if the source gives no date. Required on every row. |
|
|
|
optional |
Earliest year or date the row can refer to, with at least four digits (0921, not 921; -12000 for 12,000 BCE) or YYYY-MM-DD. Optional; leave empty if you cannot say. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
Latest year or date the row can refer to, in the same form as ‘from’. For a single year, put it in both ‘from’ and ‘to’. Leave empty if the end is unknown. |
|
Year of at least four digits, or YYYY-MM-DD |
|
required |
The source this comes from: a source_id from the sources sheet. |
|
|
|
optional |
Where in the source: a page, folio, column or entry, written as the source numbers it (‘p. 25’, ‘f. 12v’). Optional. |
|
|
|
optional |
‘Inferred’ if the source was given as ‘ibid.’ or ‘idem’ and an editor worked out which source was meant. Leave empty otherwise. |
|
One of: |
|
optional |
Why the source is cited, as a term of CiTO, the Citation Typing Ontology: ‘citesAsEvidence’ (the source is the evidence), ‘citesAsDataSource’, ‘citesAsRelated’, ‘citesForInformation’ and so on. Optional; leave empty if your data does not say. |
|
One of: |
|
optional |
How sure you are of this row, from 0 (not at all) to 1 (certain). Optional: if your source or your judgement gives certainty in words, use certainty_level instead, rather than inventing a number. |
|
A number from 0 to 1 |
|
optional |
Certainty in words: ‘Certain’, ‘LessCertain’ or ‘Uncertain’, the three levels of Linked Places Format. Optional; may be given with or instead of certainty. |
|
One of: |
|
optional |
‘yes’ if the source says this is not so: no market here, a grant refused. The row then records a denial, not an assertion, so give only the one thing the source denies. Leave empty for an ordinary row. |
|
One of: |
|
optional |
How firmly the source itself says it: ‘Reported’ if the source passes it on without vouching for it (‘it is said’), ‘Tentative’ if it hedges, ‘Doubted’ if it raises it but will not decide (that is not a denial: use denied for that), or ‘Asserted’. Leave empty where the source simply states it. This is the source’s stance, not how sure you are, which is certainty. |
|
One of: |
|
optional |
Anything else worth saying about this row, in your own words. Optional. |
properties¶
One row for each other fact a source states about a place: a population, a valuation, a market day. Each row becomes a plato:Attestation of one plato:PropertyValue. A latitude given without a longitude is a property too, not a location: property_uri http://www.w3.org/2003/01/geo/wgs84_pos#lat, with the value in decimal degrees.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
The place this row is about: a place_id from the places sheet. |
|
|
|
required |
What is being stated, as the web address of a property in a published vocabulary, for example Wikidata’s ‘population’. |
|
A web address |
|
optional |
What is being stated, in words (‘population’). Optional. |
|
|
|
required |
The value, as the source gives it or as a number. |
|
|
|
optional |
The unit, as the web address of a unit in a published vocabulary, if the value has one. Optional. |
A web address |
|
|
required |
The date as your source gives it, in any form: ‘1086’, ‘c. 925’, ‘1480-1485’, ‘a. 1300’. Write ‘undated’ if the source gives no date. Required on every row. |
|
|
|
optional |
Earliest year or date the row can refer to, with at least four digits (0921, not 921; -12000 for 12,000 BCE) or YYYY-MM-DD. Optional; leave empty if you cannot say. |
|
Year of at least four digits, or YYYY-MM-DD |
|
optional |
Latest year or date the row can refer to, in the same form as ‘from’. For a single year, put it in both ‘from’ and ‘to’. Leave empty if the end is unknown. |
|
Year of at least four digits, or YYYY-MM-DD |
|
required |
The source this comes from: a source_id from the sources sheet. |
|
|
|
optional |
Where in the source: a page, folio, column or entry, written as the source numbers it (‘p. 25’, ‘f. 12v’). Optional. |
|
|
|
optional |
‘Inferred’ if the source was given as ‘ibid.’ or ‘idem’ and an editor worked out which source was meant. Leave empty otherwise. |
|
One of: |
|
optional |
Why the source is cited, as a term of CiTO, the Citation Typing Ontology: ‘citesAsEvidence’ (the source is the evidence), ‘citesAsDataSource’, ‘citesAsRelated’, ‘citesForInformation’ and so on. Optional; leave empty if your data does not say. |
|
One of: |
|
optional |
How sure you are of this row, from 0 (not at all) to 1 (certain). Optional: if your source or your judgement gives certainty in words, use certainty_level instead, rather than inventing a number. |
|
A number from 0 to 1 |
|
optional |
Certainty in words: ‘Certain’, ‘LessCertain’ or ‘Uncertain’, the three levels of Linked Places Format. Optional; may be given with or instead of certainty. |
|
One of: |
|
optional |
‘yes’ if the source says this is not so: no market here, a grant refused. The row then records a denial, not an assertion, so give only the one thing the source denies. Leave empty for an ordinary row. |
|
One of: |
|
optional |
How firmly the source itself says it: ‘Reported’ if the source passes it on without vouching for it (‘it is said’), ‘Tentative’ if it hedges, ‘Doubted’ if it raises it but will not decide (that is not a denial: use denied for that), or ‘Asserted’. Leave empty where the source simply states it. This is the source’s stance, not how sure you are, which is certainty. |
|
One of: |
|
optional |
Anything else worth saying about this row, in your own words. Optional. |
identities¶
One row for each record elsewhere (GeoNames, Wikidata, the World Historical Gazetteer, another dataset) that you believe is the same place as one of yours. Each row becomes a plato:IdentityRelation.
Column |
Needed? |
What to put |
Example |
Values |
|---|---|---|---|---|
|
required |
Your place: a place_id from the places sheet. |
|
|
|
required |
The web address of the other record. |
|
A web address |
|
required |
‘exactMatch’ (certainly the same), ‘closeMatch’ (the same, with some difference of extent or scope), ‘related’ (closely associated), or ‘unspecified’ (your source links the two but does not say how strongly). Required, so that a match of unstated strength is marked as such rather than read as exact. |
|
One of: |
|
optional |
How sure you are that they are the same, from 0 to 1. Optional. |
|
A number from 0 to 1 |
|
optional |
Why you think so, in your own words. Optional. |
|
|
|
optional |
A source that supports the match, from the sources sheet. Optional. |