pyconvexity 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

pyconvexity/data/schema/04_scenario_schema.sql

@@ -0,0 +1,122 @@
+-- ============================================================================
+-- SCENARIO-AWARE ATTRIBUTES AND CONSTRAINTS SCHEMA
+-- Support for multiple scenarios within networks and Python constraint execution
+-- Version 1.0.0
+-- ============================================================================
+
+-- ============================================================================
+-- SCENARIOS TABLE
+-- ============================================================================
+
+-- Scenarios table - represents different modeling scenarios within a network
+-- The "Main" scenario is the master scenario (explicit, not implicit)
+-- "Master" refers to the fact that this is the main reference scenario
+CREATE TABLE scenarios (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    network_id INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    description TEXT,
+    is_master BOOLEAN DEFAULT FALSE,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    
+    CONSTRAINT fk_scenarios_network 
+        FOREIGN KEY (network_id) REFERENCES networks(id) ON DELETE CASCADE,
+    CONSTRAINT uq_scenarios_network_name 
+        UNIQUE (network_id, name)
+);
+
+-- Index for efficient scenario lookups
+CREATE INDEX idx_scenarios_network ON scenarios(network_id);
+CREATE INDEX idx_scenarios_master ON scenarios(is_master);
+
+-- ============================================================================
+-- SCENARIO MANAGEMENT TRIGGERS
+-- ============================================================================
+
+-- Ensure exactly one master scenario per network
+CREATE TRIGGER ensure_single_master_scenario
+    BEFORE INSERT ON scenarios
+    FOR EACH ROW
+    WHEN NEW.is_master = TRUE
+BEGIN
+    UPDATE scenarios 
+    SET is_master = FALSE 
+    WHERE network_id = NEW.network_id AND is_master = TRUE;
+END;
+
+-- Ensure exactly one master scenario per network on update
+CREATE TRIGGER ensure_single_master_scenario_update
+    BEFORE UPDATE ON scenarios
+    FOR EACH ROW
+    WHEN NEW.is_master = TRUE AND OLD.is_master = FALSE
+BEGIN
+    UPDATE scenarios 
+    SET is_master = FALSE 
+    WHERE network_id = NEW.network_id AND is_master = TRUE AND id != NEW.id;
+END;
+
+-- Prevent deletion of master scenario
+CREATE TRIGGER prevent_master_scenario_deletion
+    BEFORE DELETE ON scenarios
+    FOR EACH ROW
+    WHEN OLD.is_master = TRUE
+BEGIN
+    SELECT RAISE(ABORT, 'Cannot delete master scenario');
+END;
+
+-- ============================================================================
+-- SCENARIO UTILITY FUNCTIONS
+-- ============================================================================
+
+-- Create a view for easy attribute resolution with scenario inheritance
+CREATE VIEW component_attributes_with_scenario AS
+SELECT 
+    ca.component_id,
+    ca.attribute_name,
+    ca.storage_type,
+    ca.static_value,
+    ca.timeseries_data,
+    ca.data_type,
+    ca.unit,
+    ca.is_input,
+    COALESCE(ca.scenario_id, 0) as scenario_id,
+    CASE 
+        WHEN ca.scenario_id IS NULL THEN 'Main'
+        ELSE s.name
+    END as scenario_name,
+    ca.created_at,
+    ca.updated_at
+FROM component_attributes ca
+LEFT JOIN scenarios s ON ca.scenario_id = s.id;
+
+-- ============================================================================
+-- AUTOMATIC MASTER SCENARIO CREATION
+-- ============================================================================
+
+-- Trigger to automatically create "Main" scenario (the master scenario) when a network is created
+-- This ensures every network has exactly one master scenario that serves as the main reference
+CREATE TRIGGER create_master_scenario_for_network
+    AFTER INSERT ON networks
+    FOR EACH ROW
+BEGIN
+    INSERT INTO scenarios (network_id, name, description, is_master)
+    VALUES (NEW.id, 'Main', 'Main scenario (default)', TRUE);
+END;
+
+-- ============================================================================
+-- COMPONENT VALIDATION FOR CONSTRAINT
+-- ============================================================================
+
+-- Note: CONSTRAINT components can have NULL carrier_id - this is now enforced
+-- by the CHECK constraint in the components table schema
+
+-- ============================================================================
+-- INITIALIZATION
+-- ============================================================================
+
+-- This schema extends the existing core schema with scenario support
+-- "Main" scenarios (master scenarios) are automatically created for existing networks
+INSERT INTO scenarios (network_id, name, description, is_master)
+SELECT id, 'Main', 'Main scenario (default)', TRUE
+FROM networks
+WHERE id NOT IN (SELECT network_id FROM scenarios WHERE is_master = TRUE); 

pyconvexity/models/attributes.py

@@ -334,7 +334,9 @@ def serialize_timeseries_to_parquet(timeseries: List[TimeseriesPoint]) -> bytes:
     
     if not timeseries:
         # Return empty parquet file with correct schema
-        table = pa.table([], schema=schema)
+        empty_period_array = pa.array([], type=pa.int32())
+        empty_value_array = pa.array([], type=pa.float64())
+        table = pa.table([empty_period_array, empty_value_array], schema=schema)
     else:
         # Create PyArrow table with EXPLICIT schema to ensure data types match Rust
         period_indices = [p.period_index for p in timeseries]

{pyconvexity-0.1.0.dist-info → pyconvexity-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyconvexity
-Version: 0.1.0
+Version: 0.1.2
 Summary: Python library for energy system modeling and optimization with PyPSA
 Author-email: Convexity Team <info@convexity.com>
 License: MIT

pyconvexity-0.1.2.dist-info/RECORD

@@ -0,0 +1,20 @@
+pyconvexity/__init__.py,sha256=mEtafBwQ1A9s-hEv3o3XeXlJ7iFtbdS691wVUUw5miY,3303
+pyconvexity/_version.py,sha256=Cu2pGbVzHvik6YUUC3R9lxs9dHnXZq1Uj0YfLLblLUs,133
+pyconvexity/core/__init__.py,sha256=4SYAE4zqzGIRFSP4IoT7EzK-LCTB1HLe9EWhfi2aUmU,1253
+pyconvexity/core/database.py,sha256=4OW1sgwDT4ltxdW6b250ytTlsC9sk26Rz0VrveXSL4A,9605
+pyconvexity/core/errors.py,sha256=HhrrOOEBJrzyB56_pmqh3NWvX6uHqWWNkdE5XM16rYI,2881
+pyconvexity/core/types.py,sha256=eoVOAcDJWzjJKO9lYN7O17Us0XbahBpVBwv6uxdldh0,8508
+pyconvexity/data/schema/01_core_schema.sql,sha256=Vt6vASZEASPPQYuhtsARLj3PxP7VdZtfxmGcs-Id-xc,18785
+pyconvexity/data/schema/02_data_metadata.sql,sha256=9E7tnBBu0wc4w3YijyPf_vG_8KVFyu7cu59TyAP5F94,21818
+pyconvexity/data/schema/03_validation_data.sql,sha256=1rKFi9y6jQ2OnfH32jnIKnZ5WtB8eG43hz0OVJhwn3w,58325
+pyconvexity/data/schema/04_scenario_schema.sql,sha256=sL4PySJNHIthXsnoJ2T5pdXUbpAi94ld0XGuU8LwNuQ,4641
+pyconvexity/models/__init__.py,sha256=eVwf0ZTTEq1nM9M3NSMvj2yLPUOPNKMXv2A5GLT34-c,1470
+pyconvexity/models/attributes.py,sha256=gh02j_hpSeyCNg0Jt20i7Y7wOntajnuzI926W5wzA3Q,14130
+pyconvexity/models/components.py,sha256=K7QWelMVU_D18skvBZbap9dxP2AMS2116fcpmemkE6U,14629
+pyconvexity/models/network.py,sha256=-itmot8StUdXogDpZUhGVIUC5uAEucYQ1LiTN1vPdA4,12923
+pyconvexity/validation/__init__.py,sha256=_6SVqXkaDFqmagub_O064Zm_QIdBrOra-Gvvbo9vM4I,549
+pyconvexity/validation/rules.py,sha256=bshO2Ibw8tBurg708Dmf79rIBoGV32t-jNHltjap9Pw,9323
+pyconvexity-0.1.2.dist-info/METADATA,sha256=Lmk43_bNLN4jVbnqynhutZq9sK29vywiwbKBFjAWL7M,4751
+pyconvexity-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyconvexity-0.1.2.dist-info/top_level.txt,sha256=wFPEDXVaebR3JO5Tt3HNse-ws5aROCcxEco15d6j64s,12
+pyconvexity-0.1.2.dist-info/RECORD,,

pyconvexity-0.1.0.dist-info/RECORD

@@ -1,16 +0,0 @@
-pyconvexity/__init__.py,sha256=mEtafBwQ1A9s-hEv3o3XeXlJ7iFtbdS691wVUUw5miY,3303
-pyconvexity/_version.py,sha256=5CA6z91JO_fS9ADhN6383Ps_rUNBx3K4gJNbVRJmeYY,133
-pyconvexity/core/__init__.py,sha256=4SYAE4zqzGIRFSP4IoT7EzK-LCTB1HLe9EWhfi2aUmU,1253
-pyconvexity/core/database.py,sha256=zqurVzPGuWei0jII1PTMAY-qaR-fr_A7uLxm__6KIlE,9276
-pyconvexity/core/errors.py,sha256=HhrrOOEBJrzyB56_pmqh3NWvX6uHqWWNkdE5XM16rYI,2881
-pyconvexity/core/types.py,sha256=eoVOAcDJWzjJKO9lYN7O17Us0XbahBpVBwv6uxdldh0,8508
-pyconvexity/models/__init__.py,sha256=eVwf0ZTTEq1nM9M3NSMvj2yLPUOPNKMXv2A5GLT34-c,1470
-pyconvexity/models/attributes.py,sha256=I6t1x7HX1gLw_lA6K87_GGmLAO34fpe4ZDX7_3LzMx4,13974
-pyconvexity/models/components.py,sha256=K7QWelMVU_D18skvBZbap9dxP2AMS2116fcpmemkE6U,14629
-pyconvexity/models/network.py,sha256=-itmot8StUdXogDpZUhGVIUC5uAEucYQ1LiTN1vPdA4,12923
-pyconvexity/validation/__init__.py,sha256=_6SVqXkaDFqmagub_O064Zm_QIdBrOra-Gvvbo9vM4I,549
-pyconvexity/validation/rules.py,sha256=bshO2Ibw8tBurg708Dmf79rIBoGV32t-jNHltjap9Pw,9323
-pyconvexity-0.1.0.dist-info/METADATA,sha256=ltUWa115nNRTIAl4xbzFDjC2s9Q5LOhJcJHwMBS6ea4,4751
-pyconvexity-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pyconvexity-0.1.0.dist-info/top_level.txt,sha256=wFPEDXVaebR3JO5Tt3HNse-ws5aROCcxEco15d6j64s,12
-pyconvexity-0.1.0.dist-info/RECORD,,