Introduction

General Python Utilities is a comprehensive Python library offering a broad set of tools and convenience functions for scientific computing, with particular emphasis on quantum physics simulations and numerical methods. It consolidates various frequently used functionalities into a single, easy-to-use package with flexible backend support for both NumPy and JAX.

Key Features:

🧮 Advanced Algebra & Linear Algebra

  • Comprehensive linear algebra operations with automatic NumPy/JAX backend detection

  • Sparse matrix operations and specialized solvers (CG, MinRes-QLP, direct methods)

  • Eigenvalue/eigenvector computations with optimized routines

  • Preconditioners for iterative solvers

  • ODE solving utilities

🎲 Mathematics & Random Number Generation

  • High-quality pseudorandom number generators (e.g., Xoshiro256 algorithm)

  • Comprehensive statistical functions and data analysis tools

  • Mathematical utilities and special functions

  • Reproducible random sequences for scientific computing

🔗 Lattice Structures

  • Tools for creating and manipulating lattice geometries

  • Support for square, hexagonal, and honeycomb lattices

  • Efficient neighbor finding and lattice navigation algorithms

  • Visualization utilities for lattice structures

🧠 Machine Learning Framework

  • Neural network implementations with flexible JAX/NumPy backends

  • Training utilities, optimizers, and learning rate schedulers

  • Loss functions for various ML tasks

  • Integration with modern ML workflows

⚛️ Quantum Physics Utilities

  • Density matrix operations and manipulations

  • Quantum entropy calculations (von Neumann, Rényi)

  • Eigenstate analysis and quantum operator utilities

  • JAX-optimized quantum computations

🛠️ Common Utilities

  • File and directory management with advanced I/O

  • HDF5 data handling and serialization

  • Plotting and visualization tools with scientific styling

  • Comprehensive logging and debugging utilities

  • Binary operations and bit manipulation tools

Performance & Flexibility: The library is designed with performance in mind, leveraging optimized libraries like NumPy, SciPy, and JAX. The automatic backend detection allows seamless switching between NumPy (CPU) and JAX (CPU/GPU/TPU) for maximum computational efficiency.

This library serves as both a standalone toolbox for scientific programming and a foundational component for larger physics simulation frameworks, particularly in quantum many-body systems and condensed matter physics research.