MVP routing module

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -77,4 +77,4 @@ body:
     attributes:
       label: Charge code
       placeholder: >
-        If you are at NREL and fixing this bug is urgent, please provide a charge code
+        If you are at NLR and fixing this bug is urgent, please provide a charge code

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -59,4 +59,4 @@ body:
     attributes:
       label: Charge code
       placeholder: >
-        If you are at NREL and implementing this feature is urgent, please provide a charge code
+        If you are at NLR and implementing this feature is urgent, please provide a charge code

README.rst

@@ -20,7 +20,7 @@ Welcome to reV Routing (reVRt)!
 .. |Pixi| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json
     :target: https://pixi.sh
 
-.. |SWR| image:: https://img.shields.io/badge/SWR--25--112_-blue?label=NREL
+.. |SWR| image:: https://img.shields.io/badge/SWR--25--112_-blue?label=NLR
     :alt: Static Badge
 
 .. |Zenodo| image:: https://zenodo.org/badge/944738283.svg

crates/revrt/src/dataset.rs

@@ -80,9 +80,16 @@ impl Dataset {
                 let name = entry.split('/').next().unwrap_or("").to_ascii_lowercase();
                 const EXCLUDES: [&str; 6] =
                     ["latitude", "longitude", "band", "x", "y", "spatial_ref"];
-                !name.ends_with(".json") && !EXCLUDES.iter().any(|needle| name.contains(needle))
+                !name.ends_with(".json") && !EXCLUDES.iter().any(|needle| name == *needle)
             })
-            .expect("no suitable variables found in source dataset");
+            .unwrap_or_else(|| {
+                panic!(
+                    "no non-coordinate variables found in source dataset: {:?}",
+                    source
+                        .list()
+                        .unwrap_or_else(|err| panic!("failed to list dataset entries: {err}"))
+                )
+            });
         // Skip coordinate axes when selecting a representative variable for cost storage.
         let varname = first_entry.split('/').next().unwrap().to_string();
         debug!("Using '{}' to determine shape of cost data", varname);
@@ -285,6 +292,7 @@ impl Dataset {
         let neighbors = neighbors
             .iter()
             .filter(|((ir, jr), _)| !(*ir == i && *jr == j)) // no center point
+            .filter(|((_, _), v)| *v > 0.) // only positive costs
             .map(|((ir, jr), v)| ((ir, jr), 0.5 * (v + center.1)))
             .map(|((ir, jr), v)| {
                 if *ir != i && *jr != j {

docs/source/conf.py

@@ -21,7 +21,7 @@
 
 project = "reVRt"
 copyright = "2025, Alliance for Sustainable Energy, LLC"
-author = "NREL: Guilherme Pimenta Castelao, Paul Pinchuk"
+author = "NLR: Guilherme Pimenta Castelao, Paul Pinchuk"
 
 pkg = os.path.dirname(os.path.abspath(os.path.dirname(__file__)))
 pkg = os.path.dirname(pkg)
@@ -135,7 +135,7 @@
 
 html_context = {
     "display_github": True,
-    "github_user": "nrel",
+    "github_user": "nlr",
     "github_repo": "reVRt",
     "github_version": "main",
     "conf_py_path": "/docs/source/",

docs/source/glossary.rst

@@ -119,7 +119,7 @@ supporting technologies referenced throughout the reVRt documentation.
       ``revrt._rust``.
 
    reV
-      NREL's Renewable Energy Potential platform that models generation
+      NLR's Renewable Energy Potential platform that models generation
       profiles for renewable resources. reVRt complements reV by adding
       transmission routing capabilities that feed downstream analyses.
 
@@ -128,11 +128,6 @@ supporting technologies referenced throughout the reVRt documentation.
       simulations, and exports supporting analytics for transmission
       planning studies.
 
-   reVX
-      NREL's valuation framework that builds on reV outputs to assess
-      market and financial metrics. reVRt outputs can flow into reVX to
-      inform siting and transmission decisions.
-
    routing file
       HDF5 file produced by the cost preparation pipeline that stores
       coordinate grids, friction and barrier layers, metadata, and any

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "maturin"
 [project]
 name = "NREL-reVRt"
 version = "0.2.1"
-description = "National Renewable Energy Laboratory's (NREL's) Transmission for reVX tool"
+description = "National Laboratory of the Rockies' (NLR's) Transmission for reVX tool"
 readme = "README.rst"
 authors = [
   {name = "Guilherme Castelão", email = "[email protected]"},
@@ -16,7 +16,7 @@ maintainers = [
   {name = "Paul Pinchuk", email = "[email protected]"},
 ]
 license = {text = "BSD-3-Clause"}
-keywords = ["NREL", "routing", "transmission", "reVRt", "reV", "reVX"]
+keywords = ["NLR", "routing", "transmission", "reVRt", "reV", "reVX"]
 requires-python = ">= 3.11"
 classifiers=[
   "Development Status :: 2 - Pre-Alpha",

revrt/__init__.py

@@ -1,4 +1,4 @@
-"""Routing analysis library for the reV model"""
+"""Routing analysis library"""
 
 import importlib.metadata
 

revrt/_cli.py

@@ -7,6 +7,7 @@
 from revrt import __version__
 from revrt.spatial_characterization.cli import route_characterizations_command
 from revrt.costs.cli import build_routing_layers_command
+from revrt.routing.cli import route_points_command
 from revrt.utilities.cli import (
     layers_to_file_command,
     layers_from_file_command,
@@ -21,6 +22,7 @@
     layers_from_file_command,
     build_routing_layers_command,
     route_characterizations_command,
+    route_points_command,
 ]
 main = make_cli(commands, info={"name": "reVRt", "version": __version__})
 

revrt/costs/config/config.py

@@ -54,7 +54,7 @@ def __init__(self, config=None):
         config : str or dict, optional
             Dictionary of transmission cost configuration values, or
             path to JSON/JSON5 file containing this dictionary. The
-            dictionary should have the following keys:
+            dictionary should have a subset of the following keys:
 
                 - base_line_costs
                 - iso_lookup
@@ -65,6 +65,8 @@ def __init__(self, config=None):
                 - power_to_voltage
                 - transformer_costs
                 - upgrade_substation_costs
+                - voltage_polarity_mult
+                - row_width
 
             Each of these keys should point to another dictionary or
             path to JSON/JSON5 file containing a dictionary of

revrt/exceptions.py

@@ -14,7 +14,9 @@ def __init__(self, *args, **kwargs):
         """Init exception and broadcast message to logger"""
         super().__init__(*args, **kwargs)
         if args:
-            logger.error(str(args[0]), stacklevel=2)
+            logger.error(
+                "<%s> %s", self.__class__.__name__, args[0], stacklevel=2
+            )
 
 
 class revrtAttributeError(revrtError, AttributeError):
@@ -33,10 +35,18 @@ class revrtFileNotFoundError(revrtError, FileNotFoundError):
     """revrt FileNotFoundError"""
 
 
+class revrtInvalidStartCostError(revrtError, ValueError):
+    """revrt InvalidStartCostError"""
+
+
 class revrtKeyError(revrtError, KeyError):
     """revrt KeyError"""
 
 
+class revrtLeastCostPathNotFoundError(revrtError, RuntimeError):
+    """revrt LeastCostPathNotFoundError"""
+
+
 class revrtNotImplementedError(revrtError, NotImplementedError):
     """revrt NotImplementedError"""
 

revrt/routing/__init__.py

@@ -0,0 +1 @@
+"""reVRt routing logic"""