Entities - Entités

From KarstLink
Revision as of 05:33, 8 June 2022 by EricMadelaine (talk | contribs) (polished...)
Introduction
Entities (en) Entités (fr)
We will present in natural language the different Entities that we want to describe and the relationships that exist between these objects.

Some additional concepts are introduced briefly (Classes, Objects, Controlled vocabulary, ...).


Nous allons présenter, en langage naturel, les différents Entités que nous souhaitons décrire, ainsi que les relations qui existent entre ces objets.

Quelques concepts complémentaires sont également introduits succinctement (Classes, Objets, Vocabulaire contrôlé,...)


State: proposal Etat : proposition
Decision taken during the vote held in July 2020. The results are available here Décision prise lors du vote organisé en juillet 2020. les résultats sont disponibles ici
"General concepts" "Concepts généraux"
To describe and use our ontologies, we need several ingredients:


Thesaurus (or Vocabularies) list 'Terms' and give their meaning in natural language.


Ontologies describe Classes and relations between classes, Objects (instances of Classes) and Relations.

An RDF Triple (object1 relation object2) defines a relation between 2 objects and relations themselves can have an inheritance structure. Defining a request in this framework will use RDF triples.


The last element will be a mapping between the ontology classes and the structure of the existing (table-based or relational) databases, using functions that will be implemented as APIs.


There should be a link here to a more complete explanation page.

  • Naming Conventions: class names will have an initial capital (as "Underground Cavity"), while objects (instance of a class are written in lower case letters ("an underground cavity")
  • A "controlled vocabulary" is a collection of words and expressions.
  • A "Controlled vocabulary" can be used for a dictionary, that is a list of terms authorized as the value of some object.
  • A controlled vocabulary will be used for our ontology. It will consist in several lists of terms, each list describing the possible values of some class, e.g. the list for "Cavity Type" will include natural cave, pit, mega-doline, mine, underground quarry, sewer, etc.
Pour décrire et utiliser nos ontologies, nous avons besoin de plusieurs ingrédients :

Le thésaurus (ou vocabulaire) énumère les termes et donne leur signification en langage naturel.

Les ontologies décrivent les classes et les relations entre les classes, les objets (instances de classes) et les relations.

Un Triplet RDF (object1 relation object2) définit une relation entre 2 objets, et les relations elles-mêmes peuvent avoir une structure d'héritage. La définition d'une demande dans ce cadre utilisera des triplets RDF.

Le dernier élément sera une traduction entre les classes des ontologies et la structure des bases de données existantes (basées sur des tables ou relationnelles), à l'aide de fonctions qui seront implémentés dans des APIs.

Il devrait y avoir ici un lien vers une page d'explications plus complètes.

  • Conventions de nommage: les noms des classes commencent par une lettre capitalisée (comme "Cavité"), alors que les objets (instance d'une classe) sont écrits en minuscules ("cavité")
  • Un "vocabulaire contrôlé" est un ensemble de mots et d'expressions.
  • Un "Vocabulaire contrôlé" peut être utilisé pour constituer un dictionnaire, c'est à dire une liste de termes autorisés pour certains objets.
  • Un vocabulaire contrôlé sera utilisé pour notre ontologie. Il comprendra plusieurs listes de termes, par exemple la liste pour les "Types de cavités" contindra cavité naturelle, puits, aven, méga-doline, mine, carrière souterraine, égout, etc.


Main entities, selected during the July 2020 vote / Entités principales, retenues lors du vote de Juillet 2020
"Underground cavity" "Cavité"
"Underground cavity" is a class of entities. A given "underground cavity" is an object, instance of this class.

In order for this object to represent the various notions of cavities used in existing databases, it must be as polymorphic as possible.

An underground cavity can be natural or artificial (mine, quarry, sewer, tunnel, etc.), penetrable or not, karstic or not (volcanic, etc.), or certain types of superficial karst phenomena (source, drain, polje, mega-doline, etc.).

For the same reason, we do not define a specific type of "cave network" or "system", but also present it as a cavity, which can itself be made up of parts or cavities.

Each base connected via KarstLink can have its own limitations, and use a notion of Cavity type to build specific requests.

  • an underground cavity can have a cavity type
  • an underground cavity can consist of underground cavities
  • an underground cavity can be made up of underground cavity parts
  • an underground cavity can have localization properties
  • an underground cavity can be described
  • an underground cavity can be linked to persons
  • an underground cavity can be linked to organizations
  • an underground cavity can be linked to documents
  • an underground cavity can be linked to observations
"Cavité" (souterraine) est une classe d'entités. Une "cavité" est un objet, instance de cette classe.

Pour que cet objet puisse représenter les notions de cavité très variées utilisées dans les bases de données existantes, il doit être aussi polymorphe que possible.

Une cavité pourra être naturelle ou artificielle (mine, carrière, perte, tunnel, etc.), pénétrable ou non, karstique ou autre (volcanique, etc.), ou certains types de phénomènes karstiques superficiels (source, embut, méga-doline, etc.).

Pour la même raison, nous ne définissons pas un type spécifique de "réseau" ou "système", mais le présentons aussi comme une "cavité", qui peut elle-même être constituée de parties ou de cavités.

Chaque base connectée via KarstLink peut avoir ses propres limitations, et utiliser une notion de "type de cavité" pour construire des requêtes spécifiques.

  • une cavité peut avoir un type de cavité
  • une cavité peut être constituée de cavités
  • une cavité peut être constituée de parties de cavité
  • une cavité peut avoir des propriété de localisation
  • une cavité peut être décrite
  • une cavité peut être liée à des personnes
  • une cavité peut être liée à des organisations
  • une cavité peut être liée à des documents
  • une cavité peut être liée à des observations
"Point" "Point"
"Point" is a geographical class of entities.
  • a point can have localization properties
  • a point can be linked to underground cavity
  • a point can be linked to organizations
  • a point can be linked to documents
  • a point can be linked to persons
  • a point can be linked to observations
"Point" est une classe d'entités géographiques.
  • un point peut avoir des propriété de localisation
  • un point peut être associé à une cavité
  • Un point peut être associé à une organisation
  • Un point peut être associé à un document
  • Un point peut être associé à une personne
  • Un point peut être associé à des observations
"Area" "Zone"
"Area" is a super-class of multi pupose entities (geographical, administrative, geological, economical, heritage, ecological,...)
  • an area can have localization properties
  • an area can be described
  • an area can be linked to persons
  • an area can be linked to organizations
  • an area can be linked to underground cavities
  • an area can be linked to any observation
"Zone" est une super-classe d'entités à vocations multiples (géographique, administrative, géologique, économique, patrimonial, écologique,..)
  • Une zone peut avoir des propriété de localisation
  • Une zone peut être décrite
  • Une zone peut être liée à des personnes
  • Une zone peut être liée à des organisations
  • Une zone peut être liée à des cavités
  • Une zone peut être liée à tous types d'observations
"Document" "Document"
"Document" is a class of entity
  • a document can have localization properties
  • a document can be described
  • a document can be linked to persons
  • a document can be linked to organizations
  • a document can be linked to underground cavities
  • a document can be linked to a licence
  • a document can be linked to thems
  • a document can be linked to observation
"Document" est une classe d'entités.
  • Un document peut avoir des propriété de localisation
  • Un document peut être décrit
  • Un document peut être liée à des personnes
  • Un document peut être liée à des organisations
  • Un document peut être liée à des cavités
  • Un document peut être liée à une licence
  • Un document peut être lié à des thèmes
  • Un document peut être lié à des observations
"Person" "Personne"
"Person" is a class of entity. A person is an instance of this class.
  • a person can be linked to underground cavities
  • a person can be linked to organizations
  • a person can be linked to documents
  • a person can be linked to observations
  • a person do not be described (GDPR UE rules)
"Personne" est une classe d'entités.
  • Une personne peut être associée à une ou plusieurs cavité(s)
  • Une personne peut être associée à une ou plusieurs organisation(s)
  • Une personne peut être associée à un ou plusieurs document(s)
  • Une personne peut être associée à des observations
  • Une personne ne sera pas décrite (Règlementation [RGPD])
"Organization" "Organisation"
"Organization" is a class of entity that brings together persons or organizations.
  • an organization can have localization properties
  • an organization can be described
  • an organization can be linked to underground cavities
  • an organization can be linked to organizations
  • an organization can be linked to persons
  • an organization can be linked to documents
  • an organization can be linked to observations
"Organisation" est une classe d'entités qui regroupe des personnes ou d'autres organisations.
  • Une organisation peut avoir des propriété de localisation
  • Une organisation peut être décrite
  • Une organisation peut être associée à une ou plusieurs cavité(s)
  • Une organisation peut être associée à une ou plusieurs organisation(s)
  • Une organisation peut être associée à un ou plusieurs personne(s)
  • Une organisation peut être associée à un ou plusieurs document(s)
  • Une organisation peut être associée à des observations
"Observation" "Observation"
"Observation" is the union of several kinds of classes of entities (a super-class).
  • Observation includes (and is not limited to) bio-speleological, hydrological, archaeological, paleontological observations, as well as other physical measurements.
  • an observation can have localization properties
  • an observation can be linked to underground cavity
  • an observation can be linked to organizations
  • an observation can be linked to documents
  • an observation can be linked to persons
"Observation" est une classe d'entités rassemblant différentes sortes d'observation (une super-classe).
  • une observation peut être (sans limitation) une observation bio-spéléologique, hydrologique, archéologique, paléontologique, ou d'autre types de mesures physiques.
  • une observation peut avoir des propriété de localisation
  • une observation peut être associée à une cavité
  • une observation peut être associée à une organisation
  • une observation peut être associée à un document
  • une observation peut être associée à une personne
"Bio-Speleological observation" "Observation bio-spéléologique"
"Bio-Speleological observation" is a class of entity.
  • a bio-speleological observation is an observation
  • a bio-speleological observation can be linked to taxonomy
"Observation bio-spéléologique" est une classe d'entités.
  • une observation bio-spéléologique est une observation
  • une observation bio-spéléologique peut être associée à taxonomie
"Controlled vocabulary" "Vocabulaire contrôlé"
"Controlled vocabulary" is a set of collections of terms that will be used to describe certain properties of the entities described by Karstlink.


"Vocabulaire contrôlé" est un ensemble de collections de termes qui seront utilisés pour décrire certaines propriété des entités décrites par Karstlink.
Other Entities, to be defined later / Entités supplémentaires, à définir plus tard
"Surface phenomenon" "Phénomène de surface"
"Surface phenomenon" is a geographic and morphological class of entities of speleological interest (sinkholes, canyons, rock shelter ...).
  • a surface phenomenon can have localization properties
  • a surface phenomenon can be linked to underground cavity
  • a surface phenomenon can be linked to points
  • a surface phenomenon can be linked to organizations
  • a surface phenomenon can be linked to documents
  • a surface phenomenon can be linked to persons
  • a surface phenomenon can be linked to observations
"Phénomène de surface" est une classe d'entités géographiques et morphologiques d'intérêt spéléologique (dolines, canyons, abri sous-roche...).
  • Un phénomène de surface peut avoir des propriétés de localisation
  • Un phénomène de surface peut être associé à une cavité
  • Un phénomène de surface peut être associé à un point
  • Un phénomène de surface peut être associé à une organisation
  • Un phénomène de surface peut être associé à un document
  • Un phénomène de surface peut être associé à une personne
  • Un phénomène de surface peut être associé à des observations
"Physical measurement" "Mesure physique"
"Physical measurement" is a class of entity.
  • a physical measurement is an observation
  • a physical measurement can be linked to a device
  • a physical measurement can be linked to hydrological observations
"Mesure physique" est une classe d'entités.
  • une mesure physique est une observation
  • une mesure physique peut être associée à un appareil de mesure
  • une mesure physique peut être associée à une observation hydrologique


"Time series" "Série temporelle"
"Time series" is a class of entity.
  • a time series is an observation
  • a time series can be linked to a sensor
  • a time series can be linked to a one or more physical properties
  • a time series can be linked to a point
  • a time series can be linked to begin and end date/time entities
  • a time series can be linked to a temporal series file name
"Serie temporelle" est une classe d'entités.
  • une série temporelle est une observation
  • une série temporelle peut être associée à un capteur
  • une série temporelle peut être associée à une ou plusieurs propriétes physiques
  • une série temporelle peut être liée à un point
  • une série temporelle peut être liée à des entités date/heure de début et de fin
  • une série temporelle peut être liée à un nom de fichier de série temporelle
"Hydrological observation" "Observation hydrologique"
"Hydrological observation" is a class of entity dedicated to hydrology.
  • an hydrological observation is an observation
  • an hydrological observation can be linked to physical and / or time measurement
"Observation hydrologique" est une classe d'entités dédiée à l'hydrologie d'intérêt spéléologique.
  • une observation hydrologique est une observation
  • une observation hydrologique peut être associée à une mesure physique et/ou temporelle
"Archaeological observation" "Observation archéologique"
"Archaeological observation" is a class of entity.
  • an archaeological observation is an observation
  • an archaeological observation can be linked to physical and / or time measurement
"Observation archéologique" est une classe d'entités.
  • une observation archéologique est une observation
  • une observation archéologique peut être associée à une mesure physique et/ou temporelle
"Paleontological observation" "Observation paléontologique"
"Paleontological observation" is a class of entity.
  • a paleontological observation is an observation
  • a paleontological observation can be linked to physical and / or time measurement
"Observation paléontologique" est une classe d'entités.
  • une observation paléontologique est une observation
  • une observation paléontologique peut être associée à une mesure physique et/ou temporelle