# Block Model (Raw Data)

A **Block Model** entity stores structured 3D block data—typically used in resource estimation, geological modeling, and spatial analysis. The model is uploaded as a **comma-separated ASCII text file**, where each row represents an individual block.

Import structured block models in CSV format. Each row represents a volumetric block with positional and attribute data.  
→ *Commonly used in mining and geological modeling.*

<div align="center" class="MsoNormal" id="bkmrk-" style="text-align: center;">---

</div>**Uploading a Block Model**

1. Navigate to your project’s **Catalog** section and click **“Add Object.”**
2. From the dropdown, select **“Block Model.”**

[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/MFGimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/MFGimage.png)

3\. Fill out the following fields:

<table border="0" cellpadding="0" class="MsoNormalTable" id="bkmrk-field-description-%C2%A0-" style="mso-cellspacing: 1.5pt; mso-yfti-tbllook: 1184;"><thead><tr style="mso-yfti-irow: 0; mso-yfti-firstrow: yes;"><td style="padding: .75pt .75pt .75pt .75pt;">**Field**

</td><td style="padding: .75pt .75pt .75pt .75pt;">**Description**

</td></tr></thead><tbody><tr style="mso-yfti-irow: 1;"><td style="padding: .75pt .75pt .75pt .75pt;">**Item Name**

</td><td style="padding: .75pt .75pt .75pt .75pt;">A descriptive name for the new block model entity.

</td></tr><tr style="mso-yfti-irow: 2;"><td style="padding: .75pt .75pt .75pt .75pt;">**Capture Date**

</td><td style="padding: .75pt .75pt .75pt .75pt;">*(Optional)* The original date the model data was captured.

</td></tr><tr style="mso-yfti-irow: 3;"><td style="padding: .75pt .75pt .75pt .75pt;">**CSV Header**

</td><td style="padding: .75pt .75pt .75pt .75pt;">A comma-separated line of headers that define how each column in the block model should be interpreted. (Details below.)

</td></tr><tr style="mso-yfti-irow: 4;"><td style="padding: .75pt .75pt .75pt .75pt;">**Horizontal Datum**

</td><td style="padding: .75pt .75pt .75pt .75pt;">The horizontal reference system used in the model.

</td></tr><tr style="mso-yfti-irow: 5;"><td style="padding: .75pt .75pt .75pt .75pt;">**Vertical Datum**

</td><td style="padding: .75pt .75pt .75pt .75pt;">The vertical reference system used for elevation values.

</td></tr><tr style="mso-yfti-irow: 6;"><td style="padding: .75pt .75pt .75pt .75pt;">**Projection**

</td><td style="padding: .75pt .75pt .75pt .75pt;">The map projection used in the dataset.

</td></tr><tr style="mso-yfti-irow: 7;"><td style="padding: .75pt .75pt .75pt .75pt;">**Horizontal Units**

</td><td style="padding: .75pt .75pt .75pt .75pt;">Units for X and Y coordinates (e.g., meters, feet).

</td></tr><tr style="mso-yfti-irow: 8; mso-yfti-lastrow: yes;"><td style="padding: .75pt .75pt .75pt .75pt;">**Vertical Units**

</td><td style="padding: .75pt .75pt .75pt .75pt;">Units for Z coordinates (e.g., meters, feet).

</td></tr></tbody></table>

**CSV Header**

The **CSV Header** field defines how each column in your file should be interpreted. For example, a header line like:  
XC,YC,ZC,XL,YL,ZL,AU,CU  
…will produce a list of **Column Definitions** for each value, allowing you to specify their role in the model.

<table border="1" id="bkmrk--2" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/WvSimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/WvSimage.png)

</td><td>[![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/fkFimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/fkFimage.png)

</td></tr></tbody></table>

**Column Types**

Each column must be assigned a **Type**, which tells the system how to process it:

<table border="0" cellpadding="0" class="MsoNormalTable" id="bkmrk-type-purpose-%C2%A0-ignor" style="width: 68.6905%; height: 252px;"><thead><tr style="height: 36.5938px;"><td style="padding: 0.75pt; width: 28.3122%; height: 36.5938px;">**Type**

</td><td style="padding: 0.75pt; width: 71.6878%; height: 36.5938px;">**Purpose**

</td></tr></thead><tbody><tr style="height: 36.5938px;"><td style="padding: 0.75pt; width: 28.3122%; height: 36.5938px;">**Ignore**

</td><td style="padding: 0.75pt; width: 71.6878%; height: 36.5938px;">Exclude this column from processing.

</td></tr><tr style="height: 36.5938px;"><td style="padding: 0.75pt; width: 28.3122%; height: 36.5938px;">**Set**

</td><td style="padding: 0.75pt; width: 71.6878%; height: 36.5938px;">The column contains a small set of repeating categorical values.

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 28.3122%; height: 19.7969px;">**Value**

</td><td style="padding: 0.75pt; width: 71.6878%; height: 19.7969px;">Numeric values (e.g., grades, densities).

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 28.3122%; height: 19.7969px;">**<span lang="FR-CA" style="mso-ansi-language: FR-CA;">Block Centroid X/Y/Z</span>**

</td><td style="padding: 0.75pt; width: 71.6878%; height: 19.7969px;">Coordinates for the block’s center point.

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 28.3122%; height: 19.7969px;">**Block Origin X/Y/Z**

</td><td style="padding: 0.75pt; width: 71.6878%; height: 19.7969px;">Coordinates for the block’s origin corner.

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 28.3122%; height: 19.7969px;">**<span lang="FR-CA" style="mso-ansi-language: FR-CA;">Block Dimension X/Y/Z</span>**

</td><td style="padding: 0.75pt; width: 71.6878%; height: 19.7969px;">Size of the block along each axis.

</td></tr></tbody></table>

**Note:** You must choose **either** block centroids **or** block origins for positioning—not both. Using both will result in an input error.

**Level of Detail (LOD) Aggregation**

Each numeric column (e.g., grades or quantities) can also be configured with a **Level of Detail (LOD) operation**, which determines how values are aggregated in lower-resolution views:

<table border="0" cellpadding="0" class="MsoNormalTable" id="bkmrk-lod-option-descripti" style="width: 49.4048%; height: 118.781px;"><thead><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 24.6914%; height: 19.7969px;">**LOD Option**

</td><td style="padding: 0.75pt; width: 75.3086%; height: 19.7969px;">**Description**

</td></tr></thead><tbody><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 24.6914%; height: 19.7969px;">**Average**

</td><td style="padding: 0.75pt; width: 75.3086%; height: 19.7969px;">Average of all higher-resolution values.

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 24.6914%; height: 19.7969px;">**Min**

</td><td style="padding: 0.75pt; width: 75.3086%; height: 19.7969px;">Minimum value from the finer data.

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 24.6914%; height: 19.7969px;">**Max**

</td><td style="padding: 0.75pt; width: 75.3086%; height: 19.7969px;">Maximum value from the finer data.

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 24.6914%; height: 19.7969px;">**Add**

</td><td style="padding: 0.75pt; width: 75.3086%; height: 19.7969px;">Sum of all values (ideal for counters).

</td></tr><tr style="height: 19.7969px;"><td style="padding: 0.75pt; width: 24.6914%; height: 19.7969px;">**Multiply**

</td><td style="padding: 0.75pt; width: 75.3086%; height: 19.7969px;">Product of all values.

</td></tr></tbody></table>

**Uploading the File**

- Click **“Choose File”** to upload your block model file (CSV or TXT format).
- You may also upload a **ZIP archive** that contains your ASCII file.

<div align="center" class="MsoNormal" id="bkmrk--3" style="text-align: center;">---

</div>Click **“Create”** to start the upload process. You can monitor the progress in the project’s **“Pending”** section.