How waleed-sh/neuralqx works
neuraLQX is a Python toolkit for variational simulations of canonical Loop Quantum Gravity, exposing LQG-specific graphs, Hilbert spaces, gauge groups, constraints, and operators through a NetKet/JAX-based variational backend. The main documented workflow is to define a physical problem, represent a variational state, and run a simulation; the sampled solver delegates its execution loop to a VMC driver and integrates samplers and other runtime services. The graph preserves documented domain capabilities and experimental symbolic-operator infrastructure, but several relationships are dashed because their implementation was not sampled.
Main entry points: solver.py Simulation solver · base.py Variational states · abstract_hilbert_core.py Hilbert spaces · expressions.py Symbolic IR
Components 25
LQG building blocks
- Graphs
neuralqx/graph/core/graph_handler.py - Hilbert spaces
neuralqx/hilbert/abstract_hilbert_core.py - U(1) constraints
neuralqx/hilbert/u1/constrained_core.py - Gauge groups
neuralqx/gauge_groups/abstract_gauge_group_interface.py - LQG models
neuralqx/lqx/abstract_lqx_interface.py
Operators and compilation
- Operator types
neuralqx/operators/types/computational_operator/jax.py - LQG operators
neuralqx/operators/computational
Variational simulation
- Neural networks
neuralqx/nn/models - Variational states
neuralqx/vqs/base.py - Monte Carlo state
neuralqx/vqs/mc/mc_state/state.py - Simulation solver
neuralqx/solver/solver.py - VMC drivers
neuralqx/driver/vmc.py - Monte Carlo samplers
neuralqx/samplers/rules - Optimizers
neuralqx/optimizer
Runtime services
- Run callbacks
neuralqx/callbacks/live_monitoring.py - Profiling
neuralqx/profile/profiler.py - Logging and debug
neuralqx/debug.py - Configuration
neuralqx/configs.py - Serialization
neuralqx/utils/serialization.py - Distributed runtime
neuralqx/utils/distributed/core.py
Experimental extensions
- Symbolic IR
neuralqx/experimental/operators/symbolic/ir/expressions.py - IR predicates
neuralqx/experimental/operators/symbolic/ir/predicates.py - Operator DSL
neuralqx/experimental/operators/symbolic/dsl/context.py - Symbolic compiler
neuralqx/experimental/operators/symbolic/compiler/core/pipeline.py
Other components
- Researcher
Connections 30
- Researcher → Graphs: defines topology
- Researcher → Simulation solver: runs simulation
- Hilbert spaces → Graphs: uses graph
neuralqx/hilbert/abstract_hilbert_core.py - U(1) constraints → Hilbert spaces: specializes
neuralqx/hilbert/u1/constrained_core.py - Researcher → Gauge groups: configures symmetry
- Researcher → LQG models: defines model
- Researcher → Operator types: specifies operators
- LQG models → LQG operators: provides constraints
- Operator DSL → Symbolic IR: builds expressions
neuralqx/experimental/operators/symbolic/dsl/context.py - Operator DSL → IR predicates: uses predicates
neuralqx/experimental/operators/symbolic/dsl/context.py - Symbolic IR → IR predicates: references predicates
neuralqx/experimental/operators/symbolic/ir/expressions.py - Symbolic compiler → Symbolic IR: compiles program
- Researcher → Neural networks: chooses ansatz
- Variational states → Hilbert spaces: binds state space
neuralqx/vqs/base.py - Variational states → Neural networks: evaluates ansatz
- Variational states → Operator types: estimates expectations
neuralqx/vqs/base.py - Simulation solver → VMC drivers: runs iterations
neuralqx/solver/solver.py - Simulation solver → Monte Carlo samplers: builds sampler
neuralqx/solver/solver.py - Simulation solver → Optimizers: configures optimization
neuralqx/solver/solver.py - Simulation solver → Variational states: uses variational state
neuralqx/solver/solver.py - Simulation solver → Run callbacks: registers callbacks
neuralqx/solver/solver.py - Simulation solver → Serialization: loads state
neuralqx/solver/solver.py - Simulation solver → Distributed runtime: uses runtime
neuralqx/solver/solver.py - Researcher → Profiling: profiles runs
- Profiling → Distributed runtime: reads rank info
- Researcher → Logging and debug: configures diagnostics
- Configuration → Logging and debug: initializes logging
neuralqx/__init__.py - Configuration → Distributed runtime: controls initialization
- Monte Carlo state → Variational states: implements state
neuralqx/vqs/mc/mc_state/state.py - Monte Carlo samplers → Hilbert spaces: samples configurations