"""
PYORPS: An Open-Source Tool for Automated Power Line Routing
Reference:
[1] Hofmann, M., Stetz, T., Kammer, F., Repo, S.: 'PYORPS: An Open-Source Tool for
Automated Power Line Routing', CIRED 2025 - 28th Conference and Exhibition on
Electricity Distribution, 16 - 19 June 2025, Geneva, Switzerland
Exceptions for CostAssumptions
"""
[docs]
class CostAssumptionsError(Exception):
"""
Base exception for CostAssumptions class.
"""
[docs]
class FileLoadError(CostAssumptionsError):
"""
Exception raised when loading files fails.
"""
[docs]
class InvalidSourceError(CostAssumptionsError):
"""
Exception raised when the provided source is invalid.
"""
[docs]
class FeatureColumnError(Exception):
"""
Base exception for feature column detection errors
"""
[docs]
class NoSuitableColumnsError(FeatureColumnError):
"""
Exception raised when no suitable columns are found
"""
[docs]
class ColumnAnalysisError(FeatureColumnError):
"""
Exception raised when column analysis fails
"""
"""
Exceptions for vector_loader
"""
[docs]
class WFSError(Exception):
"""
Base exception for WFS-related errors.
"""
[docs]
class WFSConnectionError(WFSError):
"""
Exception raised for connection issues with WFS services.
"""
[docs]
class WFSResponseParsingError(WFSError):
"""
Exception raised when parsing WFS responses fails.
"""
[docs]
class WFSLayerNotFoundError(WFSError):
"""
Exception raised when a requested layer cannot be found.
"""
"""
Exceptions for graph library API
"""
[docs]
class RasterShapeError(Exception):
"""
Custom exception if the raster shape is not supported
"""
[docs]
def __init__(self, raster_shape: tuple[int, ...]) -> None:
message = (f"Raster shape of {raster_shape} not supported! "
f"Only 2D (n, m) or 3D (n, m, 2) supported!")
super().__init__(message)
[docs]
class NoPathFoundError(Exception):
"""
Custom exception if no path can be found in the graph for source and target
"""
[docs]
def __init__(self, source: int, target: int, add_message: str = '') -> None:
message = (f"No path found from {source} to {target}! Choose different "
f"source and target or increase buffer!")
message = message + add_message
super().__init__(message)
[docs]
class AlgorithmNotImplementedError(Exception):
"""
Custom exception if a specific algorithm is not implemented in the API or the graph
library
"""
[docs]
def __init__(self, algorithm: str, graph_library: str) -> None:
message = f"Algorithm {algorithm} for {graph_library} not supported!"
super().__init__(message)
[docs]
class PairwiseError(Exception):
"""
Custom exception if pairwise computation fails
"""
[docs]
def __init__(self) -> None:
message = (f"Pairwise computation failed! Source and target lists must have "
f"the same length for pairwise computation!")
super().__init__(message)