.. Copyright (C) 2023-2024 Enzo Busseti
.. Copyright (C) 2016 Enzo Busseti, Stephen Boyd, Steven Diamond, BlackRock Inc.

.. This file is part of Cvxportfolio.

.. Cvxportfolio is free software: you can redistribute it and/or modify it under
.. the terms of the GNU General Public License as published by the Free Software
.. Foundation, either version 3 of the License, or (at your option) any later
.. version.

.. Cvxportfolio is distributed in the hope that it will be useful, but WITHOUT
.. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
.. FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
.. details.

.. You should have received a copy of the GNU General Public License along with
.. Cvxportfolio. If not, see <https://www.gnu.org/licenses/>.

Legacy examples from the paper
==============================

*Work in progress.*

These are the examples that were originally developed for the paper. They were
used to generate plots and results in :paper:`chapter 7 <chapter.7>`. They were
developed as IPython notebook, and are being translated into Python code using
the stable API. They are shown for historical reason, but are only partially,
or un-, supported.

The original notebooks are `available on this branch of the repository
<https://github.com/cvxgrp/cvxportfolio/blob/0.0.X/examples/>`_.

.. note::

   For most of them, the translation into Python code and stable API is *work
   in progress*. It might never be done. They have various issues, and for
   some of those perhaps there is no fix.

.. toctree::
   :maxdepth: 2

   paper_examples/hello_world
   paper_examples/data_risk_model
   paper_examples/multi_period_opt
   paper_examples/portfolio_simulation
   paper_examples/rank_and_spo
   paper_examples/real_time_optimization
   paper_examples/single_period_opt
   paper_examples/single_period_opt_lin_tcost
   paper_examples/solution_time