ifc_tabular/lib.rs
1//! Structured IFC value containers indexed by position or time.
2//!
3//! A table indexes values by row and column; a time series indexes them
4//! by time. Neither carries domain meaning of its own: both bottom out in
5//! lists of `IfcValue`, and both appear side by side in the schema's own
6//! `IfcMetricValueSelect` and `IfcObjectReferenceSelect`.
7//!
8//! # Cells are the caller's to type
9//!
10//! A cell is an `IfcValue`: a SELECT over measure types. `4.2` and
11//! `IFCLENGTHMEASURE(4.2)` are different files, and only the second can be
12//! converted or compared dimensionally. This crate never invents a measure;
13//! the caller passes a `Value` and chooses.
14//!
15//! # Derived attributes are not stored
16//!
17//! `IfcTable` DERIVEs three counts from its rows. They are derived under new
18//! names rather than redeclaring an inherited attribute, so they occupy no
19//! instance slot: nothing is written for them, not even `*`, and they are
20//! never computed into the file.
21//!
22//! # Reading back
23//!
24//! [`TabularView`] borrows a model and returns [`Table`] and
25//! [`TimeSeries`] views under a declared IFC4 or IFC4X3 schema. A read
26//! reports every malformed slot and WR1/WR2 violation as a
27//! [`TabularIssue`] rather than dropping it.
28
29mod error;
30mod read;
31mod series;
32mod table;
33
34pub use error::{TabularError, TabularReadError, TabularReadResult, TabularResult};
35pub use read::{SeriesValue, TabularIssue, TabularView, TimeSeries, TimeSeriesKind};
36pub use read::{Table, TableColumn, TableRow};
37pub use series::{add_irregular_time_series, add_regular_time_series, SeriesDraft};
38pub use series::{add_irregular_value, add_time_series_value};
39pub use table::{add_table, add_table_column, add_table_row, ColumnDraft};