Skip to content

Commit

Permalink
Check more parameters and change summary of display changes
Browse files Browse the repository at this point in the history
  • Loading branch information
alexschimel committed Jan 11, 2023
1 parent aa0de1d commit 484757a
Show file tree
Hide file tree
Showing 7 changed files with 10 additions and 42 deletions.
Binary file modified Iskaffe.mlapp
Binary file not shown.
Binary file added Iskaffe_resources/Iskaffe_fig_icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Iskaffe_resources/download.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Iskaffe_resources/iskaffe_banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Iskaffe_resources/iskaffe_banner.xcf
Binary file not shown.
Binary file added Iskaffe_resources/screenshot_Iskaffe_v015.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
52 changes: 10 additions & 42 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ Multibeam backscatter quality control.

## Description

*Iskaffe* (Norwegian Bokmål for "iced coffee") is a free and open-source app to help assess the quality of the seafloor backscatter data acquired by multibeam echosounders. *Iskaffe* uses the [CoFFee multibeam data processing toolbox](https://github.com/alexschimel/CoFFee) (hence the name). It is coded in [MATLAB](https://www.mathworks.com/products/matlab.html), but is also available as a standalone application that does not require a MATLAB licence (see the Dependencies and Installing sections).
*Iskaffe* (Norwegian Bokmål for "iced coffee") is a free and open-source app to help assess the quality of the seafloor backscatter data acquired by multibeam echosounders. The main purpose of this tool is to serve as a development platform to come up with a set of algorithms that assess various aspects of backscatter quality, and define standards of backscatter quality based on the output of those algorithms. While we are currently developping *Iskaffe* for our own use, we are welcoming co-developers and feedback to help coming up with more widely-applicable algorithms and backscatter quality standards.

The main purpose of *Iskaffe* is to serve as a platform to help the community of multibeam backscatter users to come up with 1) a set of algorithms that assess various aspects of backscatter quality, and 2) standards of backscatter quality based on the output of those algorithms. Thus, while we are currently developping *Iskaffe* for our own use, we are actively seeking collaborators and feedback to help developing more universal algorithms and come up with backscatter quality standards.
*Iskaffe* uses the [CoFFee multibeam data processing toolbox](https://github.com/alexschimel/CoFFee) (hence the name). It is coded in [MATLAB](https://www.mathworks.com/products/matlab.html), but is also available as a standalone application that does not require a MATLAB licence (see the Dependencies and Installing sections).

*Iskaffe* is still at an early stage of development so it has fewer features and more bugs than you would want. Please be patient. For a starter, its main current limitations are that it only works with Kongsberg EM Series .all files for now, and that it does not like loading too many files at a time. The main features of the latest release are:
*Iskaffe* is still at an early stage of development so it has fewer features and more bugs than you would want. Please be patient. For a starter, its main current limitations are that it only works with Kongsberg EM Series .all files, and that it does not like loading too many files at a time. Still, the latest release already has some relevant features:
* Detect and alarm when a dataset contains data in more than one acquisition mode
* Display backscatter, bathymetry, slope, and acquisition mode
* Find, display, and count "bad" soundings and "bad" pings, for each loaded line
Expand Down Expand Up @@ -52,15 +52,15 @@ Note: At start-up, *Iskaffe* creates a `Iskaffe` user folder (normally, C:\Users

## Help

There is no documentation yet, but a powerpoint presentation is available for download [from the releases page](https://github.com/alexschimel/Iskaffe/releases).
There is no documentation yet, but a powerpoint presentation of an earlier release (v0.1.2) is available for download [from the releases page](https://github.com/alexschimel/Iskaffe/releases).

If you want to receive notifications of future releases (recommended), you may create a github account, and on this repository click on 'Watch', then 'Custom', and choose 'Releases'. Verify in your GitHub settings that you are set to receive 'Watching' notifications.

For more information, contact the authors.

## Authors

* Alexandre Schimel([The Geological Survey of Norway](https://www.ngu.no), alexandre.schimel@ngu.no)
* Alexandre Schimel ([The Geological Survey of Norway](https://www.ngu.no), alexandre.schimel@ngu.no)
* Margaret Dolan, Shyam Shand, Terje Thorsnes, Lilja Rún Bjarnadóttir (The Geological Survey of Norway)

## Version History
Expand All @@ -74,9 +74,10 @@ Distributed under the MIT License. See `LICENSE.txt` for more information.
## See Also

All apps based on CoFFee:
* *Grounds*: https://github.com/alexschimel/Grounds
* *Espresso* (private)
* *Iskaffe*: https://github.com/alexschimel/Iskaffe
* [*Grounds*](https://github.com/alexschimel/Grounds): Elevation Change Analysis
* *Espresso*: Water-column data viewing and processing (private)
* [*Iskaffe*](https://github.com/alexschimel/Iskaffe): Multibeam backscatter quality control
* [*Kopp*](https://github.com/alexschimel/Kopp): Tracking Multibeam raw data parameter changes


## Acknowledgments
Expand All @@ -89,37 +90,4 @@ None to date.

## For developers

*Iskaffe* is not the only application built on *CoFFee* (see list above). The philosophy behind their development is that all back-end (processing) goes in *CoFFee* while all front-end (display, user interface, application) goes in those apps. As a result, it is possible that *CoFFee* gets ahead of *Iskaffe* in terms of development, so careful version controlling is necessary.

We use [Semantic Versioning](https://semver.org/) to attribute version numbers:
* The version of CoFFee is hard-coded in function `CFF_coffee_version.m`.
* The version of *Iskaffe* is a static property of the app (`Version`), alongside the CoFFee version it was built on (`CoffeeVersion`).

A careful sequence to develop *Iskaffe* is the following:

1. Checkout the latest commits on the main branches of both *CoFFee* and *Iskaffe*.
2. Check if that latest version of *Iskaffe* uses the latest version of *CoFFee* (in the code, or warning at start-up).
3. If *Iskaffe* is running on an older version of *CoFFee*:
* Start with updating *Iskaffe* to use that latest version of *CoFFee*.
* Before committing those changes, increase *Iskaffe*'s version number and update which *CoFFee* version it runs on.
* After committing, remember to add the new tag on git.
4. Develop *Iskaffe* as you wish. Remember that all processing goes ideally in *CoFFee* and all display and user interface on *Iskaffe*.
5. When done, if *CoFFee* was modified:
* Increase its version number.
* Push it up on git first. Add a tag.
6. Increase version number for *Iskaffe* (and update which *CoFFee* version it was built on).
7. If you wish to compile this new version of *Iskaffe*:
* In MATLAB, run `restoredefaultpath` to ensure you get a clean path.
* Run *Iskaffe* and check a last time it all works fine.
* Double-click on the file `Iskaffe.prj` to run the application compiler with existing settings:
* Remove the main file `Iskaffe.mlapp` and add it again for the application compiler to find all dependencies.
* Update the version number in the setup filename, the application information, and the default installation folder.
* Save.
* Click on `Package`.
* Install the new executable with the setup file.
* Test that the setup works correctly.
* Test that the installed software runs correctly.
8. Push *Iskaffe* up on git. Add a version tag.
9. If you compiled that new version:
* Create a new release on github from the tag.
* Add the binary setup, and a zipped version of the `for_redistribution_files_only` folder.
[See the 'For developers' section on the *CoFFee* page](https://github.com/alexschimel/CoFFee)

0 comments on commit 484757a

Please sign in to comment.