+ The text is mainly written for researchers to guide them in adding a new term to PaNET.
+
+
+
+ Required Information
+
+
+
+ Decide what kind of term you want to add:
+
+ -
+ technique (class), defined by a probe and a process (e.g. x-ray diffraction)
+
+ -
+ specifier (class), a descriptor of a technique (e.g. diffraction, obtain spatial map, versus time, neutron). Currently, all specifier classes have a corresponding technique class, e.g. "diffraction" (PaNET01022) and "diffraction" (PaNET2020018); this might change soon. The former refers to the group of techniques that can be described by the process of diffraction, while the latter represents the process of diffraction itself. The technique class is linked to it specifier class via the object property, e.g. "definedbyprocess".
+
+ -
+ relationship (object property), describes the relation of two objects, e.g. defined by purpose. These terms should be well covered by PaNET, we do not expect frequent updates here.
+
+
+
+
+ Title
+
+
+ Create a meaningful title, e.g. "New term: X-ray Absorption Spectroscopy".
+
+
+ New term label
+
+
+ Assign a fitting name to the term. If multiple options are suitable, choose a full-text representation, you can designate abbreviations and additional names as synonyms later on.
+
+
+ Definition
+
+
+ Use a self-explanatory, short description. Please avoid explaining a term with itself.
+
+
+ Position in the ontology
+
+
+ The position in the ontology is described by the type of the relationship (axiom type) and a related term that already exists in the ontology.
+
+
+
+ Possible axiom types for techniques and specifiers
+
+ -
+ is equivalent to,
+
+ -
+ Term1 equals the logical conjunction of Term2 and Term3, Term1 = Term2 AND Term3, e.g. "x-ray spectroscopy" is equivalent to "x-ray probe" and "spectroscopy", because we can be sure that any technique that has "x-ray probe" and "spectroscopy" as superclasses cannot be disjoint from "x-ray spectroscopy".
+
+ -
+
+ For Maintainers: Technique1 = (ObjectProperty1 some Specifier1), e.g. "x-ray probe" (technique) is equivalent to "definedbyprobe" (object property) some "x-ray" (specifier).
+
+
+
+
+ -
+ is subclass of, e.g. "x-ray tomography" is subclass of "imaging" and "x-ray probe", but there are also other subclasses of "imaging" and "x-ray probe" like "x-ray microscopy".
+
+ -
+ is superclass of, inverse relation to "is subclass of".
+
+ -
+ disjoint with, Term1 and Term2 have no common elements, e.g. "elastic scattering" and "inelastic scattering".
+
+
+
+
+ Check if more general (parent class) or more specific (child class) techniques already exist, e.g. "diffraction" is a more general term for "powder diffraction". Add those with the strongest relations as super- and subclasses. Please give their PaNET IDs.
+
+
+
+ Check if the use specifiers is beneficial, e.g. "scanning probe" as an additional descriptor to "transmission x-ray microscopy". These terms are usually (direct) subclasses of
+
+ - defined by experimental probe (PaNET00002)
+ - defined by experimental physical process (PaNET00003)
+ - defined by functional dependence (PaNET00004)
+ - defined by purpose (PaNET00005)
+
+ Please give their PaNET IDs.
+
+
+
+
+ For Maintainers: Possible axiom types for relationships (object properties)
+
+ -
+ super property, e.g. "photon and neutron technique relationships" is a super property of "definedbyprocess".
+
+ -
+ domain/range. Used to indicate that the object property maps from a domain to a range, e.g. "definedbyprocess" maps from "photon and neutron technique" to "process"
+
+ -
+ characteristic
+
+ -
+ one or several of the following list: functional, inverse functional, transitive, symmetric, asymmetric, reflexive, irreflexive
+
+ -
+ e.g. "definedbyprocess" is asymmetric
+
+ -
+ More detailed information here.
+
+
+
+
+
+
+
+ What if a required specifier or superclass does not exist?
+
+
+ Please create a sub-issue to add the missing specifier or term, using the same template to make a "New term request".
+
+
+ Example:
+
+ -
+ New term is "x-ray absorption spectroscopy in transmission mode" and "x-ray absorption spectroscopy" exists in PaNET, but "transmission mode" (or something equivalent) does not.
+
+ -
+ Add "transmission mode (to be done)" iIn the hierarchy section.
+
+ -
+ After publishing this issue, you find a box in your post "Create sub-issue", use it to create a new term request on "transmission mode".
+
+
+
+
+ Synonyms
+
+
+ Synonyms can be abbreviations.
+
+
+ Cross-References
+
+
+ Add a cross-reference to a reliable (as persistent as possible) source, e.g. link to Wikidata.
+
+
+ Add DOIs of 1 or 2 peer-reviewed journal articles using the technique.
+
+
+ Motviation
+
+
+ Add a brief motivation on why this technique should be added, e.g. technique used at your facility, with a link to a website that proves this.
+
+
+
+
+
+