BatBot upgrade for original Sample Rate (#514)

* support for origsr

* update batbot spectrogram script

* original sr helper testing helper scripts

* updating helper functions

* update to batbot 0.1.5

* swap default to original sample rate

Author: BryonLewis

DEPLOYMENT.md

@@ -127,6 +127,10 @@ for a list of environment variables that you'll need to populate for your deploy
   spectrogram masks and save them to `PulseMetadata.contours`. When `false` or unset, contour
   extraction is skipped and stored contours are empty, which lowers DB storage size. Set to
   `true` if you need pulse contour data (e.g. the spectrogram contour overlay in the client).
+- `DJANGO_BATAI_USE_ORIGINAL_SR_SPECTROGRAMS` (optional, default `true`): when `true`, Celery
+  spectrogram tasks use BatBot's original-sample-rate (`.origsr.jpg`) images for uncompressed and
+  compressed spectrograms instead of the default resampled outputs. Set to `false` to use resampled
+  images.
 - `VITE_API_ROUTE`: this tells the Vue application where the backend (Django) API can be found.
 - `DJANGO_BATAI_URL_PATH`: this allows the Django application to be mounted at a subpath in a URL.
    It is used by the Django application itself and the nginx configuration at nginx.subpath.template

README.md

@@ -131,6 +131,12 @@ Spectrogram processing tasks honor `DJANGO_BATAI_SAVE_SPECTROGRAM_CONTOURS` envi
 Set to `False` by default so workers skip contour extraction (less DB storage space); set to `True` if you need
 contours in the UI (UI for contours currently disabled due to performance)
 
+### Original sample-rate spectrograms
+
+By default (`DJANGO_BATAI_USE_ORIGINAL_SR_SPECTROGRAMS=true`), BatBot's `.origsr.jpg` outputs are stored as the
+uncompressed and compressed spectrogram images (and related masks/waveplots). Set
+`DJANGO_BATAI_USE_ORIGINAL_SR_SPECTROGRAMS=false` to use resampled images instead.
+
 ### Species Suggestions by Range
 
 The suggested species for a given location are determined by spatial data stored in `/bats_ai/core/data/species-range.geojson`.