# =============================================================================
# American Terawatt — Transmission Planner
# EXAMPLE: building a network from an edge list ("Upload edges")
# =============================================================================
#
# Open the point-to-point designer, click "Upload edges", and paste this whole
# file in. Lines starting with # are ignored, so the file is both the reference
# and a working example — it builds the network at the bottom as-is.
#
# -----------------------------------------------------------------------------
# ONE CONNECTION PER LINE
# -----------------------------------------------------------------------------
# Two sides separated by an arrow:   A -> B
# Accepted arrows:  ->   -->   =>   →   ⟶
#
# -----------------------------------------------------------------------------
# WHAT EACH SIDE NEEDS
# -----------------------------------------------------------------------------
# REQUIRED:  lat,lng   — the coordinate is what places the point.
# OPTIONAL:  name, gen/load, type, MW — in ANY order, | -separated. Omit any you
#            do not have. Fields are recognised by their SHAPE, not their column:
#
#   coordinates   anything that parses as lat,lng   -> REQUIRED, the location
#   kind          gen | generation | supply | ipp | source      -> generation
#                 load | demand | dc | datacenter | sink        -> load
#   capacity      a bare number, with or without MW  ("400", "400MW", "400 MW")
#   name          first leftover field
#   type          second leftover field   (geothermal, solar, data center, …)
#
# TO MAKE A HUB: give the SAME lat,lng on more than one line. The same coordinate
# is the same point (~0.1 m tolerance), so several edges converge on one node.
#
# -----------------------------------------------------------------------------
# COORDINATES — all of these are read the same way
# -----------------------------------------------------------------------------
#     38.42,-112.83        38.42 -112.83        38.42; -112.83
#     38.42° N, 112.83° W  38.42N 112.83W
# Latitude first, longitude second. Hemisphere letters carry the sign, so
# "112.83 W" and "-112.83" are the same thing. Latitude must be within ±90 and
# longitude within ±180 — a coordinate that fails is reported as a bad coordinate,
# never quietly treated as a name.
#
# -----------------------------------------------------------------------------
# WHEN A LINE IS WRONG
# -----------------------------------------------------------------------------
# Bad lines are reported with their line number and do NOT take the good ones
# down with them: a 20-line paste with one typo still gives you 19 pairs. Blank
# lines and # comments are skipped.
#
# -----------------------------------------------------------------------------
# UPLOADING A ROUTE INSTEAD OF POINTS
# -----------------------------------------------------------------------------
# This file places POINTS and the edges between them. To bring in an already-drawn
# route geometry, use "Import route" on the landing page (ArcGIS shapefile .zip,
# KML/KMZ, GeoJSON, or a Felt map).
#
# =============================================================================
# THE EXAMPLE NETWORK — everything below this line is real, pasteable input
# =============================================================================

# Fullest form: coordinates, plus name, kind and type on each side.
38.42,-112.83 | Cape Station | gen | geothermal -> 32.45,-99.73 | Joule Delta | load | data center

# A HUB: repeat Joule Delta's SAME coordinate and a second plant feeds the same point.
38.39,-113.01 | Milford Solar | gen | solar | 400MW -> 32.45,-99.73 | Joule Delta

# Coordinates only — no name, kind, type or MW. Auto-labelled P1, P2, …
38.35,-112.90 -> 32.20,-110.97

# Degree / hemisphere coordinates read the same as decimal.
37.10,-113.50 | Sierra Hub -> 32.45° N, 110.97° W | Tucson Load | load