Document Objects
A "Document" Object is a type of object that generates a printable report that includes information about the project.
Parameters of Document Object:
Label | Mandatory | Description | Example | |
---|---|---|---|---|
1 | Title | Yes | Title of the Document / Project. | Title="Column" Title="Project Report" |
The sub-components of the Document object will be displayed.
1)DocSection Object:
It breaks down the document into different sections, and also includes a sidebar that provides links to other sections within the document for easier navigation.
Example:
...
...
<O T="Document" Title="Document Example">
<O T="DocSection" Title="Introduction ">
<O T="DocText">
Width |width|, height |height| This is an example of a text description for an object created using a ParamML parametric language
</O>
</O>
<O T="DocSection" Title="3D Model ">
<O T="DocText">
<![CDATA[
--md
In this section of the document, a visual representation of the 3D object will be provided.
]]>
</O>
<O T="Doc3D" Width="600" Height="300">
<P N="Obj3D" V="Vol" />
</O>
</O>
...
... |
Documentation Object |
Parameters of DocSection Object:
Label | Mandatory | Description | Example | |
---|---|---|---|---|
1 | Title | Yes | Title of the specified Document Section. | Title="Graph" Title="3D Model" |
2)DocText Object:
The text contained within this object is displayed in the designated section as paragraphs.
To begin, the text should be typed in Markdown format (--md). All subsequent text should be aligned with --md.
Example:
...
...
<O T="DocSection" Title="3D Model ">
<O T="DocText">
<![CDATA[
--md
In this section of the document, a visual representation of the 3D object will be provided.
]]>
</O>
<O T="Doc3D" Width="600" Height="300">
<P N="Obj3D" V="Vol" />
</O>
</O>
...
... |
Document Object → Document Example |
Header Size: The size of the header is determined by the number of hash symbols (#) used. One hash symbol (#) is used for the largest heading, while six hash symbols (######) are used for the smallest heading. The more hash symbols used, the smaller the header size will be.
Heading Size: The size of the heading is determined by the use of equal signs (=) and hyphens (-). Equal signs result in larger text compared to hyphens. To create a heading, place either a hyphen or an equal sign beneath the text.
Printing with a Different Color (Emphasis): Text enclosed within grave accents (
) will be highlighted in a different color.
Font Style (Italic): Text enclosed within asterisks (* *) will be displayed in italic style.
Font Style (Bold): Text enclosed within two asterisks (** **) will be displayed in bold.
Table: Table headings are enclosed within vertical slashes ( | | ). The position of the columns in the table is determined by the use of colons ( : ) placed between the vertical slashes. If two dots are placed next to the left vertical slash, the text in that column will be aligned to the left. The opposite is true for alignment to the right. If two dots are placed next to both the left and right vertical slashes, the text will be centered within the column. The text within the vertical slashes will be displayed in the table in the same order.
Reading a Value from a Parameter: When a value is enclosed within vertical slashes ( |d| ) in the code, it is treated as a parameter.
Striking Text: Text enclosed within two tildes (~~ ~~) will be crossed out.
Creating a CheckBox: A checkbox can be created by leaving a space after one hyphen, followed by square brackets with spaces inside. If there is a space within the brackets, the checkbox will be unselected. If an "x" is used instead of a space, the checkbox will be selected.
Creating a Code Block: Text enclosed within three grave accents (
) will be displayed as a code block.
Creating Emoji: Emojis can be created by enclosing the emoji name within two colons (:smile:).
Creating an Image: An image can be created by typing "![Logo]", followed by the image link within parentheses and the hover text within double quotation marks (" ") after the link.
Example:
<O N="DocumentObject2" T="Project" Category="Document Object" TransAlignRule="Right">
<!-- created by ParamML Examples on 10.02.2023 -->
<P N="d" V="15.21" />
<O N="Doc 1" T="Document">
<O T="DocText">
<![CDATA[
--md
# OpenBrIM Markdown
OpenBrIM `DocText` object supports GitHub compatible markdown content which can be directly rendered inside documents and design reports.
Markdown content must start following `--md` keyword. The markdown content must follow the same indentation as this keyword.
Here are some of the things that are supported:
## The second largest heading
This is an H1
=============
This is an H2
-------------
*This text will be italic*
**This text will be bold**
###### Material Type Lists:
1. Steel
2. Concrete
3. Wooden
### Tables:
| Column Type | Location | Material |
|: ------------- |:-------------:| -----:|
| **Column 1** | 1stFloor | Steel |
| Column 2 is | *2ndFloor* | Concrete |
| Column 3 |d| s | ~~3rd Floor~~ | Wooden |
|d| "d" Parameters Shown |d|
## Task Lists
- [x] checked list item
- [ ] unchecked list item
## Code Blocks
```
Steel = ASTM A615 Grade 60 Rebar
Concrete strength = C30
Wooden --> oak tree bending σ=75 kg/cm'2
```
## Emoji
this is a :smile: smile emoji
## Images

]]>
</O>
</O>
</O> |
To view this example in the library, see (OpenBrIM Platform) |
3)Doc3D Object
This object enables you to showcase the 3D model of the project within the document.
Parameters of Doc3D Object:
Label | Mandatory | Description | Example | |
---|---|---|---|---|
1 | Width | Yes | Width of the display in pixel. | Width="600" |
2 | Height | Yes | Height of the display in pixel. | Height="400" |
Label | Mandatory | Name Attribute | Value Attribute | Type Attribute | |
---|---|---|---|---|---|
1 | Obj3D | Yes | N="Obj3D" | Name of 3D object or group. Example: V="Pier" | Type of 3D object (Surface, Circle, Volume, Line) or group. Example: T="Volume"; T="Group" |
4)DocCADD Object:
With this object, 2D drawings of the project or the desired object can be displayed in the document.
Example:
|
|
Parameters of DocCADD Object:
Label | Mandatory | Description | Example | |
---|---|---|---|---|
1 | Width | Yes | Width of the display in pixel. | Width="600" |
2 | Height | Yes | Height of the display in pixel. | Height="400" |
Label | Mandatory | Name Attribute | Value Attribute | Type Attribute | |
---|---|---|---|---|---|
1 | CADD | Yes | N="CADD" | Name of CADD objects or CADDFrom3D object . Example: V="Elevation" | T="CADD" |
5)DocCode Object:
This object serves to display the ParamML code in the document.
Example:
6)DocGraph Object:
Using this object, linear graphics can be displayed in the document.
Example:
|
|
|
|
|
|
To view this example in the library, see (OpenBrIM Platform) |
Parameters of DocGraph Object:
Label | Mandatory | Description | Example | |
---|---|---|---|---|
1 | Title | Yes | Title indicated inside the graph. | Title="Graph 1" |
2 | Width | Yes | Width of the display in pixel. | Width="600" |
3 | Height | Yes | Height of the display in pixel. | Height="400" |
4 | AxisLabelX | Yes | Variable name along X-axis. | AxisLabelX="Width" |
5 | AxisLabelY | Yes | Variable name along Y-axis. | AxisLabelY="Height" |
6 | DataList | Yes | Data plotted along X-axis and Y-axis. V="[X value, Y value]" | DataList="[0,0],[8,16],[12,28] " |
7)DocTable Object:
With this object, a table can be prepared and displayed in the document.
Example:
Example:
To view this example in the library, see (OpenBrIM Platform) |
8)DocSectionAnalysis:
With this object, section analysis and calculations, such as rebar stress, flexural capacity, and interaction diagrams, can be displayed in the document. The values that affect the results can be overridden in the document, and changes in the results along the section can be reviewed instantaneously.
Example :