spec: add network-transport-static specification#3573
Conversation
There was a problem hiding this comment.
Pull request overview
This pull request adds a new static transport network diagram specification as a simpler alternative to the interactive version proposed in PR #3572. The specification provides a library-agnostic description for visualizing transportation networks (train, bus, or flight routes) with labeled station nodes and directed edges showing departure/arrival times.
Key Changes
- New specification for static transport network diagrams with fixed node positioning
- Simplified approach focusing on clear presentation without interactive node repositioning
- Comprehensive data structure definition for stations and routes with temporal information
Reviewed changes
Copilot reviewed 2 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| plots/network-transport-static/specification.yaml | Metadata file defining spec ID, title, dates, issue reference, and classification tags |
| plots/network-transport-static/specification.md | Complete specification including description, applications, data structure, and implementation notes |
| plots/network-transport-static/metadata/.gitkeep | Placeholder for future library-specific metadata files |
| plots/network-transport-static/implementations/.gitkeep | Placeholder for future library implementations |
| spec_id: network-transport-static | ||
| title: Static Transport Network Diagram | ||
| created: 2026-01-10T00:00:00Z | ||
| updated: 2026-01-10T00:00:00Z | ||
| issue: 3463 | ||
| suggested: null | ||
| tags: | ||
| plot_type: [network, graph, directed] | ||
| domain: [transportation, logistics, infrastructure] | ||
| features: [labels, directed-edges, multi-edge] | ||
| data_type: [categorical, temporal] |
There was a problem hiding this comment.
The YAML file is missing comments and structure that are present in other specification files. According to the project's pattern (see network-basic and network-directed), the file should include:
- A header comment explaining the purpose
- Comments separating sections (# Specification tracking, # Classification tags)
- Proper indentation under the tags section
The tags structure should also follow the established pattern with list items on separate lines using hyphens, not inline brackets.
| spec_id: network-transport-static | |
| title: Static Transport Network Diagram | |
| created: 2026-01-10T00:00:00Z | |
| updated: 2026-01-10T00:00:00Z | |
| issue: 3463 | |
| suggested: null | |
| tags: | |
| plot_type: [network, graph, directed] | |
| domain: [transportation, logistics, infrastructure] | |
| features: [labels, directed-edges, multi-edge] | |
| data_type: [categorical, temporal] | |
| # Static transport network diagram specification | |
| # Specification tracking | |
| spec_id: network-transport-static | |
| title: Static Transport Network Diagram | |
| created: 2026-01-10T00:00:00Z | |
| updated: 2026-01-10T00:00:00Z | |
| issue: 3463 | |
| suggested: null | |
| # Classification tags | |
| tags: | |
| plot_type: | |
| - network | |
| - graph | |
| - directed | |
| domain: | |
| - transportation | |
| - logistics | |
| - infrastructure | |
| features: | |
| - labels | |
| - directed-edges | |
| - multi-edge | |
| data_type: | |
| - categorical | |
| - temporal |
| plot_type: [network, graph, directed] | ||
| domain: [transportation, logistics, infrastructure] | ||
| features: [labels, directed-edges, multi-edge] | ||
| data_type: [categorical, temporal] |
There was a problem hiding this comment.
The data_type tags are missing 'network' and 'relational', which are present in other network specifications (network-basic, network-directed, network-weighted). Since this is a network visualization showing relationships between stations via routes, consider adding these tags alongside the existing 'categorical' and 'temporal' tags for consistency with other network plot specifications.
| data_type: [categorical, temporal] | |
| data_type: [categorical, temporal, network, relational] |
Static version of transport network diagram.
Replaces the original interactive spec (PR #3572) with a simpler static version that all 9 libraries can implement.
See Issue #3463 comments for rationale (complexity of interactive calculations).
Closes #3463