set_locality

Note

Locality information is not required by the ALA, but it is nice to have.

One of the functions you can use to check your data is set_locality(). This function aims to check if you have the following:

• continent: the continent of your observation

• country: the country of your observation

• countryCode: the country code of your observation

• stateProvince: the state or province of your observation

• locality: locality name of your observation

specifying continent and country

>>> my_dwca.set_locality(continent='Australia')

Traceback (most recent call last):
  File "/Users/buy003/Documents/GitHub/galaxias-python/docs/source/galaxias_user_guide/independent_observations/data_cleaning.py", line 166, in <module>
    temp_dwca.set_locality(continent='Australia')
  File "/Users/buy003/anaconda3/envs/galaxias-dev/lib/python3.11/site-packages/galaxias/dwca_build.py", line 752, in set_locality
    self.occurrences = corella.set_locality(dataframe=self.occurrences,continent=continent,
                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/buy003/anaconda3/envs/galaxias-dev/lib/python3.11/site-packages/corella/set_locality.py", line 71, in set_locality
    raise ValueError("There are some errors in your data.  They are as follows:\n\n{}".format('\n'.join(errors)))
ValueError: There are some errors in your data.  They are as follows:

Some of your continents are incorrect.  Accepted values are:

Africa, Antarctica, Asia, Europe, North America, Oceania, South America

However, for Darwin Core purposes, Australia is a country, and Oceania is the continent that Australia is part of. Therefore, we can set continent='Oceania' and country='Australia'.

>>> my_dwca.set_locality(continent='Oceania',country='Australia')

                   Species  Latitude  Longitude Collection_date continent    country
0       Corymbia latifolia    -13.04     131.07       29/3/2022   Oceania  Australia
1     Eucalyptus tectifica    -13.04     131.07       13/9/2022   Oceania  Australia
2           Banksia aemula    -33.60     150.72       15/8/2022   Oceania  Australia
3  Eucalyptus sclerophylla    -33.60     150.72       16/6/2022   Oceania  Australia
4        Persoonia laurina    -33.60     150.72      19/10/2022   Oceania  Australia

Other functions

To learn more about how to use other functions, go to

• set_occurrences

• set_coordinates

• set_datetime

• set_scientific_name

Optional functions:

• set_abundance

• set_collection

• set_individual_traits

• set_license

• set_taxonomy

Creating Unique IDs:

• Creating Unique IDs for your Occurrences

Passing Dataset:

• Passing Dataset