Download the PHP package biigle/magic-sam without Composer
On this page you can find all versions of the php package biigle/magic-sam. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download biigle/magic-sam
More information about biigle/magic-sam
Files in biigle/magic-sam
Package magic-sam
Short Description BIIGLE module for the Magic SAM image annotation instrument .
License GPL-3.0-only
Homepage https://biigle.de
Informations about the package magic-sam
BIIGLE Magic SAM Module
This is a BIIGLE module that offers the Magic SAM image annotation instrument.
Installation
- Run
composer require biigle/magic-sam. - Run
php artisan vendor:publish --tag=publicto refresh the public assets of the modules. Do this for every update of this module. -
Configure a storage disk for the image embedding files. Set the
MAGIC_SAM_EMBEDDING_STORAGE_DISKvariable in the.envfile to the name of the respective storage disk. The content of the storage disk should be publicly accessible. Example for local disks:This requires the link
storage -> ../storage/app/publicin thepublicdirectory.
Configuration
Image embeddings are generated by a Python worker process that requires a dedicated Docker Compose configuration. The Docker container can be based on ghcr.io/biigle/pyworker but also must satisfy the Python requirements of this repository. The SAM model type and checkpoint URL are configured via environment variables, as shown below. Here is a full example configuration:
While image embeddings can be generated on the CPU it is much faster on a GPU.
Image embedding files are automatically deleted after 30 days. You can configure this with the MAGIC_SAM_PRUNE_AGE_DAYS environment variable.
References
Reference publications that you should cite if you use Magic SAM 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 - Segment Anything
Kirillov, A., Mintun, E., Ravi, N., Mao, H., Rolland, C., Gustafson, L., Xiao, T., Whitehead, S., Berg, A.C., Lo, W.Y. and Dollár, P., (2023). Segment anything.
arXiv preprint arXiv:2304.02643. doi:
10.48550/arXiv.2304.02643
Developing
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 and bug reports
Contributions to BIIGLE are always welcome. Check out the contribution guide to get started.