Features.fetch_water_troughs

Features.fetch_water_troughs(update=False, pickle_it=False, data_dir=None, verbose=False)[source]

Fetch codes of water troughs from local backup.

Parameters

  • update (bool) – whether to check on update and proceed to update the package data, defaults to False

  • pickle_it (bool) – whether to replace the current package data with newly collected data, defaults to False

  • data_dir (str or None) – name of package data folder, defaults to None

  • verbose (bool) – whether to print relevant information in console as the function runs, defaults to False

Returns

data of water troughs, and date of when the data was last updated

Return type

dict

Example:

>>> from pyrcs.other_assets import Features

>>> features = Features()

>>> # wt_codes_dat = features.fetch_water_troughs(update=True, verbose=True)
>>> wt_codes_dat = features.fetch_water_troughs()

>>> type(wt_codes_dat)
dict
>>> list(wt_codes_dat.keys())
['Water troughs', 'Last updated date']

>>> wt_codes = wt_codes_dat['Water troughs']
>>> print(wt_codes.head())
    ELR  Trough Name  ...                                        Notes
0   BEI    Eckington  ...                               Installed 1904
1   BHL  Aldermaston  ...                            Installed by 1904
2  CGJ2        Moore  ...                              Installed 1860s
3  CGJ6     Lea Road  ...  Installed 1885, taken out of use 8 May 1967
4  CGJ6        Brock  ...                              Installed 1860s
[5 rows x 5 columns]