README

This is the BIIGLE module to perform a heuristic laser point detection on images.

Installation

This module is already included in biigle/biigle.

Run composer require biigle/laserpoints.
Add Biigle\Modules\Laserpoints\LaserpointsServiceProvider::class to the providers array in config/app.php.
Run php artisan vendor:publish --tag=public to publish the public assets of this module.
Run pip install -r vendor/biigle/laserpoints/requirements.txt to install the Python requirements.
Configure a storage disk for the temporary laserpoints files LASERPOINTS_DISK variable to the name of this storage disk in the .env file. Example for a local disk:
```
'laserpoints' => [
    'driver' => 'local',
    'root' => storage_path('framework/cache/laserpoints'),
],
```

Reference publications that you should cite if you use the laser point detection for one of your studies.

BIIGLE 2.0 Langenkämper, D., Zurowietz, M., Schoening, T., & Nattkemper, T. W. (2017). Biigle 2.0-browsing and annotating large marine image collections. Frontiers in Marine Science, 4, 83. doi: 10.3389/fmars.2017.00083
Laser Point Detection Schoening, T., Kuhn, T., Bergmann, M., & Nattkemper, T. W. (2015). DELPHI—fast and adaptive computational laser point detection and visual footprint quantification for arbitrary underwater image collections. Frontiers in Marine Science, 2, 20. doi: 10.3389/fmars.2015.00020

Take a look at the development guide of the core repository to get started with the development setup.

Want to develop a new module? Head over to the biigle/module template repository.

Contributions to BIIGLE are always welcome. Check out the contribution guide to get started.