WxData

FEMS: Multi RAWS Station Current Fuels Observations

def get_current_multi_raws_station_fuels_observations(station_ids, 
                                                fuel_model='Y', 
                                                clear_recycle_bin=False,
                                                path=f'{folder_modified}/FEMS Data/Current Multi Station/Observations/Fuels',
                                                proxies=None,
                                                clear_data=True,
                                                meta_path=f'{folder_modified}/FEMS Data/Station Meta Data',
                                                sheet_name='Sheet1'):

This function retrieves the current fuels observations for a user-specified list of RAWS Stations.

Required Arguments:

1) station_ids (Integer List) - An integer list of all the RAWS IDs for each RAWS station the user wants in the dataset.

Optional Arguments:

1) fuel_model (String) - Default = ‘Y’. The fuel model being used.

   Fuel Models List:

    Y - Timber
    X - Brush
    W - Grass/Shrub
    V - Grass
    Z - Slash

3) clear_recycle_bin (Boolean) - Default=False. When set to True, the contents in your recycle/trash bin will be deleted with each run of the program you are calling WxData. This setting is to help preserve memory on the machine.

4) path (String) - Default=f’{folder_modified}/FEMS Data/Current Multi Station/Observations/Fuels’. The directory the data will be saved to.

5) proxies (dict or None) - Default=None. If the user is using proxy server(s), the user must change the following:

   proxies=None ---> proxies={
                           'http':'http://your-proxy-address:port',
                           'https':'http://your-proxy-address:port'
                           }

5) clear_data (Boolean) - Default=True. When set to True, the data directory clears out and new data is downloaded.

6) meta_path (String) - Default=f’{folder_modified}/FEMS Data/Station Meta Data’. The path to where the RAWS station meta data excel file will be saved to.

7) sheet_name (String) - The name of the sheet in the excel file to be converted into a pandas.DataFrame.

Returns

A Pandas DataFrame of current observed fuels data with lat/lon coordinates for each station merged from the meta-data file.