import { Feature, FeatureCollection, LineString, Point } from "geojson"; import { BoundingBox } from "./methods/bounding-box"; /** * Represents a graph constructed from a GeoJSON FeatureCollection of LineString features. * This class provides methods to analyze the graph, including connected components, node and edge counts, * and shortest paths. Coordinates in the LineStrings are considered connected if they share identical coordinates. */ export declare class TerraRouteGraph { constructor(network: FeatureCollection); private network; /** * Gets the length of a specific route. * @param line A GeoJSON Feature of type LineString * @returns The length of the route in meters */ getRouteLength(line: Feature): number; /** * Sets the network for the graph. * This method replaces the current network with a new one. * @param network A GeoJSON FeatureCollection of LineString features representing the network. */ setNetwork(network: FeatureCollection): void; /** * Gets the current network of the graph. * @returns A GeoJSON FeatureCollection of LineString features representing the network. */ getNetwork(): FeatureCollection; /** * Gets a filtered network containing only LineStrings that are completely within the specified bounding box. * @param boundingBox A bounding box array in the format [minLng, minLat, maxLng, maxLat] * @returns A GeoJSON FeatureCollection of LineString features representing the network filtered by the bounding box. */ getNetworkInBoundingBox(boundingBox: BoundingBox): FeatureCollection; /** * Gets the network without duplicate or subsection lines. * This method processes the network to remove any duplicate lines or lines that are subsections of other lines. * @returns A FeatureCollection representing the network without duplicate or subsection lines. */ getNetworkWithoutDuplicatesOrSubsections(): FeatureCollection; /** * Gets the connected components of the graph. * @returns An array of FeatureCollection representing the connected components. */ getConnectedComponents(): FeatureCollection[]; /** * Gets the count of connected components in the graph. * @returns The number of connected components in the graph. */ getConnectedComponentCount(): number; /** * Gets the count of unique nodes and edges in the graph. * @returns An object containing the counts of nodes and edges. */ getNodeAndEdgeCount(): { nodeCount: number; edgeCount: number; }; /** * Gets the unique nodes of the graph as a FeatureCollection of Point features. * @returns A FeatureCollection containing the nodes of the graph. */ getNodes(): FeatureCollection; /** * Gets the count of unique nodes in the graph. * @returns The number of unique nodes in the graph. */ getNodeCount(): number; /** * Gets the unique edges of the graph as a FeatureCollection of LineString features. Each edge is represented as a LineString. * This method ensures that each edge is unique, meaning that edges are not duplicated in the collection. Each linestring only * two coordinates, representing the start and end points of the edge. * @returns A FeatureCollection containing the unique edges of the graph. */ getEdges(): FeatureCollection; /** * Gets the length of the longest edge in the graph based on the length of the LineString. * If no edges exist, it returns -1. * @returns The length of the longest edge in meters, or 0 if no edges exist. */ getLongestEdgeLength(): number; /** * Gets the average length of all edges in the graph based on the length of the LineString. * If no edges exist, it returns -1. * @returns The average length of all edges in meters, or -1 if no edges exist. */ getAverageEdgeLength(): number; /** * Gets the degree of each node in the graph. * @returns A Map where the key is a coordinate string "lng,lat" and the value is the degree. */ getNodeDegrees(): Record; /** * Gets summary statistics for node degrees (min, max, average). */ getNodeDegreeStats(): { min: number; max: number; avg: number; }; /** * Gets the length of the shortest edge in the graph based on the length of the LineString. * If no edges exist, it returns -1. * @returns The length of the shortest edge in meters, or 0 if no edges exist. */ getShortestEdgeLength(): number; /** * Gets the longest edge in the graph based on the length of the LineString. * @returns The longest edge as a Feature or null if no edges exist. */ getLongestEdge(): Feature | null; /** * Gets the shortest edge in the graph based on the length of the LineString. * @returns The shortest edge as a Feature or null if no edges exist. */ getShortestEdge(): Feature | null; /** * Gets the count of unique edges in the graph. * @returns The number of unique edges in the graph. */ getEdgeCount(): number; /** * Gets the leaf edges of the graph. A leaf edge is defined as an edge whose start or end node has a degree of 1. * Here an edge is defined as a LineString with two coordinates, representing the start and end points. * @returns A FeatureCollection containing only the leaf edges of the graph. */ getLeafEdges(): FeatureCollection; /** * Returns the pruned network, which is the network without the leaf edges. * i.e. This method removes all leaf edges from the network, leaving only the non-leaf edges * @return A FeatureCollection representing the pruned network without leaf edges. */ getPrunedEdges(depth?: number): FeatureCollection; /** * Returns the network where all nodes that are with n meters of each other are unified. * The function will avoid unifying coordinates in the same linestring. * @param toleranceMeters the tolerance for unifying nodes in meters. */ getUnifiedNetwork(toleranceMeters: number): FeatureCollection; }