# Bona coatings - BIM bundle

A one-time import that gives Revit (and any other BIM tool) the full structured
spec sheet for every current Bona timber-floor coating - VOC, solids, coverage,
coats, cure time, compliance, document URLs - as typed material properties.

After you import this once, every project in your office has the current Bona
data as material types, forever. Re-import after we regenerate the bundle and
your library refreshes in place.

## Files

| File                        | For                       | Purpose |
|-----------------------------|---------------------------|---------|
| `bona-coatings.ifc`         | Revit / ArchiCAD / Tekla | IFC 4x3 STEP file. Materials + `Pset_Bona_*` property sets. Import via Insert -> Link IFC or File -> Import -> IFC. |
| `bona-shared-parameters.txt`| Revit                    | Revit Shared Parameters file. Load via Manage -> Shared Parameters -> Browse, then add to your material family. GUIDs are stable across re-exports. |
| `bona-coatings-psets.json`  | scripts / Dynamo / other | Machine-readable JSON of every material + property set. Source of truth for the other two files. |

All property names follow the same convention across files: `ProductFamily`,
`VOC_gPerL`, `CoatsRequired_Min`, `CoatsRequired_Max`, `RecoatTime_h_Min`,
etc. Units are baked into the name so nothing is ambiguous.

## How to import into Revit

### Option 1 - IFC material import

1. Open your project (or an empty template).
2. `File` -> `Open` -> `IFC...` (or `Insert` -> `Link IFC` for a non-destructive link).
3. Pick `bona-coatings.ifc`.
4. Revit will create 18 materials, one per Bona product, each with
   seven `Pset_Bona_*` property sets attached.
5. In the Materials dialog you'll see every property under
   `Identity Data -> Other Properties`.

### Option 2 - Shared Parameters file

1. `Manage` tab -> `Shared Parameters` -> `Browse...` -> pick
   `bona-shared-parameters.txt`.
2. In your material family (or any category), `Manage` -> `Project
   Parameters` -> `Add` -> `Shared Parameter` -> pick the ones you want.
3. The GUIDs are stable (hashed from the parameter name), so re-loading this
   file after we re-export will update definitions without breaking existing
   data bound to those parameters.

## What's inside each Pset_Bona_*

| Pset                       | Notable fields |
|----------------------------|----------------|
| `Pset_Bona_Identity`       | ProductFamily, SystemRole, Chemistry, Components, Description |
| `Pset_Bona_Physical`       | VOC_gPerL, SolidsContent_pct, Density_gPerML, Viscosity, ShelfLife_months, GlossLevels, ColourOptions |
| `Pset_Bona_Application`    | CoatsRequired_Min/Max, CoverageMSquaredPerL_Min/Max, PotLife_h, RecoatTime_h_Min/Max, LightUse_h, FullUse_h, FullCure_days, Temperature_C_Min/Max, Humidity_RH_Min/Max, Applicators |
| `Pset_Bona_Performance`    | AbrasionTaber_mg, WearClass, SlipRRating, SlipPendulumValue, Slip_AS_NZS_4586, ScratchResistance, NonYellowing |
| `Pset_Bona_Compliance`     | VOCCompliance, SustainabilitySchemes, EPDRegistered, EPDID, EPDURL, FireRating_AS9239, HazardClassification |
| `Pset_Bona_Documents`      | TDSURL, SDSURL, SpecParagraphsURL, BrochureURL, EPDURL |
| `Pset_Bona_UseCases`       | Substrates, RoomTypes, CommercialGrade, SuitableForStairs, SuitableOutdoors, OvercoatableWith |

Every Pset carries a `data_source` value pointing at the PDF (TDS or brochure)
the numbers were lifted from, so specifiers can trace any figure back to an
authoritative source.

## Licensing

This bundle is released under **CC-BY-4.0**.

You may incorporate the data into projects, client decks, BIM models, and
specification documents. Redistribution (in any form - bundled in a Revit
template file, re-published on another website, etc.) requires attribution:

> Data sourced from floorsandingaustralia.com - the architect hub.

Questions, corrections, or spec-builder help: https://floorsandingaustralia.com/architects/