Fractional Neural Networks API Reference
========================================

ML layers, spectral autograd, stochastic memory sampling, and probabilistic fractional orders.

Architecture note
-----------------

* **``FractionalNeuralNetwork``** (``hpfracc.ml.core``) applies a **discrete** fractional
  map (native Grünwald–Letnikov / L1 Caputo where implemented) along ``fractional_axis``,
  with a **uniform** grid; see constructor args ``fractional_step`` / ``fractional_t_grid``.
* **Spectral stack** (``hpfracc.ml.spectral_autograd``): ``SpectralFractionalLayer``,
  ``SpectralFractionalNetwork``, ``spectral_fractional_derivative`` — FFT-based, PyTorch-first.
  This is a **different** formulation from the discrete FNN preprocessor; compose them in a
  model only if you intend both mechanisms.

Native discrete fractional map (for advanced use)
-------------------------------------------------

.. automodule:: hpfracc.ml.fractional_derivative_native
   :no-index:
   :members: fractional_feature_map_native

Spectral Autograd
-----------------

.. automodule:: hpfracc.ml.spectral_autograd
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Stochastic Memory Sampling
--------------------------

.. automodule:: hpfracc.ml.stochastic_memory_sampling
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Probabilistic Fractional Orders
--------------------------------

.. automodule:: hpfracc.ml.probabilistic_fractional_orders
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Variance-Aware Training
-----------------------

.. automodule:: hpfracc.ml.variance_aware_training
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

GPU Optimization
----------------

.. automodule:: hpfracc.ml.gpu_optimization
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Backend Management
------------------

.. automodule:: hpfracc.ml.backends
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Neural Networks
---------------

.. automodule:: hpfracc.ml.core
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Neural ODEs
-----------

.. automodule:: hpfracc.ml.neural_ode
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Layers
------

.. automodule:: hpfracc.ml.layers
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance:

Tensor Operations
-----------------

.. automodule:: hpfracc.ml.tensor_ops
   :no-index:
   :members:
   :undoc-members:
   :show-inheritance: