pyconvexity 0.4.3__tar.gz → 0.4.6.post1__tar.gz

pyconvexity-0.4.6.post1/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: pyconvexity
+Version: 0.4.6.post1
+Summary: Python library for energy system modeling and optimization with PyPSA
+Author-email: Convexity Team <info@convexity.com>
+License: MIT
+Project-URL: Homepage, https://github.com/bayesian-energy/pyconvexity
+Project-URL: Repository, https://github.com/bayesian-energy/pyconvexity
+Project-URL: Issues, https://github.com/bayesian-energy/pyconvexity/issues
+Project-URL: Documentation, https://pyconvexity.readthedocs.io
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Scientific/Engineering
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pyarrow>=10.0.0
+Provides-Extra: pypsa
+Requires-Dist: pypsa>=0.25.0; extra == "pypsa"
+Requires-Dist: networkx; extra == "pypsa"
+Requires-Dist: scipy; extra == "pypsa"
+Requires-Dist: xarray; extra == "pypsa"
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.0.0; extra == "excel"
+Requires-Dist: xlsxwriter>=3.0.0; extra == "excel"
+Provides-Extra: netcdf
+Requires-Dist: netcdf4>=1.6.0; extra == "netcdf"
+Requires-Dist: xarray>=2022.3.0; extra == "netcdf"
+Provides-Extra: data
+Requires-Dist: country-converter>=1.0.0; extra == "data"
+Requires-Dist: pyyaml>=6.0.0; extra == "data"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=2.20.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: pyconvexity[data,excel,netcdf,pypsa]; extra == "all"
+
+# pyconvexity
+
+Python library for energy system modeling and optimization with PyPSA.
+
+[![PyPI version](https://badge.fury.io/py/pyconvexity.svg)](https://badge.fury.io/py/pyconvexity)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+pyconvexity is the Python library that powers [Convexity](https://bayesian.energy/convexity), providing programmatic access to energy system modeling and optimization. It stores models in SQLite databases and integrates with PyPSA for solving.
+
+## Installation
+
+```bash
+pip install pyconvexity
+```
+
+With optional dependencies:
+
+```bash
+pip install pyconvexity[pypsa]     # PyPSA solver integration
+pip install pyconvexity[excel]     # Excel import/export
+pip install pyconvexity[all]       # All optional dependencies
+```
+
+## Quick Start
+
+```python
+import pyconvexity as px
+
+# Create a new model database
+px.create_database_with_schema("my_model.db")
+
+# Create a network
+with px.database_context("my_model.db") as conn:
+    network_req = px.CreateNetworkRequest(
+        name="My Network",
+        start_time="2024-01-01 00:00:00",
+        end_time="2024-01-01 23:00:00",
+        time_resolution="PT1H",
+    )
+    px.create_network(conn, network_req)
+    
+    # Create components
+    carrier_id = px.create_carrier(conn, name="AC")
+    bus_id = px.create_component(conn, "BUS", "Main Bus", carrier_id=carrier_id)
+    
+    conn.commit()
+
+# Solve the network
+result = px.solve_network("my_model.db", solver_name="highs")
+print(f"Success: {result['success']}, Objective: {result['objective_value']}")
+```
+
+## Documentation
+
+Full documentation is available at: **[docs.bayesian.energy](https://docs.bayesian.energy/convexity/user-guide/advanced-features/pyconvexity/)**
+
+- [API Reference](https://docs.bayesian.energy/convexity/user-guide/advanced-features/pyconvexity/api/api-reference)
+- [Examples & Tutorials](https://docs.bayesian.energy/convexity/user-guide/advanced-features/pyconvexity/examples/example-1/)
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/bayesian-energy/pyconvexity.git
+cd pyconvexity
+pip install -e ".[dev,all]"
+```
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Documentation Deployment
+
+API documentation is auto-generated and synced to [bayesian-docs](https://github.com/bayesian-energy/bayesian-docs).
+
+**Generate API docs locally:**
+
+```bash
+python scripts/generate_api_docs.py --output-dir api-docs
+```
+
+**How it works:**
+1. On push to `main` or release, the `sync-docs.yml` workflow runs
+2. It generates API markdown from Python docstrings
+3. Commits the generated docs to the `bayesian-docs` repository
+
+**Setup for maintainers:**
+- Add `DOCS_DEPLOY_TOKEN` secret to the repo (personal access token with `repo` scope for bayesian-docs)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+

pyconvexity-0.4.6.post1/README.md

@@ -0,0 +1,100 @@
+# pyconvexity
+
+Python library for energy system modeling and optimization with PyPSA.
+
+[![PyPI version](https://badge.fury.io/py/pyconvexity.svg)](https://badge.fury.io/py/pyconvexity)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+pyconvexity is the Python library that powers [Convexity](https://bayesian.energy/convexity), providing programmatic access to energy system modeling and optimization. It stores models in SQLite databases and integrates with PyPSA for solving.
+
+## Installation
+
+```bash
+pip install pyconvexity
+```
+
+With optional dependencies:
+
+```bash
+pip install pyconvexity[pypsa]     # PyPSA solver integration
+pip install pyconvexity[excel]     # Excel import/export
+pip install pyconvexity[all]       # All optional dependencies
+```
+
+## Quick Start
+
+```python
+import pyconvexity as px
+
+# Create a new model database
+px.create_database_with_schema("my_model.db")
+
+# Create a network
+with px.database_context("my_model.db") as conn:
+    network_req = px.CreateNetworkRequest(
+        name="My Network",
+        start_time="2024-01-01 00:00:00",
+        end_time="2024-01-01 23:00:00",
+        time_resolution="PT1H",
+    )
+    px.create_network(conn, network_req)
+    
+    # Create components
+    carrier_id = px.create_carrier(conn, name="AC")
+    bus_id = px.create_component(conn, "BUS", "Main Bus", carrier_id=carrier_id)
+    
+    conn.commit()
+
+# Solve the network
+result = px.solve_network("my_model.db", solver_name="highs")
+print(f"Success: {result['success']}, Objective: {result['objective_value']}")
+```
+
+## Documentation
+
+Full documentation is available at: **[docs.bayesian.energy](https://docs.bayesian.energy/convexity/user-guide/advanced-features/pyconvexity/)**
+
+- [API Reference](https://docs.bayesian.energy/convexity/user-guide/advanced-features/pyconvexity/api/api-reference)
+- [Examples & Tutorials](https://docs.bayesian.energy/convexity/user-guide/advanced-features/pyconvexity/examples/example-1/)
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/bayesian-energy/pyconvexity.git
+cd pyconvexity
+pip install -e ".[dev,all]"
+```
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Documentation Deployment
+
+API documentation is auto-generated and synced to [bayesian-docs](https://github.com/bayesian-energy/bayesian-docs).
+
+**Generate API docs locally:**
+
+```bash
+python scripts/generate_api_docs.py --output-dir api-docs
+```
+
+**How it works:**
+1. On push to `main` or release, the `sync-docs.yml` workflow runs
+2. It generates API markdown from Python docstrings
+3. Commits the generated docs to the `bayesian-docs` repository
+
+**Setup for maintainers:**
+- Add `DOCS_DEPLOY_TOKEN` secret to the repo (personal access token with `repo` scope for bayesian-docs)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+

{pyconvexity-0.4.3 → pyconvexity-0.4.6.post1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyconvexity"
-version = "0.4.3"
+version = "0.4.6.post1"
 description = "Python library for energy system modeling and optimization with PyPSA"
 readme = "README.md"
 license = {text = "MIT"}
@@ -81,7 +81,7 @@ profile = "black"
 line_length = 88
 
 [tool.mypy]
-python_version = "0.4.3"
+python_version = "0.4.6.post1"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true

pyconvexity-0.4.6.post1/src/pyconvexity/_version.py

@@ -0,0 +1 @@
+__version__ = "0.4.6.post1"

{pyconvexity-0.4.3 → pyconvexity-0.4.6.post1}/src/pyconvexity/data/schema/03_validation_data.sql

@@ -33,7 +33,8 @@ INSERT INTO attribute_validation_rules (component_type, attribute_name, display_
 ('BUS', 'q', 'Reactive Power', 'float', 'MVar', '0', 'timeseries', FALSE, FALSE, 'reactive power (positive if net generation at bus)', NULL, NULL, 'electrical', TRUE),
 ('BUS', 'v_mag_pu', 'Voltage Magnitude', 'float', 'per unit', '1', 'timeseries', FALSE, FALSE, 'Voltage magnitude, per unit of v_nom', NULL, NULL, 'electrical', TRUE),
 ('BUS', 'v_ang', 'Voltage Angle', 'float', 'radians', '0', 'timeseries', FALSE, FALSE, 'Voltage angle', NULL, NULL, 'electrical', TRUE),
-('BUS', 'marginal_price', 'Marginal Price', 'float', 'currency/MWh', '0', 'timeseries', FALSE, FALSE, 'Locational marginal price from LOPF from power balance constraint', NULL, NULL, 'costs', TRUE);
+('BUS', 'marginal_price', 'Marginal Price', 'float', 'currency/MWh', '0', 'timeseries', FALSE, FALSE, 'Locational marginal price from LOPF from power balance constraint', NULL, NULL, 'costs', TRUE),
+('BUS', 'market_price', 'Market Price', 'float', 'currency/MWh', '0', 'timeseries', FALSE, FALSE, 'Custom calculated market price for the bus (independent of PyPSA marginal cost)', NULL, NULL, 'costs', TRUE);
 
 -- ============================================================================
 -- GENERATOR ATTRIBUTES  

{pyconvexity-0.4.3 → pyconvexity-0.4.6.post1}/src/pyconvexity/io/netcdf_exporter.py

@@ -3,22 +3,18 @@ NetCDF exporter for PyConvexity energy system models.
 Exports networks to PyPSA NetCDF format using existing PyPSA infrastructure.
 """
 
-import logging
 from typing import Dict, Any, Optional, Callable
 from pathlib import Path
 
 # Import existing PyPSA functionality from pyconvexity
-from pyconvexity.core.database import open_connection
 from pyconvexity.solvers.pypsa import build_pypsa_network
 
-logger = logging.getLogger(__name__)
-
 
 class NetCDFModelExporter:
     """Export network model to PyPSA NetCDF format"""
 
     def __init__(self):
-        self.logger = logging.getLogger(__name__)
+        pass
 
     def export_to_netcdf(
         self,
@@ -78,7 +74,6 @@ class NetCDFModelExporter:
             }
 
         except Exception as e:
-            self.logger.error(f"NetCDF export failed: {e}", exc_info=True)
             if progress_callback:
                 progress_callback(None, f"Export failed: {str(e)}")
             raise
@@ -141,7 +136,6 @@ class NetCDFModelExporter:
             }
 
         except Exception as e:
-            self.logger.error(f"CSV export failed: {e}", exc_info=True)
             if progress_callback:
                 progress_callback(None, f"Export failed: {str(e)}")
             raise