ARTS  2.4.0(git:4fb77825)
nc_io.h
Go to the documentation of this file.
1 /* Copyright (C) 2012 Oliver Lemke <olemke@core-dump.info>
2 
3  This program is free software; you can redistribute it and/or modify it
4  under the terms of the GNU General Public License as published by the
5  Free Software Foundation; either version 2, or (at your option) any
6  later version.
7 
8  This program is distributed in the hope that it will be useful,
9  but WITHOUT ANY WARRANTY; without even the implied warranty of
10  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  GNU General Public License for more details.
12 
13  You should have received a copy of the GNU General Public License
14  along with this program; if not, write to the Free Software
15  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
16  USA. */
17 
19 // File description
21 
29 #include "arts.h"
30 
31 #ifdef ENABLE_NETCDF
32 
33 #ifndef nc_io_h
34 #define nc_io_h
35 
36 #include <netcdf.h>
37 #include "abs_species_tags.h"
38 #include "exceptions.h"
39 #include "messages.h"
40 #include "mystring.h"
41 
43 // Default file names
45 
46 void nca_filename(String& filename, const String& varname);
47 
48 void nca_filename_with_index(String& filename,
49  const Index& file_index,
50  const String& varname);
51 
53 // Generic IO routines for XML files
55 
56 template <typename T>
57 void nca_read_from_file(const String& filename,
58  T& type,
59  const Verbosity& verbosity);
60 
61 template <typename T>
62 void nca_write_to_file(const String& filename,
63  const T& type,
64  const Verbosity& verbosity);
65 
66 /*void nc_read_var(const int ncf, const int **ncvar,
67  const Index dims, const String& name);*/
68 
69 void nca_def_dim(const int ncid,
70  const String& name,
71  const Index nelem,
72  int* ncdim);
73 void nca_def_var(const int ncid,
74  const String& name,
75  const nc_type type,
76  const int ndims,
77  const int* dims,
78  int* varid);
79 
80 int nca_def_ArrayOfIndex(const int ncid,
81  const String& name,
82  const ArrayOfIndex& a);
83 
84 int nca_def_Vector(const int ncid, const String& name, const Vector& v);
85 
86 int nca_def_Matrix(const int ncid, const String& name, const Matrix& m);
87 
88 int nca_def_Tensor4(const int ncid, const String& name, const Tensor4& t);
89 
90 Index nc_get_dim(const int ncid,
91  const String& name,
92  const bool noerror = false);
93 
94 void nca_get_data_int(const int ncid, const String& name, int* data);
95 
96 void nca_get_data_long(const int ncid, const String& name, long* data);
97 
98 void nca_get_data_double(const int ncid, const String& name, Numeric* data);
99 
100 void nca_get_dataa_double(const int ncid,
101  const String& name,
102  size_t start,
103  size_t count,
104  Numeric* data);
105 
106 void nca_get_data_text(const int ncid, const String& name, char* data);
107 
108 void nca_get_data_ArrayOfIndex(const int ncid,
109  const String& name,
110  ArrayOfIndex& aoi,
111  const bool noerror);
112 
113 void nca_get_data_ArrayOfArrayOfSpeciesTag(const int ncid,
114  const String& name,
116  const bool noerror);
117 
118 void nca_get_data_Vector(const int ncid,
119  const String& name,
120  Vector& v,
121  const bool noerror = false);
122 
123 void nca_get_data_Matrix(const int ncid,
124  const String& name,
125  Matrix& m,
126  const bool noerror = false);
127 
128 void nca_get_data_Tensor4(const int ncid,
129  const String& name,
130  Tensor4& m,
131  const bool noerror = false);
132 
133 bool nca_put_var_ArrayOfIndex(const int ncid,
134  const int varid,
135  const ArrayOfIndex& a);
136 
137 bool nca_put_var_Vector(const int ncid, const int varid, const Vector& v);
138 
139 bool nca_put_var_Matrix(const int ncid, const int varid, const Matrix& m);
140 
141 bool nca_put_var_Tensor4(const int ncid, const int varid, const Tensor4& t);
142 
143 void nca_error(const int err, const String msg);
144 
145 #endif /* nc_io_h */
146 
147 #endif /* ENABLE_NETCDF */
Matrix
The Matrix class.
Definition: matpackI.h:1193
nca_get_data_ArrayOfArrayOfSpeciesTag
void nca_get_data_ArrayOfArrayOfSpeciesTag(const int ncid, const String &name, ArrayOfArrayOfSpeciesTag &aast, const bool noerror)
Read variable of type ArrayOfArrayOfSpeciesTag from NetCDF file.
Definition: nc_io.cc:438
nca_put_var_ArrayOfIndex
bool nca_put_var_ArrayOfIndex(const int ncid, const int varid, const ArrayOfIndex &a)
Write variable of type ArrayOfIndex to NetCDF file.
Definition: nc_io.cc:539
exceptions.h
The declarations of all the exception classes.
nca_get_data_Matrix
void nca_get_data_Matrix(const int ncid, const String &name, Matrix &m, const bool noerror=false)
Read variable of type Matrix from NetCDF file.
Definition: nc_io.cc:497
nca_get_data_int
void nca_get_data_int(const int ncid, const String &name, int *data)
Read variable of type int from NetCDF file.
Definition: nc_io.cc:327
ARTS::Var::verbosity
Verbosity verbosity(Workspace &ws) noexcept
Definition: autoarts.h:7112
nca_filename
void nca_filename(String &filename, const String &varname)
Gives the default filename for the NetCDF formats.
Definition: nc_io.cc:53
nca_get_data_ArrayOfIndex
void nca_get_data_ArrayOfIndex(const int ncid, const String &name, ArrayOfIndex &aoi, const bool noerror)
Read variable of type ArrayOfIndex from NetCDF file.
Definition: nc_io.cc:413
nca_def_Vector
int nca_def_Vector(const int ncid, const String &name, const Vector &v)
Define NetCDF dimensions and variable for a Vector.
Definition: nc_io.cc:236
data
G0 G2 FVC Y DV Numeric Numeric Numeric Zeeman LowerQuantumNumbers void * data
Definition: arts_api_classes.cc:232
Tensor4
The Tensor4 class.
Definition: matpackIV.h:421
nca_get_data_double
void nca_get_data_double(const int ncid, const String &name, Numeric *data)
Read variable of type double from NetCDF file.
Definition: nc_io.cc:359
nca_get_data_Tensor4
void nca_get_data_Tensor4(const int ncid, const String &name, Tensor4 &m, const bool noerror=false)
Read variable of type Tensor4 from NetCDF file.
Definition: nc_io.cc:517
Array
This can be used to make arrays out of anything.
Definition: array.h:108
Absorption::nelem
Index nelem(const Lines &l)
Number of lines.
Definition: absorptionlines.h:1820
nca_get_dataa_double
void nca_get_dataa_double(const int ncid, const String &name, size_t start, size_t count, Numeric *data)
Read variable of type array of double from NetCDF file.
Definition: nc_io.cc:375
nca_def_ArrayOfIndex
int nca_def_ArrayOfIndex(const int ncid, const String &name, const ArrayOfIndex &a)
Define NetCDF dimensions and variable for an ArrayOfIndex.
Definition: nc_io.cc:214
messages.h
Declarations having to do with the four output streams.
my_basic_string< char >
nca_write_to_file
void nca_write_to_file(const String &filename, const T &type, const Verbosity &verbosity)
Writes a variable to a NetCDF file.
Definition: nc_io.cc:134
nca_def_dim
void nca_def_dim(const int ncid, const String &name, const Index nelem, int *ncdim)
Define NetCDF dimension.
Definition: nc_io.cc:174
Numeric
NUMERIC Numeric
The type to use for all floating point numbers.
Definition: matpack.h:33
Verbosity
Definition: messages.h:49
nca_filename_with_index
void nca_filename_with_index(String &filename, const Index &file_index, const String &varname)
Gives the default filename, with file index, for the NetCDF formats.
Definition: nc_io.cc:70
nca_put_var_Tensor4
bool nca_put_var_Tensor4(const int ncid, const int varid, const Tensor4 &t)
Write variable of type Tensor4 to NetCDF file.
Definition: nc_io.cc:604
abs_species_tags.h
Header file for stuff related to absorption species tags.
nca_get_data_text
void nca_get_data_text(const int ncid, const String &name, char *data)
Read variable of type array of char from NetCDF file.
Definition: nc_io.cc:395
nc_get_dim
Index nc_get_dim(const int ncid, const String &name, const bool noerror=false)
Read a dimension from NetCDF file.
Definition: nc_io.cc:300
nca_error
void nca_error(const int err, const String msg)
Throws a runtime error for the given NetCDF error code.
Definition: nc_io.cc:622
Zeeman::start
constexpr Rational start(Rational Ju, Rational Jl, Polarization type) noexcept
Gives the lowest M for a polarization type of this transition.
Definition: zeemandata.h:77
nca_def_Tensor4
int nca_def_Tensor4(const int ncid, const String &name, const Tensor4 &t)
Define NetCDF dimensions and variable for a Tensor4.
Definition: nc_io.cc:277
nca_put_var_Vector
bool nca_put_var_Vector(const int ncid, const int varid, const Vector &v)
Write variable of type Vector to NetCDF file.
Definition: nc_io.cc:566
nca_get_data_Vector
void nca_get_data_Vector(const int ncid, const String &name, Vector &v, const bool noerror=false)
Read variable of type Vector from NetCDF file.
Definition: nc_io.cc:478
nca_put_var_Matrix
bool nca_put_var_Matrix(const int ncid, const int varid, const Matrix &m)
Write variable of type Matrix to NetCDF file.
Definition: nc_io.cc:585
ARTS::Var::file_index
Index file_index(Workspace &ws) noexcept
Definition: autoarts.h:3475
Index
INDEX Index
The type to use for all integer numbers and indices.
Definition: matpack.h:39
nca_def_var
void nca_def_var(const int ncid, const String &name, const nc_type type, const int ndims, const int *dims, int *varid)
Define NetCDF variable.
Definition: nc_io.cc:194
nca_get_data_long
void nca_get_data_long(const int ncid, const String &name, long *data)
Read variable of type long from NetCDF file.
Definition: nc_io.cc:343
nca_read_from_file
void nca_read_from_file(const String &filename, T &type, const Verbosity &verbosity)
Reads a variable from a NetCDF file.
Definition: nc_io.cc:94
Vector
The Vector class.
Definition: matpackI.h:860
nca_def_Matrix
int nca_def_Matrix(const int ncid, const String &name, const Matrix &m)
Define NetCDF dimensions and variable for a Matrix.
Definition: nc_io.cc:256
mystring.h
This file contains the definition of String, the ARTS string class.
arts.h
The global header file for ARTS.