Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

Help us improve the Bimplus API doc by providing your valuable comments. You can find the comment section at the bottom of the page.

Team

...

A Team is a tenant/company which work on the building projects. The team has to be specified and setup through the

Newwindowlink
titlebimplus
urlhttp://www.bimplus.net/
portal as so called
Newwindowlink
titleslugs
urlhttp://en.wikipedia.org/wiki/Clean_URL#Slug/
to present a
Newwindowlink
titleclean URL
urlhttp://en.wikipedia.org/wiki/Clean_URL/
. The team slug will be used to know which tenant database to work on. Please see
Newwindowlink
titleuser administration service
url2.1.5.2 User Administration Service/
for more information.

Project

...

A Project is basically a holder which contains building models.

...

Model

...

A Model is basically a technical building 3D plan. 

Layer

...

A group of element types constitute a layer. They are predefined. Please see the detailed structure of the attachment in the Object Model.

...

Note

An ElementType cannot belong to two layers.

 

Object

...

Objects are the primary component of a project and it exists in two forms.

  • Node: Objects with no graphical representation
  • Geometry: Objects with graphical representation (See Geometry)

Please see the detailed structure of the issue in the Object Model

...

Note

A project is also basically an object.

Topology

...

Topology is a hierarchical tree representing all its child nodes. A topology tree consist of components which can have a graphical representation(objects or elements) or components which does not have a graphical representation(nodes). A topology tree can be obtained both on the project as well as on the object level.

  • Please use the Bimplus Project Service for obtaining/filtering the project topology tree. This will yield the topology nodes filtered till the sub-project level.
  • Please use the Bimplus Object Service for obtaining/filtering the object topology tree. This will yield the topology nodes with all the properties, attributes, geometry and children.

Anchor
geometry
geometry

Geometry

...

It represents the geometrical information(graphical representation) of a building. Please see the detailed structure of the issue in the Object Model

...

  • mesh: It is the default geometry type. It is an uncompressed mesh format where the geometry object will be compressed on the server before storing it into the database.

    Code Block
    borderColorGreen
    langxml
    titleExamplelangxml
    mesh: {
          colors: 4291993670,
          vertices: \[ 96.149, 179.546, ... \],
          faces: \[ 4,0,1,2,3, 3,4,5,6, ... \]
          }
    where,
    color:  array of decimal RGBA values;
    vertices: plain array of 3D vertices coordinates like [x0, y0, z0, x1, y1, z1, ...]
    faces: plain array of faces definitions like first number is quantity of vertices, than vertex indices list, see example.
    
  • meshblob: It is a compressed mesh format intended to be used in the desktop CAD applications. Internal CAD format of the geometry will be converted into a Bimplus compressed mesh format with the help of a DLL in order to minimize the JSON object.

    Code Block
    borderColorGreen
    langxml
    titleExamplelangxml
    meshblob: "d273f7a6a7d8f8725484fe6282..."
    
  • threejs: It is a format which is optimized for viewing on mobile devices or in browsers where the native model is filtered and tessellated in order to deliver minimal JSON size and maximal navigation speed (FPS). This model has

    Newwindowlink
    titleThreeJS JSON v 3.1
    urlhttps://github.com/mrdoob/three.js/wiki/JSON-Model-format-3.1
    format and can be directly parsed by the client.

    Code Block
    borderColorGreen
    langxml
    titleExamplelangxml
    threejs: {
             <ThreeJS_JSON_format>
             }
    

...

Note

Objects with geometry types "mesh" or "meshblob" can be written into the Bimplus database, whereas the "threejs" geometry type is optimized for viewing on mobile devices or in browsers and cannot be written into the database directly.

ElementType

...

Element type describes the type of predefined building elements required to build a building (eg: wall, window, door etc) Each element type have an unique id. Please see the detailed structure of the ElementType in the Object Model

...

Issue

...

Issues are problems or remarks which can be assigned to any project. Comments or attachments can be added to the issue. Please see the detailed structure of the issue in the Object Model

Pin

...

Pins are relation between an issue and an object. It defines position of an issue in the 3D space. Please see the detailed structure of the pin in the Object Model

Comment

...

Comments can be added to the issues using the Bimplus Comment Service

Attachments

...

Attachments are mostly documents or any media files with additional information which can be assigned to any project, object or issue. Please see the detailed structure of the attachment in the Object Model

...