# INFORTREAT BIM Toolkit

**Version 2.0 — February 2026**

A complete open-source toolkit for documenting and publishing 3D models of Early Modern fortifications from historical treatises, developed as part of the [INFORTREAT](https://www.infortreat.unipi.it) research project (PNRR, European Union – NextGenerationEU).

![INFORTREAT](https://www.infortreat.unipi.it)

---

## What is this toolkit?

This package provides everything needed to go from a **3D model of a historical fortification** to an **interactive BIM web viewer** with property data derived from historical treatises.

The workflow is:

```
3D Model (Rhino/Grasshopper/Blender)
        ↓  export as .gltf
Excel Metadata Sheet (object names + treatise properties)
        ↓  data enrichment tool
.ifc  +  .xkt  +  _metadata.json
        ↓  upload to WordPress
Interactive BIM Viewer on the web
```

---

## Package Contents

| Folder | Contents |
|--------|----------|
| `01_web_viewer/` | WordPress plugin for 3D BIM viewing |
| `02_data_enrichment/` | Python tools: GLTF + Excel → IFC → XKT + JSON |
| `03_sample_sardi/` | Complete sample: Pietro Sardi, *Corno Dogale*, 1638 |

---

## Key documents

- **[WORKFLOW_GUIDE.md](WORKFLOW_GUIDE.md)** — Full step-by-step pipeline (start here)
- **[HOW_TO_PARTICIPATE.md](HOW_TO_PARTICIPATE.md)** — How to contribute your own treatise model
- **[LICENSE](LICENSE)** — AGPLv3 open-source license

---

## License

This toolkit is licensed under the **GNU Affero General Public License v3.0 (AGPLv3)**.
This is required because the 3D viewer uses [xeokit-sdk](https://github.com/xeokit/xeokit-sdk), which is also AGPLv3 licensed.

---

## Funding Acknowledgment

Research Project financed by the **European Union – Next-GenerationEU** – **National Recovery and Resilience Plan (NRRP)** – **MISSION 4 COMPONENT 2, INVESTMENT N. 1.1, CALL PRIN 2022 D.D. 104 02-02-2022**.

**CUP:** I53D23005420006

---

## Contact

**Dipartimento di Ingegneria dell'Energia, dei Sistemi, del Territorio e delle Costruzioni**
Università di Pisa — Largo Lucio Lazzarino 1, 56122 Pisa, Italy

Email: [infortreat@ing.unipi.it](mailto:infortreat@ing.unipi.it)
Website: [infortreat.unipi.it](https://www.infortreat.unipi.it)
Direct contact: Piergiuseppe Rechichi (piergiuseppe.rechichi@phd.unipi.it)