Expand description
Core types and traits for the Soma computational graph runtime.
This crate defines the contracts that all other crates depend on:
Filter— the computation unit (fit/forward)Value— typed data flowing between filters (Tensor, JSON, Bytes)Graph— DAG of filter nodes and edgesCacheKey/CacheStore— content-addressable cachingDataStore— abstraction for moving data between workersSchema— dtype + shape for compile-time validationEvent— runtime lifecycle events
Re-exports§
pub use cache::CacheKey;pub use cache::CacheStore;pub use cache::CacheTier;pub use cache::EntryMeta;pub use cache::Origin;pub use error::Result;pub use error::SomaError;pub use event::Event;pub use event::MetricRecord;pub use event::PlanSummary;pub use event::RunId;pub use event::StudyId;pub use event::TrialId;pub use filter::Distribution;pub use filter::Filter;pub use filter::FilterKind;pub use filter::FilterMeta;pub use filter::RemoteTarget;pub use filter::StreamMode;pub use graph::Edge;pub use graph::EdgeKind;pub use graph::Graph;pub use graph::Node;pub use graph::NodeId;pub use schema::DataType;pub use schema::Dimension;pub use schema::Schema;pub use search::Scale;pub use search::SearchDimension;pub use search::SearchSpace;pub use search::Searchable;pub use state::MemoryStateStore;pub use state::StateStore;pub use store::DataRef;pub use store::DataStore;pub use store::LocalDataStore;pub use store::StorageConfig;pub use store::StoreMeta;pub use store::StreamCache;pub use store::StreamFormat;pub use store::slice_tensor_rows;pub use strategy::ClientSelection;pub use strategy::CommunicationProtocol;pub use strategy::ExploitStrategy;pub use strategy::ExploreStrategy;pub use strategy::FederatedAggregation;pub use strategy::GradientAggregation;pub use strategy::Partition;pub use strategy::TrainingStrategy;pub use study::Direction;pub use study::Objective;pub use study::PruningStrategy;pub use study::SearchStrategy;pub use study::Study;pub use study::Trial;pub use study::TrialState;pub use value::Value;pub use virtual_value::ValueStatus;pub use virtual_value::VirtualValue;
Modules§
- cache
- Content-addressable caching — keys, traits, and metadata.
- error
- Error types for the Soma runtime.
- event
- Runtime lifecycle events — emitted during plan execution.
- filter
- The Filter trait — the fundamental computation unit in Soma.
- graph
- Computational graph — DAG of filter nodes connected by edges.
- schema
- Schema — dtype and shape for compile-time type checking between filters.
- search
- Search spaces for hyperparameter optimization.
- state
- Trained-state storage — authoritative data produced by
fit(). - store
- Data Store: abstraction for moving data between workers.
- strategy
- Training strategies for distributed execution.
- study
- Study — defines an optimization experiment with objectives and strategy.
- util
- Shared utility functions.
- value
- Typed values flowing between filters in a pipeline.
- virtual_
value - Virtual values — lazy references to data that can be materialized on demand.
Derive Macros§
- Soma
Filter - Derive macro for generating
config_hash()andSearchableimplementations.