How sebastianolmos/pylondrina works
Pylondrina is a Python library implementing the Golondrina mobility-data contract, with an auxiliary web flow viewer. Its principal workflow imports heterogeneous trips, validates and transforms them, builds OD flows, then persists or exports results; persisted flows can be inspected in the viewer. The graph preserves documented trace operations and flow queries as additional branches. Several subsystem links rely on README-level descriptions because those implementations were not excerpted; those links are cited to the README rather than implying source inspection.
Main entry points: importing.py Import trips · main.js Viewer bootstrap · datasets.py Dataset models · validation.py Validate trips
Components 28
Data contract
- Schemas
src/pylondrina/schema.py - Dataset models
src/pylondrina/datasets.py - Source profiles
src/pylondrina/sources/profile.py
Mobility operations
- Import trips
src/pylondrina/importing.py - Validate trips
src/pylondrina/validation.py - Fix correspondences
src/pylondrina/fixing.py - Clean trips
src/pylondrina/transforms/cleaning.py - Filter datasets
src/pylondrina/transforms/filtering.py - Build OD flows
src/pylondrina/transforms/flows.py - Filter flows
src/pylondrina/transforms/flows_filtering.py - Import traces
src/pylondrina/importing_traces.py - Validate traces
src/pylondrina/validation_traces.py - Infer trips
src/pylondrina/transforms/inference.py - Flow queries
src/pylondrina/queries/flows.py
Reports and artifacts
- Operation reports
src/pylondrina/reports.py - Issue catalog
src/pylondrina/issues/core.py - Trip bundles
src/pylondrina/io/trips.py - Flow bundles
src/pylondrina/io/flows.py - Flow export
src/pylondrina/export/flows.py
Flow viewer
- Viewer bootstrap
viewer_src/app/main.js - Registry loader
viewer_src/app/data/loadViewerRegistry.js - Dataset loader
viewer_src/app/data/loadDatasetData.js - Golondrina loader
viewer_src/app/data/loadGolondrinaFlowData.js - Map rendering
viewer_src/app/map/viewer.js - Map overlays
viewer_src/app/ui/overlays.js - Viewer state
viewer_src/app/state.js
Other components
- Analyst
- Viewer user
Connections 39
- Analyst → Import trips: supplies data
README.md - Import trips → Schemas: uses contract
src/pylondrina/importing.py - Import trips → Dataset models: creates dataset
src/pylondrina/importing.py - Source profiles → Import trips: configures import
src/pylondrina/sources/profile.py - Import trips → Validate trips: validates result
README.md - Validate trips → Dataset models: checks dataset
src/pylondrina/validation.py - Validate trips → Operation reports: returns report
README.md - Import trips → Operation reports: returns report
src/pylondrina/importing.py - Import trips → Issue catalog: emits issues
src/pylondrina/importing.py - Validate trips → Issue catalog: emits issues
src/pylondrina/validation.py - Analyst → Fix correspondences: requests corrections
README.md - Fix correspondences → Dataset models: corrects data
README.md - Analyst → Clean trips: requests cleaning
README.md - Clean trips → Dataset models: transforms trips
README.md - Analyst → Filter datasets: requests filtering
README.md - Filter datasets → Dataset models: filters trips
src/pylondrina/transforms/filtering.py - Analyst → Build OD flows: builds flows
README.md - Build OD flows → Dataset models: consumes trips
README.md - Analyst → Trip bundles: persists trips
README.md - Trip bundles → Dataset models: reads bundles
src/pylondrina/io/trips.py - Analyst → Flow bundles: persists flows
README.md - Analyst → Flow export: exports flows
README.md - Flow export → Operation reports: records outcome
src/pylondrina/export/flows.py - Analyst → Filter flows: filters flows
README.md - Analyst → Flow queries: queries mappings
README.md - Analyst → Import traces: imports traces
README.md - Import traces → Validate traces: validates traces
README.md - Validate traces → Infer trips: enables inference
README.md - Viewer user → Viewer bootstrap: selects dataset
viewer_src/app/main.js - Viewer bootstrap → Registry loader: loads registry
viewer_src/app/main.js - Viewer bootstrap → Dataset loader: loads dataset
viewer_src/app/main.js - Dataset loader → Golondrina loader: loads Golondrina
- Viewer bootstrap → Map rendering: starts viewer
viewer_src/app/main.js - Viewer bootstrap → Viewer state: sets loaded data
viewer_src/app/main.js - Map rendering → Viewer state: reads state
viewer_src/app/map/viewer.js - Map rendering → Map overlays: updates overlays
viewer_src/app/map/viewer.js - Map overlays → Viewer state: reads state
viewer_src/app/ui/overlays.js - Registry loader → Viewer state: supplies registry
- Viewer bootstrap → Flow bundles: inspects persisted flows