Changelog for 11.x.x#

v.11.0.0#

This update mainly expands the coverage of the Python bindings for the SAMSON API. It adds Python bindings for new helper classes used by introspection and visual-model geometry, substantially improves periodic-boundary and trajectory workflows, and exposes more camera, rendering, action, and metadata APIs.

Added bindings for the following classes:

Major improvements were made to:

SAMSON Facade#

New functionality:

Improved behavior:

  • Better validation for required arguments in document-management and neighbor-search factory helpers.

Core and Introspection#

SBValueMap

New class: samson.SBValueMap.

It exposes a Python-friendly mapping interface for introspection value maps, including dictionary-style indexing, iteration, snapshots of keys / values / items, and convenience helpers such as get, pop, update and toDict.

SBAttribute, SBInterface, and SBProxy

The introspection bindings were significantly extended:

  • samson.SBAttribute now exposes more metadata and value-management helpers, including defaults, ranges, item text, current index, and size / count access.

  • samson.SBInterface now exposes function and attribute discovery helpers such as getFunctionNames, getAttributeNames, getFunction and getAttribute accessors.

  • samson.SBProxy now exposes additional instance-management and proxy-value helpers such as get, set, clear, getSize, createInstanceType and deleteInstance.

SBValue, SBUUID, and SBVersionNumber

Utility bindings were improved:

  • samson.SBValue now supports boolean evaluation and exposes the empty sentinel.

  • samson.SBUUID now exposes increment / decrement helpers and the static invalid UUID constant.

  • samson.SBVersionNumber now exposes validation and compatibility helpers.

Data Model#

SBUnitCell

The unit-cell bindings were substantially expanded with lattice, periodicity, and minimum-image helpers:

  • lattice-vector, lattice-length, center, matrix, inverse-matrix, and reciprocal-matrix accessors;

  • coordinate-conversion helpers between Cartesian and fractional coordinates;

  • containment and nearest-periodic-image queries;

  • minimum-image distance and displacement helpers;

  • periodicity enumeration values exposed to Python, including the fully non-periodic case.

SBColor

New functionality:

SBNode and SBNodeColorScheme

The data-graph bindings now expose more rendering and color-scheme controls:

  • inherited opacity and transparency values are now available on samson.SBNode;

  • position-aware color evaluation was added to samson.SBNodeColorScheme;

  • palette-related helpers on color schemes were expanded and clarified.

Documents, Camera, and Render Preset

Document-related bindings were extended with additional state and rendering helpers:

  • samson.SBDocument now exposes setSaved and setTrusted;

  • samson.SBCamera now exposes head-position / orientation vectors and field-of-view inspector metadata such as minimum, maximum, single-step, and suffix values;

  • samson.SBRenderPreset now exposes inspector description text, background-image clearing / presence helpers, and correctly exposes many default render settings as static read-only properties.

Additional document helpers were also exposed, including SBAnimation.getIntervalIndex, SBFolder.getLightIndexer, and SBPresentation.getChildren.

Palettes and Visual Presets

Additional palette and visualization helpers are now available:

Modeling#

SBModel, SBStructuralModel, and SBPath

Periodic and trajectory workflows were substantially improved:

  • samson.SBModel, samson.SBConformation, and samson.SBPath now expose source-file metadata helpers;

  • samson.SBStructuralModel now exposes unit-cell access, periodicity checks, minimum-image distance / displacement helpers, wrapping and whole-molecule reconstruction helpers, centering inside the unit cell, and supercell generation;

  • samson.SBPath now exposes unit-cell data, mass data, unwrapped positions, whole-trajectory wrapping / unwrapping helpers, and whole-molecule reconstruction over periodic boundaries.

Structural Nodes

Structural-node bindings were expanded with additional helpers:

Visual Models

Visual-model coverage was significantly extended:

  • new classes samson.SBSurface and samson.SBTexture expose explicit geometry and texture-array workflows;

  • samson.SBMesh now supports construction from a surface list and exposes surface access together with additional geometry helpers;

  • surface and texture bindings provide direct access to index, position, normal, color, flag, node-index, texture-coordinate, and RGBA texture data.

Elements and Particle Systems

Additional modeling helpers were exposed:

Simulation and GUI#

SBAction

The action bindings now expose more UI-oriented metadata and convenience helpers, including:

  • construction from text and UUID;

  • object-name and description-image access;

  • badge and favorites-related metadata.

Simulators

Simulation bindings were improved with better model access:

  • samson.SBSimulator now exposes associated dynamical-model and interaction-model getters;

  • particle-system simulators, neighbor searches, and state updaters were updated to better match the current SDK surface and validation behavior.

Breaking changes#

  • Several debug helpers were normalized to print instead of older printDebugInfo bindings.

  • The abstract samson.SBDynamicalModel binding no longer exposes a direct clone entry point.