isamplesorg / metadata

Collation of metadata examples and notes for the project
https://isamplesorg.github.io/metadata/
8 stars 2 forks source link

update schema for permit and sampling protocol information #102

Closed smrgeoinfo closed 1 year ago

smrgeoinfo commented 1 year ago

See https://github.com/isamplesorg/isamples_inabox/issues/193

CompliesWith: one or more statements about the procedures and policies followed in a sample collection event; include biocultural label type content reltating to social conventions and cultural considerations.

AuthorizedBy: one or more statements about legal permits related to accessing a site or removing material from a site.

use cases from Neil Davies for Fair island work, also Geome permit information.

smrgeoinfo commented 1 year ago

current solution is to concatenate this information in the description field. Let's discuss. We haven't implemented the accessConstraints property on SamplingSite, a possible place for permitInformation. Also haven't implemented usedProcedure on SamplingEvent, which would be the logical place for samplingProtocol, which is in 116441 records (currently concatenated in description). Debatable whether this is a good place for compliesWith policies (social conventions, cultural considerations) that are not about the actual technical sampling procedure.

smrgeoinfo commented 1 year ago

Modeling question: is PermitInformation on a samplingSite or samplingEvent. Seems that it should be on the Event, because different agents might sample at the same site, but under different permits.... accessconstraints on the site would say a permit is required, what are conditions of permit, contact xxxx to obtain permit.

datadavev commented 1 year ago

Neil indicated that permits are typically "per expedition", with possibly a bundle of permits referenced by samples collected on the expedition, with perhaps some permits not being directly relevant to a particular sample. I think an example might be permits for shore and scuba collection, with a mix collected on the expedition. Assigning a specific permit to each sample during collection appears to be a significant burden.

smrgeoinfo commented 1 year ago

That suggests another possibility (in the YAML but not implemented). A samplingEvent hasInitiative, which is intended to link the event to a project, cruise, expedition, etc.... Perhaps the Initiative should have the permitInformation property.

smrgeoinfo commented 1 year ago

looks like 'authorizedBy' and 'compliesWith' have been added to the schema with no documentation, I assume to address this issue?

smrgeoinfo commented 1 year ago

these are in schema v1.0 (PR #127)