.. _group__a3d__31__topology:

################
Topology (B-Rep)
################

B-Rep topology.

This module defines the topological entities: a body is an exact 3D geometric representation of a solid, surfacic, or wireframe model, contained in a representation item entity. For solids, a connex represents a continuous piece of material; a hollow sphere, for instance, is represented by two shells (one inner and one outer). Every shell is represented by a collection of faces sewn together; each face holds an associated geometric surface and may be trimmed by one outer loop and multiple inner loops. Currently, HOOPS Exchange does not allow a face to have multiple outer loops. Instead, you can make several faces, each containing a single outer loop. A loop is a collection of oriented and ordered co-edges, containing space parametric curves (if any), and neighboring information; each co-edge holds an edge, which in turn holds 3D information such as 3D curves and vertices. The current API handles only manifold solids, which have single neighbors per co-edge.


   An :c:type:`~A3DTopoContext` defines a global tolerance for every topological entity in this context. This global tolerance can then be superseded by less strict local tolerances for particular entities such as edges.



Tolerance
=========

In general, if the local tolerance is lower than the tolerance specified in the associated :c:type:`~A3DTopoContext` entity, you must use the tolerance from the :c:type:`~A3DTopoContext` entity.


.. rst-class:: kind-group kind-topic

.. rubric:: Topics
   :class: kind-group-title


.. rst-class:: api-xref-list


* :ref:`BrepData <group__a3d__brepdata>`
* :ref:`CoEdge <group__a3d__coedge>`
* :ref:`Connex <group__a3d__connex>`
* :ref:`Edge <group__a3d__edge>`
* :ref:`Face <group__a3d__face>`
* :ref:`Loop <group__a3d__loop>`
* :ref:`Shell <group__a3d__shell>`
* :ref:`SingleWireBody <group__a3d__singlewirebody>`
* :ref:`Topology Body (the topology base entity) <group__a3d__topobody>`
* :ref:`Topology Body Data <group__a3d__topobodydata>`
* :ref:`Topology Context <group__a3d__topocontext>`
* :ref:`Topology Context Data <group__a3d__topocontextdata>`
* :ref:`Vertex defined with a single position <group__a3d__unique__vertex>`
* :ref:`Vertex defined with multiple positions <group__a3d__multiple__vertex>`
* :ref:`WireEdge <group__a3d__wireedge>`

.. toctree::
   :maxdepth: 1
   :hidden:

   a3d_topobody
   a3d_topobodydata
   a3d_topocontextdata
   a3d_topocontext
   a3d_singlewirebody
   a3d_brepdata
   a3d_connex
   a3d_shell
   a3d_face
   a3d_loop
   a3d_coedge
   a3d_edge
   a3d_wireedge
   a3d_unique_vertex
   a3d_multiple_vertex


