From 1827f5f32f41007d42764129f4873414062bdecd Mon Sep 17 00:00:00 2001 From: Urs Hofmann Date: Mon, 22 Jul 2024 22:27:53 +0200 Subject: [PATCH 1/3] Fixing edit link for documentation, adding badge to README --- README.md | 2 ++ docs/.vitepress/config.mts | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 11f315c..1c93562 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # opensaft +![documentation](https://github.com/hofmannu/opensaft/actions/workflows/deploy-documentation.yml/badge.svg) + > [!WARNING] > This project is currently under development and not yet ready for use. Please check back later. diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 0089303..9bf27b8 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -38,7 +38,7 @@ export default defineConfig({ }, editLink: { - pattern: 'https://github.com/hofmannu/opensaft/edit/main/blog/:path', + pattern: 'https://github.com/hofmannu/opensaft/edit/main/docs/:path', }, markdown: { From 0a25c40048a306558455fe47a9969840139645b8 Mon Sep 17 00:00:00 2001 From: Urs Hofmann Date: Mon, 22 Jul 2024 22:29:17 +0200 Subject: [PATCH 2/3] Fixing typos in README --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1c93562..e333341 100644 --- a/README.md +++ b/README.md @@ -7,11 +7,11 @@ Volumetric synthetic aperture focusing technique (SAFT) for acoustic resolution optoacoustic microscopy and (soon) scanning acoustic microscopy. -This repository contains an implementation of the synthetic aperture focsuing technique purely written in C++ and CUDA. You need a CUDA capable device and Linux installed on your PC to run the fast GPU version of it. A "slow" CPU version is implemented as well. Installation instructions will soon be provided for ArchLinux as well as dataset specifications. +This repository contains an implementation of the synthetic aperture focusing technique purely written in C++ and CUDA. You need a CUDA capable device and Linux installed on your PC to run the fast GPU version of it. A "slow" CPU version is implemented as well. Installation instructions will soon be provided for ArchLinux as well as dataset specifications. ## Features -- Loading files from a stadardized h5 file format +- Loading files from a standardized `hdf5` file format - Defining transducer geometries - Supports both ultrasound pulse echo and optoacoustic mode - Graphical user interface including preview of preprocessed datasets and reconstructed datasets @@ -62,7 +62,7 @@ The last command will generate an executable called `main_exp`. ## Limitations of the underlying model -SAFT induces a strong absorption bias over depth. Absorbance "reconstructed" at different depths can therefore never be compared in a quantitative manner. It also tends to amplify low frequency signals which is the reason why most groups so far reconstruct different freqeucny bands independently (feature requires implementation). In planes very distant from the focus blurring is unavoidable due to the large shape of the reconstruction arcs. +SAFT induces a strong absorption bias over depth. Absorbance "reconstructed" at different depths can therefore never be compared in a quantitative manner. It also tends to amplify low frequency signals which is the reason why most groups so far reconstruct different frequency bands independently (feature requires implementation). In planes very distant from the focus blurring is unavoidable due to the large shape of the reconstruction arcs. ## Documentation @@ -99,7 +99,7 @@ The documentation is published on every merge to `main` to [github pages](https: ### Error while loading files -If there is an error occuring about a version mismatch of the hdf5 library while loading a dataset from a file, it is most likely not the dataset itself that has an outdated format but rather the version of the installed h5 library and the library you linked during compilation (e.g. your PC updated the h5 library in the meantime). Simply recompile the program and the error should be gone. +If there is an error occurring about a version mismatch of the `hdf5` library while loading a dataset from a file, it is most likely not the dataset itself that has an outdated format but rather the version of the installed `hdf5` library and the library you linked during compilation (e.g. your PC updated the `hdf5` library in the meantime). Simply recompile the program and the error should be gone. ### Currently not tested against datasets From a03904a8542c04fb9bb83bc30e7c2eeb595088a8 Mon Sep 17 00:00:00 2001 From: Urs Hofmann Date: Mon, 22 Jul 2024 22:53:51 +0200 Subject: [PATCH 3/3] Adding logo and a few literature references --- docs/index.md | 3 ++ docs/literature.md | 26 +++++++++- docs/public/logo.svg | 114 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 142 insertions(+), 1 deletion(-) create mode 100644 docs/public/logo.svg diff --git a/docs/index.md b/docs/index.md index efb70ab..754ba3d 100644 --- a/docs/index.md +++ b/docs/index.md @@ -6,6 +6,9 @@ hero: name: "opensaft" text: tagline: An open source implementation of the SAFT technique for optoacoustic imaging + image: + src: /logo.svg + alt: opensaft-logo actions: - theme: alt text: Physics diff --git a/docs/literature.md b/docs/literature.md index 573b526..cce9cf8 100644 --- a/docs/literature.md +++ b/docs/literature.md @@ -1,3 +1,27 @@ # Literature -Here we will add a throughout literature review for the technique \ No newline at end of file +## SAFT + +- C.-K. Liao et al.: Optoacoustic imaging with synthetic aperture focusing and coherence weighting *Optics Letters* 2004, [10.1364/OL.29.002506][liao2004] +- Meng-Lin Li et al.: Improved in vivo photoacoustic microscopy based on a virtual-detector concept *Optica* 2006 [10.1364/OL.31.000474][li2006] +- Jake Turner et al.: Improved optoacoustic microscopy through three-dimensional spatial impulse response synthetic aperture focusing technique, *Optica* 2014 [10.1364/OL.39.003390][turner2014] +- Jake Turner et al.: Universal weighted synthetic aperature focusing technique (W-SAFT) for scanning optoacoustic microscopy, *Optica* 2017 [10.1364/OPTICA.4.000770][turner2017] + +## Iterative reconstruction + +- Urs Hofmann et al.: Enhancing optoacoustic mesoscopy through calibration-based iterative reconstruction *Photoacoustics* 2022 [10.1016/j.pacs.2022.100405][hofmann2022] + +## System descriptions + +- Urs A. T. Hofmann et al.: Rapid functional optoacoustic micro-angiography in a burst mode *Optics Letters* 2020, [10.1364/OL.387630][hofmann2020] + +## Applications + +missing + +[liao2004]: https://doi.org/10.1364/OL.29.002506 +[li2006]: https://doi.org/10.1364/OL.31.000474 +[turner2014]: https://doi.org/10.1364/OL.39.003390 +[turner2017]: https://doi.org/10.1364/OPTICA.4.000770 +[hofmann2020]: https://doi.org/10.1364/OL.387630 +[hofmann2022]: https://doi.org/10.1016/j.pacs.2022.100405 diff --git a/docs/public/logo.svg b/docs/public/logo.svg new file mode 100644 index 0000000..fb357b7 --- /dev/null +++ b/docs/public/logo.svg @@ -0,0 +1,114 @@ + + + + + + + + + + + + + + + + + + + + + + +