tpattern 0.1.8__tar.gz → 0.1.9__tar.gz

{tpattern-0.1.8/tpattern.egg-info → tpattern-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tpattern
-Version: 0.1.8
+Version: 0.1.9
 Summary: Open, auditable temporal & sequential pattern analysis (T-patterns) for sport and behaviour
 Author-email: Andrew Callaway <acallaway@bournemouth.ac.uk>
 License-Expression: MIT

{tpattern-0.1.8 → tpattern-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tpattern"
-version = "0.1.8"
+version = "0.1.9"
 description = "Open, auditable temporal & sequential pattern analysis (T-patterns) for sport and behaviour"
 readme = "README.md"
 requires-python = ">=3.9"

{tpattern-0.1.8 → tpattern-0.1.9}/tpattern/__init__.py

@@ -6,7 +6,7 @@ behavior: T-patterns and their detection. Behavior Research Methods,
 Instruments, & Computers, 32(1), 93-110.
 """
 
-__version__ = "0.1.8"   # defined before submodule imports (methods.py reads it)
+__version__ = "0.1.9"   # defined before submodule imports (methods.py reads it)
 
 from .io import Observation, read_observation, read_sample, read_table, read_sofcoder
 from .pattern import Instance, Pattern

{tpattern-0.1.8 → tpattern-0.1.9}/tpattern/io.py

@@ -116,8 +116,8 @@ def read_sample(folder: str | Path, pattern: str = "*.txt") -> list[Observation]
 
 def read_table(path: str | Path, *, observation: str = "observation",
                event: str = "event", start: str = "start",
-               end: str | None = None, obs_start: str | None = None,
-               obs_end: str | None = None, build_event_from: list[str] | None = None,
+               end: str | None = "end", obs_start: str | None = "obs_start",
+               obs_end: str | None = "obs_end", build_event_from: list[str] | None = None,
                time_unit: str = "s", sep: str = ",") -> list[Observation]:
     """Read the canonical flat event table (see SCHEMA.md) into a sample.
 
@@ -135,11 +135,14 @@ def read_table(path: str | Path, *, observation: str = "observation",
         taken from the min/max event `start`.
     obs_start, obs_end : str, optional
         Columns giving the *observation window* (constant within an observation).
-        Supply these when the unit has real bounds that extend beyond its first and
-        last event — a possession, rally or bout usually does. The window length
-        T = obs_end - obs_start is the denominator of the NX/T baseline, so deriving
-        it from the events instead will shift every baseline probability. If absent,
-        the window falls back to the first/last event time.
+        These default to the conventional column names ("obs_start"/"obs_end"), so a
+        table that includes them is read correctly with **no arguments**; they are
+        ignored silently if the columns are absent. Supply a window when the unit has
+        real bounds that extend beyond its first and last event — a possession, rally
+        or bout usually does. The window length T = obs_end - obs_start is the
+        denominator of the NX/T baseline, so deriving it from the events instead will
+        shift every baseline probability. If absent, the window falls back to the
+        first/last event time.
     build_event_from : list[str], optional
         If given, the event code is built by joining these columns with '_'
         (for coders who keep the code split across descriptor columns) instead of

{tpattern-0.1.8 → tpattern-0.1.9/tpattern.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tpattern
-Version: 0.1.8
+Version: 0.1.9
 Summary: Open, auditable temporal & sequential pattern analysis (T-patterns) for sport and behaviour
 Author-email: Andrew Callaway <acallaway@bournemouth.ac.uk>
 License-Expression: MIT