Skip to content

docs: add Barcelona and Stockholm use-case demos - #475

Closed
kanaaraman wants to merge 2 commits into
mainfrom
docs/barcelona-amb-gtfs-demo
Closed

kanaaraman wants to merge 2 commits into
mainfrom
docs/barcelona-amb-gtfs-demo

Conversation

@kanaaraman

@kanaaraman kanaaraman commented Oct 21, 2026 •

Copy link
Copy Markdown

What type of PR is this? (check all applicable)

  • Refactor
  • Test Result
  • Deployment Update
  • Design Decision
  • Documentation Update

Description

Adds two end-to-end use-case demos under design_decisions/data_sources/: Barcelona (AMB bus GTFS) and Stockholm (SLB air quality for the low emission zone).

Barcelona AMB demo (barcelona_demo/, linked from barcelona.md)

  • validate_gtfs.sh: checks required GTFS files, record counts, referential integrity (trips → routes, stop_times → stops/trips) and feed validity dates.
  • profile_gtfs.sh: routes per operator, busiest lines, wheelchair-accessible stops and modes.
  • bcn-amb-gtfs.workflow.yaml: EDC management API workflow (asset, policy, contract definition, catalogue, negotiation, transfer) reusing the request shapes from test 2.2.3.1A. Hosts, API key and the MobilityDCAT-AP theme URI are placeholders.

Run on 2026-10-21 against AMB feed version 20261021 (8,295,351 bytes, sha256 bc87858b…cddc3b):

validate_gtfs.sh  RESULT: PASS
  11 agencies, 140 routes, 4970 stops, 30145 trips, 950579 stop_times
  trips -> routes 0 orphans · stop_times -> stops 0 orphans · stop_times -> trips 0 orphans
profile_gtfs.sh
  busiest line M19 Badalona-Barcelona (1092 trips) · wheelchair-boarding stops 1888 of 4970 (38%)

Stockholm LEZ demo (stockholm_demo/, new stockholm.md)

SLB-analys (provider) shares NO2, PM10 and noise with Trafikkontoret (consumer) for low emission zone follow-up.

  • fetch_slb.sh: hourly NO2 and PM10 from the open SLB API (public key lvl1).
  • analyse_slb.sh: mean, peak, latest, busiest hour and days above the WHO 2021 24 h guidelines (NO2 25, PM10 45 µg/m³).
  • slb-tk-lez.workflow.yaml: EDC calls with a policy limited to TK and the purpose LEZ-follow-up. The EnviroSuite noise key is referenced only as a vault secret name.

Run on 2026-10-21 for Norrlandsgatan 21, 7–21 Oct (675 hourly records):

analyse_slb.sh
  NO2   mean 11.8  peak 44.3 at 2026-10-19T11:00  days above WHO 24h guideline (25): 1 of 13
  PM10  mean 9.1   peak 30.4 at 2026-10-15T09:00  days above WHO 24h guideline (45): 0 of 13

Neither connector workflow has been executed against live connectors yet; both are ready-to-fill collections with placeholder hosts, DIDs and keys.

Related Tickets & Documents

  • Related to design_decisions/data_sources/barcelona.md and the new stockholm.md
  • Request shapes from tests/data_product_publication/publication/publication_on_emds_catalogue/test_2_2_3_1a

Instructions

  • I have linked the PR to a relevant issue in our tracker. (no existing issue)
  • I have used descriptive commit messages.
  • I have updated any related documentation and included any relevant screenshots.
  • In case this is a Test Result PR, I have included the test results in the correct test_X_Y_Z_T/result_{testing_facility}.md file. (not a test result PR)
  • I have verified that the submitted code follows the deployEMDS Information Security Policy and filled out the risk assessment template below:

Security Risk Assessment

Deliverable Info
Work Package 2
Task 2.2
Deliverable D2.2
Work package lead (name) Sebastian Pretzsch (FHG)
Task lead (name) Laure De Cock (IMEC)
Deliverable lead (name) Sebastian Pretzsch (FHG)
Result Yes/No Risk (low, medium, high) Describe if Yes
Sensitive Information: Is information used or created already marked as sensitive or is the deliverable listed in Annex 3 – Information Asset Register with security recommendation of the deployEMDS Information Security Policy? Yes N/A Deliverable is listed in Annex 3.
Does the activity generate knowledge, materials or technologies that could be adapted for a malicious act? No
Does the activity provide a description of gaps or weaknesses in networks, services, systems, assets, operations or processes which can be exploited during malicious acts? No
Does the activity provide exact guidelines on the design, composition, manufacture, maintenance or operation of threat substances or countermeasure substances, technologies and procedures? No
Does the activity provide a description of the ability of an asset, system, network, service or authority to fulfil its intended role? No Uses public open data only; no hosts, keys, credentials or internal addresses are included.
Does the activity provide detailed information on real-life security incidents and potential threat scenarios? No

🤖 Generated with Claude Code

Add validate_gtfs.sh and profile_gtfs.sh, which check and summarise the
AMB metropolitan bus GTFS feed listed in barcelona.md, and an EDC
workflow that publishes the feed as a data product using the request
shapes from test 2.2.3.1A. Link the demo from barcelona.md.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@kanaaraman
kanaaraman marked this pull request as ready for review October 21, 2026 07:56
@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://salmon-desert-0898cbb03-475.westeurope.5.azurestaticapps.net

Add stockholm.md listing SLB-analys data sources, and a demo in which
SLB shares NO2, PM10 and noise with Trafikkontoret for low emission
zone follow-up: fetch_slb.sh and analyse_slb.sh fetch hourly data from
the open SLB API and compare it with the WHO 2021 24 h guidelines, and
slb-tk-lez.workflow.yaml holds the EDC calls with a purpose-bound
policy. No API keys are included.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@kanaaraman kanaaraman changed the title docs: add Barcelona AMB GTFS demo scripts docs: add Barcelona and Stockholm use-case demos Oct 21, 2026
@github-actions

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://salmon-desert-0898cbb03-475.westeurope.5.azurestaticapps.net

@kanaaraman

Copy link
Copy Markdown
Author

Closing: this demo material now lives in a separate repository instead.

@kanaaraman kanaaraman closed this Oct 21, 2026
@kanaaraman
kanaaraman deleted the docs/barcelona-amb-gtfs-demo branch October 21, 2026 10:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant