tlpytools 0.2.4__tar.gz → 0.2.5__tar.gz

{tlpytools-0.2.4 → tlpytools-0.2.5}/.env.example

@@ -7,15 +7,16 @@
 # Copy this file to .env and modify the values as needed
 
 # Required Environment Variables for Azure Batch
-BATCH_ACCOUNT_ENDPOINT=https://your-batch-account.your-region.batch.azure.com
+BATCH_ACCOUNT_ENDPOINT=your-batch-account.your-region.batch.azure.com
 BATCH_API_VERSION=2024-07-01.20.0
 IMAGE_REGISTRY_ENDPOINT=your-registry.azurecr.io
 AZURE_SUBSCRIPTION_ID=your-subscription-id
 AZURE_RESOURCE_GROUP=your-resource-group
 MANAGED_IDENTITY_NAME=your-managed-identity
 
-# Azure Data Lake Storage URL
+# Azure Data Lake Storage
 ORCA_ADLS_URL=yourstorageaccount.dfs.core.windows.net
+ORCA_ADLS_CONTAINER=yourcontainer
 
 # Azure SQL Server URI
 TLPT_AZURE_SQL_URI=yoursever.database.windows.net

{tlpytools-0.2.4 → tlpytools-0.2.5}/.github/copilot-instructions.md

@@ -98,8 +98,8 @@ Interpretation for agent PRs:
 
 Observed result:
 - Build succeeds and produces:
-  - `dist/tlpytools-0.2.4.tar.gz`
-  - `dist/tlpytools-0.2.4-py3-none-any.whl`
+  - `dist/tlpytools-0.2.5.tar.gz`
+  - `dist/tlpytools-0.2.5-py3-none-any.whl`
 
 ### 5) Run
 - ORCA CLI (module form):

{tlpytools-0.2.4 → tlpytools-0.2.5}/.github/workflows/deploy.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Version number to release (e.g., 0.2.4)'
+        description: 'Version number to release (e.g., 0.2.5)'
         required: true
         type: string
       prerelease:

{tlpytools-0.2.4 → tlpytools-0.2.5}/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to TLPyTools will be documented in this file.
 
+## [0.2.5]
+
+### Changed
+- **Dependency update:**
+  - Add matplotlib as a dependency with version specifications for compatibility
+- **ADLS configuration moved to environment variables:**
+  - `adls_url` and `adls_container` are no longer read from `operational_mode.cloud` in YAML config
+  - Both are now read exclusively from `ORCA_ADLS_URL` and `ORCA_ADLS_CONTAINER` environment variables; an error is raised at runtime if either is missing
+  - `adls_folder` is now derived solely from the `project_folder` parameter passed to `OrcaOrchestrator`; the `operational_mode.cloud` YAML subsection has been removed from the default config template
+- **Error dump restricted to cloud production mode:**
+  - Error dumps are now only created when `operational_mode.type` is `cloud_production`; they are silently skipped in `local_testing` mode regardless of the `create_error_dump` config setting
+- **Error dump operations log removed:**
+  - `create_error_dump` no longer writes a CSV operations log file; a single `logger.info` message reports the dump path instead
+  - The `export_log` parameter has been removed from `create_error_dump`
+- **Improved model run completion reporting in `print_execution_summary`:**
+  - `[ERROR] MODEL RUN FAILED` — run ended with an error
+  - `[OK] MODEL RUN COMPLETED` — all iterations and steps completed successfully
+  - `[OK] MODEL RUN IS PARTIALLY COMPLETED WITH NO ERRORS` — run stopped cleanly before all iterations were done (e.g. after `run_one_step` or `run_one_iteration`)
+
+### Fixed
+- **Unit test for ADLS config now validates `.env.example`:**
+  - `test_get_adls_config` parses `.env.example` at test time and asserts that `ORCA_ADLS_URL` and `ORCA_ADLS_CONTAINER` are present; the test fails if either variable is removed from the example file
+
 ## [0.2.4]
 
 ### Changed

{tlpytools-0.2.4 → tlpytools-0.2.5}/DEVELOPER_GUIDE.md

@@ -200,7 +200,7 @@ make check-all
 4. Click **"Run workflow"** button
 5. Fill in the required information:
    - **Branch**: Select `main` (or your release branch)
-   - **Version number**: Enter the new version (e.g., `0.2.4`)
+   - **Version number**: Enter the new version (e.g., `0.2.5`)
    - **Is this a pre-release?**: Check if this is a pre-release version
 
 #### 3. Monitor the Release
@@ -219,7 +219,7 @@ After the workflow completes:
 
 ```bash
 # Verify the package is available on PyPI
-pip install tlpytools==0.2.4  # Replace with your version
+pip install tlpytools==0.2.5  # Replace with your version
 
 # Test installation in a fresh environment
 python -c "import tlpytools; print(tlpytools.__version__)"

{tlpytools-0.2.4 → tlpytools-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tlpytools
-Version: 0.2.4
+Version: 0.2.5
 Summary: TransLink's Python Tools - A comprehensive toolkit for transportation modeling and forecasting
 Project-URL: Homepage, https://github.com/TransLinkForecasting/tlpytools
 Project-URL: Bug Tracker, https://github.com/TransLinkForecasting/tlpytools/issues
@@ -23,6 +23,7 @@ Requires-Dist: coverage>=7.10.6
 Requires-Dist: cryptography>=3.4.7
 Requires-Dist: cryptpandas>=0.1.1
 Requires-Dist: ipykernel>=7.2.0
+Requires-Dist: matplotlib>=3.10.9
 Requires-Dist: notebook>=7.5.6
 Requires-Dist: numpy>=1.18
 Requires-Dist: openmatrix>=0.3

{tlpytools-0.2.4 → tlpytools-0.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tlpytools"
-version = "0.2.4"
+version = "0.2.5"
 description = "TransLink's Python Tools - A comprehensive toolkit for transportation modeling and forecasting"
 readme = "README.md"
 requires-python = ">=3.10.0, <3.13"
@@ -26,6 +26,7 @@ classifiers = [
 # Runtime dependencies: these are installed when a user `pip install tlpytools`
 # and also when a developer runs `pip install -e .`
 dependencies = [
+    "matplotlib>=3.10.9",
     "pandas>=1.1",
     "numpy>=1.18",
     "sqlalchemy>=1.4",

{tlpytools-0.2.4 → tlpytools-0.2.5}/src/tlpytools/__init__.py

@@ -2,7 +2,7 @@
 TLPyTools - A set of tools for building models at the TransLink Forecasting Team
 """
 
-__version__ = "0.2.4"
+__version__ = "0.2.5"
 
 # Core modules that should always be available (minimal dependencies)
 from . import log

{tlpytools-0.2.4 → tlpytools-0.2.5}/src/tlpytools/orca/orchestrator.py

@@ -2144,7 +2144,6 @@ class OrcaScenario:
         iteration: int,
         error_message: str,
         include_all_scenario: bool = False,
-        export_log: bool = True,
     ) -> bool:
         """
         Create an error dump when a model execution fails.
@@ -2161,7 +2160,6 @@ class OrcaScenario:
             iteration: Current iteration number
             error_message: Error message describing the failure
             include_all_scenario: If True, includes entire scenario in error dump
-            export_log: Whether to export operation log
 
         Returns:
             bool: True if error dump was created successfully, False otherwise
@@ -2188,8 +2186,6 @@ class OrcaScenario:
                 "dump_contents": [],
             }
 
-            operations = []
-
             # 1. Copy the failed step directory if it exists
             step_dir = os.path.join(self.scenario_path, step_name)
             if os.path.exists(step_dir):
@@ -2205,26 +2201,6 @@ class OrcaScenario:
 
                 if success:
                     error_info["dump_contents"].append(f"{step_name}/")
-                    operations.append(
-                        {
-                            "source": step_dir,
-                            "target": step_dump_dir,
-                            "type": "directory_copy",
-                            "status": "success",
-                            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                        }
-                    )
-                else:
-                    operations.append(
-                        {
-                            "source": step_dir,
-                            "target": step_dump_dir,
-                            "type": "directory_copy",
-                            "status": "failed",
-                            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                            "error": "Failed to copy step directory",
-                        }
-                    )
 
             # 2. Copy configuration files
             config_files = [
@@ -2243,25 +2219,11 @@ class OrcaScenario:
                     try:
                         shutil.copy2(config_path, target_path)
                         error_info["dump_contents"].append(f"config/{config_file}")
-                        operations.append(
-                            {
-                                "source": config_path,
-                                "target": target_path,
-                                "type": "file_copy",
-                                "status": "success",
-                                "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                            }
-                        )
                     except Exception as e:
-                        operations.append(
-                            {
-                                "source": config_path,
-                                "target": target_path,
-                                "type": "file_copy",
-                                "status": "failed",
-                                "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                                "error": str(e),
-                            }
+                        self.logger.warning(
+                            "Failed to copy config file %s to error dump: %s",
+                            config_file,
+                            e,
                         )
 
             # 3. Copy log files
@@ -2276,25 +2238,9 @@ class OrcaScenario:
                     try:
                         shutil.copy2(log_file, target_path)
                         error_info["dump_contents"].append(f"{LOGS_DIR}/{log_name}")
-                        operations.append(
-                            {
-                                "source": log_file,
-                                "target": target_path,
-                                "type": "file_copy",
-                                "status": "success",
-                                "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                            }
-                        )
                     except Exception as e:
-                        operations.append(
-                            {
-                                "source": log_file,
-                                "target": target_path,
-                                "type": "file_copy",
-                                "status": "failed",
-                                "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                                "error": str(e),
-                            }
+                        self.logger.warning(
+                            "Failed to copy log file %s to error dump: %s", log_name, e
                         )
 
             # 4. Copy outputs directory if it exists
@@ -2312,26 +2258,6 @@ class OrcaScenario:
 
                 if success:
                     error_info["dump_contents"].append(f"{OUTPUTS_DIR}/")
-                    operations.append(
-                        {
-                            "source": outputs_dir,
-                            "target": outputs_dump_dir,
-                            "type": "directory_copy",
-                            "status": "success",
-                            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                        }
-                    )
-                else:
-                    operations.append(
-                        {
-                            "source": outputs_dir,
-                            "target": outputs_dump_dir,
-                            "type": "directory_copy",
-                            "status": "failed",
-                            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                            "error": "Failed to copy outputs directory",
-                        }
-                    )
 
             # 5. Optionally copy entire scenario (excluding the error dump itself)
             if include_all_scenario:
@@ -2348,26 +2274,6 @@ class OrcaScenario:
 
                 if success:
                     error_info["dump_contents"].append("full_scenario/")
-                    operations.append(
-                        {
-                            "source": self.scenario_path,
-                            "target": full_dump_dir,
-                            "type": "full_scenario_copy",
-                            "status": "success",
-                            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                        }
-                    )
-                else:
-                    operations.append(
-                        {
-                            "source": self.scenario_path,
-                            "target": full_dump_dir,
-                            "type": "full_scenario_copy",
-                            "status": "failed",
-                            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
-                            "error": "Failed to copy full scenario",
-                        }
-                    )
 
             # 6. Save error information
             error_info_file = os.path.join(error_dump_dir, "error_info.json")
@@ -2395,23 +2301,8 @@ class OrcaScenario:
                     error_dump_dir,
                 )
 
-            # 8. Log all operations
-            if export_log and operations:
-                self.log_file_operations(
-                    operations=operations,
-                    log_dir=error_dump_base,
-                    operation_type="error_dump",
-                    export_log=export_log,
-                )
-
-            # Summary logging
-            self.logger.info("Error dump completed successfully")
-            self.logger.debug(
-                "Error dump location: %s", zip_path if zip_success else error_dump_dir
-            )
-            self.logger.debug(
-                "Error dump contents: %s", ", ".join(error_info["dump_contents"])
-            )
+            dump_location = zip_path if zip_success else error_dump_dir
+            self.logger.info("Error dump created at: %s", dump_location)
 
             return True
 
@@ -2764,30 +2655,13 @@ class OrcaOrchestrator:
             raise ValueError(f"Invalid mode: {self.mode}")
 
         # Initialize state - for cloud mode, this will load the cloud-synchronized state
-        # Get project name from config or project_folder_override
-        # Priority: adls_folder in YAML > project_folder parameter > default
-        adls_folder_in_config = (
-            self.config.get("operational_mode", {}).get("cloud", {}).get("adls_folder")
-        )
-
-        if adls_folder_in_config:
-            # Use adls_folder from YAML if already set
-            project_name = adls_folder_in_config
-            self.logger.debug("Using adls_folder from config: '%s'", project_name)
-        elif self.project_folder_override:
-            # Use project_folder parameter if provided and adls_folder not in YAML
+        # project_folder parameter is the authoritative source for project name
+        if self.project_folder_override:
             project_name = self.project_folder_override
-            # Automatically inject into config for consistency
-            if "operational_mode" not in self.config:
-                self.config["operational_mode"] = {}
-            if "cloud" not in self.config["operational_mode"]:
-                self.config["operational_mode"]["cloud"] = {}
-            self.config["operational_mode"]["cloud"]["adls_folder"] = project_name
             self.logger.debug(
-                "Set adls_folder from project_folder parameter: '%s'", project_name
+                "Using project folder as project name: '%s'", project_name
             )
         else:
-            # Use default if neither is set
             project_name = "proj_unnamed"
             self.logger.debug("Using default project name: '%s'", project_name)
 
@@ -3926,10 +3800,10 @@ class OrcaOrchestrator:
                     error_config = self.config.get("error_handling", {})
                     create_dump = error_config.get("create_error_dump", True)
                     include_full_scenario = error_config.get(
-                        "include_all_files_in_dump", False
+                        "include_all_files_in_dump", True
                     )
 
-                    if create_dump:
+                    if create_dump and self.mode == "cloud_production":
                         # Create error dump when command fails
                         self.logger.info(
                             "Creating error dump for failed step: %s", step_name
@@ -3939,7 +3813,6 @@ class OrcaOrchestrator:
                             iteration=display_iteration,
                             error_message=error_msg,
                             include_all_scenario=include_full_scenario,
-                            export_log=True,
                         )
 
                         if dump_success:
@@ -4290,26 +4163,19 @@ class OrcaOrchestrator:
 
     def _get_adls_config(self):
         """
-        Get ADLS configuration from config file.
+        Get ADLS configuration from environment variables and the project_folder parameter.
 
         Returns:
             tuple: (adls_url, adls_container, adls_folder)
         """
-        cloud_config = self.config["operational_mode"].get("cloud", {})
+        adls_base = get_env_var("ORCA_ADLS_URL", required=True)
+        adls_url = f"https://{adls_base}"
 
-        adls_url = cloud_config.get("adls_url")
-        if adls_url is None:
-            adls_base = get_env_var("ORCA_ADLS_URL", required=True)
-            adls_url = f"https://{adls_base}"
-
-        adls_container = cloud_config.get("adls_container", "raw")
+        adls_container = get_env_var("ORCA_ADLS_CONTAINER", required=True)
 
-        # Use project_folder override if provided, otherwise use config value
+        adls_folder = self.project_folder_override or "proj_unnamed"
         if self.project_folder_override:
-            adls_folder = self.project_folder_override
             self.logger.info("Using project folder override: %s", adls_folder)
-        else:
-            adls_folder = cloud_config.get("adls_folder", "proj_unnamed")
 
         return adls_url, adls_container, adls_folder
 
@@ -7030,8 +6896,18 @@ class OrcaOrchestrator:
         """
         Print a summary of the model execution results.
         """
+        status = self.state.get("status") if self.state else None
+        all_complete = self.state.is_all_iterations_complete() if self.state else False
+
+        if status == "error":
+            header = "[ERROR] MODEL RUN FAILED"
+        elif all_complete:
+            header = "[OK] MODEL RUN COMPLETED"
+        else:
+            header = "[OK] MODEL RUN IS PARTIALLY COMPLETED WITH NO ERRORS"
+
         print("\n" + "=" * 70)
-        print("[OK] MODEL EXECUTION COMPLETED")
+        print(header)
         print("=" * 70)
 
         if self.state:
@@ -7911,6 +7787,7 @@ class OrcaUtil:
         # Required environment variables for cloud operations
         required_env_vars = [
             "ORCA_ADLS_URL",
+            "ORCA_ADLS_CONTAINER",
             "BATCH_ACCOUNT_ENDPOINT",
             "IMAGE_REGISTRY_ENDPOINT",
             "AZURE_SUBSCRIPTION_ID",
@@ -7965,11 +7842,10 @@ class OrcaUtil:
                 if tenant_name_output:
                     print(f"[INFO] tenantDisplayName: {tenant_name_output}")
 
-        # Get cloud configuration from orchestrator
-        cloud_config = orchestrator.config.get("operational_mode", {}).get("cloud", {})
-        adls_url = cloud_config.get("adls_url", "")
-        adls_container = cloud_config.get("adls_container", "")
-        adls_folder = cloud_config.get("adls_folder", "")
+        # Get cloud configuration from environment variables
+        adls_url = os.getenv("ORCA_ADLS_URL", "")
+        adls_container = os.getenv("ORCA_ADLS_CONTAINER", "")
+        adls_folder = orchestrator.project_folder_override or ""
 
         # Print detailed configuration status
         print("\n" + "=" * 70)

{tlpytools-0.2.4 → tlpytools-0.2.5}/tests/test_orca_unit.py

@@ -530,14 +530,48 @@ class TestOrcaOrchestrator(unittest.TestCase):
             self.assertEqual(len(archive_files), 0)
 
     def test_get_adls_config(self):
-        """Test ADLS config retrieval."""
-        orchestrator = self._create_test_orchestrator()
+        """Test ADLS config retrieval.
+
+        Loads .env.example to verify it contains the required variables, then
+        uses those values to exercise _get_adls_config so the test breaks if
+        either the code or the example file drops a required variable.
+        """
+        env_example_path = os.path.join(
+            os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
+            ".env.example",
+        )
+        self.assertTrue(
+            os.path.exists(env_example_path),
+            f".env.example not found at {env_example_path}",
+        )
+
+        # Parse .env.example into a dict (skip comments and blank lines)
+        env_vars = {}
+        with open(env_example_path) as f:
+            for line in f:
+                line = line.strip()
+                if line and not line.startswith("#") and "=" in line:
+                    key, _, value = line.partition("=")
+                    env_vars[key.strip()] = value.strip()
+
+        self.assertIn(
+            "ORCA_ADLS_URL", env_vars, "ORCA_ADLS_URL missing from .env.example"
+        )
+        self.assertIn(
+            "ORCA_ADLS_CONTAINER",
+            env_vars,
+            "ORCA_ADLS_CONTAINER missing from .env.example",
+        )
+
+        with patch.dict(os.environ, env_vars):
+            orchestrator = self._create_test_orchestrator()
+            orchestrator.project_folder_override = "test_folder"
 
-        adls_url, adls_container, adls_folder = orchestrator.get_adls_config()
+            adls_url, adls_container, adls_folder = orchestrator.get_adls_config()
 
-        self.assertEqual(adls_url, "https://test.dfs.core.windows.net")
-        self.assertEqual(adls_container, "test")
-        self.assertEqual(adls_folder, "test_folder")
+            self.assertEqual(adls_url, f"https://{env_vars['ORCA_ADLS_URL']}")
+            self.assertEqual(adls_container, env_vars["ORCA_ADLS_CONTAINER"])
+            self.assertEqual(adls_folder, "test_folder")
 
     def test_input_data_initialization(self):
         """Test that input_data configuration is properly loaded."""

{tlpytools-0.2.4 → tlpytools-0.2.5}/uv.lock

@@ -1250,11 +1250,11 @@ wheels = [
 
 [[package]]
 name = "filelock"
-version = "3.31.1"
+version = "3.32.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/53/55/1e19b2b56a24a4b94624f7e819e1bb87fa6c5609dbaf621df3aa6568a761/filelock-3.31.1.tar.gz", hash = "sha256:9e0c4e88ebe90833c1beafd3a547ccbc0bf7f491cd3858c3ec7aed63efe02163", size = 196656, upload-time = "2026-07-20T03:14:32.414Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c0/80/8232b582c4b318b817cf1274ba74976b07b34d35ef439b3eb948f98645a1/filelock-3.32.0.tar.gz", hash = "sha256:7be2ad23a14607ccc71808e68fe30848aeace7058ace17852f68e2a68e310402", size = 213757, upload-time = "2026-07-21T13:17:42.898Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/88/61/df1d9db18f188d0ae648956a1decadc0e3b77d0571474370fd01f28a82b1/filelock-3.31.1-py3-none-any.whl", hash = "sha256:9ea33146c780161bf67cb20c7cb26b651566820d65ad8dfdd79422602a2dcfc0", size = 97189, upload-time = "2026-07-20T03:14:31.307Z" },
+    { url = "https://files.pythonhosted.org/packages/06/79/b4c714bef36bc4ec2beeae1e0c124f0223888cd8c6feb1cdc56038116920/filelock-3.32.0-py3-none-any.whl", hash = "sha256:d396bea984af47333ef05e50eae7eff88c84256de6112aea0ec48a233c064fe3", size = 97732, upload-time = "2026-07-21T13:17:41.55Z" },
 ]
 
 [[package]]
@@ -1970,7 +1970,7 @@ wheels = [
 
 [[package]]
 name = "jupyterlab"
-version = "4.6.1"
+version = "4.6.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "async-lru" },
@@ -1987,10 +1987,11 @@ dependencies = [
     { name = "tomli", marker = "python_full_version < '3.11'" },
     { name = "tornado" },
     { name = "traitlets" },
+    { name = "typing-extensions", marker = "python_full_version < '3.12'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/bc/2a/d6af53bfd45a43a5bfe7e40ba47ee7a8921a807daf4bb708e3a295bbb54d/jupyterlab-4.6.1.tar.gz", hash = "sha256:75315982ed28427edaa62bb85eadb5105e4043a757643c910efd787fe6ed0837", size = 28179125, upload-time = "2026-06-29T12:48:45.402Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7a/7f/51c0c856ab286bdaf5709cf61ed13584ed9d4bee906479707da45b11b353/jupyterlab-4.6.2.tar.gz", hash = "sha256:e18ce8b34f3de350e93cd5b2c4f3ae884cbe266eb76bf5d6825a4ed34c13bcff", size = 28183650, upload-time = "2026-07-21T12:05:24.051Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5a/81/90ac6cc31d248e83a0d1eab343a5e6e68bc783d3f74fbe61640f42a61da4/jupyterlab-4.6.1-py3-none-any.whl", hash = "sha256:85a58546c831f3dce6cf919468c26874c9065e99c42279fb4abb8e1b552a98bb", size = 17164660, upload-time = "2026-06-29T12:48:41.21Z" },
+    { url = "https://files.pythonhosted.org/packages/63/1f/e39b248c76bb3736bc05a9491a6aa1315414c32dea12f548ecc1b24c758e/jupyterlab-4.6.2-py3-none-any.whl", hash = "sha256:5964447036629adfcd3fc0969effc1da6f47d2cbd0a60b2c2eea7c31be0ec6a8", size = 17166703, upload-time = "2026-07-21T12:05:19.818Z" },
 ]
 
 [[package]]
@@ -3247,11 +3248,11 @@ wheels = [
 
 [[package]]
 name = "platformdirs"
-version = "4.10.1"
+version = "4.11.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/52/cd/4f25b2f95b23f5d2c9c1fe43e49841bff5800562149b2666afc09309aa8f/platformdirs-4.10.1.tar.gz", hash = "sha256:ceab4084426fe6319ce18e86deada8ab1b7487c7aee7040c55e277c9ae793695", size = 31678, upload-time = "2026-07-18T03:53:43.808Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/78/9b/560e4be8e26f6fd133a03630a8df0c663b9e8d61b4ade152b72005aec83b/platformdirs-4.11.0.tar.gz", hash = "sha256:0555d18370482847566ffabcaa53ad7c6c1c29f195989ae1ed634a05f76ea1e0", size = 31953, upload-time = "2026-07-21T13:09:36.565Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ec/73/6fd0bb9ce84138c3857f12e9de63bc901852975a092d545f18087a204aa2/platformdirs-4.10.1-py3-none-any.whl", hash = "sha256:0e4eff26be2d75293977f7cddc153fd9b8eaa7fb0c7b64ffe4076cb443117443", size = 22906, upload-time = "2026-07-18T03:53:42.576Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/68/d8d58938dfb1370b266a1a729e6d77a985be23689a0496498ee17b2cbf90/platformdirs-4.11.0-py3-none-any.whl", hash = "sha256:360ccded2b7fce0af0ff80cc8f5942a1c5d99b0e856033acb030bfc634709e74", size = 23247, upload-time = "2026-07-21T13:09:35.422Z" },
 ]
 
 [[package]]
@@ -3278,30 +3279,30 @@ wheels = [
 
 [[package]]
 name = "polars"
-version = "1.42.1"
+version = "1.43.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "polars-runtime-32" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/27/99/fe77f10a13a778705ef05b499fc708c9a0b0a3680d9eb6bc6e1b6a6b9914/polars-1.42.1.tar.gz", hash = "sha256:2fe94f3059334650bd850ae19a9c165dcd5d9cb12cd95ea04de2201662e70e8a", size = 741532, upload-time = "2026-06-30T04:57:51.504Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/5b/5d0f0aa53c6e9a8ecbc99ff502edcf9584e5d08ab34ea407c086999103d5/polars-1.43.0.tar.gz", hash = "sha256:bb2c67553e4968c18dfe268a88ff9a5790d5c2e0b7ea7efe97640b9a90438c88", size = 749537, upload-time = "2026-07-21T04:30:25.966Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/be/6a/edd939cc6fa04b6415aaa9bf19720fc74ead81234b3d38542e0005816d4d/polars-1.42.1-py3-none-any.whl", hash = "sha256:3c0c65cdfa21a621650c4bdcbbccf93964d052fd766c3e70e84a55d961c259fd", size = 837622, upload-time = "2026-06-30T04:56:34.686Z" },
+    { url = "https://files.pythonhosted.org/packages/76/28/a8eac2c1d1b2d2a4ba2eb745921616d863185d94b1afd91cbb07af9ef21a/polars-1.43.0-py3-none-any.whl", hash = "sha256:c49078b14e2d6b8ff5cc5b78b6d9638603ea5dffafb889d9204818822f55b813", size = 846493, upload-time = "2026-07-21T04:29:06.68Z" },
 ]
 
 [[package]]
 name = "polars-runtime-32"
-version = "1.42.1"
+version = "1.43.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/1f/59/15bcc4dac380c6d63efa5446d8317f22671cbd6c9dadd576bd17a334c45a/polars_runtime_32-1.42.1.tar.gz", hash = "sha256:4d4809e1c1b9a6611f6944f27b24abea902b5159e6b6fa262fd716e947af5afd", size = 3045460, upload-time = "2026-06-30T04:57:52.866Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/86/96/7e714cad082e9e6aaebb8886fcb1b0220d5c35149d4c8d3466bd7e7d581e/polars_runtime_32-1.43.0.tar.gz", hash = "sha256:5fb47a3a883402e62eab2fde5922f78c531d037aeece3640c15225f39228621e", size = 3090044, upload-time = "2026-07-21T04:30:27.185Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/62/29/16ff6e4e91d71e530d3581f45e342a9cc35072ac6b31dcbc2fa33de2569e/polars_runtime_32-1.42.1-cp310-abi3-macosx_10_12_x86_64.whl", hash = "sha256:bbdc26d68ee5b23b0ce227fa0599220aa35b77c826b6b0a6b2d8e7f6c1c36974", size = 53117325, upload-time = "2026-06-30T04:56:37.972Z" },
-    { url = "https://files.pythonhosted.org/packages/04/8e/4f8296fcfd1347f1351342fecf13bf2430d7efbae2f1f45964ec7930a99e/polars_runtime_32-1.42.1-cp310-abi3-macosx_11_0_arm64.whl", hash = "sha256:f6c0288be940b607dc4a7476c01e67fb6bbee93f5f1dd42c64970274c71008ba", size = 47446251, upload-time = "2026-06-30T04:56:41.459Z" },
-    { url = "https://files.pythonhosted.org/packages/88/2e/0d66a7deadc453b890c3391034ca8ab4b05d0beaebbb92a7d65199fba61b/polars_runtime_32-1.42.1-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:635d9dbcae2302ae223afb395d5cd220bffa61a53d0ab6871d17c8bc830101cf", size = 51359402, upload-time = "2026-06-30T04:56:44.595Z" },
-    { url = "https://files.pythonhosted.org/packages/5d/10/ffb85fa380bc9c9000dc35f40f44954dde49023018501c54faab94b3a39e/polars_runtime_32-1.42.1-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d059e8e53cc114ff82f9bd791fd341dc53534a2c745e6f6aa37594c3a93f01fe", size = 57302723, upload-time = "2026-06-30T04:56:47.609Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/63/ca50adc62e44224ca5c622a842ba6f35ee87d1d40ef0df7ea2ed6c6edb08/polars_runtime_32-1.42.1-cp310-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:f91f0b13588324905682809d270e1de5f1990c908721c8527657d77a044c9919", size = 51515673, upload-time = "2026-06-30T04:56:50.88Z" },
-    { url = "https://files.pythonhosted.org/packages/63/c3/08fbbf38deaa17bf34a601d327cb7451074098673c78b7c1a8538dde9794/polars_runtime_32-1.42.1-cp310-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:8b8bf972d99d48aaaa2582e2bce966a6f43bc815bd8725d15f5cab9e2fb15d17", size = 55217259, upload-time = "2026-06-30T04:56:53.834Z" },
-    { url = "https://files.pythonhosted.org/packages/d1/0e/51db89361668fe077a835fc579277f824ba526e7daf7b94d23d25439e0d0/polars_runtime_32-1.42.1-cp310-abi3-win_amd64.whl", hash = "sha256:e9364c26da389a8b7339e4d29e20a3d12af730247e6ed3b7804bddce2477f428", size = 52715432, upload-time = "2026-06-30T04:56:57.109Z" },
-    { url = "https://files.pythonhosted.org/packages/76/c5/2fb8592d691bd114de25d9c84300b23541dca7060eac11d7b4bed0327786/polars_runtime_32-1.42.1-cp310-abi3-win_arm64.whl", hash = "sha256:7051226e6b42ffc395a7a9190377cd28649fbfb991b8f85c6271f4e1cfb736fb", size = 46718300, upload-time = "2026-06-30T04:56:59.855Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/14/9b1f5eb1c5104ba1ceb380a7308ffcd979f3ce1df86e76293062698f2ff1/polars_runtime_32-1.43.0-cp310-abi3-macosx_10_12_x86_64.whl", hash = "sha256:6707193d30a7135bce0424304f76d8145270527444097548e794ad8d26823b70", size = 53059463, upload-time = "2026-07-21T04:29:09.194Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/14/73d77d1c0c928eb599d9516d874af0cd2b6225201e1327a6c4857e6776d0/polars_runtime_32-1.43.0-cp310-abi3-macosx_11_0_arm64.whl", hash = "sha256:78ca2f97740b2a6beb36eb112749280b5e08750c60f53c08d2feffebdba9d35a", size = 47499586, upload-time = "2026-07-21T04:29:13.229Z" },
+    { url = "https://files.pythonhosted.org/packages/80/b1/98278fa796f93d0975fd3fe1d4ab4031707d4a9f1da44c21c29996b62c73/polars_runtime_32-1.43.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4ffa99bb2c7ee0a9392ae50b350af0ed17acf0519d15c75fe223021798566174", size = 51326702, upload-time = "2026-07-21T04:29:16.084Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/7d/24ae73389aac03296925973c4e2cbe2e4982e859b9fad69eb1a72b9026fa/polars_runtime_32-1.43.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3ecc8feaf04de5989a29245885921db612ef1ce9065e5cb6ec37495acfa55bba", size = 57266705, upload-time = "2026-07-21T04:29:19.288Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/49/2026be1f7b51242ad62e08b20728462558e161fb84b564e5b986f2b38664/polars_runtime_32-1.43.0-cp310-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:01e1471a5ee161a969c7a96991d8e5d20b97a0b7fe075df9c7a01f52a49c5ac2", size = 51484129, upload-time = "2026-07-21T04:29:22.639Z" },
+    { url = "https://files.pythonhosted.org/packages/db/e2/047c7695f08a9b18614c0e1ec5e70a754455542a21a6d52955f7f05c6268/polars_runtime_32-1.43.0-cp310-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:9cd8b813afe67d59e87027dedcaf5c6a06fe602472fd74e1a49f4bafea47259c", size = 55169401, upload-time = "2026-07-21T04:29:25.902Z" },
+    { url = "https://files.pythonhosted.org/packages/92/dc/bfd2533c487563c7a21ab7d7af3d78f820b0236e14dc5ee63d46188cd275/polars_runtime_32-1.43.0-cp310-abi3-win_amd64.whl", hash = "sha256:41a75fb3cb4cc574eb21801383578f75cfc374597c22322ef457ab7bac8a3301", size = 52541527, upload-time = "2026-07-21T04:29:29.162Z" },
+    { url = "https://files.pythonhosted.org/packages/46/d7/5c47f1bf57479d1671669af9c421f9abf4986b2ddaa64c177244ff811de0/polars_runtime_32-1.43.0-cp310-abi3-win_arm64.whl", hash = "sha256:c285e598dd91e08560e519275b8b8108adbafb438d218a175ebe073dbc2027fb", size = 46552281, upload-time = "2026-07-21T04:29:32.224Z" },
 ]
 
 [[package]]
@@ -3840,15 +3841,15 @@ wheels = [
 
 [[package]]
 name = "python-discovery"
-version = "1.4.4"
+version = "1.5.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "filelock" },
     { name = "platformdirs" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/4c/81/58c70036dffeccb7fe7d79d6260c69f7a28272bbd3909c29a01ea9422744/python_discovery-1.4.4.tar.gz", hash = "sha256:5cad33982d412c1f3ffb8f9ca4ea292c9680bca3942451d30b69c37fce53a4a3", size = 72212, upload-time = "2026-07-08T23:06:50.691Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f1/51/276f964496a5714ab9f320896195639086881c2b39c03b5ad13de84acbb8/python_discovery-1.5.0.tar.gz", hash = "sha256:3e014c6327154d3dda27939a9a0dc9c5c000439f1906d3f303b48f984bd2ecef", size = 72483, upload-time = "2026-07-21T13:14:14.641Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/9d/ae/84bc0d2440c95772272bb6f4b3d09ccf08b2898fce89b3d4f969a9fc74e9/python_discovery-1.4.4-py3-none-any.whl", hash = "sha256:abebe9120b43453b68c908acfb1e72a19d1a959ed2cb620ad38fc57d08056dbe", size = 34181, upload-time = "2026-07-08T23:06:49.402Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/7b/14882602ddee241d7984a742fcb423cb4a30fb0d6efc546ac3129fba475a/python_discovery-1.5.0-py3-none-any.whl", hash = "sha256:70c4fc61b4e7404e44f01d6fc44a715c4d685ca6cea83d295922f05891877c98", size = 34205, upload-time = "2026-07-21T13:14:13.398Z" },
 ]
 
 [[package]]
@@ -4495,11 +4496,11 @@ wheels = [
 
 [[package]]
 name = "soupsieve"
-version = "2.9"
+version = "2.9.1"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/80/f1/93422647dd7e461f23d254e6b2bfa687a85b53aeb4903fcdbb74474d4584/soupsieve-2.9.tar.gz", hash = "sha256:acee8417325c5653e1377dc31eccad59eb82cbc65942afe6174c53b3aaad63fc", size = 122122, upload-time = "2026-07-19T01:35:18.425Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/d9/38/e12680bbe6b4f8f3d17adcaf38d26850aa756c85cf4a80e79fc12a018fe8/soupsieve-2.9.1.tar.gz", hash = "sha256:c33e6605bbc71dd628b00c632d58ae607c22bade247e52553928f83bbb75b4ba", size = 122261, upload-time = "2026-07-21T16:57:17.452Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7b/d6/3185ab5ad1280319b31986898f3206dd7227cd75e293d4dba2a5e6bf27a0/soupsieve-2.9-py3-none-any.whl", hash = "sha256:a2b2c76d67df2382d245409fd71e321a571717e58463efa32ace87dcadac2c12", size = 37387, upload-time = "2026-07-19T01:35:17.106Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/2c/437fe806897c2d6cfdc3ee43a18da8bf8e568530a4ae9bac781541ca9896/soupsieve-2.9.1-py3-none-any.whl", hash = "sha256:4f4477399246b7a0c720a88ca2454b11cd6bb9ae4c9d170140786e916776c14c", size = 37404, upload-time = "2026-07-21T16:57:16.421Z" },
 ]
 
 [[package]]
@@ -4652,7 +4653,7 @@ wheels = [
 
 [[package]]
 name = "tlpytools"
-version = "0.2.4"
+version = "0.2.5"
 source = { editable = "." }
 dependencies = [
     { name = "azure-core" },
@@ -4664,6 +4665,8 @@ dependencies = [
     { name = "cryptography" },
     { name = "cryptpandas" },
     { name = "ipykernel" },
+    { name = "matplotlib", version = "3.10.9", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "matplotlib", version = "3.11.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
     { name = "notebook" },
     { name = "numpy" },
     { name = "openmatrix" },
@@ -4746,6 +4749,7 @@ requires-dist = [
     { name = "geopandas", marker = "extra == 'dev'", specifier = ">=0.13.0" },
     { name = "ipykernel", specifier = ">=7.2.0" },
     { name = "kiwisolver", marker = "extra == 'dev'", specifier = ">=1.4.0" },
+    { name = "matplotlib", specifier = ">=3.10.9" },
     { name = "mypy", marker = "extra == 'dev'", specifier = ">=1.5.0" },
     { name = "notebook", specifier = ">=7.5.6" },
     { name = "numpy", specifier = ">=1.18" },
@@ -4925,7 +4929,7 @@ wheels = [
 
 [[package]]
 name = "virtualenv"
-version = "21.6.1"
+version = "21.7.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "distlib" },
@@ -4934,9 +4938,9 @@ dependencies = [
     { name = "python-discovery" },
     { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/34/d9/b477fddb68840b570af8b22afe9b035cbc277b5fb7b33dea390617a8b10f/virtualenv-21.6.1.tar.gz", hash = "sha256:15f978b7cd329f24855ff4a0c4b4899cc7678589f49adbdcbbb4d3232e641128", size = 5526620, upload-time = "2026-07-10T19:33:53.312Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/fe/25/e367a7229b0914772ca8d81b41fde012d9feda68523b52644a571bb21ce8/virtualenv-21.7.0.tar.gz", hash = "sha256:7f9519b9432ff11b6e1a3e94061664efc2ff99ea21780e3cf4f6bd0a5da8b37c", size = 5527510, upload-time = "2026-07-21T13:12:14.109Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c1/7c/4e7225d46d634a0d8d534dd8a6ce0c319d09b4d0cf0337eb314ca4789d8c/virtualenv-21.6.1-py3-none-any.whl", hash = "sha256:afe991df855715a2b2f60edfcc0107ef95a79fdfd8cb4cdaa71603d1c12e463b", size = 5506392, upload-time = "2026-07-10T19:33:51.629Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/7a/ae29312b1e88a22e81f5d21fc11526d2a114089776c2550d2b205b6c2a47/virtualenv-21.7.0-py3-none-any.whl", hash = "sha256:a8370c1c5530fbabf955e40b8fbbc68a431648b10f9433faa587db30a06e51dd", size = 5507078, upload-time = "2026-07-21T13:12:12.136Z" },
 ]
 
 [[package]]