Skip to content

BH.oM.Geometry.CoordinateSystem.Cartesian

A three-dimensional Cartesian coordinate system, as defined by a set of mutually orthogonal unit vectors and a common origin point

Class structure

Implemented interfaces and base types

The Cartesian is inheriting from the following base type(s) and implements the following interfaces:

Properties

Defining properties

The following properties are defined on the class

Name Type Description Quantity
X Vector Unit vector defining local x coordinate axis -
Y Vector Unit vector defining local y coordinate axis -
Z Vector Unit vector defining local z coordinate axis -
Origin Point Location point in three-dimensional space defining (0,0,0) and the origin for each axis -

Derived properties

The following properties are defined as extension methods in one of the BHoM_Engines

Name Type Description Quantity Engine
Bounds BoundingBox Returns the global world axis oriented BoundingBox of the Cartesian coordinate system. If the coordinate system is parallel to any of the world axis, the returned BoundingBox will be an infinite flat box in the plane. If not, the rturned box will be infinite box in all coordinate directions. - Geometry_Engine
GeometryHash string Returns a signature of the input geometry, useful for diffing.
The hash is computed as a serialised array representing the coordinate of significant points taken on the geometry.
The number of points is reduced to the minimum essential to determine uniquely any geometry.
Additionally, the resulting points are transformed based on the source geometry type, to remove or minimize collisions.
(Any transformation so performed is translational only, in order to support geometrical tolerance, i.e. numerical distance, when comparing GeometryHashes downstream).		 - Geometry_Engine
IArea double Calculates the area of the provided geometry. Area [m²] Geometry_Engine
IBounds BoundingBox Returns the global world axis oriented enclosing BoundingBox for all points of the geometry, i.e. the box with the smallest volume within which all the points on the geometry lie. - Geometry_Engine
IHashArray double[] Returns a signature of the input geometry, useful for distance-based comparisons and diffing.
The hash is computed as an array representing the coordinate of significant points taken on the geometry.
The number of points is reduced to the minimum essential to determine uniquely any geometry.
Additionally, the resulting points are transformed based on the source geometry type, to remove or minimize collisions.
(Any transformation so performed is translational only, in order to support geometrical tolerance, i.e. numerical distance, when comparing GeometryHashes downstream).		 - Geometry_Engine
IIsPlanar bool Checks if the IGeometry is planar, i.e. all of its parts fit in a single plane. - Geometry_Engine
IIsValid bool - - Geometry_Engine
INormals List<Vector> Interface method that returns the list of vectors normal to any IGeometry. - Geometry_Engine
IsNull bool Checks if a Geometry is null and outputs relevant error message. - Geometry_Engine
ISubParts IEnumerable<IGeometry> - - Geometry_Engine
IsValid bool - - Geometry_Engine

Code and Schema

C# implementation

C#
public class Cartesian : BH.oM.Geometry.IGeometry, BH.oM.Base.IObject, BH.oM.Base.IImmutable

Assembly: Geometry_oM.dll

The C# class definition is available on github:

All history and changes of the class can be found by inspection the history.

JSON Schema implementation

The object is defined as a JSON schema. You can validate a JSON instance against this schema by reference. To do this, use the schema reference below in a validator like this one.

JSON Schema
{
 "$ref" : "https://raw.githubusercontent.com/BHoM/BHoM_JSONSchema/develop/Geometry_oM/CoordinateSystem/Cartesian.json"
}

The JSON Schema is available on github here:

Example JSON instance

Example JSON instance of type Cartesian.

Example JSON
{
  "_t": "BH.oM.Geometry.CoordinateSystem.Cartesian",
  "X": {
    "_t": "BH.oM.Geometry.Vector",
    "X": 1.0,
    "Y": 0.0,
    "Z": 0.0
  },
  "Y": {
    "_t": "BH.oM.Geometry.Vector",
    "X": 0.0,
    "Y": 1.0,
    "Z": 0.0
  },
  "Z": {
    "_t": "BH.oM.Geometry.Vector",
    "X": 0.0,
    "Y": 0.0,
    "Z": 1.0
  },
  "Origin": {
    "_t": "BH.oM.Geometry.Point",
    "X": 0.0,
    "Y": 0.0,
    "Z": 0.0
  },
  "_bhomVersion": "8.2"
}