User Guide
==========

Comprehensive guide to using **qig** for quantum information geometry.

.. toctree::
   :maxdepth: 2
   
   exponential_families
   dynamics
   constraints
   generic_decomposition
   advanced

Quantum Exponential Families
-----------------------------

*Coming soon: Detailed guide on quantum exponential families*

Topics:
- Creating exponential families
- Different operator bases (Pauli, Gell-Mann)
- Computing density matrices
- Parameter space and natural coordinates

Constrained Dynamics
--------------------

*Coming soon: Guide to constrained quantum dynamics*

Topics:
- Information-geometric structure (GENERIC)
- Marginal entropy constraints
- The inaccessible game framework
- Integrating dynamics

Constraint Manifolds
--------------------

*Coming soon: Understanding constraint manifolds*

Topics:
- Fisher information metric
- Constraint gradients and Hessians
- Jacobian of the flow
- Geometric decomposition

Advanced Topics
---------------

*Coming soon: Advanced features and techniques*

Topics:
- Entanglement with pair operators
- High-precision derivatives (Duhamel)
- Third-order cumulants
- Optimization on manifolds