views-frames 1.10.1__tar.gz → 1.10.2__tar.gz

{views_frames-1.10.1 → views_frames-1.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: views-frames
-Version: 1.10.1
+Version: 1.10.2
 Summary: The VIEWS platform data-contract layer: immutable array+identifier frames (numpy only, root of the dependency DAG).
 Project-URL: Homepage, https://github.com/views-platform/views-frames
 Project-URL: Repository, https://github.com/views-platform/views-frames
@@ -36,7 +36,7 @@ Description-Content-Type: text/markdown
 > containers (`FeatureFrame`, `PredictionFrame`, and their anticipated siblings)
 > that every other repo depends on and that depends on nothing internal.
 >
-> **Status:** **v1.10.0 — frozen API, published to PyPI** (frozen since v1.0.0, ADR-018; the
+> **Status:** **v1.10.2 — frozen API, published to PyPI** (frozen since v1.0.0, ADR-018; the
 > v1.1 surface is
 > purely additive — the coherent posterior summary, ADR-019; v1.2.0 rebuilt the tower
 > `outside-in`, C-44; v1.3.0 makes the tower summary distribution-agnostic — no magnitude
@@ -53,7 +53,7 @@ Description-Content-Type: text/markdown
 > `research/figures/` tower-figure toolkit; v1.10.0 adds the **dense-grid fill**
 > primitive — `reindex_fill(other, *, fill_value)` on all three frames +
 > `SpatioTemporalIndex.cartesian` + the published `assert_reindex_fill_law`, ADR-026,
-> unblocking pandas-free FAO ingestion). This
+> unblocking pandas-free FAO ingestion; v1.10.1 makes `io.arrow.load` fail loudly on a parquet whose row order breaks the wire contract, #199; v1.10.2 changes no behaviour — it arms the documentation check in CI, turns eleven falsification tests from README-wording checks into behaviour checks, and records ADR-027 declining the construction shortcut). This
 > README is the design
 > bible; the contract it specifies is realised in `src/views_frames/` (index, frames,
 > io, conformance suite) plus the `src/views_frames_summarize/` sibling package

{views_frames-1.10.1 → views_frames-1.10.2}/README.md

@@ -4,7 +4,7 @@
 > containers (`FeatureFrame`, `PredictionFrame`, and their anticipated siblings)
 > that every other repo depends on and that depends on nothing internal.
 >
-> **Status:** **v1.10.0 — frozen API, published to PyPI** (frozen since v1.0.0, ADR-018; the
+> **Status:** **v1.10.2 — frozen API, published to PyPI** (frozen since v1.0.0, ADR-018; the
 > v1.1 surface is
 > purely additive — the coherent posterior summary, ADR-019; v1.2.0 rebuilt the tower
 > `outside-in`, C-44; v1.3.0 makes the tower summary distribution-agnostic — no magnitude
@@ -21,7 +21,7 @@
 > `research/figures/` tower-figure toolkit; v1.10.0 adds the **dense-grid fill**
 > primitive — `reindex_fill(other, *, fill_value)` on all three frames +
 > `SpatioTemporalIndex.cartesian` + the published `assert_reindex_fill_law`, ADR-026,
-> unblocking pandas-free FAO ingestion). This
+> unblocking pandas-free FAO ingestion; v1.10.1 makes `io.arrow.load` fail loudly on a parquet whose row order breaks the wire contract, #199; v1.10.2 changes no behaviour — it arms the documentation check in CI, turns eleven falsification tests from README-wording checks into behaviour checks, and records ADR-027 declining the construction shortcut). This
 > README is the design
 > bible; the contract it specifies is realised in `src/views_frames/` (index, frames,
 > io, conformance suite) plus the `src/views_frames_summarize/` sibling package

{views_frames-1.10.1 → views_frames-1.10.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "views-frames"
-version = "1.10.1"
+version = "1.10.2"
 description = "The VIEWS platform data-contract layer: immutable array+identifier frames (numpy only, root of the dependency DAG)."
 authors = [
     { name = "Simon Polichinel von der Maase", email = "simmaa@prio.org" },

{views_frames-1.10.1 → views_frames-1.10.2}/src/views_frames/feature_frame.py

@@ -1,10 +1,11 @@
 """`FeatureFrame` — model inputs (X): ``y_features (N, F, S)`` float32.
 
 A sibling frame (no shared base; ADR-011 Option C). Relocated from
-views-datafactory. The sample axis is **always explicit** (ADR-012): legacy 2D
-``(N, F)`` arrays are lifted to ``(N, F, 1)`` only through the explicit
-:meth:`from_2d` shim. Carries ``feature_names`` and a typed metadata header
-(ADR-013). ``from_grid`` is **not** here — it stays in views-datafactory.
+views-datafactory. The sample axis is **always explicit** (ADR-012), so
+unsampled features are stored as ``(N, F, 1)``; :meth:`from_2d` builds such a
+frame from a 2-D ``(N, F)`` array by adding that trailing axis. Carries
+``feature_names`` and a typed metadata header (ADR-013). ``from_grid`` is
+**not** here — it stays in views-datafactory.
 """
 
 from __future__ import annotations
@@ -38,7 +39,7 @@ class FeatureFrame:
             raise ValueError(
                 "FeatureFrame y_features must be 3D (N, F, S) with an explicit "
                 f"trailing sample axis (ADR-012), got ndim={values.ndim}. "
-                "Use FeatureFrame.from_2d to lift a legacy (N, F) array."
+                "Use FeatureFrame.from_2d to build a frame from a 2-D (N, F) array."
             )
         if values.shape[0] != index.n_rows:
             raise ValueError(
@@ -62,7 +63,12 @@ class FeatureFrame:
         feature_names: list[str],
         metadata: FrameMetadata | None = None,
     ) -> FeatureFrame:
-        """Lift a legacy 2D ``(N, F)`` array to ``(N, F, 1)`` (deprecated shim)."""
+        """Build a frame from a 2-D ``(N, F)`` array of unsampled features.
+
+        The sample axis is always explicit (ADR-012), so unsampled features are
+        stored as ``(N, F, 1)``. This adds that trailing axis for you. Raises
+        ``ValueError`` if the input is not 2-D.
+        """
         arr = coerce_values(y_features_2d)
         if arr.ndim != 2:
             raise ValueError(f"from_2d expects a 2D (N, F) array, got ndim={arr.ndim}")