thiesdl1file.cc File Reference

handle a ThiesDL1 data file (implementation) More...

#include <datrwxx/thiesdl1file.h>
#include <datrwxx/thiesdl1line.h>
#include <datrwxx/error.h>
#include <aff/seriesoperators.h>

Include dependency graph for thiesdl1file.cc:

Go to the source code of this file.

Namespaces
	datrw
	Root namespace of library.
	datrw::thiesdl1
	internals of the Thies DL1 reading module

Macros
#define	DATRW_THIESDL1FILE_CC_VERSION   "DATRW_THIESDL1FILE_CC V1.4"
#define	DL1_rcassert(C, M, E, L, N)

Functions
const libtime::TRelativeTime	datrw::thiesdl1::dl1samplinginterval (0, 0, 1)
FileHeader	datrw::thiesdl1::readheader (std::istream &is)
	Read and parse a file header. More...

Variables
const char *const	datrw::thiesdl1::precipitationID ="WR1"
	SEED channel identifier for precipitation. More...

Detailed Description

handle a ThiesDL1 data file (implementation)

---

Author

Thomas Forbriger

Date

13/09/2011

handle a ThiesDL1 data file (implementation)

Copyright (c) 2011 by Thomas Forbriger (BFO Schiltach)

---

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software

Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

REVISIONS and CHANGES

• 13/09/2011 V1.0 Thomas Forbriger
• 31/10/2012 V1.1 distinguish warning and critical warning; the latter for duplicate sample values being at variance
• 07/11/2012 V1.2 add sample values for duplicate entries
• 07/01/2015 V1.3
  modifications applied to File::put() function:
  • accept duplicate time stamps as part of normal operation; this is consistent with the behaviour of DL1logger as implemented on 20/03/2014; it is further consistent with the tested behaviour of the ThiesDL1 logger (see note below).
  • add sample values for duplicate time stamps
  • tr-mode (input stream tolerates redundant samples) now suppresses a notice-message which otherwise would be output to the terminal in cases of duplicate time stamps

• 08/07/2016 V1.4 thof:

  • make correct use of new DATRW_report_assert
  • make correct use of new DATRW_nonfatal_assert

    ---

    A statement of Volker König at ThiesClima regarding the duplicate entries

    in the data files is added at the end of this source file.

  Since the statement by Volker König is quite unsatisfactory, Peter Duffner and Thomas Forbriger on 07.11.2012 checked Thies DL1 recordings of several month against manual readings taken directly at the display of the Thies DL1 logger by Peter Duffner for cases where duplicate samples are present in the recorded data. The result is, that the values provided on the data loggers display are obtained, if data values for lines with duplicate time

  value are added to form the final value for the respective minute.

Definition in file thiesdl1file.cc.