# Start here — FX Options Playground & Toolkit

Welcome. This package accompanies **FX Options: Pricing, Hedging, Exotics, Risk and Institutional Practice**
(Foreign Exchange Markets Professional Series).

You have **two ways** to use the companion Python:

| Mode | Best for | Where |
|------|----------|--------|
| **Browser playground** | Quick checks, no install | [rondanini.com/fxoptionsplayground](https://rondanini.com/fxoptionsplayground) |
| **Download package** (this folder) | Offline work, customization, batch runs | Your computer (Python 3.10+) |

---

## 1. Browser playground (no install)

1. Open [rondanini.com/fxoptionsplayground](https://rondanini.com/fxoptionsplayground).
2. Sign in with the access you received after purchase (or redeem your book entitlement).
3. Pick a **worked example** by ID (e.g. `WE-9.4`) or browse by chapter.
4. Press **Run with my parameters**. Book defaults are pre-filled; **change inputs first** (that is the default workflow), then re-run. Use **Reset to book example** to restore printed numbers.
5. Optional: from a printed **Scan for code** / QR link in the book, land on the matching example after sign-in.

Full steps: see **[PLAYGROUND.md](PLAYGROUND.md)**.

### Local tester (authors / reviewers — no gate)

From this folder:

```bash
python local_playground.py
```

Opens **http://127.0.0.1:8765** — browse all 193 examples and Run against your installed Python (same scripts buyers get in the ZIP).

---

## 2. Download package (this folder)

1. Unzip the package if you received a ZIP.
2. Open a terminal in this folder (`playground-content`).
3. Confirm Python 3.10+ is installed: `python --version`
4. Install scientific libs (once): `python -m pip install numpy scipy`
5. Run one example, e.g.:

```bash
python examples/ch09/WE-9.4_turnbull-wakeman-pricing.py
```

6. Or validate everything:

```bash
python verify_bundle.py
python run_examples.py
```

Full steps: see **[USER_GUIDE.md](USER_GUIDE.md)**.

---

## What you get

- **193** worked examples across Chapters 4 and 8–30
- Shared helpers (`examples/gk.py`, `var.py`, `vol_models.py`, …)
- A machine-readable catalogue: `manifest.json`

Chapters 1–3 and 5–7 are explained numerically in the book without companion scripts.

---

## Important notice

This code is for **education and professional development**.  
Validate, test, and adapt it yourself before any production, trading, or risk-management use.  
Illustrative market inputs in the book are **not** live quotes.

---

## Problems or errors?

Email **fxoptions@rondanini.com**

Please include:

- Whether you used the **playground** or the **download package**
- Example ID (e.g. `WE-9.4`) or file path
- Your operating system and Python version (download package)
- Exact error message or a screenshot (playground)
- Book edition / page if the printed figure disagrees with the code

Educational / publisher questions (not code): education@rondanini.com  
General publishing: support@rondanini.com  
Website: [education.rondanini.com](https://education.rondanini.com)