birdnet-analyzer 2.1.0__py3-none-any.whl → 2.1.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. birdnet_analyzer/__init__.py +9 -9
  2. birdnet_analyzer/analyze/__init__.py +19 -19
  3. birdnet_analyzer/analyze/__main__.py +3 -3
  4. birdnet_analyzer/analyze/cli.py +30 -30
  5. birdnet_analyzer/analyze/core.py +268 -246
  6. birdnet_analyzer/analyze/utils.py +700 -694
  7. birdnet_analyzer/audio.py +368 -368
  8. birdnet_analyzer/cli.py +732 -732
  9. birdnet_analyzer/config.py +243 -243
  10. birdnet_analyzer/eBird_taxonomy_codes_2024E.json +13045 -13045
  11. birdnet_analyzer/embeddings/__init__.py +3 -3
  12. birdnet_analyzer/embeddings/__main__.py +3 -3
  13. birdnet_analyzer/embeddings/cli.py +12 -12
  14. birdnet_analyzer/embeddings/core.py +70 -70
  15. birdnet_analyzer/embeddings/utils.py +173 -220
  16. birdnet_analyzer/evaluation/__init__.py +189 -189
  17. birdnet_analyzer/evaluation/__main__.py +3 -3
  18. birdnet_analyzer/evaluation/assessment/metrics.py +388 -388
  19. birdnet_analyzer/evaluation/assessment/performance_assessor.py +364 -364
  20. birdnet_analyzer/evaluation/assessment/plotting.py +378 -378
  21. birdnet_analyzer/evaluation/preprocessing/data_processor.py +631 -631
  22. birdnet_analyzer/evaluation/preprocessing/utils.py +98 -98
  23. birdnet_analyzer/gui/__init__.py +19 -19
  24. birdnet_analyzer/gui/__main__.py +3 -3
  25. birdnet_analyzer/gui/analysis.py +179 -179
  26. birdnet_analyzer/gui/assets/arrow_down.svg +4 -4
  27. birdnet_analyzer/gui/assets/arrow_left.svg +4 -4
  28. birdnet_analyzer/gui/assets/arrow_right.svg +4 -4
  29. birdnet_analyzer/gui/assets/arrow_up.svg +4 -4
  30. birdnet_analyzer/gui/assets/gui.css +36 -36
  31. birdnet_analyzer/gui/assets/gui.js +89 -93
  32. birdnet_analyzer/gui/embeddings.py +638 -638
  33. birdnet_analyzer/gui/evaluation.py +801 -801
  34. birdnet_analyzer/gui/localization.py +75 -75
  35. birdnet_analyzer/gui/multi_file.py +265 -265
  36. birdnet_analyzer/gui/review.py +472 -472
  37. birdnet_analyzer/gui/segments.py +191 -191
  38. birdnet_analyzer/gui/settings.py +149 -149
  39. birdnet_analyzer/gui/single_file.py +264 -264
  40. birdnet_analyzer/gui/species.py +95 -95
  41. birdnet_analyzer/gui/train.py +687 -687
  42. birdnet_analyzer/gui/utils.py +803 -797
  43. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_af.txt +6522 -6522
  44. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_ar.txt +6522 -6522
  45. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_bg.txt +6522 -6522
  46. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_ca.txt +6522 -6522
  47. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_cs.txt +6522 -6522
  48. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_da.txt +6522 -6522
  49. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_de.txt +6522 -6522
  50. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_el.txt +6522 -6522
  51. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_en_uk.txt +6522 -6522
  52. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_es.txt +6522 -6522
  53. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_fi.txt +6522 -6522
  54. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_fr.txt +6522 -6522
  55. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_he.txt +6522 -6522
  56. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_hr.txt +6522 -6522
  57. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_hu.txt +6522 -6522
  58. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_in.txt +6522 -6522
  59. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_is.txt +6522 -6522
  60. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_it.txt +6522 -6522
  61. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_ja.txt +6522 -6522
  62. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_ko.txt +6522 -6522
  63. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_lt.txt +6522 -6522
  64. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_ml.txt +6522 -6522
  65. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_nl.txt +6522 -6522
  66. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_no.txt +6522 -6522
  67. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_pl.txt +6522 -6522
  68. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_pt_BR.txt +6522 -6522
  69. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_pt_PT.txt +6522 -6522
  70. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_ro.txt +6522 -6522
  71. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_ru.txt +6522 -6522
  72. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_sk.txt +6522 -6522
  73. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_sl.txt +6522 -6522
  74. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_sr.txt +6522 -6522
  75. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_sv.txt +6522 -6522
  76. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_th.txt +6522 -6522
  77. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_tr.txt +6522 -6522
  78. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_uk.txt +6522 -6522
  79. birdnet_analyzer/labels/V2.4/BirdNET_GLOBAL_6K_V2.4_Labels_zh.txt +6522 -6522
  80. birdnet_analyzer/lang/de.json +342 -341
  81. birdnet_analyzer/lang/en.json +342 -341
  82. birdnet_analyzer/lang/fi.json +342 -341
  83. birdnet_analyzer/lang/fr.json +342 -341
  84. birdnet_analyzer/lang/id.json +342 -341
  85. birdnet_analyzer/lang/pt-br.json +342 -341
  86. birdnet_analyzer/lang/ru.json +342 -341
  87. birdnet_analyzer/lang/se.json +342 -341
  88. birdnet_analyzer/lang/tlh.json +342 -341
  89. birdnet_analyzer/lang/zh_TW.json +342 -341
  90. birdnet_analyzer/model.py +1213 -1212
  91. birdnet_analyzer/search/__init__.py +3 -3
  92. birdnet_analyzer/search/__main__.py +3 -3
  93. birdnet_analyzer/search/cli.py +11 -11
  94. birdnet_analyzer/search/core.py +78 -78
  95. birdnet_analyzer/search/utils.py +104 -107
  96. birdnet_analyzer/segments/__init__.py +3 -3
  97. birdnet_analyzer/segments/__main__.py +3 -3
  98. birdnet_analyzer/segments/cli.py +13 -13
  99. birdnet_analyzer/segments/core.py +81 -81
  100. birdnet_analyzer/segments/utils.py +383 -383
  101. birdnet_analyzer/species/__init__.py +3 -3
  102. birdnet_analyzer/species/__main__.py +3 -3
  103. birdnet_analyzer/species/cli.py +13 -13
  104. birdnet_analyzer/species/core.py +35 -35
  105. birdnet_analyzer/species/utils.py +73 -74
  106. birdnet_analyzer/train/__init__.py +3 -3
  107. birdnet_analyzer/train/__main__.py +3 -3
  108. birdnet_analyzer/train/cli.py +13 -13
  109. birdnet_analyzer/train/core.py +113 -113
  110. birdnet_analyzer/train/utils.py +878 -877
  111. birdnet_analyzer/translate.py +132 -133
  112. birdnet_analyzer/utils.py +425 -425
  113. {birdnet_analyzer-2.1.0.dist-info → birdnet_analyzer-2.1.1.dist-info}/METADATA +147 -146
  114. birdnet_analyzer-2.1.1.dist-info/RECORD +124 -0
  115. {birdnet_analyzer-2.1.0.dist-info → birdnet_analyzer-2.1.1.dist-info}/licenses/LICENSE +18 -18
  116. birdnet_analyzer/playground.py +0 -5
  117. birdnet_analyzer-2.1.0.dist-info/RECORD +0 -125
  118. {birdnet_analyzer-2.1.0.dist-info → birdnet_analyzer-2.1.1.dist-info}/WHEEL +0 -0
  119. {birdnet_analyzer-2.1.0.dist-info → birdnet_analyzer-2.1.1.dist-info}/entry_points.txt +0 -0
  120. {birdnet_analyzer-2.1.0.dist-info → birdnet_analyzer-2.1.1.dist-info}/top_level.txt +0 -0
@@ -1,133 +1,132 @@
1
- """Module for translating species labels.
2
-
3
- Can be used to translate species names into other languages.
4
-
5
- Uses the requests to the eBird-API.
6
- """
7
-
8
- import json
9
- import os
10
- import urllib.request
11
-
12
- import birdnet_analyzer.config as cfg
13
- from birdnet_analyzer import utils
14
-
15
- LOCALES = [
16
- "af",
17
- "ar",
18
- "cs",
19
- "da",
20
- "de",
21
- "en_uk",
22
- "es",
23
- "fi",
24
- "fr",
25
- "hu",
26
- "it",
27
- "ja",
28
- "ko",
29
- "nl",
30
- "no",
31
- "pl",
32
- "pt_BR",
33
- "pt_PT",
34
- "ro",
35
- "ru",
36
- "sk",
37
- "sl",
38
- "sv",
39
- "th",
40
- "tr",
41
- "uk",
42
- "zh",
43
- ]
44
- """ Locales for 26 common languages (according to GitHub Copilot) """
45
-
46
- API_TOKEN = "yourAPIToken"
47
- """ Sign up for your personal access token here: https://ebird.org/api/keygen """
48
-
49
-
50
- def get_locale_data(locale: str):
51
- """Download eBird locale species data.
52
-
53
- Requests the locale data through the eBird API.
54
-
55
- Args:
56
- locale: Two character string of a language.
57
-
58
- Returns:
59
- A data object containing the response from eBird.
60
- """
61
- url = "https://api.ebird.org/v2/ref/taxonomy/ebird?cat=species&fmt=json&locale=" + locale
62
- header = {"X-eBirdAPIToken": API_TOKEN}
63
-
64
- req = urllib.request.Request(url, headers=header)
65
- response = urllib.request.urlopen(req)
66
-
67
- return json.loads(response.read())
68
-
69
-
70
- def translate(locale: str):
71
- """Translates species names for a locale.
72
-
73
- Translates species names for the given language with the eBird API.
74
-
75
- Args:
76
- locale: Two character string of a language.
77
-
78
- Returns:
79
- The translated list of labels.
80
- """
81
- print(f"Translating species names for {locale}...", end="", flush=True)
82
-
83
- # Get locale data
84
- data = get_locale_data(locale)
85
-
86
- # Create list of translated labels
87
- labels: list[str] = []
88
-
89
- for label in cfg.LABELS:
90
- has_translation = False
91
- for entry in data:
92
- if label.split("_", 1)[0] == entry["sciName"]:
93
- labels.append("{}_{}".format(label.split("_", 1)[0], entry["comName"]))
94
- has_translation = True
95
- break
96
- if not has_translation:
97
- labels.append(label)
98
-
99
- print("Done.", flush=True)
100
-
101
- return labels
102
-
103
-
104
- def save_labels_file(labels: list[str], locale: str):
105
- """Saves localized labels to a file.
106
-
107
- Saves the given labels into a file with the format:
108
- "{config.LABELSFILE}_{locale}.txt"
109
-
110
- Args:
111
- labels: List of labels.
112
- locale: Two character string of a language.
113
- """
114
- # Create folder
115
- os.makedirs(cfg.TRANSLATED_LABELS_PATH, exist_ok=True)
116
-
117
- # Save labels file
118
- fpath = os.path.join(
119
- cfg.TRANSLATED_LABELS_PATH, "{}_{}.txt".format(os.path.basename(cfg.LABELS_FILE).rsplit(".", 1)[0], locale)
120
- )
121
- with open(fpath, "w", encoding="utf-8") as f:
122
- for label in labels:
123
- f.write(label + "\n")
124
-
125
-
126
- if __name__ == "__main__":
127
- # Load labels
128
- cfg.LABELS = utils.read_lines(cfg.LABELS_FILE)
129
-
130
- # Translate labels
131
- for locale in LOCALES:
132
- labels = translate(locale)
133
- save_labels_file(labels, locale)
1
+ """Module for translating species labels.
2
+
3
+ Can be used to translate species names into other languages.
4
+
5
+ Uses the requests to the eBird-API.
6
+ """
7
+
8
+ import json
9
+ import os
10
+ import urllib.request
11
+
12
+ import birdnet_analyzer.config as cfg
13
+ from birdnet_analyzer import utils
14
+
15
+ LOCALES = [
16
+ "af",
17
+ "ar",
18
+ "cs",
19
+ "da",
20
+ "de",
21
+ "en_uk",
22
+ "es",
23
+ "fi",
24
+ "fr",
25
+ "hu",
26
+ "it",
27
+ "ja",
28
+ "ko",
29
+ "nl",
30
+ "no",
31
+ "pl",
32
+ "pt_BR",
33
+ "pt_PT",
34
+ "ro",
35
+ "ru",
36
+ "sk",
37
+ "sl",
38
+ "sv",
39
+ "th",
40
+ "tr",
41
+ "uk",
42
+ "zh",
43
+ ]
44
+ """ Locales for 26 common languages (according to GitHub Copilot) """
45
+
46
+ API_TOKEN = "yourAPIToken"
47
+ """ Sign up for your personal access token here: https://ebird.org/api/keygen """
48
+
49
+
50
+ def get_locale_data(locale: str):
51
+ """Download eBird locale species data.
52
+
53
+ Requests the locale data through the eBird API.
54
+
55
+ Args:
56
+ locale: Two character string of a language.
57
+
58
+ Returns:
59
+ A data object containing the response from eBird.
60
+ """
61
+ url = "https://api.ebird.org/v2/ref/taxonomy/ebird?cat=species&fmt=json&locale=" + locale
62
+ header = {"X-eBirdAPIToken": API_TOKEN}
63
+
64
+ req = urllib.request.Request(url, headers=header)
65
+ response = urllib.request.urlopen(req)
66
+
67
+ return json.loads(response.read())
68
+
69
+
70
+ def translate(locale: str):
71
+ """Translates species names for a locale.
72
+
73
+ Translates species names for the given language with the eBird API.
74
+
75
+ Args:
76
+ locale: Two character string of a language.
77
+
78
+ Returns:
79
+ The translated list of labels.
80
+ """
81
+ print(f"Translating species names for {locale}...", end="", flush=True)
82
+
83
+ # Get locale data
84
+ data = get_locale_data(locale)
85
+
86
+ # Create list of translated labels
87
+ labels: list[str] = []
88
+
89
+ for label in cfg.LABELS:
90
+ has_translation = False
91
+ for entry in data:
92
+ if label.split("_", 1)[0] == entry["sciName"]:
93
+ labels.append("{}_{}".format(label.split("_", 1)[0], entry["comName"]))
94
+ has_translation = True
95
+ break
96
+ if not has_translation:
97
+ labels.append(label)
98
+
99
+ print("Done.", flush=True)
100
+
101
+ return labels
102
+
103
+
104
+ def save_labels_file(labels: list[str], locale: str):
105
+ """Saves localized labels to a file.
106
+
107
+ Saves the given labels into a file with the format:
108
+ "{config.LABELSFILE}_{locale}.txt"
109
+
110
+ Args:
111
+ labels: List of labels.
112
+ locale: Two character string of a language.
113
+ """
114
+ # Create folder
115
+ os.makedirs(cfg.TRANSLATED_LABELS_PATH, exist_ok=True)
116
+
117
+ # Save labels file
118
+ fpath = os.path.join(
119
+ cfg.TRANSLATED_LABELS_PATH, "{}_{}.txt".format(os.path.basename(cfg.LABELS_FILE).rsplit(".", 1)[0], locale)
120
+ )
121
+ with open(fpath, "w", encoding="utf-8") as f:
122
+ f.writelines(label + "\n" for label in labels)
123
+
124
+
125
+ if __name__ == "__main__":
126
+ # Load labels
127
+ cfg.LABELS = utils.read_lines(cfg.LABELS_FILE)
128
+
129
+ # Translate labels
130
+ for locale in LOCALES:
131
+ labels = translate(locale)
132
+ save_labels_file(labels, locale)