Skip to content
This repository has been archived by the owner on Oct 19, 2023. It is now read-only.

Property:preparationType #64

Open
mtrekels opened this issue Nov 26, 2019 · 16 comments
Open

Property:preparationType #64

mtrekels opened this issue Nov 26, 2019 · 16 comments
Assignees
Labels
Class:ObjectGroup data model issues related to data model subtasks done Reviewed and ready to go help wanted Extra attention is needed include in version 1

Comments

@mtrekels
Copy link
Contributor

mtrekels commented Nov 26, 2019

Label Preparation Type
Definition A term used to classify or describe an object that indicates the actions that have been taken upon it and/or the processes it has been put through to prepare it for scientific use or study.
Usage A more specific classification of items in the collection than described in objectType.
Existing property
Existing class
Existing property identifier
Format Text
Required No
Repeatable Yes
Constraints Preparation Type should be set in conjunction with Object Type, as each Object Type has specific Preparation Types. E.g., if objectType = DNA: preparationType should be one of gDNA, eDNA, aDNA
Examples Bones, Eggs, Fossils, Gemstones, Lysate, Macrofossils, eDNA, Viable cells, Pollen, Muscle, Leaf, Blood, Known - witheld
Notes This can be the same as PreservationMethod (e.g. Bone), but is not always. This should not be used for classifying objects by taxon. The best way to do that is to use the Taxon class (formal taxonomy and vernacular names) or ObjectClassification class (informal classification). For large collections with multiple types use a pipe delimited list.
@mtrekels mtrekels added data model issues related to data model subtasks Class:ObjectGroup labels Nov 26, 2019
@Blerina01
Copy link

Might be named as a "taxon", which may be a species, subspecies, genera, family or class.

@qgroom
Copy link
Member

qgroom commented Feb 11, 2020

I think the intention is for this to be the type of object, such as herbarium sheet, bottle, slide, skin, mounted skeleton, box etc. However, it really needs to be made clearer

@rondlg
Copy link
Contributor

rondlg commented Feb 11, 2020

Hi Quentin, yes that was the intent for this property.

@mswoodburn
Copy link
Contributor

mswoodburn commented Mar 15, 2020

Suggestion for definition/existing term from a comment in the index spreadsheet: https://www.dublincore.org/specifications/dublin-core/collection-description/collection-application-profile/#colclditemType

@mswoodburn
Copy link
Contributor

@ekrimmel
Copy link
Collaborator

ekrimmel commented Mar 16, 2020

Is the Dublin Core 'item type' too broad? Since it is similar to and uses the same suggested controlled vocabulary as DC 'type' which is used in DwC to indicate at a very high level what the object is: PhysicalObject, MovingImage, etc.

Also, will this be equivalent to #82 ?

@qgroom
Copy link
Member

qgroom commented Mar 16, 2020

This dimension is quite important for collecting metrics on aggregated collections. I think we need to constrain the users to a strict set of values, otherwise they will not aggregate cleanly

@qgroom
Copy link
Member

qgroom commented Mar 16, 2020

I don't think we need to go to fine detail, as in DwC, because we want to describe collections in common terms.

@ekrimmel
Copy link
Collaborator

I can see why it's important to provide controlled vocabulary for this property and why this is a crucial property to define well in order to collate metrics across individual collections. I also think this is a tricky property to define and even trickier to provide a controlled vocabulary for that is detailed enough to differentiate object types in interesting ways, but broad enough to apply universally.

In the current definition I think "the physical type of object" and "that is curated as a single specimen" are problematic when combined. It might be useful to consider whether objectType is designed to fit cataloged objects or physical objects, which are not always equivalent, e.g. a cataloged object may have multiple physical objects that belong to different collections depending on preparation or research use. You might have a single organism, let's say a bat, for which you prepare a dry study skin (stored in a cabinet), a non-articulated skeleton (stored with the skin), and a DNA sample (stored in a freezer). Those three types of physical objects might be treated as a single cataloged object, i.e. one record in the database, one record on GBIF, citations in the literature for one biological individual that is now one specimen, etc.

Maybe this property just needs to be flexible enough for individual collections to determine their own scope re cataloged objects vs physical objects? In how I'm understanding the current CD model, either way would have implications for other classes: if you count all three bat parts separately then classes like Storage Location and Object Quantity fit more cleanly, but if you count all three bat parts as a single cataloged object then classes like Taxon Quantity and Digitization Level Assessment fit more cleanly.

Arctos has given this a considerable amount of thought. See their rationale for "what is a cataloged object" vs. "what kinds of parts make up a cataloged object" (also see their code table for controlled vocab, which isn't meant to be exhaustive but gives a view into how detailed some collections folks get about object type).

@debpaul debpaul added the vocabulary:needed terms that needs controlled vocabularies label Mar 27, 2020
@mswoodburn
Copy link
Contributor

As discussed, we've made this a bit more flexible in the definition and removed the controlled vocabulary constraint (although should be recommended to use some form of controlled vocabulary for any CD scheme where using this property as a dimension to group and report on CDs). I've also added in some examples based on NHM Join the Dots data.

@mswoodburn mswoodburn removed the vocabulary:needed terms that needs controlled vocabularies label Jan 28, 2021
@qgroom
Copy link
Member

qgroom commented Jan 28, 2021

This should generally be used for classifying objects by taxon

Shouldn't this be...

This should not generally be used for classifying objects by taxon

@Blerina01
Copy link

Blerina01 commented Jan 28, 2021 via email

@mswoodburn
Copy link
Contributor

Yes, sorry - very bad word to miss out! I've fixed that in the notes.

@wouteraddink
Copy link
Contributor

suggestion to change from objectType to materialAppearance or objectAppearance. See also my comments in #255.

controlled terms used in SYNTHESYS+ (the descriptions are for different disciplines so there is some repetition):

Dried assemblage | Not in fluid
Dried - not assembled | Not in fluid, human remains bones, (not recent)
Fluid preserved |  
Microscope slides |  
Cryopreserved/frozen - 80C |  
Artefacts: climate controlled conditions | Air conditioning/climate controlled units/rooms
Artefacts: non climate controlled conditions | Not air conditioned/climate controlled units/rooms can include mummies
Pressed and dried | Herbarium specimens
Dried | Fruits wood samples, not preserved in fluid.
Fluid preserved | Flowers/fungi in alcohol/formalin/glycerine
Microscopic slides | Microscopic slides
Cryopreserved/frozen 80C | DNA/RNA, tissue
Spore print | Spore print
Dried | Not preserved in fluid
Cryopreserved DNA/RNA | DNA/RNA, tissue
Dried - assembled | Multiple animal parts or entire organism skeletons, stuffed animals
Dried - not assembled | Animal part: tanned skin, egg shell, etc
Fluid preserved | Animals in alcohol/formalin/glycerine
Dried and pinned | Pinned insects
Dried - assembled | Not pinned. Multiple animal parts of entire organism
Dried - not assembled | Animal part. shell, bone, etc.
Fluid preserved | Animals in alcohol/formalin/glycerine
Microscope slides | Microscopic slides
Cryopreserved / frozen -80C | DNA/RNA, tissue
Other |  
Unspecified
Macrofossils (dry preserved) | Handspecimens/slabs/matrix support (i.e. surrounded by original sediment), matrix free (free from original sediment) - botanical, vertebrates, invertebrates, trace fossils etc.
Mesofossils (dry preserved) | Small fossilised parts of plants such as fruits, leaves, and seeds contained in Jars, Franke cells - i.e. a paper container, the size of a preperation glass with a circular space covered by a lid-covering glass.
Microfossils (dry preserved) | Dry samples, in jars, trays (i.e. not preserved in fluid) etc.
Macrofossils (fluid preserved) | Preserved in a fluid in a jar, a concealed units.
Messofossils (fluid preserved) | Preserved in a fluid in a jar, a concealed unit.
Microfossils (fluid preserved) | Preserved in a fluid in a jar, a concealed unit
Fossils preserved in Amber, natural resin | required to be kept in humidity and light controlled storage units.
Microscope slides | Microscope slides of microfossils, messofossils and macrofossils for either binocular or petrographic microscopes
Oversized fossils | Too large to be fit into standard storage units.
Other | Sieving residue, other microscopic preperations (SEM stubs) etc.
Unspecified
Macro-objects | Handspecimens/hand-held objects/slabs that can be contained in standard units (draws, shelves, cabinets). E.g. rocks, minerals, gems (rough natural form) and ores.
Micro-objects | Can only be handled/observed with the aid of a microscope. Contained in jars
Cut/polished gemstones | High-expense/rare/precious stones that need careful handling and contained in secure units
Microscope slides | Binocular or petrographic microscope slides of rocks, minerals, gems, ore, alloys etc
Cores | Rocks, Ore, Sediments (soil, mud etc.) etc.
Fluids | Hydrocarbons, oils etc.
Oversized objects | Requires extra space because objects are too large for standard units/containers.
Hazardous material/objects | Material or fluids that are hazardous to health - radioactive, toxic etc.
Other | Does not fit into the above subcatagories. e.g. crushed rocks, other microscopic prepared objects (e.g. SEM stubs) etc.
Macro-objects | Handspecimens/hand-held/slabs Meteorites, Moon rock etc
Micro-objects | Can only be handled/observed with the aid of a microscope. contained in Jars, sample bags etc.
Oversized objects | Requires extra space because objects are too large for standard units/containers.
Microscope slides | Thin sections of meteorites etc.

This set is particularly helpful for collection management or image recognition services.

Note: This is NOT the same as BioCASE ObjectClassType vocabulary: https://www.biocase.org/doc/Results/WP3/Oldversions/SpyDoc_122/BioCASE_MetaProfile_1.22.shtml#complexType_ObjectClassType_Link01DEB818 which is more like Material (wood, bark, leaf, gold, ivory etc) although a bit mixed.

@wouteraddink
Copy link
Contributor

Note that in Synth+ dashboard development this was called PreservationType which I think was not right, as that should be more something like http://arctos.database.museum/info/ctDocumentation.cfm?table=CTPART_PRESERVATION, see also #65 (preservationMethod)

@essvee essvee changed the title Property:objectType Property:preparationType May 17, 2021
@essvee
Copy link
Contributor

essvee commented May 17, 2021

Updated the property name + examples to reflect that this property/discussion focuses on a lower-level classification than objectType which has a new issue assigned: #304.

@fmjjones fmjjones added the done Reviewed and ready to go label Feb 3, 2022
jbstatgen added a commit that referenced this issue Apr 12, 2023
jbstatgen added a commit that referenced this issue Apr 12, 2023
magpiedin added a commit that referenced this issue Oct 19, 2023
* Adds hasObject properties to termlist and updates examples

* Adds datatypes to termlist

* updates identifier to identifierValue

* adds Event.eventName

* specifies array item datatypes

* add range & class-level-properties

* Updates Person.Identifier examples to have more than one

* Create ltc_skos_mapping.csv

Initial version of skos mappings

* Create Latimer Core browser.pbix

New version of LtC browser

* Update Latimer Core browser.pbix

Changed skos mapping csv source from local to GitHub

* Update Latimer Core browser.pbix

Minor fix to property html

* Update ltc_standard_terms_draft.csv

Added term_status, term_added and term_modified

* Update ltc_standard_terms_draft.csv

Added proposed hasSchemeTerm and hasSchemeMeasurementOrFact properties to the CollectionDescriptionScheme class

* Update ltc_standard_terms_draft.csv

Added proposed hasObjectGroup property to CollectionDescriptionScheme class

* Update ltc_standard_terms_draft.csv

Removed objectClassificationParent property, as superseded by the hasObjectClassification property

* Update ltc_skos_mapping.csv

Tweaks to some mapping relations, and also removed duplicate rows (repeated for hasIdentifier etc in mulltiple classes)

* Update ltc_standard_terms_draft.csv

Updates from SKOS mapping review (see issues #399 to #412)

* Updates json schema and examples: removes objectClassificationParent and renames Identifier.source as .identifierSource

* updates schema description

* Adds PersonRole.hasMeasurementOrFact

* Fixes omission of parent class in termlist.csv

* Updates termlist and schema

* Adds term to termlist.csv

* Updates StorageLocation schema to include locationDescription

* Adds ObjectGroup.alternativeCollectionName to termlist.

* Adds ObjectGroup.alternativeCollectionName to ObjectGroup schema and example files

* Fixes a couple of typos

* adds object count estimates to orgClass

* Separates property datatypes from normative termlist fields

* Updates bool property names in class-level examples

* Updates bool property names in json schema files

* Updates bool property names, labels and defs

* Small, pedantic edits to definitions to match those in the termlist

* updates collectionDescriptionScheme term name to hasCollectionDescriptionScheme

* Adds GO terms to skos mapping

* Adds GO terms to termlist

* Adds GO terms to datatypes list

* Adds GeographicOrigin.ecoRegion

* Updates json schema with amended definitions for GeoOrigin terms

* Update ltc_standard_terms_draft.csv

Fixed some special character encodings

* Update Latimer Core browser.pbix

Refreshed data from termlists

* kw-csv-to-json (#432)

* setup csv-to-json in tools

* setup json-schema converter

* add first batch of test-output

* draft update 'required'/minItems for arrays

* add env options for live/test output

* add initial test-output

* fix link?

* update how-to

* edit trouble-shooting + to-do

* generalize variable names

* fix link

* fix name

* fix description

* typo

* reorganize

* fix link

* update minItems/requirements & troubleshooting

* auto-json (#433)

* fix MeasOrFact

* note date-datatype (to-do)

* update main json-schema

* Revert "auto-json (#433)" (#439)

This reverts commit d881331.

* Add spec csv-to-json tool (#440)

* add test-spec based on ltc terms CSV

* edit test-spec based on ltc terms CSV

* add SPEC_CSV variable to .env

* add spec script + output path

* require CollStHis:hasMeasOrFact and GeoCtxt:bed

* fix spec script's use of spec-csv

* revert to pre-auto JSON

* fix repeatable term vs class

* fix SPEC_CSV example URL

* add spec JSON_OUTPUT_PATH

* add missing spec-steps

* fix typo

* re-try auto-generating json-schema (#441)

* Update ltc_standard_terms_draft.csv

Fixed mislabeled measurementAccuracy term

* Added Role class

Added the new Role class, removed PersonRole.role and added hasRole, with some tweaks to PersonRole class notes

* Updated Role mappings and datatypes

Also modified PersonRole.hasRole to repeatable array

* Adds country codes to examples field

* add note to Address.addressCountry field

relates to #455

* Update to notes field: only for paleo OGs

#465

* Updated examples to "`MaterialEntity`, `InformationArtefact`, `AbstractConcept`"

#463

* Removes contactDetailType and adds additional examples to contactDetailFunction

* Adds ContactDetail.contactDetailFunction

* Update of typeOfCollection?

#463

* Adds ObjectClassification.isTopParent

* Adds hasParentEvent to Event

* Updated typeOfCollection

#463

* Update ltc_standard_terms_draft.csv

* Corrects required/repeatable flags for ObjectGroup.alternativeCollectionName

* baseTypeOfCollection: change from term to terms in def

#365

* Updated typeOfCollection example from "MaterialEntities" to "MaterialEntity"

#255

* Update typeOfCollection examples

* Updated objectType

#304

* objectType: example update

#304

* objectType: removed spelling error

#304

* Updated preparationType Examples and Notes

* Updated Examples of preparationType

#64

* Changed examples of material

#261

* Corrected spelling mistake in material

#261

* Updated examples for preparationType

#64

* Updated Notes and Examples of preservationMethod

#65

* Update to Notes in baseTypeOfCollection

#365

* rename CollectionDescriptionScheme

...to ObjectGroupDescriptionScheme - #429

* rename CollectionDescriptionScheme

...to ObjectGroupDescriptionScheme - #429

* rename remaining CollectionDescriptionScheme

to "ObjectGroupDescriptionScheme" - #429

* baseTypeOfCollection: set repeatable = YES

#446

* Updated baseTypeOfCollection: spelling error

#446

* rename to LatimerCoreScheme

following #476 & updated #429

* Update ltc_standard_terms_draft.csv

Updated according to issue #462

* Update ltc_standard_terms_draft.csv

Updated with additional notes from issue #450

* rename baseTypeOfCollection

...to baseTypeOfObjectGroup - #477

* rename typeOfCollection

to typeOfObjectGroup - #478

* rename to LatimerCoreScheme - #429

#429

* rename baseTypeOfCollection - #477

to baseTypeOfObjectGroup

* rename typeOfCollection - #478

to typeOfObjectGroup

* rename typeOfCollection - #478

to typeOfObjectGroup

* rename CollectionDescriptionScheme - #429

to LatimerCoreScheme

* Add files via upload

Terms defined as human versus machine readable. Check terms after all review updates are made.

* update LtCScheme in ranges - #429

* rename CDScheme to LtCScheme - #429

"CollectionDescriptionScheme" class name updated to "LatimerCoreScheme"

* rename typeOfCollection in ltc.csv - #478

...to typeOfObjectGroup

* rename baseTypeOfCollection in ltc.csv - #477

...to baseTypeOfObjectGroup

* Updated GeographicOrigin to GeographicContext

* Update ltc_standard_terms_draft.csv

Further updates to definitions in the renamed GeographicContext class

* Updates class-level notes and usage recommendations

* Removes reference to stratigraphy from verbatimChronometricAge

* Update ltc_standard_terms_draft.csv

Changed labels for stateProvince and county #431

* Update ltc_categories.csv

Updated GeographicContext name & definition

* Updated hasOrganisationalUnit to hasParentOrganisationalUnit

* updates examples for chronometricAgeProtocol

* updates baseTypeOfObjectGroup to array

* updates usage notes for isDerivedCollection

* update CDScheme to LtCScheme in termlist-header

* Updated example for Reference.referenceDetails

#454 326

* 2nd Example added for Reference.referenceDetails

#326

* Updated example: collection dynamics to growth status

#367

* Updated example 

#124

* Removes collectionDescriptionPID and adds recommendation to hasIdentifier

* extends TemporalCoverage to PersonRole, changes dates to datetimes

* Update ltc_standard_terms_draft.csv

added superGroup property

* Updated referenceText to referenceName

Closes #453

* Changed collectionName to required = No

Closes #485

* Updates GeographicContext.ecoRegion notes

* Update ltc_datatypes.csv

Updated remaining references to GeographicOrigin to GeographicContext

* Added new EcologicalContext class

Add class and term definitions

* Update ltc_standard_terms_draft.csv

Removed ResourceRelationship.resourceRelationshipID as superseded by hasIdentifier

* Update ltc_standard_terms_draft.csv

Removed GeographicContext.salinityType as superseded by EcologicalContext class

* Update ltc_standard_terms_draft.csv

While checking boolean values: for "isDistinctObjects" removed "If isDistinctObjects is set to 'true', then no collection object should be covered by more than one object group within the LatimerCoreScheme." from "Usage", since it was already present in "Notes" and fits better there.

* Update ltc.csv

changed 1 of 11 instances of Organization... to Organisation. The other 10 are from other standards.

* Update ltc_standard_terms_draft.csv

2 of 4 instances of "organiza..." replaced with "organisa..." The other 2 are namespace dependent.

* match readme to master

to prevent conflicts

* Update Latimer Core browser.pbix

Refreshed from term list, added icon and other minor tweaks

* Refreshed derived csvs fpr terms

Regenerated namespace-specific CSVs and category CSVs from main term CSV

* clean up examples in ltc_standard_terms_draft.csv

* Update Latimer Core browser.pbix

* Added SKOS mapping decision tree

* Term updates from new SKOS review

Tweaks to terms to get definitions in line with the outcomes of the new SKOS mappings review. Includes namespace changes and definition tweaks. Also added new StorageLocation.hasParentStorageLocation term.

* Update ltc_standard_terms_draft.csv

Fix to hasParentStorageLocation term name

* Update ltc_standard_terms_draft.csv

Removed escaped double quotes

* Update ltc_standard_terms_draft.csv

Removed unpaired double quote

* Update ltc_standard_terms_draft.csv

* Update ltc_standard_terms_draft.csv

* Update ltc_standard_terms_draft.csv

* Updated term mappings

Updated SKOS mappings after review and replacing term names with URIs. Added more comprehensive SSSOM mappings.

* Removed trailing CSV columns

* Update Latimer Core browser.pbix

Refreshed data and modified to accept SKOS mappings from URIs

* Update ltc_standard_terms_draft.csv

Fixed issues with merge overwriting changes

* Update Latimer Core browser.pbix

Refreshed data

---------

Co-authored-by: Kate Webbink <[email protected]>
Co-authored-by: Matt Woodburn <[email protected]>
Co-authored-by: jbstatgen <[email protected]>
Co-authored-by: fmjjones <[email protected]>
Co-authored-by: Sharon Grant <[email protected]>
Co-authored-by: Kate Webbink <[email protected]>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Class:ObjectGroup data model issues related to data model subtasks done Reviewed and ready to go help wanted Extra attention is needed include in version 1
Projects
None yet
Development

No branches or pull requests

10 participants