edges_io.auxiliary.read_thermlog_file#

edges_io.auxiliary.read_thermlog_file(filename: 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 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 (%)