From b9c829a8697be25cedf6c0fa5fbcde687900b93f Mon Sep 17 00:00:00 2001 From: shnmrt Date: Tue, 2 Sep 2025 15:33:25 +0200 Subject: [PATCH 1/3] fix: installation of duckdb before run the test --- .github/workflows/test-ci.yml | 57 ++++++++++++++++++----------------- 1 file changed, 29 insertions(+), 28 deletions(-) diff --git a/.github/workflows/test-ci.yml b/.github/workflows/test-ci.yml index 708dd3c..0c71231 100644 --- a/.github/workflows/test-ci.yml +++ b/.github/workflows/test-ci.yml @@ -1,10 +1,10 @@ name: Test CI -on: +on: push: - branches: [ main ] + branches: [main] pull_request: - branches: [ main ] + branches: [main] jobs: test: @@ -16,32 +16,33 @@ jobs: python-version: ["3.11"] steps: - - name: Checkout code - uses: actions/checkout@v4 + - name: Checkout code + uses: actions/checkout@v4 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v5 - with: - python-version: ${{ matrix.python-version }} + - name: Set up Python ${{ matrix.python-version }} + uses: actions/setup-python@v5 + with: + python-version: ${{ matrix.python-version }} - - name: Install project and tools - run: | - python -m pip install --upgrade pip - pip install . - pip install coverage + - name: Install project and tools + run: | + python -m pip install --upgrade pip + pip install . + python -c "import duckdb; duckdb.install_extension('spatial')" + pip install coverage - - name: Run unittests with coverage - env: - PYTHONWARNINGS: ignore::ResourceWarning - PYTHONPATH: src - run: | - coverage run -m unittest discover -s test -p "test_*.py" - coverage report -m --omit="test/*" - coverage xml + - name: Run unittests with coverage + env: + PYTHONWARNINGS: ignore::ResourceWarning + PYTHONPATH: src + run: | + coverage run -m unittest discover -s test -p "test_*.py" + coverage report -m --omit="test/*" + coverage xml - - name: Upload coverage report - if: success() - uses: actions/upload-artifact@v4 - with: - name: coverage-report - path: coverage.xml \ No newline at end of file + - name: Upload coverage report + if: success() + uses: actions/upload-artifact@v4 + with: + name: coverage-report + path: coverage.xml From 121b259eee23cff4bf888fc974bedc17bbc05a43 Mon Sep 17 00:00:00 2001 From: shnmrt Date: Fri, 12 Sep 2025 08:54:02 +0200 Subject: [PATCH 2/3] docs: enhancing docs --- README.md | 10 ++++++++-- docs/source/index.rst | 6 +++--- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index ea1356e..9805b13 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,9 @@ ## Overview -**SafeBridge** is a light-weight open-source tool for the Python programming language that calculates bridge damage indicators with low latency by combining remotely sensed and processed data (Persistent Scatterer InSAR time series) with algorithms to process topologies in the geospatial domain. +**SafeBridge** is a light-weight open-source tool for the Python programming language that estimates bridge damage indicators with low latency by combining remotely sensed and processed data (Multi-Temporal InSAR time series) with algorithms to process topologies in the geospatial domain. + +For furher information and underlying research, you can check the paper from [here](https://www.ndt.net/search/docs.php3?id=29731) ## Installation @@ -45,6 +47,10 @@ python tutorial.py If everything works correctly, you should see a folder called **`SafeBridgeDB`** inside the example folder. Inside that folder, you will find the generated **PDF** report for the entire dataset provided. -## Acknowledgements & Funding +## Disclaimer + +The toy MT-InSAR data presented in the repository and used for the tutorial is a synthetic one and has no relation to real data. It was generated with the intent to present how the `SafeBridge` is working. + +## Acknowledgements This work is supported by Vidi project InStruct, project number 18912, financed by the Dutch Research Council (NWO). diff --git a/docs/source/index.rst b/docs/source/index.rst index 9b0d407..275f9f9 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -11,7 +11,7 @@ Welcome to SafeBridge's documentation! :align: left :alt: SafeBridge Logo -**SafeBridge** is an open-source Python package to calculate the damage indicators for bridges, utilising Persistent Scatter InSAR (PSInSAR) +**SafeBridge** is an open-source Python package for estimating damage indicators for bridges, utilising Multi-Temporal InSAR (MT-InSAR) time-series data and geospatial operations to leverage bridge topologies within a Geographical Information System (GIS) environment. **SafeBridge** provides an efficient way to derive the damage indicators for bridges promptly in the era of big data. @@ -37,9 +37,9 @@ Background & Motivation The growing use of satellite-based monitoring, particularly time-series data from MT-InSAR, has led to a significant increase in data volume and complexity, posing challenges for researchers and engineers in terms of storage, processing, and analysis. Handling such large datasets often requires access to high-performance computing (HPC) systems; however, access to these resources can be limited by institutional constraints, cost, or technical barriers. As an alternative, many professionals -rely on in-house computing resources—laptops, desktops, or workstations—which demand careful optimisation and the use of efficient, open-source tools to manage processing +rely on in-house computing resources such as laptops, desktops, or workstations, which demand careful optimisation and the use of efficient, open-source tools to manage processing loads. Yet, selecting and effectively using these tools requires expertise across multiple domains, including geospatial analysis, remote sensing, and data science. This is -where `SafeBridge` offers a practical solution—by providing a streamlined, tailored approach for analysing Persistent Scatterer InSAR time-series data, it simplifies the complex +where `SafeBridge` offers a practical solution—by providing a streamlined, tailored approach for analysing Multi-Temporal InSAR time-series data, it simplifies the complex workflow of bridge damage detection, enabling more users to extract meaningful insights from satellite observations without needing advanced computation infrastructures. From 65ff866c5602803e5f7a5d07979c566c22ce769f Mon Sep 17 00:00:00 2001 From: shnmrt Date: Fri, 12 Sep 2025 08:59:18 +0200 Subject: [PATCH 3/3] docs: fix doi --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9805b13..96c932a 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ **SafeBridge** is a light-weight open-source tool for the Python programming language that estimates bridge damage indicators with low latency by combining remotely sensed and processed data (Multi-Temporal InSAR time series) with algorithms to process topologies in the geospatial domain. -For furher information and underlying research, you can check the paper from [here](https://www.ndt.net/search/docs.php3?id=29731) +For furher information and underlying research, you can check the paper from [here](https://doi.org/10.58286/29731) ## Installation