Rtsys metadata

.gitignore

@@ -1,4 +1,5 @@
 .env
+.idea/
 pbp-doc/site/
 output*/
 cloud_tmp*/

pbp-doc/docs/pbp-meta-gen/index.md

@@ -14,11 +14,12 @@ Once this is done, you can proceed to the main program [pbp-hmb-gen](../pbp-hmb-
 Three types of audio recorders are supported: NRS, IcListen, and Soundtrap files. Here is the current supported matrix:
 
 ----------------
-| Recorder | [Google Storage](https://cloud.google.com/storage/docs/buckets) | [AWS S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) | Local Storage |
-|----------|-----------------------------------------------------------------|------------------|---------------|
-| NRS      |  :material-check:                                                               |  :material-close:               |  :material-check:             |
-| IcListen |  :material-close:                                                               |  :material-check:               | :material-check:             |
-| Soundtrap|  :material-close:                                                               |  :material-check:               | :material-check:             |
+| Recorder  | [Google Storage](https://cloud.google.com/storage/docs/buckets) | [AWS S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) | Local Storage |
+|-----------|-----------------------------------------------------------------|------------------------------------------------------------------------------|---------------|
+| NRS       |  :material-check:                                                               | :material-close:                                                             |  :material-check:             |
+| IcListen  |  :material-close:                                                               | :material-check:                                                             | :material-check:             |
+| Soundtrap |  :material-close:                                                               | :material-check:                                                             | :material-check:             |
+| RESEA     |  :material-close:                                                               | :material-close:                                                             | :material-check:             |
 
 
 For audio that is stored in a cloud storage bucket, the URI that is required to access the audio files depends on the cloud storage provider.
@@ -48,6 +49,12 @@ The data must be stored in a public cloud storage bucket; private buckets are no
         NRS11_191024T022220Z.d100.x.wav
     ```
 
+!!! note start and end date
+    The start and end date should be a string date, not including hour, minutes nor seconds. 
+    When using the API directly instead of running the `pbp-meta-gen` command-line program, start and end date should
+    be a datetime.datetime object starting at 00:00:00. A datetime.date can also be passed, and it will be 
+    automatically converted. If these requirements are not met, pbp will raise an error. 
+
 
 ## Generate JSONs with audio metadata from NRS flac files for a date range
 

pbp/main_meta_generator.py

@@ -70,6 +70,16 @@ def main():
                 xml_dir=xml_dir.as_posix(),
             )
             generator.run()
+        if opts.recorder == "RESEA":
+            generator = RESEAMetadataGenerator(
+                log=log,
+                uri=opts.uri,
+                json_base_dir=json_dir.as_posix(),
+                prefixes=opts.prefix,
+                start=start,
+                end=end
+            )
+            generator.run()
     except KeyboardInterrupt:
         log.info("INTERRUPTED")
 

pbp/main_meta_generator_args.py

@@ -33,7 +33,7 @@ def parse_arguments():
 
     parser.add_argument(
         "--recorder",
-        choices=[InstrumentType.NRS, InstrumentType.ICLISTEN, InstrumentType.SOUNDTRAP],
+        choices=[InstrumentType.NRS, InstrumentType.ICLISTEN, InstrumentType.SOUNDTRAP, InstrumentType.RESEA],
         required=True,
         help="Choose the audio instrument type",
     )

pbp/meta_gen/gen_abstract.py

@@ -6,6 +6,8 @@
 
 import pandas as pd
 
+from pbp.meta_gen.utils import check_start_end_args
+
 
 class MetadataGeneratorAbstract(object):
     def __init__(
@@ -36,6 +38,7 @@ def __init__(
         :return:
         """
         try:
+            start, end = check_start_end_args(start, end)
             self.audio_loc = audio_loc
             self.json_base_dir = json_base_dir
             self.df = pd.DataFrame()
@@ -92,6 +95,7 @@ def __init__(
         :return:
         """
         try:
+            start, end = check_start_end_args(start, end)
             self.audio_loc = audio_loc
             self.json_base_dir = json_base_dir
             self.df = pd.DataFrame()