Py-vAllocation Core Module
==========================

The core module provides the foundational classes and functions for portfolio allocation and optimization.
This page provides an overview and links to the submodules.

Submodules
----------

Portfolio Allocation
^^^^^^^^^^^^^^^^^^^^

- :doc:`pyvallocation.portfolioapi`: Core portfolio management functionality
- :doc:`pyvallocation.optimization`: Advanced portfolio optimization techniques
- :doc:`pyvallocation.views`: Flexible views and constraints management

Ensembling & Discrete Allocation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- :doc:`pyvallocation.ensembles`: Portfolio averaging and exposure stacking utilities
- :doc:`pyvallocation.discrete_allocation`: Convert continuous weights to discrete share counts

Probabilistic Methods
^^^^^^^^^^^^^^^^^^^^^

- :doc:`pyvallocation.bayesian`: Bayesian portfolio allocation methods
- :doc:`pyvallocation.probabilities`: Probabilistic modeling tools
- :doc:`pyvallocation.moments`: Statistical moments and distribution analysis

Utility Functions
^^^^^^^^^^^^^^^^^

- :doc:`pyvallocation.utils`: Comprehensive utility functions for data handling, validation, and projection
- :doc:`pyvallocation.utils.performance`: Scenario PnL helpers and performance summaries
- :doc:`pyvallocation.plotting`: Plotting utilities for visualizing frontiers and allocations

Stress Testing
^^^^^^^^^^^^^^

- :doc:`pyvallocation.stress`: Probability tilts and linear scenario shocks