edges_io.auxiliary.read_weather_file#

edges_io.auxiliary.read_weather_file(weather_file: str | Path, year: int, day: int, hour: int = 0, minute: int = 0, n_hours: int | None = None, end_time: tuple[int, int, int, int] | None = None)[source]#

Read (a chunk of) the weather file maintained by the on-site (MRO) monitoring.

The primary location of this file is on the enterprise cluster at /data5/edges/data/2014_February_Boolardy/weather2.txt, but the function requires you to pass in the filename manually, as you may have copied the file to your own system or elsewhere.

Parameters:

  • weather_file (path or str) – The path to the file on the system.

  • year (int) – The year defining the start of the chunk of times to return.

  • day (int) – The day defining the start of the chunk of times to return.

  • hour (int) – The hour defining the start of the chunk of times to return.

  • minute (int) – The minute defining the start of the chunk of times to return.

  • n_hours (int) – Number of hours of data to return. Default is to return the rest of the day.

  • end_time (tuple of int) – The (year, day, hour, minute) defining the end of the returned data (exclusive). Default is to return the rest of the starting day.

Returns:

structured array – A numpy structured array with the field names: * seconds: seconds since the start of the chosen day. * rack_temp: temperature of the rack (K) * ambient_temp: ambient temperature on site (K) * ambient_hum: ambient humidity on site (%) * frontend_temp: temperature of the frontend (K) * lna_temp: temperature of the LNA (K).