wegamekinglc / Derivatives-Algorithms-Lib / 35503613940

92%

Build Type

push

github

Committed by web-flow

Commit Message

DAL-284: three-end simulation diagnostic projections and docs (T5) (#402)

* DAL-284: three-end simulation diagnostic projections and docs (T5)

- Python: ScriptSimulation_Explain binding (kw-only valuation/simulation
  SettingsInput, GIL released for the native run) plus high-level wrapper;
  MonteCarloSettings_ gains keyword-only lsmc_basis_degree (integer 1..8,
  rejecting bool/enums/floats) with shared integer-input validation
- Excel: SCRIPTSIMULATION.EXPLAIN public stub (Machinist-regenerated) and
  the lsmc_basis_degree settings key on MONTECARLOSETTINGS.NEW with
  integral 1..8 validation; unknown-key message lists the new key
- Tests: lsmc_basis_degree validation and ScriptSimulation_Explain e2e in
  dal-python test_script_settings.py; SCRIPTSIMULATION.EXPLAIN contract
  test in dal-excel test_script_valuation.cpp; new-key parsing in
  test_script_settings.cpp (portable suites, 1869/1869 green)
- Examples: dal-cpp/examples/american_put_mc and
  dal-python/examples/013.exercise_bermudan.py (European-limit, two-date
  Bermudan, and weekly-exercise puts off the T2 benchmark scenario)
- Docs: script_engine.md gains the LSMC driver and simulation-diagnostic
  sections and the payoff-variable null wording; random.md sobol-only note;
  pde.md test-only obstacle note; example mapping table; excel settings
  guide; Python README signatures; public-api projections; CHANGELOG
  capability entry

Co-authored-by: multica-agent <github@multica.ai>

* Correct the LSMC Phase C replay description and a settings-table row

- The hard replay prices each path by its first winning exercise decision
  (frozen h_k > C_k(z_k) comparison, h_k discounted at the exercise date's
  numeraire, never-exercised paths keep their PAYS value), not a backward
  max recursion against the realized continuation, and the hard driver has
  no final first-event-numeraire division; that division belongs to the
  fuzzy blend, which is carried in event-date units.
- Re-wrap the new lsmc... (continued)

Coverage Stats

14 of 14 new or added lines in 2 files covered. (100.0%)

1 existing line in 1 file now uncovered.

15324 of 16730 relevant lines covered (91.6%)

3949506.49 hits per line