maad.util.xc_query
- maad.util.xc_query(searchTerms, max_nb_files=None, format_time=False, format_date=False, random_seed=1979, verbose=False)[source]
Query metadata from Xeno-Canto website depending on the search terms. The audio recordings metadata are grouped and stored in a dataframe.
- Parameters:
- searchTermslist
list of search terms to perform the query The main seach terms are : - grp : birds - gen : genus - ssp : subspecies - en : english name - q : quality - cnt : country - len : length - area : continent (europe, africa, america, asia) see more here : https://www.xeno-canto.org/help/search
- max_nb_files: integer, optional
Maximum number of audio files requested. The default is None
- format_timeboolean, optional
Time in Xeno-Canto is not always present neither correctly formated. If true, time will be correctly formated to be processed as DateTime format. When formating is not possible, the row is dropped. The default is False
- format_dateboolean, optional
Date in Xeno-Canto is not always present neither correctly formated. If true, rows with uncorrect format of date are dropped.
- random_seedinteger, optional
Fix the random seed in order to get the same result every time the function is called
- verboseboolean, optional
Print messages during the execution of the function. The default is False.
- Returns:
- df_datasetpandas DataFrame
Dataframe containing all the recordings metadata matching search terms