deriweave 0.4.0__tar.gz

deriweave-0.4.0/.gitattributes

@@ -0,0 +1,6 @@
+# Native patch checksums must survive Windows checkouts.
+* text=auto eol=lf
+*.bat text eol=crlf
+*.png binary
+*.jpg binary
+*.pdf binary

deriweave-0.4.0/.github/workflows/tests.yml

@@ -0,0 +1,42 @@
+name: Build and test
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python: ["3.10", "3.12", "3.14"]
+        openmp: ["OFF"]
+        include:
+          - os: ubuntu-latest
+            python: "3.12"
+            openmp: "ON"
+          - os: windows-latest
+            python: "3.12"
+            openmp: "ON"
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    env:
+      CMAKE_BUILD_PARALLEL_LEVEL: "4"
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install development dependencies
+        run: python -m pip install "scikit-build-core>=1.0" "pybind11>=3.0,<4" "pytest>=8" "numpy>=1.23" "build>=1.2" "twine>=6"
+      - name: Build and install the native extension; run C++ suites
+        run: python tools/build_local.py --openmp ${{ matrix.openmp }} --tests
+      - name: Build distributions and test the wheel in a fresh environment
+        run: python tools/check_distribution.py --tests ${{ runner.os == 'Windows' && matrix.python == '3.12' && matrix.openmp == 'OFF' && '--migration' || '' }}
+      - name: Check release metadata
+        run: python -c "import glob, subprocess, sys; subprocess.run([sys.executable, '-m', 'twine', 'check', '--strict', *glob.glob('dist/*.whl'), *glob.glob('dist/*.tar.gz')], check=True)"

deriweave-0.4.0/.gitignore

@@ -0,0 +1,18 @@
+/.venv/
+/build/
+/_skbuild/
+*.egg-info/
+__pycache__/
+.pytest_cache/
+/.audit/
+/dist/
+*.pyd
+*.so
+
+# Keep the pinned engine and Eigen headers in source control for pip install .
+/vendor/*
+!/vendor/deriweave/
+!/vendor/eigen-source/
+/vendor/eigen-source/*
+!/vendor/eigen-source/Eigen/
+!/vendor/eigen-source/COPYING*

deriweave-0.4.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.4.0 — 2026-11-07
+
+- Primary distribution and import renamed to `deriweave`.
+- `deriweave-python` becomes a pure Python compatibility distribution depending on `deriweave` 0.4.x.
+- Historical imports share the primary classes and native extension; no overlapping package files.
+- Migration validation covers the published 0.3.0 wheel and independent removal of the compatibility package.
+- Financial algorithms and numerical conventions are unchanged from the audited 0.3.0 release.
+
+## 0.3.0 — 2026-11-07
+
+- Six native models and reusable expressions, with autocalls and separate LSM training/evaluation.
+- Native paths, deterministic contract evaluation, moment diagnostics, NumPy interoperability and type information.
+- Numerical portability fixes validated on Windows/MSVC and Linux/GCC; details in docs/AUDIT.md.
+- Self-contained sources with an explicit archive whitelist and sequential Windows CPython 3.12 wheel; native dependencies are retained in source control.
+- Source preparation reuses existing headers without compiling Eigen and patches new engine sources before installing them.
+- Development builds install the actual extension they validate; clean-environment distribution checks are reproducible.
+
+## 0.2.0
+
+Initial Python bindings with six models, declarative compositions and historical pricing helpers.

deriweave-0.4.0/CMakeLists.txt

@@ -0,0 +1,60 @@
+cmake_minimum_required(VERSION 3.20)
+project(DeriWeavePython VERSION 0.4.0 LANGUAGES CXX)
+
+option(DERIWEAVE_PY_BUILD_TESTS "Build native tests and the Python reference executable" OFF)
+option(DERIWEAVE_ENABLE_OPENMP "Enable native OpenMP pricing (runtime required)" OFF)
+if(NOT DEFINED DERIWEAVE_SOURCE_DIR)
+  if(DEFINED ENV{DERIWEAVE_CPP_DIR} AND NOT "$ENV{DERIWEAVE_CPP_DIR}" STREQUAL "")
+    set(DERIWEAVE_SOURCE_DIR "$ENV{DERIWEAVE_CPP_DIR}" CACHE PATH "DeriWeave C++ sources")
+  else()
+    set(DERIWEAVE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/vendor/deriweave" CACHE PATH "DeriWeave C++ sources")
+  endif()
+endif()
+if(NOT EXISTS "${DERIWEAVE_SOURCE_DIR}/CMakeLists.txt")
+  message(FATAL_ERROR "DeriWeave C++ sources missing. Run python prepare_windows.py or set DERIWEAVE_SOURCE_DIR.")
+endif()
+find_package(Eigen3 3.4 QUIET NO_MODULE)
+if(NOT Eigen3_FOUND)
+  set(DERIWEAVE_EIGEN_INCLUDE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/vendor/eigen-source")
+  if(NOT EXISTS "${DERIWEAVE_EIGEN_INCLUDE_DIR}/Eigen/Core")
+    message(FATAL_ERROR "Eigen 3.4+ missing. Install Eigen or run python prepare_windows.py.")
+  endif()
+  include(CMakePackageConfigHelpers)
+  set(Eigen3_DIR "${CMAKE_CURRENT_BINARY_DIR}/eigen-package")
+  file(MAKE_DIRECTORY "${Eigen3_DIR}")
+  configure_file(cmake/Eigen3Config.cmake.in "${Eigen3_DIR}/Eigen3Config.cmake" @ONLY)
+  write_basic_package_version_file("${Eigen3_DIR}/Eigen3ConfigVersion.cmake"
+    VERSION 3.4.0 COMPATIBILITY SameMajorVersion ARCH_INDEPENDENT)
+  find_package(Eigen3 3.4 REQUIRED NO_MODULE)
+endif()
+set(DERIWEAVE_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
+set(DERIWEAVE_BUILD_TESTS ${DERIWEAVE_PY_BUILD_TESTS} CACHE BOOL "" FORCE)
+if(DERIWEAVE_PY_BUILD_TESTS)
+  include(CTest)
+endif()
+find_package(Python COMPONENTS Interpreter Development.Module REQUIRED)
+set(PYBIND11_FINDPYTHON ON)
+find_package(pybind11 3.0 CONFIG REQUIRED)
+add_subdirectory("${DERIWEAVE_SOURCE_DIR}" "${CMAKE_CURRENT_BINARY_DIR}/deriweave_cpp" EXCLUDE_FROM_ALL)
+pybind11_add_module(_core NO_EXTRAS bindings/module.cpp bindings/composition.cpp)
+target_compile_features(_core PRIVATE cxx_std_20)
+target_link_libraries(_core PRIVATE DeriWeave::deriweave_core)
+install(TARGETS _core LIBRARY DESTINATION deriweave COMPONENT python RUNTIME DESTINATION deriweave COMPONENT python)
+install(FILES "${DERIWEAVE_SOURCE_DIR}/LICENSE" DESTINATION deriweave/licenses
+        RENAME DeriWeave-LICENSE COMPONENT python)
+if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/vendor/eigen-source/COPYING.MPL2")
+  install(FILES vendor/eigen-source/COPYING.MPL2 vendor/eigen-source/COPYING.BSD
+                vendor/eigen-source/COPYING.MINPACK vendor/eigen-source/COPYING.README
+          DESTINATION deriweave/licenses COMPONENT python)
+endif()
+if(DERIWEAVE_PY_BUILD_TESTS)
+  add_custom_target(native_tests)
+  get_property(_native_targets DIRECTORY "${DERIWEAVE_SOURCE_DIR}" PROPERTY BUILDSYSTEM_TARGETS)
+  foreach(_target IN LISTS _native_targets)
+    if(_target MATCHES "_tests$")
+      add_dependencies(native_tests "${_target}")
+    endif()
+  endforeach()
+  add_executable(native_reference tests/native_reference.cpp)
+  target_link_libraries(native_reference PRIVATE DeriWeave::deriweave_core)
+endif()

deriweave-0.4.0/INSTALL_WINDOWS.bat

@@ -0,0 +1,36 @@
+@echo off
+setlocal
+cd /d "%~dp0"
+where cl >nul 2>&1
+if errorlevel 1 (
+    echo ERROR: Open an x64 Native Tools Command Prompt for Visual Studio.
+    exit /b 1
+)
+where cmake >nul 2>&1
+if errorlevel 1 (
+    if exist "%ProgramFiles%\CMake\bin\cmake.exe" set "PATH=%ProgramFiles%\CMake\bin;%PATH%"
+)
+where cmake >nul 2>&1
+if errorlevel 1 (
+    echo ERROR: CMake is required.
+    exit /b 1
+)
+if not exist ".venv\Scripts\python.exe" (
+    py -3 -m venv .venv
+    if errorlevel 1 exit /b 1
+)
+call ".venv\Scripts\activate.bat"
+python prepare_windows.py
+if errorlevel 1 exit /b 1
+python -m pip install ".[test]"
+if errorlevel 1 exit /b 1
+python tools\build_local.py --tests
+if errorlevel 1 exit /b 1
+python -m pytest -q
+if errorlevel 1 exit /b 1
+for %%f in (examples\*.py) do (
+    python "%%f"
+    if errorlevel 1 exit /b 1
+)
+echo SUCCESS: installation, native tests, Python tests and examples passed.
+endlocal

deriweave-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeriWeave contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deriweave-0.4.0/PKG-INFO

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: deriweave
+Version: 0.4.0
+Summary: Composable derivatives pricing with the native DeriWeave C++20 engine
+Keywords: derivatives,monte-carlo,quantitative-finance,pricing
+Author: DeriWeave contributors
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Provides-Extra: numpy
+Requires-Dist: numpy>=1.23; extra == "numpy"
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: numpy>=1.23; extra == "test"
+Requires-Dist: build>=1.2; extra == "test"
+Requires-Dist: scikit-build-core>=1.0; extra == "test"
+Requires-Dist: pybind11<4,>=3.0; extra == "test"
+Provides-Extra: release
+Requires-Dist: build>=1.2; extra == "release"
+Requires-Dist: twine>=6; extra == "release"
+Description-Content-Type: text/markdown
+
+# DeriWeave 0.4.0
+
+Contrats financiers composables en Python, avec **DeriWeave C++20** pour la
+simulation, les cashflows, les statistiques et Longstaff-Schwartz.
+Les descriptions Python sont réutilisables ; aucun callback Python ne s'exécute
+dans les boucles Monte Carlo.
+
+Six modèles, expressions imbriquées, barrières discrètes, autocalls avec mémoire
+et politiques LSM sont disponibles. La documentation détaillée accompagne
+l'archive source : `docs/guide.md`, `docs/coverage.md` et `docs/AUDIT.md`.
+
+## Installation avec pip
+
+~~~bash
+python -m pip install deriweave
+~~~
+
+La wheel prête à l'emploi cible **CPython 3.12, Windows x64**. Pour les autres
+configurations, pip construit depuis les sources : un compilateur C++20 et
+CMake sont alors nécessaires. La construction Linux/GCC est vérifiée sur Python 3.12.
+NumPy est facultatif pour le pricing ; pour les matrices et diagnostics de chemin :
+
+~~~bash
+python -m pip install "deriweave[numpy]"
+~~~
+
+## Installer la wheel Windows fournie
+
+Pour **CPython 3.12, Windows x64**, la wheel de `dist/` s'installe sans
+compilateur C++. Dans un environnement virtuel activé :
+
+~~~bat
+python -m pip install dist\deriweave-0.4.0-cp312-cp312-win_amd64.whl
+python examples\demo.py
+~~~
+
+Le nom du paquet et de l'import est désormais `deriweave`.
+La wheel et les sources permettent aussi une installation à partir d'un fichier
+local. Les instructions de maintenance et de publication figurent dans
+`docs/release.md`, inclus dans l'archive source.
+
+## Migrer depuis deriweave-python 0.3.0
+
+Pour conserver les anciens scripts :
+
+~~~bash
+python -m pip install --upgrade deriweave-python
+~~~
+
+La version 0.4.0 de ce paquet installe `deriweave` et conserve
+`import deriweave_py as dw`. Les deux noms donnent accès aux mêmes classes et au
+même moteur natif ; ils peuvent être utilisés ensemble sans mélanger deux moteurs.
+Les nouveaux projets utilisent `import deriweave as dw`.
+La procédure détaillée figure dans `docs/MIGRATION.md`, dans l'archive source.
+
+## Compiler et installer sous Windows
+
+Prérequis : Python 64 bits 3.10+, MSVC C++20 et CMake 3.20+.
+Validation sur Python 3.12.3, MSVC 19.51 et pybind11 3.1.0.
+Ouvrir une **x64 Native Tools Command Prompt** de Visual Studio :
+
+~~~bat
+python -m venv .venv
+.venv\Scripts\activate
+python -m pip install .
+~~~
+
+Réutiliser le .venv existant sans le recréer si souhaité.
+Le moteur et les en-têtes Eigen sont inclus dans les sources et conservés par
+les règles Git du projet : un checkout complet suffit pour `pip install .`.
+CMake n'a pas besoin du réseau ; pip peut télécharger le backend de construction.
+Pour une copie privée de ses dépendances, `python prepare_windows.py` récupère
+uniquement les sources manquantes, sur Windows ou Linux. Il réutilise les sources
+existantes et ne compile pas Eigen. Les corrections vérifiées par empreintes sont
+appliquées avant d'installer une nouvelle copie du moteur.
+
+Avec NumPy et les tests :
+
+~~~bat
+python -m pip install ".[test]"
+python tools\build_local.py --tests
+python -m pytest -q
+~~~
+
+`tools/build_local.py` installe le binaire qu'il construit avant de lancer les
+tests natifs ; les appels Python suivants utilisent donc cette compilation.
+INSTALL_WINDOWS.bat automatise préparation, installation, tests et exemples.
+
+## Installation Linux
+
+Avec Python, venv, les en-têtes de développement Python, un compilateur C++20 et
+CMake installés :
+
+~~~bash
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install .
+~~~
+
+Un Eigen 3.4+ installé est prioritaire ; les en-têtes inclus servent de repli.
+La validation Linux/GCC et ses limites figurent dans le rapport d'audit.
+
+## Premier prix
+
+~~~python
+import deriweave as dw
+
+asset = dw.Asset("AAPL")
+product = dw.Product(dw.Call(dw.Spot(asset, 1.0), 100), payment_date=1.05)
+market = dw.Market({"AAPL": 100}, rate=0.03, dividend_yields={"AAPL": 0.02})
+model = dw.BlackScholes(0.20)
+settings = dw.SimulationSettings(n_simulations=20_000, seed=42, antithetic=True)
+result = dw.price(product, market=market, model=model, settings=settings)
+print(result.price, result.standard_error, result.confidence_interval_95)
+~~~
+
+L'observation à 1.0 et le paiement à 1.05 restent distincts.
+20 000 observations antithétiques produisent 40 000 trajectoires.
+
+## Produits composables
+
+~~~python
+import deriweave as dw
+
+observations = [
+    dw.Basket([dw.Spot("A", t), dw.Spot("B", t)], [0.5, 0.5])
+    for t in [0.25, 0.5, 0.75, 1.0]
+]
+product = dw.Product(dw.Call(dw.Average(observations), 105), payment_date=1.0)
+result = dw.price(product, market=dw.Market({"A": 100, "B": 110}, 0.03),
+                  model=dw.BlackScholes([0.20, 0.25], [[1, 0.4], [0.4, 1]]))
+print(result.price)
+~~~
+
+Un call sur panier diffère d'un panier de calls. Les moyennes imbriquées
+conservent leur ordre et leurs observations répétées.
+
+## Exercice anticipé
+
+~~~python
+import deriweave as dw
+
+t = dw.ExerciseTime
+contract = dw.American(
+    payoff=dw.Put(dw.Spot("A", t), 100),
+    states=[dw.Spot("A", t)], start=0, maturity=1,
+)
+market = dw.Market({"A": 100}, 0.03)
+model = dw.BlackScholes(0.20)
+policy = dw.train_longstaff_schwartz(
+    contract, market=market, model=model,
+    settings=dw.LsmSettings(training_paths=4000, seed=7919,
+                            max_exercise_time_step=1/12),
+)
+result = dw.price(policy, market=market, model=model,
+                  settings=dw.SimulationSettings(n_simulations=6000, seed=42))
+print(result.price, policy.exercise_dates)
+~~~
+
+L'entraînement reste séparé de l'évaluation. Sous Heston, utiliser au minimum
+spot et variance comme états pour une vanille. L'intervalle de confiance est
+conditionnel à la politique apprise.
+
+## Vérifier une distribution
+
+Après installation de `.[test,release]` et construction de la référence C++ avec
+`python tools/build_local.py --tests` :
+
+~~~bash
+python tools/check_distribution.py --tests --migration
+~~~
+
+Cette commande construit les deux paquets depuis leurs archives source, contrôle leurs contenus
+et installe les wheels dans un venv neuf. Elle vérifie d'abord le pricing sans
+NumPy, puis exécute tous les tests Python et les cinq exemples.
+`--migration` teste aussi une mise à jour de la wheel historique 0.3.0 sous
+Windows/CPython 3.12, puis la désinstallation du paquet de compatibilité.
+`--no-isolation` réutilise les dépendances de construction déjà installées.
+
+## Exemples et OpenMP
+
+~~~bash
+python examples/demo.py
+python examples/composition_demo.py
+python examples/models_demo.py
+python examples/structured_demo.py
+python examples/exercise_demo.py
+python tools/memory_check.py
+~~~
+
+OpenMP est désactivé par défaut. Pour l'activer :
+
+~~~bash
+python -m pip install . -Ccmake.define.DERIWEAVE_ENABLE_OPENMP=ON
+~~~
+
+Utiliser ensuite SimulationSettings(use_openmp=True, num_threads=4).
+dw.build_info() indique les capacités réelles du binaire.
+Le runtime du compilateur est requis : vcomp140.dll sous MSVC, libgomp avec GCC.
+La wheel séquentielle évite cette dépendance.
+
+Les fonctions historiques european, asian et basket restent disponibles.
+Base : [DeriWeave 0.1.0](https://github.com/AmineFendi94/DeriWeave),
+commit 8e54378b0800c936e22c2abca0afaca751c73888, avec les corrections de portabilité
+documentées dans l'audit. Licence MIT ; Eigen conserve ses licences.

deriweave-0.4.0/README.md

@@ -0,0 +1,205 @@
+# DeriWeave 0.4.0
+
+Contrats financiers composables en Python, avec **DeriWeave C++20** pour la
+simulation, les cashflows, les statistiques et Longstaff-Schwartz.
+Les descriptions Python sont réutilisables ; aucun callback Python ne s'exécute
+dans les boucles Monte Carlo.
+
+Six modèles, expressions imbriquées, barrières discrètes, autocalls avec mémoire
+et politiques LSM sont disponibles. La documentation détaillée accompagne
+l'archive source : `docs/guide.md`, `docs/coverage.md` et `docs/AUDIT.md`.
+
+## Installation avec pip
+
+~~~bash
+python -m pip install deriweave
+~~~
+
+La wheel prête à l'emploi cible **CPython 3.12, Windows x64**. Pour les autres
+configurations, pip construit depuis les sources : un compilateur C++20 et
+CMake sont alors nécessaires. La construction Linux/GCC est vérifiée sur Python 3.12.
+NumPy est facultatif pour le pricing ; pour les matrices et diagnostics de chemin :
+
+~~~bash
+python -m pip install "deriweave[numpy]"
+~~~
+
+## Installer la wheel Windows fournie
+
+Pour **CPython 3.12, Windows x64**, la wheel de `dist/` s'installe sans
+compilateur C++. Dans un environnement virtuel activé :
+
+~~~bat
+python -m pip install dist\deriweave-0.4.0-cp312-cp312-win_amd64.whl
+python examples\demo.py
+~~~
+
+Le nom du paquet et de l'import est désormais `deriweave`.
+La wheel et les sources permettent aussi une installation à partir d'un fichier
+local. Les instructions de maintenance et de publication figurent dans
+`docs/release.md`, inclus dans l'archive source.
+
+## Migrer depuis deriweave-python 0.3.0
+
+Pour conserver les anciens scripts :
+
+~~~bash
+python -m pip install --upgrade deriweave-python
+~~~
+
+La version 0.4.0 de ce paquet installe `deriweave` et conserve
+`import deriweave_py as dw`. Les deux noms donnent accès aux mêmes classes et au
+même moteur natif ; ils peuvent être utilisés ensemble sans mélanger deux moteurs.
+Les nouveaux projets utilisent `import deriweave as dw`.
+La procédure détaillée figure dans `docs/MIGRATION.md`, dans l'archive source.
+
+## Compiler et installer sous Windows
+
+Prérequis : Python 64 bits 3.10+, MSVC C++20 et CMake 3.20+.
+Validation sur Python 3.12.3, MSVC 19.51 et pybind11 3.1.0.
+Ouvrir une **x64 Native Tools Command Prompt** de Visual Studio :
+
+~~~bat
+python -m venv .venv
+.venv\Scripts\activate
+python -m pip install .
+~~~
+
+Réutiliser le .venv existant sans le recréer si souhaité.
+Le moteur et les en-têtes Eigen sont inclus dans les sources et conservés par
+les règles Git du projet : un checkout complet suffit pour `pip install .`.
+CMake n'a pas besoin du réseau ; pip peut télécharger le backend de construction.
+Pour une copie privée de ses dépendances, `python prepare_windows.py` récupère
+uniquement les sources manquantes, sur Windows ou Linux. Il réutilise les sources
+existantes et ne compile pas Eigen. Les corrections vérifiées par empreintes sont
+appliquées avant d'installer une nouvelle copie du moteur.
+
+Avec NumPy et les tests :
+
+~~~bat
+python -m pip install ".[test]"
+python tools\build_local.py --tests
+python -m pytest -q
+~~~
+
+`tools/build_local.py` installe le binaire qu'il construit avant de lancer les
+tests natifs ; les appels Python suivants utilisent donc cette compilation.
+INSTALL_WINDOWS.bat automatise préparation, installation, tests et exemples.
+
+## Installation Linux
+
+Avec Python, venv, les en-têtes de développement Python, un compilateur C++20 et
+CMake installés :
+
+~~~bash
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install .
+~~~
+
+Un Eigen 3.4+ installé est prioritaire ; les en-têtes inclus servent de repli.
+La validation Linux/GCC et ses limites figurent dans le rapport d'audit.
+
+## Premier prix
+
+~~~python
+import deriweave as dw
+
+asset = dw.Asset("AAPL")
+product = dw.Product(dw.Call(dw.Spot(asset, 1.0), 100), payment_date=1.05)
+market = dw.Market({"AAPL": 100}, rate=0.03, dividend_yields={"AAPL": 0.02})
+model = dw.BlackScholes(0.20)
+settings = dw.SimulationSettings(n_simulations=20_000, seed=42, antithetic=True)
+result = dw.price(product, market=market, model=model, settings=settings)
+print(result.price, result.standard_error, result.confidence_interval_95)
+~~~
+
+L'observation à 1.0 et le paiement à 1.05 restent distincts.
+20 000 observations antithétiques produisent 40 000 trajectoires.
+
+## Produits composables
+
+~~~python
+import deriweave as dw
+
+observations = [
+    dw.Basket([dw.Spot("A", t), dw.Spot("B", t)], [0.5, 0.5])
+    for t in [0.25, 0.5, 0.75, 1.0]
+]
+product = dw.Product(dw.Call(dw.Average(observations), 105), payment_date=1.0)
+result = dw.price(product, market=dw.Market({"A": 100, "B": 110}, 0.03),
+                  model=dw.BlackScholes([0.20, 0.25], [[1, 0.4], [0.4, 1]]))
+print(result.price)
+~~~
+
+Un call sur panier diffère d'un panier de calls. Les moyennes imbriquées
+conservent leur ordre et leurs observations répétées.
+
+## Exercice anticipé
+
+~~~python
+import deriweave as dw
+
+t = dw.ExerciseTime
+contract = dw.American(
+    payoff=dw.Put(dw.Spot("A", t), 100),
+    states=[dw.Spot("A", t)], start=0, maturity=1,
+)
+market = dw.Market({"A": 100}, 0.03)
+model = dw.BlackScholes(0.20)
+policy = dw.train_longstaff_schwartz(
+    contract, market=market, model=model,
+    settings=dw.LsmSettings(training_paths=4000, seed=7919,
+                            max_exercise_time_step=1/12),
+)
+result = dw.price(policy, market=market, model=model,
+                  settings=dw.SimulationSettings(n_simulations=6000, seed=42))
+print(result.price, policy.exercise_dates)
+~~~
+
+L'entraînement reste séparé de l'évaluation. Sous Heston, utiliser au minimum
+spot et variance comme états pour une vanille. L'intervalle de confiance est
+conditionnel à la politique apprise.
+
+## Vérifier une distribution
+
+Après installation de `.[test,release]` et construction de la référence C++ avec
+`python tools/build_local.py --tests` :
+
+~~~bash
+python tools/check_distribution.py --tests --migration
+~~~
+
+Cette commande construit les deux paquets depuis leurs archives source, contrôle leurs contenus
+et installe les wheels dans un venv neuf. Elle vérifie d'abord le pricing sans
+NumPy, puis exécute tous les tests Python et les cinq exemples.
+`--migration` teste aussi une mise à jour de la wheel historique 0.3.0 sous
+Windows/CPython 3.12, puis la désinstallation du paquet de compatibilité.
+`--no-isolation` réutilise les dépendances de construction déjà installées.
+
+## Exemples et OpenMP
+
+~~~bash
+python examples/demo.py
+python examples/composition_demo.py
+python examples/models_demo.py
+python examples/structured_demo.py
+python examples/exercise_demo.py
+python tools/memory_check.py
+~~~
+
+OpenMP est désactivé par défaut. Pour l'activer :
+
+~~~bash
+python -m pip install . -Ccmake.define.DERIWEAVE_ENABLE_OPENMP=ON
+~~~
+
+Utiliser ensuite SimulationSettings(use_openmp=True, num_threads=4).
+dw.build_info() indique les capacités réelles du binaire.
+Le runtime du compilateur est requis : vcomp140.dll sous MSVC, libgomp avec GCC.
+La wheel séquentielle évite cette dépendance.
+
+Les fonctions historiques european, asian et basket restent disponibles.
+Base : [DeriWeave 0.1.0](https://github.com/AmineFendi94/DeriWeave),
+commit 8e54378b0800c936e22c2abca0afaca751c73888, avec les corrections de portabilité
+documentées dans l'audit. Licence MIT ; Eigen conserve ses licences.