MeteoIODoc 20260620.13b5b0a5
Environmental timeseries pre-processing
Loading...
Searching...
No Matches
PSQLIO.h
Go to the documentation of this file.
1// SPDX-License-Identifier: LGPL-3.0-or-later
2/***********************************************************************************/
3/* Copyright 2012 Mountain-eering Srl, Trento/Bolzano, Italy */
4/***********************************************************************************/
5/* This file is part of MeteoIO.
6 MeteoIO is free software: you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
10
11 MeteoIO is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU Lesser General Public License for more details.
15
16 You should have received a copy of the GNU Lesser General Public License
17 along with MeteoIO. If not, see <http://www.gnu.org/licenses/>.
18*/
19#ifndef PSQLIO_H
20#define PSQLIO_H
21
22#include <meteoio/IOInterface.h>
23
24#include <libpq-fe.h>
25#include <string>
26#include <map>
27
28namespace mio {
29
39class PSQLIO : public IOInterface {
40 public:
41 ~PSQLIO();
42 PSQLIO(const std::string& configfile);
43 PSQLIO(const PSQLIO&);
44 PSQLIO(const Config& cfg);
45
46 PSQLIO& operator=(const PSQLIO& in);
47
48 virtual void readStationData(const Date& date, std::vector<StationData>& vecStation) override;
49 virtual void readMeteoData(const Date& dateStart, const Date& dateEnd,
50 std::vector< std::vector<MeteoData> >& vecMeteo) override;
51
52 virtual void writeMeteoData(const std::vector< std::vector<MeteoData> >& vecMeteo,
53 const std::string& name="") override;
54
55 private:
56 void getParameters(const Config& cfg);
57 void open_connection(const bool& input=true);
58 PGresult* sql_exec(const std::string& sqlcommand, const bool& input=true);
59 PGresult* sql_exec_params(const std::string& sql_command, const int nParams, const char *const *paramValues, const bool& input=true);
60 void readData(const Date& dateStart, const Date& dateEnd, std::vector<MeteoData>& vecMeteo, const size_t& stationindex);
61 void readMetaData(const std::string& query, std::vector<StationData>& vecStation, const bool& input=true);
62 void add_meta_data(const unsigned int& index, const StationData& sd);
63 static void map_parameters(const PGresult* result, MeteoData& md, std::vector<size_t>& index);
64 void parse_row(const PGresult* result, const int& row, const int& cols,
65 MeteoData& md, const std::vector<size_t>& index, std::vector<mio::MeteoData>& vecMeteo) const;
66 void close_connection(PGconn *conn);
67 static bool checkConsistency(const std::vector<MeteoData>& vecMeteo, StationData& sd);
68 static size_t checkExistence(const std::vector<StationData>& vec_stations, const StationData& sd);
69 static void convertUnits(MeteoData& meteo);
70 static void convertUnitsBack(MeteoData& meteo);
71 static void checkForUsedParameters(const std::vector<MeteoData>& vecMeteo, std::vector<bool>& vecParamInUse, std::vector<std::string>& vecColumnName);
72 void add_sensors(const unsigned int& index, const std::vector<std::string>& vecColumnName, std::map<size_t, std::string>& map_sensor_id);
73 int get_sensor_index();
74 int get_measurement_index();
75 void get_sensors(const std::string& index, const std::vector<std::string>& vecColumnName, std::map<size_t, std::string>& map_sensor_id);
76
77 std::string coordin, coordinparam, coordout, coordoutparam; //projection parameters
78 std::string in_endpoint, in_port, in_dbname, in_userid, in_passwd;
79 std::string out_endpoint, out_port, out_dbname, out_userid, out_passwd;
80 bool input_configured, output_configured;
81
82 PGconn *psql;
83 double default_timezone;
84 std::vector<StationData> vecMeta;
85 std::vector<std::string> vecFixedStationID;
86 std::string sql_meta, sql_data;
87
88 static const std::string sqlInsertMetadata, sqlInsertSensor, sqlInsertMeasurement;
89 static const double plugin_nodata; //plugin specific nodata value, e.g. -999
90};
91
92} //namespace
93#endif
A class that reads a key/value file. These files (typically named *.ini) follow the INI file format s...
Definition Config.h:79
A class to handle timestamps. This class handles conversion between different time display formats (I...
Definition Date.h:87
A class representing the IO Layer of the software Alpine3D. For each type of IO (File,...
Definition IOInterface.h:121
A class to represent a singular measurement received from one station at a certain time (represented ...
Definition MeteoData.h:108
This plugin connects to a generic PostgreSQL server to retrieve its meteorological data.
Definition PSQLIO.h:39
virtual void readMeteoData(const Date &dateStart, const Date &dateEnd, std::vector< std::vector< MeteoData > > &vecMeteo) override
Fill vecMeteo with a time series of objects corresponding to the interval indicated by dateStart and ...
Definition PSQLIO.cc:272
virtual void readStationData(const Date &date, std::vector< StationData > &vecStation) override
Fill vecStation with StationData objects for a certain date of interest.
Definition PSQLIO.cc:236
PSQLIO & operator=(const PSQLIO &in)
Definition PSQLIO.cc:117
~PSQLIO()
Destructor - cleans up PostgreSQL connection.
Definition PSQLIO.cc:150
virtual void writeMeteoData(const std::vector< std::vector< MeteoData > > &vecMeteo, const std::string &name="") override
Write vecMeteo time series to a certain destination.
Definition PSQLIO.cc:614
A class to represent meteo stations with attributes like longitude, latitude, etc.
Definition StationData.h:40
Definition Config.cc:34