update schema for permit and sampling protocol information
Closed this issue · 6 comments
See isamplesorg/isamples_inabox#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.
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.
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.
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.
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.
looks like 'authorizedBy' and 'compliesWith' have been added to the schema with no documentation, I assume to address this issue?
these are in schema v1.0 (PR #127)