The attribution from tdwg

observed (concept)


Definition	Observed the subject
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"observed"
Notes

Action by software: identification of the software

If the property:type has value http://schema.org/SoftwareApplication

Is there a way to specify:

software used
version of the software (release number, revision number...)

Use-case: action is performed in an automated way (identified by artificial intelligence, recorded with camera trap...)

startedAtTime (property)


Definition	Start is when an action is deemed to have been started by an agent.
Existing property	prov:startedAtTime
Existing namespace	http://www.w3.org/ns/prov#
Existing property identifier	http://www.w3.org/ns/prov#startedAtTime
Format	date
Required	no
Constraints
Examples	"2012-04-25T01:30:00Z"
Notes	Borrowed from the PROV ontology, aligning with work done through RDA. https://www.w3.org/TR/prov-o/

alternateName (property)


Definition	An alias for the item. Other full name agent may have been known under such as maiden name.
Existing property	alternateName
Existing namespace	https://schema.org/
Existing property identifier	https://schema.org/alternateName
Format	string
Required	no
Constraints
Examples	"Margaret Johnson"
Notes

drew (concept)


Definition	Drew or sketched on a specimen
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"drew"
Notes	The Latin word for this is delineavit.

agentIdentifierType (property)


Definition	The type of identifier for the agent. Recommended best practice is to use a controlled vocabulary.
Existing property
Existing namespace
Existing property identifier
Format	string
Required	no
Constraints	Controlled vocabulary
Examples	"ORCID", "ISNI", "IPNI", "HUH", "ResearcherID", "Wikidata", "VIAF", "RoR", "Ringgold", "GRID"
Notes	Thesaurus at https://tdwg.github.io/attribution/people/dwc/vocubulary/agentIdentifierType.xml

Figure out how to accommodate IRI terms

AgentActions DwC-A extension does not use the IRI namespaced terms like dwciri:identifiedBy, dwciri:recordedBy, dwciri:measuremendDeterminedBy, or dwciri:georeferencedBy. Do we need to accommodate these or would it be a step backward?

property:givenName

givenName (property)


Definition	Given name. In the U.S., the first name of a Person. This can be used along with familyName instead of the name property.
Existing property	givenName
Existing namespace	https://schema.org/
Existing property identifier	https://schema.org/givenName
Format	string
Required	no
Constraints
Examples	"Margaret"
Notes

Develop agent action controlled vocabulary

Candidate terms

authored
borrowed
catalogued
collected
conserved
contributed
created
curated
described
determined
- verified
digitized
georeferenced
illustrated
organized
participated
photographed
prepared
processed
reviewed
transcribed
mounted
loaned
barcoded
sampled

Sorting out attribution for contributors to standards and their parts

Here's another issue that the Attribution IG could weigh in on related to who gets attribution for standards and their various parts (documents, vocabularies). In particular, how do review managers and maintenance group members involved in ratification get acknowledged?

concept:communicated

communicated (concept)


Definition	On botanical specimens, this usually refers to the act of sending plant specimens (often accompanied by a letter) to a colleague or an institution.
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"communicated"
Notes	The Latin word for this is communicavit, often abbreviated comm.

name prefixes and suffixes

Name prefixes and suffixes are important disambiguating information. These should not be lost when data are converted or transcribed.

associating TDWG standards documents with their contributors

I would really be interested in some feedback from the Attribution IG about this issue regarding linking TDWG standards documents to their contributors. At the present, I'm linking people via dcterms:contributoras you can see here. But this does not capture the nature of the relationships.

What I've done so far is to take the relationships recorded in this table and generate this RDF/Turtle which is available to anyone who discovers that dump but won't actually show up if the document URIs are dereferenced (see this example).

Anyway, I'm open to suggestion on the best practices for making these links in a manner that will indicate the contributor's role.

property:agentType

agentType (property)


Definition	The nature of the agent. Recommended practice is to use a controlled vocabulary.
Existing property
Existing namespace
Existing property identifier
Format	string
Required	yes
Constraints	Controlled vocabulary
Examples	"Person", "Organization", "SoftwareApplication"
Notes	Thesaurus at https://tdwg.github.io/attribution/people/dwc/vocubulary/agentType.xml

quality of curation

How do we measure the quality of curation of a collection?

property:identificationID

identificationID (property)


Definition	An identifier for the Identification (the body of information associated with the assignment of a scientific name). May be a global unique identifier or an identifier specific to the data set. The intent of this term is to maintain the relational integrity between the `concept:identified` action and a particular determination/annotation expressed in the Identification History Extension when present.
Existing property	identificationID
Existing namespace	http://rs.tdwg.org/dwc/terms/
Existing property identifier	http://rs.tdwg.org/dwc/terms/identificationID
Format	string
Required	no
Constraints
Examples	9992
Notes

property:name

name (property)


Definition	The name of the item. In this case the full name as woud be written on a legal document (without abbreviation), eg givenName familyName
Existing property	name
Existing namespace	https://schema.org/
Existing property identifier	https://schema.org/name
Format	string
Required	yes
Constraints
Examples	"Margaret Smith"
Notes

property:verbatimName

verbatimName (property)


Definition	As written on occurrence, such as the collection or determination label.
Existing property
Existing namespace
Existing property identifier
Format	string
Required	no
Constraints
Examples	"Mrs. Mark Smith"
Notes

property:additionalName

additionalName (property)


Definition	An additional name for a Person, can be used for a middle name.
Existing property	additionalName
Existing namespace	https://schema.org/
Existing property identifier	https://schema.org/additionalName
Format	string
Required	no
Constraints
Examples	Robert
Notes

concept:illustrated

illustrated (concept)


Definition	Attached or drew a plate of a specimen or attached it to a specimen.
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"illustrated"
Notes	The Latin word for this is illustravit.

concept:preserved

preserved (concept)


Definition	Maintained the subject in its original state or in a conserved state to prevent the subject from decomposing
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"preserved"
Notes

concept:georeferenced

georeferenced (concept)


Definition	Determined the georeference (spatial representation) for the location
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"georeferenced"
Notes

concept:distributed

distributed (concept)


Definition	In exsiccatae (series) the one who issued the series
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"distributed"
Notes	The Latin word for this is edit.

Complete how to contribute section

The "how to contribute" section of the README should be updated. Here is how other IG have done it:

less PROV-y

Modify recommendation to be a bit more generic and then provide specific reifications and how they can be transformed from one to the other.

concept:identified

identified (concept)


Definition	Assigned the subject to a taxon
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"identified"
Notes

concept:measured

measured (concept)


Definition	Determined the value of a measurement
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"measured"
Notes

ORCID and WikiData

Modify recommendation to include ORCID and Wikidata for people.

property:action

action (property)


Definition	The name of the single action written as a verb in past tense. Recommended best practice is to use a controlled vocabulary.
Existing property
Existing namespace
Existing property identifier
Format	string
Required	yes
Constraints	Controlled vocabulary
Examples	"collected","identified"
Notes	Thesaurus available at https://tdwg.github.io/attribution/people/dwc/vocubulary/action.xml

property:role

role (property)


Definition	The name of the role the agent played in the context of executing the action. Not to be confused with the agent's role in an organization. Recommended best practice is to use a controlled vocabulary.
Existing property	cro
Existing namespace	http://purl.obolibrary.org/obo/cro.owl
Existing property identifier	http://purl.obolibrary.org/obo/cro.owl
Format	string
Required	yes
Constraints	Controlled vocabulary
Examples	"primary collector role", "specimen collection role"
Notes	Thesaurus at https://tdwg.github.io/attribution/people/dwc/vocubulary/role.xml. See also the Contributor Role Ontology http://purl.obolibrary.org/obo/cro.owl where roles can be derived.

feature request: user-friendly working examples

Hi.
I was planning to use a simple spreadsheet to track work of volunteers in our institution, so I searched and found this repository and the publication: https://doi.org/10.5334/dsj-2019-054

I took a look and saw some graphical examples, plus some SQL-like queries.
Sorry, I don't know exactly what kind of language it is. The same one used in Wikidata?
Are those tables with the examples available somewhere?

I would like to see a tabular version of those examples, like a spreadsheet with columns representing all those examples of object-entities, curatorial-actions and curator-agents.

Also, do you know if there is any piece of open collection-databasing software already implementing all these ideas?
(or something similar)

Thanks a lot
@abubelinha

concept:prepared

prepared


Definition	Made the subject ready for use
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"prepared"
Notes

Complete rationale of README

Currently empty at https://github.com/tdwg/attribution/blob/master/README.md. Should be updated with (parts of) the charter.

concept:verified

verified


Definition	Assigned the subject to a taxon in concordance with a prior determination.
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples
Notes

concept:transcribed

transcribed


Definition	Entered the text written on a physical object into a digital resource.
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"transcribed"
Notes

property:familyName

familyName (property)


Definition	Family name. In the U.S., the last name of an Person. This can be used along with givenName instead of the name property.
Existing property	familyName
Existing namespace	https://schema.org/
Existing property identifier	https://schema.org/familyName
Format	string
Required	no
Constraints
Examples	"Smith"
Notes

property:identifier

identifier (property)


Definition	Recommended practice is to identify the resource by means of a string conforming to an identification system. Examples include International Standard Book Number (ISBN), Digital Object Identifier (DOI), and Uniform Resource Name (URN). Persistent identifiers should be provided as HTTP URIs.
Existing property	dc:identifier
Existing namespace	http://purl.org/dc/terms/
Existing property identifier	http://purl.org/dc/terms/identifier
Format	URI
Required	no
Constraints
Examples	"https://orcid.org/0000-0001-6201-7340", "http://www.wikidata.org/entity/Q78571"
Notes

Review start/endDate in Agent extension

There was a lot of discussion for dwc:eventDate which resulted in a single field as opposed to start and end dates. What are the reasons for having a start and end date as opposed to a single field here please?

(I was actually in the minority in the DwC discussion as I preferred the simplicity of start and end dates for e.g. databasing as time ranges weren't widely supported back then. Today, I would probably favour consistency with other date formats within DwC)

property:displayOrder

displayOrder (property)


Definition	The display order for the agent that executed the action when more than one agent was a participant.
Existing property	displayOrder
Existing namespace	http://vocab.getty.edu/ontology/
Existing property identifier	http://vocab.getty.edu/ontology/displayOrder
Format	integer
Required	no
Constraints
Examples	1, 2
Notes

property:endedAtTime

endedAtTime (property)


Definition	End is when an action is deemed to have been ended by an agent.
Existing property	prov:endedAtTime
Existing namespace	http://www.w3.org/ns/prov#
Existing property identifier	http://www.w3.org/ns/prov#endedAtTime
Format	date
Required	no
Constraints
Examples	"2012-04-25T03:40:00Z"
Notes	Borrowed from the PROV ontology, aligning with work done through RDA. https://www.w3.org/TR/prov-o/

Make the rep public

@peterdesmet can we make the rep public? The group is formally recognised and endorsed by both RDA and TDWG.

concept:collected

collected (concept)


Definition	Collected the subject
Existing concept
Existing namespace
Existing concept identifier
Format	string
Examples	"collected"
Notes	In Latin, collegerit.

concept:unknown

Definition: Performed an unspecified action on the specimen.

Example usage: A signature/agent name was automatically read from a label and connected to an identifier, without knowing which action this agent performed. The exact action may also be unclear/ambiguous in the written source.

Also possible to use a more elaborate vocabulary for unknown instead, as described in table 2 of this paper: https://doi.org/10.1093/database/baz129

tdwg / attribution Goto Github PK

attribution's People

Contributors

Stargazers

Watchers

Forkers

attribution's Issues