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

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

@@ -1,182 +1,182 @@
-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.
+Metadata-Version: 2.4
+Name: ins_pricing
+Version: 0.5.0
+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 → ins_pricing-0.5.0}/ins_pricing/README.md

@@ -7,12 +7,13 @@ 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).
+- `cli/`: CLI entry points and shared utilities.
+- `modelling/`
+  - `bayesopt/`: BayesOpt training core (GLM / XGB / ResNet / FT / GNN).
+  - `plotting/`: model-agnostic curves and geo visualizations.
+  - `explain/`: permutation, gradients, and SHAP helpers.
+  - `evaluation.py`: calibration, metrics, and evaluation utilities.
+- `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.
@@ -31,29 +32,54 @@ between modelling, production, governance, and reporting.
    - `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`
+5. Production and governance
+   - `from ins_pricing.production import batch_score, psi_report`
+   - Inference: `from ins_pricing.production import load_predictor_from_config`
+   - `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.
+## 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`.
+- 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`.
+  - Inference: `torch` only when loading FT/ResNet/GNN models.
+
+## Inference interface (new)
+
+- `production.inference` provides a small registry-based interface so inference
+  does not hard-code model loaders:
+  - `ModelSpec` describes the saved model location and config.
+  - `PredictorRegistry` lets you plug in custom model loaders.
+  - `load_predictor_from_config` remains backward compatible.
+
+Example:
+
+```
+from ins_pricing.production import load_predictor_from_config
+
+predictor = load_predictor_from_config(
+    "config.json",
+    "resn",
+    device="cuda",  # or "mps"/"cpu"
+)
+preds = predictor.predict(df)
+```
 
-## Multi-platform and GPU notes
+## 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.
+- 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.
+  CLI usage prefers `python -m ins_pricing.cli.BayesOpt_entry ...` but the
+  direct script path (`python ins_pricing/cli/BayesOpt_entry.py ...`) still works.
 
 ## Backward-compatible imports