Crate kizzasi_logic

Crate kizzasi_logic 

Source
Expand description

§kizzasi-logic

TensorLogic bridge for Kizzasi - constraint enforcement and safety guardrails.

This module converts logical rules into:

  1. Training Loss: Penalize the model during training if it violates physics
  2. Inference Guards: Runtime checks to reject “hallucinated” physics

§COOLJAPAN Ecosystem

This crate integrates with tensorlogic for neuro-symbolic constraint definitions and uses scirs2-core for all array operations.

Modules§

block_utils
Utility functions for creating block structures

Structs§

AC3
AC-3 Algorithm for Arc Consistency
ADMMConfig
Configuration for ADMM-based consensus optimization
ActiveConstraintBoundaryLearner
Active learner for exploring constraint boundaries
AdaptiveConstraintOrder
Adaptive constraint ordering for efficient early termination
AdaptiveWeighting
Adaptive constraint weighting for balanced training
AffineEquality
Affine equality constraint: Ax = b
AnomalyBasedConstraintDiscovery
Anomaly detector for discovering new constraints
AnytimeSolver
Anytime constraint solver that improves solution quality over time
ApproximateSolution
Result of approximate constraint satisfaction
AugmentedLagrangian
Augmented Lagrangian method for constrained optimization
BacktrackingSearch
Backtracking search with constraint propagation
BarrierMethod
Barrier method for inequality constrained optimization
BatchConstraintChecker
Batch constraint checker for evaluating multiple points efficiently
BendersConfig
Configuration for Benders decomposition
BendersDecomposition
Benders Decomposition for mixed-integer programming
BendersIterationResult
Result of Benders iteration
Block
Block specification for block-wise decomposition
BlockCoordinateDescent
Block coordinate descent for structured constraints
BoundedErrorSolver
Soft constraint approximation with bounded error
CSP
Constraint Satisfaction Problem
CVaRConstraint
Risk-aware constraint using CVaR (Conditional Value at Risk)
CacheStats
Cache statistics
ChanceConstraint
Chance constraint: Pr[g(x) <= 0] >= 1 - ε
ConflictResolver
Conflict resolution for constraint sets
ConsensusADMM
Consensus ADMM solver for decomposed optimization
ConsistencyAnalysis
Result of constraint consistency analysis
ConstrainedProjection
Projects predictions onto valid constraint manifolds
Constraint
A single constraint on signal values
ConstraintAwareLoss
Constraint-aware loss function for training
ConstraintBuilder
Builder for constructing constraints
ConstraintChangeDetector
Constraint change detector
ConstraintConsistencyChecker
Constraint Consistency Checker
ConstraintInspector
Constraint inspector for interactive debugging
ConstraintInterpolator
Temporal constraint interpolation
ConstraintLearner
Learn constraints from positive and negative examples
ConstraintRepairer
Constraint repairer for handling infeasible constraint sets
ConstraintReport
Debugging report for multiple constraints
ConstraintSensitivityAnalyzer
Constraint Sensitivity Analyzer
ConstraintSet
Collection of soft and hard constraints
ConstraintSynthesizer
Synthesize constraints from specifications
ConstraintTimeSeries
Time series analysis of constraint satisfaction
CounterfactualAnalyzer
Counterfactual analyzer for finding nearest feasible points
DecompositionLevel
A single level in the hierarchical decomposition
DerivativeConstraint
Higher-order derivative constraint
DifferentiableProjection
Differentiable projection using soft projection with temperature parameter
DifferentialAlgebraicConstraint
Differential-algebraic constraint (DAE) Represents constraints of the form: F(x, dx/dt, t) = 0
DifferentialConstraintSet
Constraint set for differential constraints
DistributionallyRobustConstraint
Distributionally robust constraint: worst-case expectation over ambiguity set
DualDecomposition
Dual decomposition for separable constraints
DykstraProjection
Dykstra’s alternating projection algorithm for convex sets
EpsilonConstraintMethod
ε-constraint method for multi-objective optimization
FeedbackConstraintTuner
Feedback-based constraint tuner
ForwardChecker
Forward checking: maintain arc consistency during search
GPUConstraintChecker
GPU-accelerated constraint checker
GPUGradientComputer
GPU-accelerated constraint gradient computation
GPUProjector
GPU-accelerated projection onto constraint sets
GradientProjection
Gradient-based projection for smooth nonlinear constraints
Guardrail
A single guardrail combining a constraint with enforcement policy
GuardrailSet
A set of guardrails for multi-dimensional signals
HierarchicalConstraint
Constraint with priority level for hierarchical relaxation
HierarchicalDecomposition
Hierarchical decomposition for very large-scale problems
HierarchicalRelaxation
Hierarchical constraint relaxation solver
HypervolumeIndicator
Hypervolume indicator for Pareto front quality
HysteresisChecker
Checker for multiple hysteresis constraints
HysteresisConstraint
Hysteresis constraint for preventing rapid state transitions
IISFinder
Minimal Infeasible Subset (IIS) finder
IncrementalSolver
Incremental Constraint Solver
IncrementalState
Incremental solver state
InspectionResult
Result of constraint inspection
IntegralConstraint
Integral constraint over a time window
LTLChecker
LTL constraint checker that evaluates formulas over time traces
LagrangianRelaxation
Lagrangian relaxation for constrained optimization during training
LazyConstraintEvaluator
Lazy constraint evaluator that skips evaluation when not needed
LinearConstraint
Linear constraint: a·x (op) b
LinearConstraintSet
A set of linear constraints
LinearDynamics
Linear dynamics: x_{t+1} = Ax_t + Bu_t
LocalSensitivity
Local sensitivity analysis result for a single constraint
MPCConfig
MPC Configuration
MPCController
MPC Controller
MPCSolution
MPC Solution
MinimalViolatingSubsetFinder
Minimal violating subset finder
MultiObjectiveOptimizer
Multi-objective optimizer
MultiObjectiveSolution
Multi-objective solution point
NonlinearConstraint
Nonlinear constraint defined by an arbitrary function
OnlineConstraintLearner
Online learner for refining constraints from streaming data
OnlineLearningSystem
Unified online learning system combining multiple strategies
OnlineSTLMonitor
Online STL Monitor: incrementally processes streaming data
ParallelConstraintChecker
Parallel constraint checker using rayon (when available)
ParameterUpdate
Parameter update for constraint modification
PathIntegralConstraint
Path integral constraint for trajectory optimization
PenaltyMethod
Penalty method for constrained optimization
PredictiveConstraintAdapter
Predictive constraint adaptation
QuadraticConstraint
Quadratic constraint: x’Qx + c’x (op) b
QuadraticConstraintSet
Set of quadratic constraints
QuadraticCost
Quadratic cost function: ||x - x_ref||^2_Q + ||u - u_ref||^2_R
RepairResult
Result of constraint repair operation
RobustConstraint
Robust constraint: g(x, ξ) <= 0 for all ξ in uncertainty set
STLMonitor
STL Monitor: computes robustness of signal traces
SensitivityAnalysis
Result of constraint sensitivity analysis
SetMembershipConstraint
Set membership constraint
Signal
Signal: time series of multi-dimensional values
SlidingWindowChecker
Collection of sliding window constraints
SlidingWindowConstraint
Sliding window constraint for time-series data
SoftHardConstraint
Wrapper for any constraint with soft/hard mode
StateDependentConstraint
State-dependent constraint activation
Subproblem
A subproblem in hierarchical decomposition
TemporalChecker
Temporal constraint checker that maintains state
TemporalConstraint
Temporal constraint for rate-of-change limits
TemporalConstraintBuilder
Builder for temporal constraints
TimeInterval
Time interval for temporal operators
TimeVaryingConstraint
A constraint that varies over time
TimeVaryingConstraintSet
Manager for multiple time-varying constraints
VectorizedConstraints
Vectorized operations for efficient batch processing
ViolationAttributionAnalyzer
Violation attribution analyzer
ViolationExplainer
Unified violation explainer combining multiple strategies
ViolationExplanation
Explanation for a constraint violation
ViolationStats
Statistics about constraint violations over a sequence of values
WeightedSumMethod
Weighted sum method for multi-objective optimization

Enums§

ActivationFunction
Activation function type
AmbiguitySet
Types of ambiguity sets for distributionally robust optimization
BendersCut
Benders cut: either optimality or feasibility
BoundType
Type of bound constraint
ChanceConstraintMethod
Methods for handling chance constraints
ComposedConstraint
Composed constraint from multiple constraints with logical operators
ConstraintChange
Incremental constraint change type
ConstraintMode
Constraint enforcement mode
ConstraintParams
Constraint parameters that can be updated
ConstraintTemplate
Constraint template for synthesis
DecompositionError
Errors that can occur during constraint decomposition
DerivativeOrder
Order of derivative
DiscreteConstraint
Discrete constraint between variables
DivergenceType
Types of φ-divergences
GeometricSet
Geometric set types for membership constraints
InterpolationMode
Interpolation mode for smooth transitions
LTLFormula
LTL formula combining operators and atomic propositions
LTLOperator
Linear Temporal Logic operators for expressing temporal properties
LinearConstraintType
Type of linear constraint
LogicError
Errors that can occur in the logic module
LogicalOperator
Logical operators for combining constraints
NonlinearConstraintType
Type of nonlinear constraint
PenaltyFunction
Penalty function type for soft constraints
QuadraticConstraintType
Type of quadratic constraint
RateType
Rate-of-change constraint type
RepairStrategy
Strategy for repairing infeasible constraints
RobustnessApproach
Approaches to handle robust constraints
STLFormula
STL Formula with quantitative semantics
SlidingWindowFn
Types of sliding window constraints
SymbolicExpr
Symbolic constraint expression for reasoning
UncertaintySet
Types of uncertainty sets

Traits§

ConstrainedInference
Trait for constrained inference
DynamicsModel
Dynamics model for MPC
MPCCost
Cost function for MPC
ViolationComputable
Trait for constraints that can compute violation

Functions§

validate_constraint_set
Helper to validate constraint sets before use

Type Aliases§

Array1
one-dimensional array
DecompositionResult
Result type for decomposition operations
Domain
Domain of possible values for a variable
LogicResult
Result type alias for logic operations
VarId
Variable identifier