Architecture Terminology Glossary

Usage Guidelines

Reference lists should contain information to be deployed in data systems. They should also contain information that helps users understand the data in ways that prevent incorrect usage and resulting data attenuation.
Trade names
Trade or proprietary names should not be included in reference lists.
Definitions should be complete enough to support user's understanding of each list and each value. They should be written with the assumption that the user does not fully understand the subject area. Where extended explanations are available links to relevant sites may be included.
Where information is taken verbatim from other sources, the other source must be attributed.
IP Rights
List sources must be clearly identified and copyright laws followed. Where rights to use are not clearly shown on a website, it may be necessary to obtain consent in writing. This consent must be provided to Amanda Phillips as a legal document. Where sites are used as a reference, but material is not replicated (in accordance with copyright law), the source may be included as an additional reference.
It is not mandatory for every list to use one or more of the terms accepted for use. However, use of the "rejected" terms should be avoided in favor of terms that are approved.

Architecture Terminology Glossary Guideline

Approved Terms
Causes reflect why a particular event occurred or something happened and are captured after the event. WHY it happened (usually unplanned)
Class is an abstraction of a set of similar elements and is based on specific and defined criteria. A class may be a characterization class, associated with properties. Classes are primarily defined to support user understanding of the concepts embedded in complex or hierarchical reference lists.

Classes may be further divided into Subclasses as necessary to ensure that concepts are laid out as clearly as necessary.

Classes and subclasses may be embedded into reference lists to help users understand how reference values fit into the business world. These do not need to be created as separate reference lists unless doing so it considered to be helpful and supportive of interoperability.
A grouping mechanism
Component is a constituent, defined, part of a system or complex object. The PPDM What is a Well standard decomposed well configurations into its constituent components All of the components should be part of the same object. In some cases, a component may be comprised of other components. In taxonomies, this is a decompositional hierarchy (parts of cars).
Condition (Legal) Condition(Legal) A Condition (Legal) is a premise upon which the fulfillment of an agreement depends (stipulation); a provision making the effect of a legal instrument contingent upon an uncertain event; something essential to the appearance or occurrence of something else; a restricting or modifying factor (qualification). A condition laid out in a contract or agreement
Condition (Physical) Condition(Physical) A Condition (Physical) indicates the state of something with regard to its appearance, quality, or working order. It is used in the context of a document or other media or any physical asset. State of an asset of physical thing
Each criterion in a list of criteria is a specific trait or characteristic on which an identifier, judgment, interpretation or decision is based.

Dimensions describe the number and kind of spatial and temporal properties. A 2D object is linear, 3D objects are polygonal, 4D objects include time. 2D, 3D, 4D, 5D …
Format is used to describe how data is organized in digital form. Many formats are defined by standards organizations. Understanding the format helps the user manage and deploy data appropriately. Organization of data
Level (Hierarchy) Level(Hierarchy) Level (hierarchy) indicates the position of an object within a defined hierarchy. In a hierarchy, multiple entries may exist at the same level of a hierarchy.

Location describes the point or area occupied by an entity. Can be a descriptive name or term that may or may not be associated with geographic coordinates.

Measurement Class MeasurementClass A Measurement Class is a list of the units of measure that are appropriate to use when measuring a particular property.
This is particularly useful when a property can be measured in more than one way. For example, when measuring the property “drilling fluid viscosity”, measurements can be made using the time required to empty a vessel or with traditional viscosity units (e.g. Centipoise). Measurements that are made in time are represented in a data system using the Time Quantity Class; the Measurement Class clarifies that within the Time Quantify Class, only seconds are appropriate (not years or months). All Measurement Classes are subsets of units of measure that are specifically appropriate to a particular property.
Methods are systematic procedures followed for deriving a specific kind of outcome. For example, methods used by laboratories are specific to obtaining TOC data. Procedure, technique
Position (Order) Position(Order) Position indicates the rank, sequence or order of an entity relative to other entities.

A Property is an essential or distinctive characteristic of an entity that can be quantified (measured) or identified (named). These values describe what is being measured. Atmospheric pressure is a property that is measured as part of weather forecasting. These pressures may be captured using more than one quantity class. They can be measured in length units (mm of Mercury) or in pressure units (PSI or bar) or in kilopascals (kPa). Similarly, the property drilling fluid viscosity may be measured using the quantity classes time or centipoise. If the property is quantifiable, the definition of the property should not include how it is to be quantified. For example, length may seem like an obvious abstract parent property, but a better choice might be linear distance (between two points) or something equivalent. The method used to measure a distance may vary depending on the magnitude of the distance. Linear distance is most commonly expressed in traditional units of length (feet, meter, etc.), but may also be measured in units of time, as in the amount of time required for light to travel between two points. The Depth (a child of linear distance) of a well may be expressed as 10,000 feet, or as 10.1647 light-micro-seconds. Both are accurate, but one is generally preferred over the other. The choice is not so obvious when quantifying a pressure (psi, bar, mm[Hg]), or a viscosity (poise, centipoise, seconds[marsh funnel]) because the conversion between units depends on more than just the units themselves.
Qualifiers are word groups that expand on, limit or clarify the meaning of another concept or piece of information. They may also be used to differentiate between meanings that may otherwise be semantically unclear. In the reference list architecture, some terms include qualifiers, shown in brackets. The purpose of the qualifier is to ensure that the meaning of a term is clearly stated.
Quantity Class QuantityClass Quantity Class: The kind of units, with the same dimension and same underlying measurement concept, that are used when measuring a property. The kind of units that are used when measuring a property, such as time, pressure or length. While two Quantity Classes may have the same underlying Unit Dimension, they may still represent distinct concepts that are not interconvertible. For example mass per mass and length per length have the same underlying Unit Dimension, but there is no conversion between them. The same is true for reciprocal length and area per volume because they represent distinctly different concepts.
Reasons reflect why a procedure or activity will be done and are usually captured in advance of the event or activity. WHY I did it something
Reference (Context) Reference(Context) Reference (Context): A reference list containing terms that are used to provide context to other information in a data object. For examples, depth readings in a storage tank may be based on tank strapping markers installed on the side of the tank.

A result is the conclusion or end to which any course or condition of things leads, or which is obtained by any process or operation; consequence or effect. All outcomes are results, but not all results are outcomes.
A Role is a function assumed or assigned, or part played, by a person or thing in a particular situation.

A scheme is a named set of criteria that has been organized by an authoritative source, and which is used as a reference in analysis, interpretation or organization of data. A data schema is a kind of scheme.
A Set is a logical collection of things or concepts that are grouped for a described purpose. For each reference list, the purpose that binds them into a set should be described. A set of characteristics that describe roads. Components may comprise a set.
Source: something that refers a reader or consulter to the origin or provider of information. A source may be another organization, a procedure or software system, data store etc. Where I got this from
Status indicates a state of an entity with respect to circumstances or a particular perspective (such as from the perspective of finance, regulatory approvals, construction etc.). Each status typically has a starting and ending date which is dependent on an event, activity or condition.
Any entity may have more than one status at any given time. Both current and historical status information is often important. Ideally, each status value in a list should contain only one kind of information.
A step is a particular activity or event in an organized set of activities or events that are part of a workflow. Stage, Phase
Types are terms used to describe and characterizes a thing or concept. They do not describe methods, procedures or techniques (use METHOD). They may be considered nouns or adjectives. Kind, thing
Deprecated Terms
Category Class
Code Alias or alternate name Abbreviation or short version or numeric representation. Can be a term in an attribute name, but will not be part of the reference list name.
Where code is historically part of the common name, that name will be cited as an alias in the lists.
where code is historically part of the common name, that name will be cited as an alias in the lists.
Group Class
Kind Class
Outcome Result All outcomes are results, but not all results are outcomes.
System Class A regularly interacting or interdependent group of items forming a unified whole; a group of related natural objects or forces; group of devices or artificial objects or an organization forming a network…; an organized set of doctrines, ideas, or principles; a manner of classifying, symbolizing, or schematizing; harmonious arrangement or pattern (order).
Technique Method The manner in which technical details are treated (as by a writer) or basic physical movements are used (as by a dancer); a body of technical methods (as in a craft or in scientific research); a method of accomplishing a desired aim.
Value This is probably just a column or attribute name. Something determined by calculation or measurement results in a measured number.
The monetary worth of something; relative worth, utility, or importance; something (such as a principle or quality) intrinsically valuable or desirable; a numerical quantity that is assigned or is determined by calculation or measurement.
Stage A period or step in a process, activity, or development.
Process A series of actions or operations conducing to an end. A continuous operation or treatment especially in manufacture.

Special Character Recommendations

Character - Be mindful when using these on Reference List names and remarks. In some technical systems, special characters can present difficulties for implementations.