ins-pricing 0.4.4__tar.gz → 0.4.5__tar.gz

{ins_pricing-0.4.4 → ins_pricing-0.4.5}/MANIFEST.in

@@ -1,3 +1,3 @@
-include README.md
-recursive-include ins_pricing *.md
-recursive-exclude ins_pricing/examples *
+include README.md
+recursive-include ins_pricing *.md
+recursive-exclude examples *

{ins_pricing-0.4.4 → ins_pricing-0.4.5}/PKG-INFO

@@ -1,162 +1,182 @@
-Metadata-Version: 2.4
-Name: ins_pricing
-Version: 0.4.4
-Summary: Reusable modelling, pricing, governance, and reporting utilities.
-Author: meishi125478
-License: Proprietary
-Keywords: pricing,insurance,bayesopt,ml
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-Classifier: License :: Other/Proprietary License
-Classifier: Operating System :: OS Independent
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: numpy>=1.20
-Requires-Dist: pandas>=1.4
-Provides-Extra: bayesopt
-Requires-Dist: torch>=1.13; extra == "bayesopt"
-Requires-Dist: optuna>=3.0; extra == "bayesopt"
-Requires-Dist: xgboost>=1.6; extra == "bayesopt"
-Requires-Dist: scikit-learn>=1.1; extra == "bayesopt"
-Requires-Dist: statsmodels>=0.13; extra == "bayesopt"
-Requires-Dist: joblib>=1.2; extra == "bayesopt"
-Requires-Dist: matplotlib>=3.5; extra == "bayesopt"
-Provides-Extra: plotting
-Requires-Dist: matplotlib>=3.5; extra == "plotting"
-Requires-Dist: scikit-learn>=1.1; extra == "plotting"
-Provides-Extra: explain
-Requires-Dist: torch>=1.13; extra == "explain"
-Requires-Dist: shap>=0.41; extra == "explain"
-Requires-Dist: scikit-learn>=1.1; extra == "explain"
-Provides-Extra: geo
-Requires-Dist: contextily>=1.3; extra == "geo"
-Requires-Dist: matplotlib>=3.5; extra == "geo"
-Provides-Extra: gnn
-Requires-Dist: torch>=1.13; extra == "gnn"
-Requires-Dist: pynndescent>=0.5; extra == "gnn"
-Requires-Dist: torch-geometric>=2.3; extra == "gnn"
-Provides-Extra: all
-Requires-Dist: torch>=1.13; extra == "all"
-Requires-Dist: optuna>=3.0; extra == "all"
-Requires-Dist: xgboost>=1.6; extra == "all"
-Requires-Dist: scikit-learn>=1.1; extra == "all"
-Requires-Dist: statsmodels>=0.13; extra == "all"
-Requires-Dist: joblib>=1.2; extra == "all"
-Requires-Dist: matplotlib>=3.5; extra == "all"
-Requires-Dist: shap>=0.41; extra == "all"
-Requires-Dist: contextily>=1.3; extra == "all"
-Requires-Dist: pynndescent>=0.5; extra == "all"
-Requires-Dist: torch-geometric>=2.3; extra == "all"
-
-# Insurance-Pricing
-
-A reusable toolkit for insurance modeling, pricing, governance, and reporting.
-
-## Overview
-
-Insurance-Pricing (ins_pricing) is an enterprise-grade Python library designed for machine learning model training, pricing calculations, and model governance workflows in the insurance industry.
-
-### Core Modules
-
-| Module | Description |
-|--------|-------------|
-| **modelling** | ML model training (GLM, XGBoost, ResNet, FT-Transformer, GNN) and model interpretability (SHAP, permutation importance) |
-| **pricing** | Factor table construction, numeric binning, premium calibration, exposure calculation, PSI monitoring |
-| **production** | Model prediction, batch scoring, data drift detection, production metrics monitoring |
-| **governance** | Model registry, version management, approval workflows, audit logging |
-| **reporting** | Report generation (Markdown format), report scheduling |
-| **utils** | Data validation, performance profiling, device management, logging configuration |
-
-### Quick Start
-
-```python
-# Model training with Bayesian optimization
-from ins_pricing import bayesopt as ropt
-
-model = ropt.BayesOptModel(
-    train_data, test_data,
-    model_name='my_model',
-    resp_nme='target',
-    weight_nme='weight',
-    factor_nmes=feature_list,
-    cate_list=categorical_features,
-)
-model.bayesopt_xgb(max_evals=100)      # Train XGBoost
-model.bayesopt_resnet(max_evals=50)    # Train ResNet
-model.bayesopt_ft(max_evals=50)        # Train FT-Transformer
-
-# Pricing: build factor table
-from ins_pricing.pricing import build_factor_table
-factors = build_factor_table(
-    df,
-    factor_col='age_band',
-    loss_col='claim_amount',
-    exposure_col='exposure',
-)
-
-# Production: batch scoring
-from ins_pricing.production import batch_score
-scores = batch_score(model.trainers['xgb'].predict, df)
-
-# Model governance
-from ins_pricing.governance import ModelRegistry
-registry = ModelRegistry('models.json')
-registry.register(model_name, version, metrics=metrics)
-```
-
-### Project Structure
-
-```
-ins_pricing/
-├── cli/                    # Command-line entry points
-├── modelling/
-│   ├── core/bayesopt/     # ML model training core
-│   ├── explain/           # Model interpretability
-│   └── plotting/          # Model visualization
-├── pricing/               # Insurance pricing module
-├── production/            # Production deployment module
-├── governance/            # Model governance
-├── reporting/             # Report generation
-├── utils/                 # Utilities
-└── tests/                 # Test suite
-```
-
-### Installation
-
-```bash
-# Basic installation
-pip install ins_pricing
-
-# Full installation (all optional dependencies)
-pip install ins_pricing[all]
-
-# Install specific extras
-pip install ins_pricing[bayesopt]    # Model training
-pip install ins_pricing[explain]     # Model explanation
-pip install ins_pricing[plotting]    # Visualization
-pip install ins_pricing[gnn]         # Graph neural networks
-```
-
-#### Multi-platform & GPU installation notes
-
-- **PyTorch (CPU/GPU/MPS)**: Install the correct PyTorch build for your platform/GPU first (CUDA on
-  Linux/Windows, ROCm on supported AMD platforms, or MPS on Apple Silicon). Then install the
-  optional extras you need (e.g., `bayesopt`, `explain`, or `gnn`). This avoids pip pulling a
-  mismatched wheel.
-- **Torch Geometric (GNN)**: `torch-geometric` often requires platform-specific wheels (e.g.,
-  `torch-scatter`, `torch-sparse`). Follow the official PyG installation instructions for your
-  CUDA/ROCm/CPU environment, then install `ins_pricing[gnn]`.
-- **Multi-GPU**: Training code will use CUDA when available and can enable multi-GPU via
-  `torch.distributed`/`DataParallel` where supported. On Windows, CUDA DDP is not supported and will
-  fall back to single-GPU or DataParallel where possible.
-
-### Requirements
-
-- Python >= 3.9
-- Core dependencies: numpy >= 1.20, pandas >= 1.4
-
-### License
-
-Proprietary
+Metadata-Version: 2.4
+Name: ins_pricing
+Version: 0.4.5
+Summary: Reusable modelling, pricing, governance, and reporting utilities.
+Author: meishi125478
+License: Proprietary
+Keywords: pricing,insurance,bayesopt,ml
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: numpy>=1.20
+Requires-Dist: pandas>=1.4
+Provides-Extra: bayesopt
+Requires-Dist: torch>=1.13; extra == "bayesopt"
+Requires-Dist: optuna>=3.0; extra == "bayesopt"
+Requires-Dist: xgboost>=1.6; extra == "bayesopt"
+Requires-Dist: scikit-learn>=1.1; extra == "bayesopt"
+Requires-Dist: statsmodels>=0.13; extra == "bayesopt"
+Requires-Dist: joblib>=1.2; extra == "bayesopt"
+Requires-Dist: matplotlib>=3.5; extra == "bayesopt"
+Provides-Extra: plotting
+Requires-Dist: matplotlib>=3.5; extra == "plotting"
+Requires-Dist: scikit-learn>=1.1; extra == "plotting"
+Provides-Extra: explain
+Requires-Dist: torch>=1.13; extra == "explain"
+Requires-Dist: shap>=0.41; extra == "explain"
+Requires-Dist: scikit-learn>=1.1; extra == "explain"
+Provides-Extra: geo
+Requires-Dist: contextily>=1.3; extra == "geo"
+Requires-Dist: matplotlib>=3.5; extra == "geo"
+Provides-Extra: gnn
+Requires-Dist: torch>=1.13; extra == "gnn"
+Requires-Dist: pynndescent>=0.5; extra == "gnn"
+Requires-Dist: torch-geometric>=2.3; extra == "gnn"
+Provides-Extra: all
+Requires-Dist: torch>=1.13; extra == "all"
+Requires-Dist: optuna>=3.0; extra == "all"
+Requires-Dist: xgboost>=1.6; extra == "all"
+Requires-Dist: scikit-learn>=1.1; extra == "all"
+Requires-Dist: statsmodels>=0.13; extra == "all"
+Requires-Dist: joblib>=1.2; extra == "all"
+Requires-Dist: matplotlib>=3.5; extra == "all"
+Requires-Dist: shap>=0.41; extra == "all"
+Requires-Dist: contextily>=1.3; extra == "all"
+Requires-Dist: pynndescent>=0.5; extra == "all"
+Requires-Dist: torch-geometric>=2.3; extra == "all"
+
+# Insurance-Pricing
+
+A reusable toolkit for insurance modeling, pricing, governance, and reporting.
+
+## Overview
+
+Insurance-Pricing (ins_pricing) is an enterprise-grade Python library designed for machine learning
+model training, pricing calculations, and model governance workflows in the insurance industry.
+
+### Core Modules
+
+| Module | Description |
+|--------|-------------|
+| modelling | ML model training (GLM, XGBoost, ResNet, FT-Transformer, GNN) and model interpretability |
+| pricing | Factor table construction, numeric binning, premium calibration, exposure calculation, PSI monitoring |
+| production | Model prediction, batch scoring, data drift detection, production metrics monitoring |
+| governance | Model registry, version management, approval workflows, audit logging |
+| reporting | Report generation (Markdown format), report scheduling |
+| utils | Data validation, performance profiling, device management, logging configuration |
+
+### Quick Start
+
+```python
+# Model training with Bayesian optimization
+from ins_pricing import bayesopt as ropt
+
+model = ropt.BayesOptModel(
+    train_data, test_data,
+    model_name='my_model',
+    resp_nme='target',
+    weight_nme='weight',
+    factor_nmes=feature_list,
+    cate_list=categorical_features,
+)
+model.bayesopt_xgb(max_evals=100)      # Train XGBoost
+model.bayesopt_resnet(max_evals=50)    # Train ResNet
+model.bayesopt_ft(max_evals=50)        # Train FT-Transformer
+
+# Pricing: build factor table
+from ins_pricing.pricing import build_factor_table
+factors = build_factor_table(
+    df,
+    factor_col='age_band',
+    loss_col='claim_amount',
+    exposure_col='exposure',
+)
+
+# Production: batch scoring
+from ins_pricing.production import batch_score
+scores = batch_score(model.trainers['xgb'].predict, df)
+
+# Model governance
+from ins_pricing.governance import ModelRegistry
+registry = ModelRegistry('models.json')
+registry.register(model_name, version, metrics=metrics)
+```
+
+### Project Structure
+
+```
+ins_pricing/
+  cli/                    # Command-line entry points
+  modelling/
+    core/bayesopt/         # ML model training core
+    explain/               # Model interpretability
+    plotting/              # Model visualization
+  pricing/                 # Insurance pricing module
+  production/              # Production deployment module
+  governance/              # Model governance
+  reporting/               # Report generation
+  utils/                   # Utilities
+  tests/                   # Test suite
+```
+
+### Installation
+
+```bash
+# Basic installation
+pip install ins_pricing
+
+# Full installation (all optional dependencies)
+pip install ins_pricing[all]
+
+# Install specific extras
+pip install ins_pricing[bayesopt]    # Model training
+pip install ins_pricing[explain]     # Model explanation
+pip install ins_pricing[plotting]    # Visualization
+pip install ins_pricing[gnn]         # Graph neural networks
+```
+
+#### Multi-platform and GPU notes
+
+- Install the correct PyTorch build for your platform/GPU before installing extras.
+- Torch Geometric requires platform-specific wheels; follow the official PyG install guide.
+- Multi-GPU uses torch.distributed/DataParallel where supported; Windows disables CUDA DDP.
+
+---
+## PyPI Upload (scripts)
+
+This repo includes upload scripts for Windows and Linux/macOS.
+
+### Windows
+
+```cmd
+set TWINE_PASSWORD=your_pypi_token_here
+python -m build
+upload_to_pypi.bat
+```
+
+### Linux / macOS
+
+```bash
+chmod +x upload_to_pypi.sh
+export TWINE_PASSWORD='your_pypi_token_here'
+python -m build
+./upload_to_pypi.sh
+```
+
+### Makefile (if make is available)
+
+```bash
+make build
+make upload
+```
+
+### Tips
+
+- Never commit tokens to version control.
+- Use environment variables or secret managers to store credentials.
+- Test with TestPyPI before publishing when needed.

ins_pricing-0.4.5/README.md

@@ -0,0 +1,130 @@
+# Insurance-Pricing
+
+A reusable toolkit for insurance modeling, pricing, governance, and reporting.
+
+## Overview
+
+Insurance-Pricing (ins_pricing) is an enterprise-grade Python library designed for machine learning
+model training, pricing calculations, and model governance workflows in the insurance industry.
+
+### Core Modules
+
+| Module | Description |
+|--------|-------------|
+| modelling | ML model training (GLM, XGBoost, ResNet, FT-Transformer, GNN) and model interpretability |
+| pricing | Factor table construction, numeric binning, premium calibration, exposure calculation, PSI monitoring |
+| production | Model prediction, batch scoring, data drift detection, production metrics monitoring |
+| governance | Model registry, version management, approval workflows, audit logging |
+| reporting | Report generation (Markdown format), report scheduling |
+| utils | Data validation, performance profiling, device management, logging configuration |
+
+### Quick Start
+
+```python
+# Model training with Bayesian optimization
+from ins_pricing import bayesopt as ropt
+
+model = ropt.BayesOptModel(
+    train_data, test_data,
+    model_name='my_model',
+    resp_nme='target',
+    weight_nme='weight',
+    factor_nmes=feature_list,
+    cate_list=categorical_features,
+)
+model.bayesopt_xgb(max_evals=100)      # Train XGBoost
+model.bayesopt_resnet(max_evals=50)    # Train ResNet
+model.bayesopt_ft(max_evals=50)        # Train FT-Transformer
+
+# Pricing: build factor table
+from ins_pricing.pricing import build_factor_table
+factors = build_factor_table(
+    df,
+    factor_col='age_band',
+    loss_col='claim_amount',
+    exposure_col='exposure',
+)
+
+# Production: batch scoring
+from ins_pricing.production import batch_score
+scores = batch_score(model.trainers['xgb'].predict, df)
+
+# Model governance
+from ins_pricing.governance import ModelRegistry
+registry = ModelRegistry('models.json')
+registry.register(model_name, version, metrics=metrics)
+```
+
+### Project Structure
+
+```
+ins_pricing/
+  cli/                    # Command-line entry points
+  modelling/
+    core/bayesopt/         # ML model training core
+    explain/               # Model interpretability
+    plotting/              # Model visualization
+  pricing/                 # Insurance pricing module
+  production/              # Production deployment module
+  governance/              # Model governance
+  reporting/               # Report generation
+  utils/                   # Utilities
+  tests/                   # Test suite
+```
+
+### Installation
+
+```bash
+# Basic installation
+pip install ins_pricing
+
+# Full installation (all optional dependencies)
+pip install ins_pricing[all]
+
+# Install specific extras
+pip install ins_pricing[bayesopt]    # Model training
+pip install ins_pricing[explain]     # Model explanation
+pip install ins_pricing[plotting]    # Visualization
+pip install ins_pricing[gnn]         # Graph neural networks
+```
+
+#### Multi-platform and GPU notes
+
+- Install the correct PyTorch build for your platform/GPU before installing extras.
+- Torch Geometric requires platform-specific wheels; follow the official PyG install guide.
+- Multi-GPU uses torch.distributed/DataParallel where supported; Windows disables CUDA DDP.
+
+---
+## PyPI Upload (scripts)
+
+This repo includes upload scripts for Windows and Linux/macOS.
+
+### Windows
+
+```cmd
+set TWINE_PASSWORD=your_pypi_token_here
+python -m build
+upload_to_pypi.bat
+```
+
+### Linux / macOS
+
+```bash
+chmod +x upload_to_pypi.sh
+export TWINE_PASSWORD='your_pypi_token_here'
+python -m build
+./upload_to_pypi.sh
+```
+
+### Makefile (if make is available)
+
+```bash
+make build
+make upload
+```
+
+### Tips
+
+- Never commit tokens to version control.
+- Use environment variables or secret managers to store credentials.
+- Test with TestPyPI before publishing when needed.

{ins_pricing-0.4.4 → ins_pricing-0.4.5}/ins_pricing/README.md

@@ -1,74 +1,66 @@
-# Ins-Pricing
-
-Distribution name: Ins-Pricing (import package is `ins_pricing`, legacy alias `user_packages` still works).
-
-Reusable modelling and pricing utilities organized as a small toolbox with clear boundaries
-between modelling, production, governance, and reporting.
-
-## Architecture
-
-- `cli/`: CLI entry points + shared utilities.
-- `modelling/`
-  - `core/`: BayesOpt training core (GLM / XGB / ResNet / FT / GNN).
-  - `plotting/`: model-agnostic curves and geo visualizations.
-  - `explain/`: permutation, gradients, and SHAP helpers.
-- `docs/modelling/`: modelling documentation.
-- `examples/modelling/`: demo configs + notebooks (repo only; not packaged).
-- `pricing/`: factor tables, calibration, exposure, monitoring.
-- `production/`: scoring, metrics, drift/PSI.
-- `governance/`: registry, release, audit, approval workflow.
-- `reporting/`: report builder + scheduler.
-
-## Call flow (typical)
-
-1. Model training
-   - Python API: `from ins_pricing.modelling import BayesOptModel`
-   - CLI: `python ins_pricing/cli/BayesOpt_entry.py --config-json ...`
-2. Evaluation & visualization
-   - Curves: `from ins_pricing.plotting import curves`
-   - Importance: `from ins_pricing.plotting import importance`
-   - Geo: `from ins_pricing.plotting import geo`
-3. Explainability
-   - `from ins_pricing.explain import permutation_importance, integrated_gradients_torch`
-4. Pricing loop
-   - `from ins_pricing.pricing import build_factor_table, rate_premium`
-5. Production & governance
-   - `from ins_pricing.production import batch_score, psi_report`
-   - `from ins_pricing.governance import ModelRegistry, ReleaseManager`
-6. Reporting
-   - `from ins_pricing.reporting import build_report, write_report, schedule_daily`
-
-## Import notes
-
-- `ins_pricing` exposes lightweight lazy imports so that `pricing/production/governance`
-  can be used without installing heavy ML dependencies.
-- Migration note: CLI entry points now live under `ins_pricing/cli/` and demo assets are under
-  `ins_pricing/examples/modelling/`. Update any scripts that referenced `ins_pricing/modelling/cli/*` or
-  `ins_pricing/modelling/examples/*`.
-- Demo notebooks/configs live in the repo under `ins_pricing/examples/modelling/` and are not shipped in the PyPI package.
-- Heavy dependencies are only required when you import or use the related modules:
-  - BayesOpt: `torch`, `optuna`, `xgboost`, etc.
-  - Explain: `torch` (gradients), `shap` (SHAP).
-  - Geo plotting on basemap: `contextily`.
-  - Plotting: `matplotlib`.
-
-## Multi-platform & GPU installation notes
-
-- **Install PyTorch first**: Use the correct PyTorch build for your platform/GPU (CUDA/ROCm/MPS)
-  before installing the `bayesopt`, `explain`, or `gnn` extras. This avoids incompatible wheels.
-- **GNN dependencies**: `torch-geometric` and its companion packages are platform-specific. Follow
-  the official PyG install guide for your CUDA/ROCm/CPU environment, then install
-  `ins_pricing[gnn]`.
-- **Multi-GPU**: Training utilities will select CUDA/MPS/CPU automatically. Multi-GPU uses DDP or
-  DataParallel when supported; on Windows, CUDA DDP is disabled and will fall back to single-GPU or
-  DataParallel where available.
-
-## Backward-compatible imports
-
-Legacy import paths continue to work:
-
-- `import user_packages`
-- `import user_packages.bayesopt`
-- `import user_packages.plotting`
-- `import user_packages.explain`
-- `import user_packages.BayesOpt`
+# ins_pricing
+
+Distribution name: ins_pricing (import package is `ins_pricing`; legacy alias `user_packages` still works).
+
+Reusable modelling and pricing utilities organized as a small toolbox with clear boundaries
+between modelling, production, governance, and reporting.
+
+## Architecture
+
+- `cli/`: CLI entry points and shared utilities.
+- `modelling/`
+  - `core/`: BayesOpt training core (GLM / XGB / ResNet / FT / GNN).
+  - `plotting/`: model-agnostic curves and geo visualizations.
+  - `explain/`: permutation, gradients, and SHAP helpers.
+- `examples/`: demo configs and notebooks (repo only; not packaged).
+- `pricing/`: factor tables, calibration, exposure, monitoring.
+- `production/`: scoring, metrics, drift/PSI.
+- `governance/`: registry, approval, audit workflows.
+- `reporting/`: report builder and scheduler.
+
+## Call flow (typical)
+
+1. Model training
+   - Python API: `from ins_pricing.modelling import BayesOptModel`
+   - CLI: `python ins_pricing/cli/BayesOpt_entry.py --config-json ...`
+2. Evaluation and visualization
+   - Curves: `from ins_pricing.plotting import curves`
+   - Importance: `from ins_pricing.plotting import importance`
+   - Geo: `from ins_pricing.plotting import geo`
+3. Explainability
+   - `from ins_pricing.explain import permutation_importance, integrated_gradients_torch`
+4. Pricing loop
+   - `from ins_pricing.pricing import build_factor_table, rate_premium`
+5. Production and governance
+   - `from ins_pricing.production import batch_score, psi_report`
+   - `from ins_pricing.governance import ModelRegistry, ReleaseManager`
+6. Reporting
+   - `from ins_pricing.reporting import build_report, write_report, schedule_daily`
+
+## Import notes
+
+- `ins_pricing` exposes lightweight lazy imports so that pricing/production/governance
+  can be used without installing heavy ML dependencies.
+- Demo notebooks/configs live in the repo under `examples/` and are not shipped
+  in the PyPI package.
+- Heavy dependencies are only required when you import or use the related modules:
+  - BayesOpt: `torch`, `optuna`, `xgboost`, etc.
+  - Explain: `torch` (gradients), `shap` (SHAP).
+  - Geo plotting on basemap: `contextily`.
+  - Plotting: `matplotlib`.
+
+## Multi-platform and GPU notes
+
+- Install the correct PyTorch build for your platform/GPU before installing extras.
+- Torch Geometric requires platform-specific wheels; follow the official PyG install guide.
+- Multi-GPU uses DDP or DataParallel where supported; Windows disables CUDA DDP.
+
+## Backward-compatible imports
+
+Legacy import paths continue to work:
+
+- `import user_packages`
+- `import user_packages.bayesopt`
+- `import user_packages.plotting`
+- `import user_packages.explain`
+- `import user_packages.BayesOpt`