🧭 A system map for the Federal Office for Agriculture

This repository is set up to gather and visualize information about IT systems, the data those contain and their operating organizations in the Swiss agri-food sector. You can visually explore this work on the following pages:

• DigiAgriFood system map, a visualization of the system map knowledge graph that specifically shows the classes organization, system and information unit.
• Circular system map, an alternative visualization in circular arrangement.
• Table on a federal demo site that shows (a) how quickly we can query LINDAS data and perform some computation and (b) how this information can be displayed on a (federal) webpage.
• Standalone search site to help you find an entity in case you're lost.
• Tiny data catalog demo to visualize datasets more conventionally.
• Nanoid generator just for internal use.

If instead you are interested in the actual data, you can have a look at the following folders:

• Ontology files contains information about how the data is structured. You can visualize it using WebVOWL.¹
• Data files contains information about the organizations, systems and information units themselves.

🔎 Subgraphs

Subgraphs of the system map allow inspecting one part of the overall system without being disturbed by the multitude of connected nodes around it. Have a look at the subgraphs for

• MARS III
• digiFLUX
• Acontrol
• AGIS
• NTGS

If you want a always up-to-date list of all subgraphs and their size, you can query the system map accordingly.

⚙️ Examples of SPARQL queries from LINDAS

The DigiAgriFoodCH System Map graph on LINDAS can be queried to return various tables as data products from one source. Here are some examples:

• Is there (sensitive) personal data in a system?
• Label and comment length for all objects in any language
• Private sector system engagement

You may find more examples in this directory

🔄 Run the data processing pipeline

To run the data processing and upload to LINDAS, follow these steps:

1. Add variables to .env

USER=lindas-foag
PASSWORD=********
GRAPH=https://lindas.admin.ch/foag/crops
ENDPOINT=https://stardog.cluster.ldbar.ch/lindas

2. Start a virtual environment and install libraries:

python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate
pip install -r requirements.txt

3. Execute upload.bash

bash upload.bash

4. Run all tests

pytest

You can find the rest of the technical documentation on the Wiki of this repository. There, the ontology, the data processing pipeline and the visualization tool are explained in much more detail.

Footnotes

1. Note that because WebVOWL expects rdfs:label and rdfs:comment and doesn't recognize the similar schema.org properties, we bind a separately written file here. ↩