torchvine 0.1.0__tar.gz

torchvine-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016-2025 Shahab A. Shojaeezadeh
+
+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.

torchvine-0.1.0/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.4
+Name: torchvine
+Version: 0.1.0
+Summary: Pure-PyTorch vine copula modelling — GPU-ready, differentiable, and API-compatible with pyvinecopulib
+Author: Bluerrror
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Bluerrror/torchvine
+Project-URL: Repository, https://github.com/Bluerrror/torchvine
+Project-URL: Issues, https://github.com/Bluerrror/torchvine/issues
+Keywords: copula,vine-copula,pytorch,gpu,statistics,dependence-modeling
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: torch>=2.0
+Requires-Dist: matplotlib>=3.5
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pyvinecopulib>=0.6; extra == "dev"
+Requires-Dist: scipy>=1.10; extra == "dev"
+Requires-Dist: numpy>=1.24; extra == "dev"
+Requires-Dist: nbformat>=5.0; extra == "dev"
+Dynamic: license-file
+
+# torchvine
+
+<p align="center">
+  <img src="https://capsule-render.vercel.app/api?type=waving&height=180&color=0:ee4c2c,100:ff6f00&text=torchvine&fontColor=ffffff&fontSize=60&fontAlignY=35&desc=Pure-PyTorch%20Vine%20Copula%20Modelling&descAlign=50&descAlignY=55" width="100%" alt="torchvine"/>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/torchvine/"><img src="https://img.shields.io/pypi/v/torchvine?color=ee4c2c&style=for-the-badge" alt="PyPI"/></a>
+  <a href="https://pypi.org/project/torchvine/"><img src="https://img.shields.io/pypi/pyversions/torchvine?style=for-the-badge&color=ff6f00" alt="Python"/></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"/></a>
+  <a href="https://pytorch.org/"><img src="https://img.shields.io/badge/PyTorch-2.0%2B-ee4c2c?style=for-the-badge&logo=pytorch&logoColor=white" alt="PyTorch"/></a>
+</p>
+
+<p align="center">
+  GPU-ready, differentiable vine copula modelling in pure PyTorch.<br>
+  <b>Drop-in replacement</b> for <a href="https://github.com/vinecopulib/pyvinecopulib">pyvinecopulib</a> — same API, but with autograd and CUDA support.
+</p>
+
+---
+
+## ✨ Why torchvine?
+
+| | torchvine | pyvinecopulib |
+|---|---|---|
+| **Backend** | Pure PyTorch (GPU / CPU) | C++ with Python bindings |
+| **Differentiable** | ✅ Autograd-compatible | ❌ |
+| **GPU acceleration** | ✅ CUDA tensors | ❌ CPU only |
+| **API** | Drop-in replacement | Reference |
+| **Copula families** | 13 (full parity) | 13 |
+
+**Zero C/C++ dependencies** — everything is implemented in pure PyTorch, making it easy to install, debug, and extend.
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install torchvine
+```
+
+From source:
+
+```bash
+git clone https://github.com/Bluerrror/torchvine.git
+cd torchvine
+pip install -e .
+```
+
+**Requirements:** Python ≥ 3.9 &nbsp;|&nbsp; PyTorch ≥ 2.0 &nbsp;|&nbsp; matplotlib ≥ 3.5
+
+---
+
+## 📖 Quick Start
+
+### Bivariate Copula
+
+```python
+import torch
+import torchvine as tv
+
+# Create a Gaussian copula with correlation 0.7
+cop = tv.Bicop(tv.BicopFamily.gaussian, parameters=torch.tensor([0.7]))
+print(cop.str())               # <Bicop> family=gaussian, rotation=0, parameters=[0.7]
+print(cop.parameters_to_tau()) # Kendall's tau ≈ 0.494
+
+# Evaluate density and simulate
+u = torch.rand(1000, 2, dtype=torch.float64)
+pdf_vals = cop.pdf(u)
+samples  = cop.simulate(1000)
+
+# Fit from data (automatic family selection)
+fitted = tv.Bicop()
+fitted.select(samples)
+print(fitted.str())
+```
+
+### Vine Copula
+
+```python
+# Fit a 5-dimensional vine copula
+data = torch.rand(500, 5, dtype=torch.float64)
+vine = tv.Vinecop(d=5)
+vine.select(data, controls=tv.FitControlsVinecop(family_set=tv.parametric))
+
+print(vine.str())
+print(f"Log-likelihood: {vine.loglik(data):.2f}")
+print(f"AIC: {vine.aic(data):.2f}")
+
+# Simulate and transform
+sim = vine.simulate(1000)
+pit = vine.rosenblatt(data)      # probability integral transform
+```
+
+### Dependence Measures
+
+```python
+x = torch.randn(1000, dtype=torch.float64)
+y = 0.6 * x + 0.8 * torch.randn(1000, dtype=torch.float64)
+
+print(tv.kendall_tau(x, y))    # Kendall's tau
+print(tv.spearman_rho(x, y))   # Spearman's rho
+print(tv.pearson_cor(x, y))    # Pearson correlation
+print(tv.blomqvist_beta(x, y)) # Blomqvist's beta
+print(tv.hoeffding_d(x, y))    # Hoeffding's D
+```
+
+### GPU Acceleration
+
+```python
+device = "cuda" if torch.cuda.is_available() else "cpu"
+u_gpu = torch.rand(10000, 2, dtype=torch.float64, device=device)
+
+cop = tv.Bicop(tv.BicopFamily.clayton, parameters=torch.tensor([3.0], device=device))
+pdf_gpu = cop.pdf(u_gpu)  # runs entirely on GPU
+```
+
+---
+
+## 📋 Supported Copula Families
+
+| Family | Parameters | Type |
+|--------|-----------|------|
+| Independence | 0 | — |
+| Gaussian | 1 (ρ) | Elliptical |
+| Student-t | 2 (ρ, ν) | Elliptical |
+| Clayton | 1 (θ) | Archimedean |
+| Gumbel | 1 (θ) | Archimedean / Extreme-value |
+| Frank | 1 (θ) | Archimedean |
+| Joe | 1 (θ) | Archimedean |
+| BB1 | 2 (θ, δ) | Archimedean |
+| BB6 | 2 (θ, δ) | Archimedean |
+| BB7 | 2 (θ, δ) | Archimedean |
+| BB8 | 2 (θ, δ) | Archimedean |
+| Tawn | 3 (ψ₁, ψ₂, θ) | Extreme-value |
+| TLL | nonparametric | Kernel-based |
+
+All asymmetric families support rotations (0°, 90°, 180°, 270°).
+
+---
+
+## 📚 API Reference
+
+### Core Classes
+
+| Class | Description |
+|-------|-------------|
+| `tv.Bicop` | Bivariate copula — create, fit, evaluate, simulate |
+| `tv.Vinecop` | Vine copula model — select, pdf, simulate, rosenblatt |
+| `tv.Kde1d` | 1-D kernel density estimation — fit, pdf, cdf, quantile |
+| `tv.RVineStructure` | R-vine structure matrix |
+| `tv.DVineStructure` | D-vine structure (convenience subclass) |
+| `tv.CVineStructure` | C-vine structure (convenience subclass) |
+| `tv.FitControlsBicop` | Fitting options for bivariate copulas |
+| `tv.FitControlsVinecop` | Fitting options for vine copulas |
+| `tv.BicopFamily` | Enum of all copula families |
+
+### Dependence Measures
+
+| Function | Description |
+|----------|-------------|
+| `tv.kendall_tau(x, y)` | Kendall's rank correlation |
+| `tv.spearman_rho(x, y)` | Spearman's rank correlation |
+| `tv.pearson_cor(x, y)` | Pearson linear correlation |
+| `tv.blomqvist_beta(x, y)` | Blomqvist's beta (medial correlation) |
+| `tv.hoeffding_d(x, y)` | Hoeffding's D statistic |
+| `tv.wdm(x, y, method)` | Unified interface for all measures |
+
+### Utilities
+
+| Function | Description |
+|----------|-------------|
+| `tv.to_pseudo_obs(data)` | Rank-transform to pseudo-observations |
+| `tv.simulate_uniform(n, d)` | Uniform random / quasi-random samples |
+| `tv.pairs_copula_data(data)` | Pairs plot with copula density contours |
+
+---
+
+## 📓 Examples
+
+See the [`examples/`](examples/) directory for Jupyter notebooks:
+
+| Notebook | Topics |
+|----------|--------|
+| [01 — Getting Started](examples/01_getting_started.ipynb) | Imports, copula basics, simulation, fitting |
+| [02 — Bivariate Copulas](examples/02_bivariate_copulas.ipynb) | All families, rotations, Student-t, model selection |
+| [03 — Vine Copulas](examples/03_vine_copulas.ipynb) | Vine fitting, structure, simulation, Rosenblatt transform |
+| [04 — Kde1d & Statistics](examples/04_kde1d_and_stats.ipynb) | KDE, dependence measures, pairs plot visualization |
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create a feature branch: `git checkout -b feature/amazing-feature`
+3. Commit changes: `git commit -m "Add amazing feature"`
+4. Push: `git push origin feature/amazing-feature`
+5. Open a Pull Request
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgements
+
+- API design follows [vinecopulib](https://github.com/vinecopulib/vinecopulib) / [pyvinecopulib](https://github.com/vinecopulib/pyvinecopulib) by Thomas Nagler and Thibault Vatter.
+
+<img width="100%" src="https://capsule-render.vercel.app/api?type=waving&color=0:ee4c2c,100:ff6f00&height=100&section=footer"/>

torchvine-0.1.0/README.md

@@ -0,0 +1,211 @@
+# torchvine
+
+<p align="center">
+  <img src="https://capsule-render.vercel.app/api?type=waving&height=180&color=0:ee4c2c,100:ff6f00&text=torchvine&fontColor=ffffff&fontSize=60&fontAlignY=35&desc=Pure-PyTorch%20Vine%20Copula%20Modelling&descAlign=50&descAlignY=55" width="100%" alt="torchvine"/>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/torchvine/"><img src="https://img.shields.io/pypi/v/torchvine?color=ee4c2c&style=for-the-badge" alt="PyPI"/></a>
+  <a href="https://pypi.org/project/torchvine/"><img src="https://img.shields.io/pypi/pyversions/torchvine?style=for-the-badge&color=ff6f00" alt="Python"/></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"/></a>
+  <a href="https://pytorch.org/"><img src="https://img.shields.io/badge/PyTorch-2.0%2B-ee4c2c?style=for-the-badge&logo=pytorch&logoColor=white" alt="PyTorch"/></a>
+</p>
+
+<p align="center">
+  GPU-ready, differentiable vine copula modelling in pure PyTorch.<br>
+  <b>Drop-in replacement</b> for <a href="https://github.com/vinecopulib/pyvinecopulib">pyvinecopulib</a> — same API, but with autograd and CUDA support.
+</p>
+
+---
+
+## ✨ Why torchvine?
+
+| | torchvine | pyvinecopulib |
+|---|---|---|
+| **Backend** | Pure PyTorch (GPU / CPU) | C++ with Python bindings |
+| **Differentiable** | ✅ Autograd-compatible | ❌ |
+| **GPU acceleration** | ✅ CUDA tensors | ❌ CPU only |
+| **API** | Drop-in replacement | Reference |
+| **Copula families** | 13 (full parity) | 13 |
+
+**Zero C/C++ dependencies** — everything is implemented in pure PyTorch, making it easy to install, debug, and extend.
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install torchvine
+```
+
+From source:
+
+```bash
+git clone https://github.com/Bluerrror/torchvine.git
+cd torchvine
+pip install -e .
+```
+
+**Requirements:** Python ≥ 3.9 &nbsp;|&nbsp; PyTorch ≥ 2.0 &nbsp;|&nbsp; matplotlib ≥ 3.5
+
+---
+
+## 📖 Quick Start
+
+### Bivariate Copula
+
+```python
+import torch
+import torchvine as tv
+
+# Create a Gaussian copula with correlation 0.7
+cop = tv.Bicop(tv.BicopFamily.gaussian, parameters=torch.tensor([0.7]))
+print(cop.str())               # <Bicop> family=gaussian, rotation=0, parameters=[0.7]
+print(cop.parameters_to_tau()) # Kendall's tau ≈ 0.494
+
+# Evaluate density and simulate
+u = torch.rand(1000, 2, dtype=torch.float64)
+pdf_vals = cop.pdf(u)
+samples  = cop.simulate(1000)
+
+# Fit from data (automatic family selection)
+fitted = tv.Bicop()
+fitted.select(samples)
+print(fitted.str())
+```
+
+### Vine Copula
+
+```python
+# Fit a 5-dimensional vine copula
+data = torch.rand(500, 5, dtype=torch.float64)
+vine = tv.Vinecop(d=5)
+vine.select(data, controls=tv.FitControlsVinecop(family_set=tv.parametric))
+
+print(vine.str())
+print(f"Log-likelihood: {vine.loglik(data):.2f}")
+print(f"AIC: {vine.aic(data):.2f}")
+
+# Simulate and transform
+sim = vine.simulate(1000)
+pit = vine.rosenblatt(data)      # probability integral transform
+```
+
+### Dependence Measures
+
+```python
+x = torch.randn(1000, dtype=torch.float64)
+y = 0.6 * x + 0.8 * torch.randn(1000, dtype=torch.float64)
+
+print(tv.kendall_tau(x, y))    # Kendall's tau
+print(tv.spearman_rho(x, y))   # Spearman's rho
+print(tv.pearson_cor(x, y))    # Pearson correlation
+print(tv.blomqvist_beta(x, y)) # Blomqvist's beta
+print(tv.hoeffding_d(x, y))    # Hoeffding's D
+```
+
+### GPU Acceleration
+
+```python
+device = "cuda" if torch.cuda.is_available() else "cpu"
+u_gpu = torch.rand(10000, 2, dtype=torch.float64, device=device)
+
+cop = tv.Bicop(tv.BicopFamily.clayton, parameters=torch.tensor([3.0], device=device))
+pdf_gpu = cop.pdf(u_gpu)  # runs entirely on GPU
+```
+
+---
+
+## 📋 Supported Copula Families
+
+| Family | Parameters | Type |
+|--------|-----------|------|
+| Independence | 0 | — |
+| Gaussian | 1 (ρ) | Elliptical |
+| Student-t | 2 (ρ, ν) | Elliptical |
+| Clayton | 1 (θ) | Archimedean |
+| Gumbel | 1 (θ) | Archimedean / Extreme-value |
+| Frank | 1 (θ) | Archimedean |
+| Joe | 1 (θ) | Archimedean |
+| BB1 | 2 (θ, δ) | Archimedean |
+| BB6 | 2 (θ, δ) | Archimedean |
+| BB7 | 2 (θ, δ) | Archimedean |
+| BB8 | 2 (θ, δ) | Archimedean |
+| Tawn | 3 (ψ₁, ψ₂, θ) | Extreme-value |
+| TLL | nonparametric | Kernel-based |
+
+All asymmetric families support rotations (0°, 90°, 180°, 270°).
+
+---
+
+## 📚 API Reference
+
+### Core Classes
+
+| Class | Description |
+|-------|-------------|
+| `tv.Bicop` | Bivariate copula — create, fit, evaluate, simulate |
+| `tv.Vinecop` | Vine copula model — select, pdf, simulate, rosenblatt |
+| `tv.Kde1d` | 1-D kernel density estimation — fit, pdf, cdf, quantile |
+| `tv.RVineStructure` | R-vine structure matrix |
+| `tv.DVineStructure` | D-vine structure (convenience subclass) |
+| `tv.CVineStructure` | C-vine structure (convenience subclass) |
+| `tv.FitControlsBicop` | Fitting options for bivariate copulas |
+| `tv.FitControlsVinecop` | Fitting options for vine copulas |
+| `tv.BicopFamily` | Enum of all copula families |
+
+### Dependence Measures
+
+| Function | Description |
+|----------|-------------|
+| `tv.kendall_tau(x, y)` | Kendall's rank correlation |
+| `tv.spearman_rho(x, y)` | Spearman's rank correlation |
+| `tv.pearson_cor(x, y)` | Pearson linear correlation |
+| `tv.blomqvist_beta(x, y)` | Blomqvist's beta (medial correlation) |
+| `tv.hoeffding_d(x, y)` | Hoeffding's D statistic |
+| `tv.wdm(x, y, method)` | Unified interface for all measures |
+
+### Utilities
+
+| Function | Description |
+|----------|-------------|
+| `tv.to_pseudo_obs(data)` | Rank-transform to pseudo-observations |
+| `tv.simulate_uniform(n, d)` | Uniform random / quasi-random samples |
+| `tv.pairs_copula_data(data)` | Pairs plot with copula density contours |
+
+---
+
+## 📓 Examples
+
+See the [`examples/`](examples/) directory for Jupyter notebooks:
+
+| Notebook | Topics |
+|----------|--------|
+| [01 — Getting Started](examples/01_getting_started.ipynb) | Imports, copula basics, simulation, fitting |
+| [02 — Bivariate Copulas](examples/02_bivariate_copulas.ipynb) | All families, rotations, Student-t, model selection |
+| [03 — Vine Copulas](examples/03_vine_copulas.ipynb) | Vine fitting, structure, simulation, Rosenblatt transform |
+| [04 — Kde1d & Statistics](examples/04_kde1d_and_stats.ipynb) | KDE, dependence measures, pairs plot visualization |
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create a feature branch: `git checkout -b feature/amazing-feature`
+3. Commit changes: `git commit -m "Add amazing feature"`
+4. Push: `git push origin feature/amazing-feature`
+5. Open a Pull Request
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgements
+
+- API design follows [vinecopulib](https://github.com/vinecopulib/vinecopulib) / [pyvinecopulib](https://github.com/vinecopulib/pyvinecopulib) by Thomas Nagler and Thibault Vatter.
+
+<img width="100%" src="https://capsule-render.vercel.app/api?type=waving&color=0:ee4c2c,100:ff6f00&height=100&section=footer"/>

torchvine-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "torchvine"
+version = "0.1.0"
+description = "Pure-PyTorch vine copula modelling — GPU-ready, differentiable, and API-compatible with pyvinecopulib"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+keywords = ["copula", "vine-copula", "pytorch", "gpu", "statistics", "dependence-modeling"]
+authors = [
+  { name = "Bluerrror" },
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Science/Research",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering :: Mathematics",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+  "torch>=2.0",
+  "matplotlib>=3.5",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.0",
+  "pyvinecopulib>=0.6",
+  "scipy>=1.10",
+  "numpy>=1.24",
+  "nbformat>=5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Bluerrror/torchvine"
+Repository = "https://github.com/Bluerrror/torchvine"
+Issues = "https://github.com/Bluerrror/torchvine/issues"
+
+[tool.setuptools]
+package-dir = { "" = "." }
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["torchvine*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

torchvine-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

torchvine-0.1.0/tests/test_api_parity.py

@@ -0,0 +1,106 @@
+"""Test that torchvine has API parity with pyvinecopulib (excluding student copula)."""
+import unittest
+
+try:
+    import pyvinecopulib as pv
+    HAS_PV = True
+except ImportError:
+    HAS_PV = False
+
+import torchvine as tv
+
+
+@unittest.skipUnless(HAS_PV, "pyvinecopulib not installed")
+class TestBicopAPIParity(unittest.TestCase):
+    """Every public method on pv.Bicop should exist on tv.Bicop."""
+
+    SKIP = {"plot"}  # plot may differ in implementation
+
+    def test_all_methods_exist(self):
+        pv_methods = {m for m in dir(pv.Bicop) if not m.startswith("_")} - self.SKIP
+        tv_methods = {m for m in dir(tv.Bicop) if not m.startswith("_")}
+        missing = pv_methods - tv_methods
+        self.assertEqual(missing, set(),
+                         f"Missing Bicop methods: {missing}")
+
+
+@unittest.skipUnless(HAS_PV, "pyvinecopulib not installed")
+class TestVinecopAPIParity(unittest.TestCase):
+    """Every public method on pv.Vinecop should exist on tv.Vinecop."""
+
+    SKIP = {"plot"}
+
+    def test_all_methods_exist(self):
+        pv_methods = {m for m in dir(pv.Vinecop) if not m.startswith("_")} - self.SKIP
+        tv_inst = tv.Vinecop.from_dimension(3)
+        tv_methods = {m for m in dir(tv_inst) if not m.startswith("_")}
+        missing = pv_methods - tv_methods
+        self.assertEqual(missing, set(),
+                         f"Missing Vinecop methods: {missing}")
+
+
+@unittest.skipUnless(HAS_PV, "pyvinecopulib not installed")
+class TestRVineStructureAPIParity(unittest.TestCase):
+    """Every public method on pv.RVineStructure should exist on tv.RVineStructure."""
+
+    def test_all_methods_exist(self):
+        pv_methods = {m for m in dir(pv.RVineStructure) if not m.startswith("_")}
+        tv_inst = tv.RVineStructure.from_dimension(4)
+        tv_methods = {m for m in dir(tv_inst) if not m.startswith("_")}
+        missing = pv_methods - tv_methods
+        self.assertEqual(missing, set(),
+                         f"Missing RVineStructure methods: {missing}")
+
+
+@unittest.skipUnless(HAS_PV, "pyvinecopulib not installed")
+class TestFitControlsAPIParity(unittest.TestCase):
+    """FitControls classes should have matching attributes."""
+
+    SKIP_BICOP = set()
+    SKIP_VINECOP = set()
+
+    def test_bicop_controls(self):
+        pv_attrs = {m for m in dir(pv.FitControlsBicop) if not m.startswith("_")} - self.SKIP_BICOP
+        tv_inst = tv.FitControlsBicop()
+        tv_attrs = {m for m in dir(tv_inst) if not m.startswith("_")}
+        missing = pv_attrs - tv_attrs
+        self.assertEqual(missing, set(),
+                         f"Missing FitControlsBicop attrs: {missing}")
+
+    def test_vinecop_controls(self):
+        pv_attrs = {m for m in dir(pv.FitControlsVinecop) if not m.startswith("_")} - self.SKIP_VINECOP
+        tv_inst = tv.FitControlsVinecop()
+        tv_attrs = {m for m in dir(tv_inst) if not m.startswith("_")}
+        missing = pv_attrs - tv_attrs
+        self.assertEqual(missing, set(),
+                         f"Missing FitControlsVinecop attrs: {missing}")
+
+
+@unittest.skipUnless(HAS_PV, "pyvinecopulib not installed")
+class TestModuleLevelParity(unittest.TestCase):
+    """Module-level names should exist in torchvine."""
+
+    # Names that are intentionally excluded
+    SKIP = {"student", "benchmark", "pyvinecopulib_ext"}
+
+    def test_module_names(self):
+        pv_names = {m for m in dir(pv)
+                    if not m.startswith("_") and m[0].islower()} - self.SKIP
+        tv_names = {m for m in dir(tv) if not m.startswith("_") and m[0].islower()}
+        missing = pv_names - tv_names
+        self.assertEqual(missing, set(),
+                         f"Missing module-level names: {missing}")
+
+
+@unittest.skipUnless(HAS_PV, "pyvinecopulib not installed")
+class TestFamilyEnumParity(unittest.TestCase):
+    """BicopFamily enum should contain all pyvinecopulib families except student."""
+
+    def test_families_match(self):
+        pv_fams = {f.name for f in pv.BicopFamily} - {"student"}
+        tv_fams = {f.name for f in tv.BicopFamily}
+        self.assertEqual(pv_fams, tv_fams)
+
+
+if __name__ == "__main__":
+    unittest.main()