edges.io.auxiliary¶
Module defining EDGES-specific reading functions for weather and auxiliary data.
- edges.io.auxiliary.read_auxiliary_data(weather_file: str | Path, thermlog_file: str | Path, start: Time, n_hours: int | None = None, end: Time | None = None)[source]¶
Read both weather and thermlog files for a given time range.
- Parameters:
weather_file (path or str) – The file containing the weather information.
thermlog_file (path or str) – The file containing the thermlog information.
year (int) – The year defining the chunk of times to return.
day (int) – The day defining 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 – The weather data (see
read_weather_file()).structured array – The thermlog data (see
read_thermlog_file())
- edges.io.auxiliary.read_thermlog_file(filename: str | Path, start: Time, n_hours: int | None = None, end: Time | None = None)[source]¶
Read (a chunk of) the thermlog 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/thermlog_{band}.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:
filename (path or str) – The path to the file on the system.
year (int) – The year defining the chunk of times to return.
day (int) – The day defining 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. *temp_set: temperature that it was set to (?) (C) *receiver_temp: temperature of the receiver (C) *power_percent: power of something (%)