View source for Entities - Entités

 {| class="wikitable center" width="80%"
 |-
 ! colspan="2" | Introduction
 |-
|}

{| class="wikitable alternance left" width="100%"
 |-
 ! scope="col" | Entities (en)
 ! scope="col" | Entités (fr)
 |-
 | valign="top" width="50%" | 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, ...).

Please, resume and/or modify proposal A ; feel free to make comments in the [[Talk:Objects_-_Objets|Talk page]] or suggest alternate definitions (proposal B, C, etc.) in this main page.

Since 2020 May 8th, an alternative for the name of the main object ([[#Proposal/Proposition B|B]] hereunder) is available.

To prepare the final version for the forthcoming vote, we have separated the entities here in 2 sets: the Core Entities, that are subject to the vote (Underground Cavity/Void, Point, Area, Document, Person, Observation, Bio-speleological Observation), and the rest of this page, that will be refined later. 

To get more ideas about ontologies accessible on the web, [https://web-semantique.developpez.com/ontologies/?page=general_metadonnees read this page]. 

 | valign="top" width="50%" | 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é,...)

Pour contribuer, complète ou modifie la proposition A, fait des remarques dans la [[Talk:Objects_-_Objets|page de discussion]] ou propose des définitions alternatives (proposition B, C,..) dans la présente page.

Le 8 mai 2020, une proposition alternative pour le nom de notre Entité principale a été déposée ([[#Proposal/Proposition B|B]] ci-dessous).

Pour préparer la version de cette page qui va être soumise au vote, nous avons séparé les entités en deux parties: Les Entités "Coeur" (Cavité/Vide, Point, Zone, Document, Personne, Observation, Observation bio-spéléologique), et les autres, qui seront précisées plus tard.

Pour élargir le champ des possibles, voir [https://web-semantique.developpez.com/ontologies/?page=general_metadonnees ICI] une page web listant un grand nombre d'ontologies accessibles sur l'internet..

 |-
 ! scope="col" | ''State:'' draft
 ! scope="col" | ''Etat :'' brouillon
 |-
 | scope="col" | ''Planned vote:'' July 19: opening of the vote - July 24: closing of the vote
 | scope="col" | ''Vote prévu :'' 19 Juillet ouverture du vote - 24 juillet fermeture du vote
 |-
 |}

== Proposal/Proposition A ==

 {| class="wikitable center" width="80%"
 |-
 ! colspan="2" | '''General concepts/Concepts généraux "A"'''
 |-
|}

{| class="wikitable alternance left" width="100%"
 |-
 ! scope="col" | "''General concepts''"
 ! scope="col" | "''Concepts généraux''"
 |-
 | valign="top" width="50%"| 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 - Vocabulaire contrôlé|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.

 | valign="top" width="50%"| 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 "''[[Controlled vocabulary - Vocabulaire contrôlé|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.
 |-
 |}


 {| class="wikitable center" width="80%"
 |-
 ! colspan="2" | '''Entities / Entités "A"'''
 |-
 | colspan="2" | ''Core Entities for the 2020 July Vote / Entités principales, soumise au vote de Juillet 2020''
 |-
 | colspan="2" | ''<small>proposed by:/proposé par :<br />Frédéric URIEN et Eric Madelaine<br />[updated July, 12th 2020 / M.àj. 12 juillet 2020]''</small> 
 |-
 |}

 {| class="wikitable alternance left" width="100%"
 |-
 ! scope="col" | "''[[Underground cavity - Cavité|Underground cavity]]''"
 ! scope="col" | "''[[Underground cavity - Cavité|Cavité]]''"
 |-
 | valign="top" width="50%" | "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

NB: An alternate proposition is available for this definition (see [[#B|proposition B]] hereunder).

 | valign="top" width="50%"| "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 


NB: Une proposition alternative est disponible pour cette définition  (voir [[#B|proposition B]] ci-dessous).

 |-
 ! scope="col" | "''[[Point]]''"
 ! scope="col" | "''[[Point]]''"
 |-
 | valign="top" width="50%"| "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

 | valign="top" width="50%"| "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
 
|-
 ! scope="col" | "''[[Area - Zone|Area]]''"
 ! scope="col" | "''[[Area - Zone|Zone]]''"
 |-
 | valign="top" width="50%"| "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

 | valign="top" width="50%"| "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

 |-
 ! scope="col" | "''[[Document]]''"
 ! scope="col" | "''[[Document]]''"
 |-
 | valign="top" width="50%"| "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

 | valign="top" width="50%"| "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

 |-
 ! scope="col" | "''[[Person_-_Personne|Person]]''"
 ! scope="col" | "''[[Person_-_Personne|Personne]]''"
 |-
 | valign="top" width="50%"| "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 ([https://en.wikipedia.org/wiki/General_Data_Protection_Regulation GDPR] [https://eur-lex.europa.eu/eli/reg/2016/679/oj UE rules])

 | valign="top" width="50%"| "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 ([https://eur-lex.europa.eu/eli/reg/2016/679/oj?locale=fr# Règlementation] [RGPD])

|-
|-
 ! scope="col" | "''[[Observation]]''"
 ! scope="col" | "''[[Observation]]''"
 |-
 |  valign="top" width="50%"| "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

 |  valign="top" width="50%"| "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

 |-
 |-
 ! scope="col" | "''[[Bio-Speleological observation - Observation bio-spéléologique|Bio-Speleological observation]]''"
 ! scope="col" | "''[[Bio-Speleological observation - Observation bio-spéléologique|Observation bio-spéléologique]]''"
 |-
 | valign="top" width="50%"| "Bio-Speleological observation" is a class of entity.

* a physical measurement is an observation
* a bio-speleological observation can be linked to taxonomy

 | valign="top" width="50%"| "Observation bio-spéléologique" est une classe d'entités.

* une mesure physique est une observation
* une observation bio-spéléologique peut être associée à taxonomie
 |-

 


 

 |-
 |}

{| class="wikitable center" width="80%"
 |-
 ! colspan="2" | '''Entities / Entités "A"'''
 |-
 | colspan="2" | ''Other Entities, to be defined later / Entités supplémentaires, à définir plus tard''
 |-
 | colspan="2" | ''<small>proposed by:/proposé par :<br />Frédéric URIEN et Eric Madelaine<br />[updated July, 12th 2020 / M.àj. 12 juillet 2020]''</small> 
 |-
 |}

{| class="wikitable alternance left" width="100%"
 
|-
 ! scope="col" | "''[[Surface phenomenon - Phénomène de surface|Surface phenomenon]]''"
 ! scope="col" | "''[[Surface phenomenon - Phénomène de surface|Phénomène de surface]]''"
 |-
 | valign="top" width="50%"| "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

 | valign="top" width="50%"| "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

|-
|-
 ! scope="col" | "''[[Organization - Organisation|Organization]]''"
 ! scope="col" | "''[[Organization - Organisation|Organisation]]''"

|-
 |  valign="top" width="50%"| "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

 |  valign="top" width="50%"| "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

|-
 ! scope="col" | "''[[Physical measurement - Mesure physique|Physical measurement]]''"
 ! scope="col" | "''[[Physical measurement - Mesure physique|Mesure physique]]''"
 |-
 | valign="top" width="50%"| "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

 | valign="top" width="50%"| "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
|-
 ! scope="col" | "''[[Hydrogical observations - Observations hydrologiques|Hydrological observation]]''"
 ! scope="col" | "''[[Hydrogical observations - Observations hydrologiques|Observation hydrologique]]''"
 |-
 | valign="top" width="50%"| "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

 | valign="top" width="50%"| "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

 |-
 ! scope="col" | "''[[Archaeological observations - Observations archéologiques|Archaeological observation]]''"
 ! scope="col" | "''[[Archaeological observations - Observations archéologiques|Observation archéologique]]''"
 |-
 | valign="top" width="50%"| "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

 | valign="top" width="50%"| "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

 |-
 |-
 ! scope="col" | "''[[Paleontological observation - Observations paléontologiques|Paleontological observation]]''"
 ! scope="col" | "''[[Paleontological observation - Observations paléontologiques|Observation paléontologique]]''"
 |-
 | valign="top" width="50%"| "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

 |valign="top" width="50%"| "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

 |-
 |}

== Proposal/Proposition B ==

 {| class="wikitable center" width="80%"
 |-
 ! colspan="2" | '''Entities/Entités "B"'''
 |-
 | colspan="2" | ''<small>proposed by:/proposé par :<br />Bernard THOMACHOT alias BTH<br />[May 8th, 2020 / 8 mai 2020]''</small> 
 |}

 {| class="wikitable alternance left"
 |-
 ! scope="col" | ''[[Underground cavity - Cavité|(Underground) "Void"]]''
 ! scope="col" | ''[[Underground cavity - Cavité|"Vide" (souterrain)]]''
 |-
 | valign="top" width="50%" | (Underground) "Void" is a class of entity. 

In this alternate proposal "B", English word "Void" is preferred to "Cavity", because "cavity" generally refers to a biological void (sinus, abdomen, tooth disease,...). 


For instance, "[https://en.wikipedia.org/wiki/Cave natural void in the ground]" is the consensual expression chosen in the Wikipedia free encyclopedia.


In addition, "Void", as well as "Vide" in French, gives a more general idea of what this class of entity could represent : a cave, a room, a fault, a fissure, a diaclasis, a shaft, a gallery, a subterranean system,..).

 | valign="top" width="50%"| Un "vide" (souterrain) est une entité. 

Dans cette proposition alternative "B", le terme anglais "Void" (vide, lacune, ) est préféré au terme "Cavity" qui désigne plus fréquemment une cavité biologique (sinus, cavité abdominale, carie dentaire,...).

Par exemple, l'expression "[https://en.wikipedia.org/wiki/Cave natural void in the ground]" est celle retenue dans l'encyclopédie collaborative en anglais Wikipedia.

De plus, "Void", à l'instar de "Vide" en français, donne une idée plus globale de ce que cet objet peut représenter : une cavité pénétrable, une salle, une fissure, une faille, une diaclase, un puits, une galerie, un système souterrain,..).

 |-
 ! scope="col" | ''[...]''
 ! scope="col" | ''[...]''
 |-
 | valign="top" width="50%" |

For all other terms defining entities of this ontology, proposal B remains identical to [[#Proposal/Proposition A|proposal A]].

 | valign="top" width="50%"|
Pour tous les autres termes définissant des entités de cette ontologie, la proposition B reste identique à la [[#Proposal/Proposition A|proposition A]].

 |-
 |}

== Proposal/Proposition C ==

 {| class="wikitable center" width="80%"
 |-
 ! colspan="2" | '''Entities/Entités C'''
 |-
 |}

 {| class="wikitable alternance left" width=100%
 |-
 ! scope="col" | ''?''
 ! scope="col" | ''?''
 |-
 | valign="top" width="50%" | None, so far
 | valign="top" width="50%" | Rien pour l'instant
 |-
 |}