Repository navigation
v0.14.0
Remaining-limits close-out on the 0.13 stack: opt-in operator families,
analysis extras, scale helpers, protocol-matched evaluation, and restricted
export. Homogeneous scientific defaults and the linear latent operator
contract are unchanged (koopman=None still selects "pernode").
Added
- Discrete parameterizations
row_stochastic,doubly_stochastic
(finite Sinkhorn), andsymplectic(evenlatent_dim). Constraints
apply to parameterizedK, not decodedx. - Bilinear
KoopmanMPCsequential-linearization (iterated QP) on per-node
discrete operators; additive mode still solves one QP. - Factory kinds
koopman="switched","mixture", and"hodge", plus
PredictedTopologyHead(AdaptiveAdjacency remains static Graph WaveNet). - Equivariant block
K(EquivariantKoopmanOperator) and
E3EquivariantEncoder(..., project_invariants=False); isotypic /
orbit neighbor-factor tying. - Cell-complex degree cap 3;
[tdl]TopologicX incidence bridge;
[tda]0-d persistence andPersistenceRegularizer. - Matrix-free hypergraph (Zhou-symmetric) and continuous-graph distributed
paths;scipy.sparsehelper; cluster subgraph sampler; injective
remap_node_features; opt-inKOOPMAN_GRAPH_MULTINODE=1Ray recipe. evaluate(..., include_resdmd=True),ResDMDFitCallback, Kronecker
dispersion plots, Granger-style causal MVP, optional[control-lmi].LeaderboardProtocol(distinct from teachingForecasterProtocol),
STAEformer-class and spatiotemporal SSM teaching ports, Fourier neural
operator encoder, ERA5-slice card, alanine-dipeptide teaching card.- Restricted
koopman_graph.export(torch.export/ TorchScript; ONNX
behind[export]), SVDKcompression, in-tree FedAvg, FDI feature
corruption, and aK^2VAE MVP ([probabilistic]). - Sphinx graphon page plus
sample_graphon_adjacency.
Changed
explain_representationaccepts delay embeddings and additive control
when the explainer algebra is defined (hetero / hypergraph / adaptive
remain rejected).- README and Sphinx quickstart keep the default constructor and add a
secondkoopman="graph"snippet. limitations.rstretires closed 0.13 bullets and records new ceilings
(finite ResDMD, TDA extra, federated-not-DP, restricted export,
leaderboard-not-SOTA, alanine-not-Folding@home).- Tests live in subdirectories that follow
src/koopman_graph/packages.
Version-named coverage dump files were split into module-named tests. - Orbit neighbor-factor tying reuses the representative
K_nbr/
K_hedgemodule so a one-orbit graph matches the shared parameter
count. DualK_bwdand heteroK_rstay globally shared.
Notes
- New operator kinds round-trip
safetensors_v1; custom injected modules
remain non-round-trippable.FORMAT_VERSIONstays 1. - Export refuses hetero / hypergraph / control / switched. Federated
averaging is not DP-SGD. Windows remains out of the CI matrix.
Full changelog: see CHANGELOG.md ([0.14.0] - 2026-08-13).