CoolProp 7.0.0
An open-source fluid property and humid air property database
DataStructures.cpp
Go to the documentation of this file.
1
2
3#include "DataStructures.h"
4#include "Exceptions.h"
5#include "CoolPropTools.h"
6#include "CoolProp.h"
7#include <memory>
8
9namespace CoolProp {
10
12{
13 int key;
15 bool trivial;
16};
17
18const std::vector<parameter_info> parameter_info_list = {
20 {iT, "T", "IO", "K", "Temperature", false},
21 {iP, "P", "IO", "Pa", "Pressure", false},
22 {iDmolar, "Dmolar", "IO", "mol/m^3", "Molar density", false},
23 {iHmolar, "Hmolar", "IO", "J/mol", "Molar specific enthalpy", false},
24 {iSmolar, "Smolar", "IO", "J/mol/K", "Molar specific entropy", false},
25 {iUmolar, "Umolar", "IO", "J/mol", "Molar specific internal energy", false},
26 {iGmolar, "Gmolar", "O", "J/mol", "Molar specific Gibbs energy", false},
27 {iHelmholtzmolar, "Helmholtzmolar", "O", "J/mol", "Molar specific Helmholtz energy", false},
28 {iDmass, "Dmass", "IO", "kg/m^3", "Mass density", false},
29 {iHmass, "Hmass", "IO", "J/kg", "Mass specific enthalpy", false},
30 {iSmass, "Smass", "IO", "J/kg/K", "Mass specific entropy", false},
31 {iUmass, "Umass", "IO", "J/kg", "Mass specific internal energy", false},
32 {iGmass, "Gmass", "O", "J/kg", "Mass specific Gibbs energy", false},
33 {iHelmholtzmass, "Helmholtzmass", "O", "J/kg", "Mass specific Helmholtz energy", false},
34 {iQ, "Q", "IO", "mol/mol", "Molar vapor quality", false},
35 {iDelta, "Delta", "IO", "-", "Reduced density (rho/rhoc)", false},
36 {iTau, "Tau", "IO", "-", "Reciprocal reduced temperature (Tc/T)", false},
38 {iCpmolar, "Cpmolar", "O", "J/mol/K", "Molar specific constant pressure specific heat", false},
39 {iCpmass, "Cpmass", "O", "J/kg/K", "Mass specific constant pressure specific heat", false},
40 {iCvmolar, "Cvmolar", "O", "J/mol/K", "Molar specific constant volume specific heat", false},
41 {iCvmass, "Cvmass", "O", "J/kg/K", "Mass specific constant volume specific heat", false},
42 {iCp0molar, "Cp0molar", "O", "J/mol/K", "Ideal gas molar specific constant pressure specific heat", false},
43 {iCp0mass, "Cp0mass", "O", "J/kg/K", "Ideal gas mass specific constant pressure specific heat", false},
44 {iHmolar_residual, "Hmolar_residual", "O", "J/mol/K", "Residual molar enthalpy", false},
45 {iSmolar_residual, "Smolar_residual", "O", "J/mol/K", "Residual molar entropy (sr/R = s(T,rho) - s^0(T,rho))", false},
46 {iGmolar_residual, "Gmolar_residual", "O", "J/mol/K", "Residual molar Gibbs energy", false},
47 {iGWP20, "GWP20", "O", "-", "20-year global warming potential", true},
48 {iGWP100, "GWP100", "O", "-", "100-year global warming potential", true},
49 {iGWP500, "GWP500", "O", "-", "500-year global warming potential", true},
50 {iFH, "FH", "O", "-", "Flammability hazard", true},
51 {iHH, "HH", "O", "-", "Health hazard", true},
52 {iPH, "PH", "O", "-", "Physical hazard", true},
53 {iODP, "ODP", "O", "-", "Ozone depletion potential", true},
54 {iBvirial, "Bvirial", "O", "-", "Second virial coefficient", false},
55 {iCvirial, "Cvirial", "O", "-", "Third virial coefficient", false},
56 {idBvirial_dT, "dBvirial_dT", "O", "-", "Derivative of second virial coefficient with respect to T", false},
57 {idCvirial_dT, "dCvirial_dT", "O", "-", "Derivative of third virial coefficient with respect to T", false},
58 {igas_constant, "gas_constant", "O", "J/mol/K", "Molar gas constant", true},
59 {imolar_mass, "molar_mass", "O", "kg/mol", "Molar mass", true},
60 {iacentric_factor, "acentric", "O", "-", "Acentric factor", true},
61 {idipole_moment, "dipole_moment", "O", "C-m", "Dipole moment", true},
62 {irhomass_reducing, "rhomass_reducing", "O", "kg/m^3", "Mass density at reducing point", true},
63 {irhomolar_reducing, "rhomolar_reducing", "O", "mol/m^3", "Molar density at reducing point", true},
64 {irhomolar_critical, "rhomolar_critical", "O", "mol/m^3", "Molar density at critical point", true},
65 {irhomass_critical, "rhomass_critical", "O", "kg/m^3", "Mass density at critical point", true},
66 {iT_reducing, "T_reducing", "O", "K", "Temperature at the reducing point", true},
67 {iT_critical, "T_critical", "O", "K", "Temperature at the critical point", true},
68 {iT_triple, "T_triple", "O", "K", "Temperature at the triple point", true},
69 {iT_max, "T_max", "O", "K", "Maximum temperature limit", true},
70 {iT_min, "T_min", "O", "K", "Minimum temperature limit", true},
71 {iP_min, "P_min", "O", "Pa", "Minimum pressure limit", true},
72 {iP_max, "P_max", "O", "Pa", "Maximum pressure limit", true},
73 {iP_critical, "p_critical", "O", "Pa", "Pressure at the critical point", true},
74 {iP_reducing, "p_reducing", "O", "Pa", "Pressure at the reducing point", true},
75 {iP_triple, "p_triple", "O", "Pa", "Pressure at the triple point (pure only)", true},
76 {ifraction_min, "fraction_min", "O", "-", "Fraction (mole, mass, volume) minimum value for incompressible solutions", true},
77 {ifraction_max, "fraction_max", "O", "-", "Fraction (mole, mass, volume) maximum value for incompressible solutions", true},
78 {iT_freeze, "T_freeze", "O", "K", "Freezing temperature for incompressible solutions", true},
79
80 {ispeed_sound, "speed_of_sound", "O", "m/s", "Speed of sound", false},
81 {iviscosity, "viscosity", "O", "Pa-s", "Viscosity", false},
82 {iconductivity, "conductivity", "O", "W/m/K", "Thermal conductivity", false},
83 {isurface_tension, "surface_tension", "O", "N/m", "Surface tension", false},
84 {iPrandtl, "Prandtl", "O", "-", "Prandtl number", false},
85
86 {iisothermal_compressibility, "isothermal_compressibility", "O", "1/Pa", "Isothermal compressibility", false},
87 {iisobaric_expansion_coefficient, "isobaric_expansion_coefficient", "O", "1/K", "Isobaric expansion coefficient", false},
88 {iisentropic_expansion_coefficient, "isentropic_expansion_coefficient", "O", "-", "Isentropic expansion coefficient", false},
89 {iZ, "Z", "O", "-", "Compressibility factor", false},
90 {ifundamental_derivative_of_gas_dynamics, "fundamental_derivative_of_gas_dynamics", "O", "-", "Fundamental derivative of gas dynamics", false},
91 {iPIP, "PIP", "O", "-", "Phase identification parameter", false},
92
93 {ialphar, "alphar", "O", "-", "Residual Helmholtz energy", false},
94 {idalphar_dtau_constdelta, "dalphar_dtau_constdelta", "O", "-", "Derivative of residual Helmholtz energy with tau", false},
95 {idalphar_ddelta_consttau, "dalphar_ddelta_consttau", "O", "-", "Derivative of residual Helmholtz energy with delta", false},
96
97 {ialpha0, "alpha0", "O", "-", "Ideal Helmholtz energy", false},
98 {idalpha0_dtau_constdelta, "dalpha0_dtau_constdelta", "O", "-", "Derivative of ideal Helmholtz energy with tau", false},
99 {idalpha0_ddelta_consttau, "dalpha0_ddelta_consttau", "O", "-", "Derivative of ideal Helmholtz energy with delta", false},
100 {id2alpha0_ddelta2_consttau, "d2alpha0_ddelta2_consttau", "O", "-", "Second derivative of ideal Helmholtz energy with delta", false},
101 {id3alpha0_ddelta3_consttau, "d3alpha0_ddelta3_consttau", "O", "-", "Third derivative of ideal Helmholtz energy with delta", false},
102
103 {iPhase, "Phase", "O", "-", "Phase index as a float", false},
104
105};
106
108{
109 public:
110 std::map<int, bool> trivial_map;
111 std::map<int, std::string> short_desc_map, description_map, IO_map, units_map;
112 std::map<std::string, int> index_map;
114 for (auto& el : parameter_info_list) {
115 short_desc_map.insert(std::pair<int, std::string>(el.key, el.short_desc));
116 IO_map.insert(std::pair<int, std::string>(el.key, el.IO));
117 units_map.insert(std::pair<int, std::string>(el.key, el.units));
118 description_map.insert(std::pair<int, std::string>(el.key, el.description));
119 index_map_insert(el.short_desc, el.key);
120 trivial_map.insert(std::pair<int, bool>(el.key, el.trivial));
121 }
122 // Backward compatibility aliases
123 index_map_insert("D", iDmass);
124 index_map_insert("H", iHmass);
125 index_map_insert("M", imolar_mass);
126 index_map_insert("S", iSmass);
127 index_map_insert("U", iUmass);
128 index_map_insert("C", iCpmass);
129 index_map_insert("O", iCvmass);
130 index_map_insert("G", iGmass);
131 index_map_insert("V", iviscosity);
132 index_map_insert("L", iconductivity);
133 index_map_insert("pcrit", iP_critical);
134 index_map_insert("Pcrit", iP_critical);
135 index_map_insert("Tcrit", iT_critical);
136 index_map_insert("Ttriple", iT_triple);
137 index_map_insert("ptriple", iP_triple);
138 index_map_insert("rhocrit", irhomass_critical);
139 index_map_insert("Tmin", iT_min);
140 index_map_insert("Tmax", iT_max);
141 index_map_insert("pmax", iP_max);
142 index_map_insert("pmin", iP_min);
143 index_map_insert("molemass", imolar_mass);
144 index_map_insert("molarmass", imolar_mass);
145 index_map_insert("A", ispeed_sound);
146 index_map_insert("I", isurface_tension);
147 }
148
149 private:
150 void index_map_insert(const std::string& desc, int key) {
151 index_map.insert(std::pair<std::string, int>(desc, key));
152 index_map.insert(std::pair<std::string, int>(upper(desc), key));
153 }
154};
155
156std::unique_ptr<ParameterInformation> parameter_information_p;
159 parameter_information_p = std::make_unique<ParameterInformation>();
160 }
162}
163
164bool is_trivial_parameter(int key) {
165 auto& parameter_information = get_parameter_information();
166 auto it = parameter_information.trivial_map.find(key);
167 if (it != parameter_information.trivial_map.end()) {
168 return it->second;
169 }
170 throw ValueError(format("Unable to match the key [%d: %s] in is_trivial_parameter", key, get_parameter_information(key, "short").c_str()));
171}
172
173std::string get_parameter_information(int key, const std::string& info) {
174 const std::map<int, std::string>* M;
175 auto& parameter_information = get_parameter_information();
176 // Hook up the right map (since they are all of the same type)
177 if (!info.compare("IO")) {
178 M = &(parameter_information.IO_map);
179 } else if (!info.compare("short")) {
180 M = &(parameter_information.short_desc_map);
181 } else if (!info.compare("long")) {
182 M = &(parameter_information.description_map);
183 } else if (!info.compare("units")) {
184 M = &(parameter_information.units_map);
185 } else {
186 throw ValueError(format("Bad info string [%s] to get_parameter_information", info.c_str()));
187 }
188
189 auto it = M->find(key);
190 if (it != M->end()) {
191 return it->second;
192 }
193 throw ValueError(format("Unable to match the key [%d] in get_parameter_information for info [%s]", key, info.c_str()));
194}
195
198 auto& parameter_information = get_parameter_information();
199 std::vector<std::string> strings;
200 for (auto& it : parameter_information.index_map) {
201 strings.push_back(it.first);
202 }
203 return strjoin(strings, ",");
204}
205bool is_valid_parameter(const std::string& param_name, parameters& iOutput) {
206 auto& parameter_information = get_parameter_information();
207 // Try to find it
208 std::map<std::string, int>::const_iterator it = parameter_information.index_map.find(param_name);
209 // If equal to end, not found
210 if (it != parameter_information.index_map.end()) {
211 // Found, return it
212 iOutput = static_cast<parameters>(it->second);
213 return true;
214 } else {
215 return false;
216 }
217}
218
219bool is_valid_first_derivative(const std::string& name, parameters& iOf, parameters& iWrt, parameters& iConstant) {
220 if (get_debug_level() > 5) {
221 std::cout << format("is_valid_first_derivative(%s)", name.c_str());
222 }
223 // There should be exactly one /
224 // There should be exactly one |
225
226 // Suppose we start with "d(P)/d(T)|Dmolar"
227 std::vector<std::string> split_at_bar = strsplit(name, '|'); // "d(P)/d(T)" and "Dmolar"
228 if (split_at_bar.size() != 2) {
229 return false;
230 }
231
232 std::vector<std::string> split_at_slash = strsplit(split_at_bar[0], '/'); // "d(P)" and "d(T)"
233 if (split_at_slash.size() != 2) {
234 return false;
235 }
236
237 std::size_t i0 = split_at_slash[0].find("(");
238 std::size_t i1 = split_at_slash[0].find(")", i0);
239 if (!((i0 > 0) && (i0 != std::string::npos) && (i1 > (i0 + 1)) && (i1 != std::string::npos))) {
240 return false;
241 }
242 std::string num = split_at_slash[0].substr(i0 + 1, i1 - i0 - 1);
243
244 i0 = split_at_slash[1].find("(");
245 i1 = split_at_slash[1].find(")", i0);
246 if (!((i0 > 0) && (i0 != std::string::npos) && (i1 > (i0 + 1)) && (i1 != std::string::npos))) {
247 return false;
248 }
249 std::string den = split_at_slash[1].substr(i0 + 1, i1 - i0 - 1);
250
251 parameters Of, Wrt, Constant;
252 if (is_valid_parameter(num, Of) && is_valid_parameter(den, Wrt) && is_valid_parameter(split_at_bar[1], Constant)) {
253 iOf = Of;
254 iWrt = Wrt;
255 iConstant = Constant;
256 return true;
257 } else {
258 return false;
259 }
260}
261
262bool is_valid_first_saturation_derivative(const std::string& name, parameters& iOf, parameters& iWrt) {
263 if (get_debug_level() > 5) {
264 std::cout << format("is_valid_first_saturation_derivative(%s)", name.c_str());
265 }
266 // There should be exactly one /
267 // There should be exactly one |
268
269 // Suppose we start with "d(P)/d(T)|sigma"
270 std::vector<std::string> split_at_bar = strsplit(name, '|'); // "d(P)/d(T)" and "sigma"
271 if (split_at_bar.size() != 2) {
272 return false;
273 }
274
275 std::vector<std::string> split_at_slash = strsplit(split_at_bar[0], '/'); // "d(P)" and "d(T)"
276 if (split_at_slash.size() != 2) {
277 return false;
278 }
279
280 std::size_t i0 = split_at_slash[0].find("(");
281 std::size_t i1 = split_at_slash[0].find(")", i0);
282 if (!((i0 > 0) && (i0 != std::string::npos) && (i1 > (i0 + 1)) && (i1 != std::string::npos))) {
283 return false;
284 }
285 std::string num = split_at_slash[0].substr(i0 + 1, i1 - i0 - 1);
286
287 i0 = split_at_slash[1].find("(");
288 i1 = split_at_slash[1].find(")", i0);
289 if (!((i0 > 0) && (i0 != std::string::npos) && (i1 > (i0 + 1)) && (i1 != std::string::npos))) {
290 return false;
291 }
292 std::string den = split_at_slash[1].substr(i0 + 1, i1 - i0 - 1);
293
294 parameters Of, Wrt;
295 if (is_valid_parameter(num, Of) && is_valid_parameter(den, Wrt) && upper(split_at_bar[1]) == "SIGMA") {
296 iOf = Of;
297 iWrt = Wrt;
298 return true;
299 } else {
300 return false;
301 }
302}
303
304bool is_valid_second_derivative(const std::string& name, parameters& iOf1, parameters& iWrt1, parameters& iConstant1, parameters& iWrt2,
305 parameters& iConstant2) {
306 if (get_debug_level() > 5) {
307 std::cout << format("is_valid_second_derivative(%s)", name.c_str());
308 }
309
310 // Suppose we start with "d(d(P)/d(Dmolar)|T)/d(Dmolar)|T"
311 std::size_t i = name.rfind('|');
312 if ((i == 0) || (i == std::string::npos)) {
313 return false;
314 }
315 std::string constant2 = name.substr(i + 1); // "T"
316 if (!is_valid_parameter(constant2, iConstant2)) {
317 return false;
318 };
319 std::string left_of_bar = name.substr(0, i); // "d(d(P)/d(Dmolar)|T)/d(Dmolar)"
320
321 i = left_of_bar.rfind('/');
322 if ((i == 0) || (i == std::string::npos)) {
323 return false;
324 }
325 std::string left_of_slash = left_of_bar.substr(0, i); // "d(d(P)/d(Dmolar)|T)"
326 std::string right_of_slash = left_of_bar.substr(i + 1); // "d(Dmolar)"
327
328 i = left_of_slash.find("(");
329 std::size_t i1 = left_of_slash.rfind(")");
330 if (!((i > 0) && (i != std::string::npos) && (i1 > (i + 1)) && (i1 != std::string::npos))) {
331 return false;
332 }
333 std::string num = left_of_slash.substr(i + 1, i1 - i - 1); // "d(P)/d(Dmolar)|T"
334 if (!is_valid_first_derivative(num, iOf1, iWrt1, iConstant1)) {
335 return false;
336 }
337
338 i = right_of_slash.find("(");
339 i1 = right_of_slash.rfind(")");
340 if (!((i > 0) && (i != std::string::npos) && (i1 > (i + 1)) && (i1 != std::string::npos))) {
341 return false;
342 }
343 std::string den = right_of_slash.substr(i + 1, i1 - i - 1); // "Dmolar"
344 if (!is_valid_parameter(den, iWrt2)) {
345 return false;
346 }
347
348 // If we haven't quit yet, all is well
349 return true;
350}
351
353{
355 const char *short_desc, *long_desc;
356};
357
359 {iphase_liquid, "phase_liquid", ""},
360 {iphase_gas, "phase_gas", ""},
361 {iphase_twophase, "phase_twophase", ""},
362 {iphase_supercritical, "phase_supercritical", ""},
363 {iphase_supercritical_gas, "phase_supercritical_gas", "p < pc, T > Tc"},
364 {iphase_supercritical_liquid, "phase_supercritical_liquid", "p > pc, T < Tc"},
365 {iphase_critical_point, "phase_critical_point", "p = pc, T = Tc"},
366 {iphase_unknown, "phase_unknown", ""},
367 {iphase_not_imposed, "phase_not_imposed", ""},
368};
369
371{
372 public:
373 std::map<phases, std::string> short_desc_map, long_desc_map;
374 std::map<std::string, phases> index_map;
376 const phase_info* const end = phase_info_list + sizeof(phase_info_list) / sizeof(phase_info_list[0]);
377 for (const phase_info* el = phase_info_list; el != end; ++el) {
378 short_desc_map.insert(std::pair<phases, std::string>(el->key, el->short_desc));
379 long_desc_map.insert(std::pair<phases, std::string>(el->key, el->long_desc));
380 index_map.insert(std::pair<std::string, phases>(el->short_desc, el->key));
381 }
382 }
383};
384
385std::unique_ptr<PhaseInformation> phase_information_p;
387 if (!phase_information_p) {
388 phase_information_p = std::make_unique<PhaseInformation>();
389 }
390 return *phase_information_p;
391}
392
393const std::string& get_phase_short_desc(phases phase) {
394 auto& coolprop_information = get_phase_information();
395 auto iter = coolprop_information.short_desc_map.find(phase);
396 if (iter != coolprop_information.short_desc_map.end()) {
397 return iter->second;
398 }
399 throw ValueError("Cannot find the short phase description.");
400}
401bool is_valid_phase(const std::string& phase_name, phases& iOutput) {
402 auto& phase_information = get_phase_information();
403 // Try to find it
404 std::map<std::string, phases>::const_iterator it = phase_information.index_map.find(phase_name);
405 // If equal to end, not found
406 if (it != phase_information.index_map.end()) {
407 // Found, return it
408 iOutput = static_cast<phases>(it->second);
409 return true;
410 } else {
411 return false;
412 }
413}
414
415phases get_phase_index(const std::string& param_name) {
417 if (is_valid_phase(param_name, iPhase)) {
418 return iPhase;
419 } else {
420 throw ValueError(format("Your input name [%s] is not valid in get_phase_index (names are case sensitive)", param_name.c_str()));
421 }
422}
423
425{
427 std::string short_desc;
428};
429
431 { i1, "1"},
432 { i2a, "2A"},
433 { i2b, "2B"},
434 { i3a, "3A"},
435 { i3b, "3B"},
436 { i4a, "4A"},
437 { i4b, "4B"},
438 { i4c, "4C"},
439};
440
442public:
443 std::map<schemes, std::string> short_desc_map;
444 std::map<std::string, schemes> index_map;
446 {
447 const scheme_info* const end = scheme_info_list + sizeof(scheme_info_list) / sizeof(scheme_info_list[0]);
448 for (const scheme_info* el = scheme_info_list; el != end; ++el)
449 {
450 short_desc_map.insert(std::pair<schemes, std::string>(el->key, el->short_desc));
451 index_map.insert(std::pair<std::string, schemes>(el->short_desc, el->key));
452 }
453 }
454};
455
456std::unique_ptr<SchemeInformation> scheme_information_p;
459 scheme_information_p = std::make_unique<SchemeInformation>();
460 }
461 return *scheme_information_p;
462}
463
464const std::string& get_scheme_short_desc(schemes scheme) {
465 auto& coolprop_information = get_scheme_information();
466 auto it = coolprop_information.short_desc_map.find(scheme);
467 if (it != coolprop_information.short_desc_map.end()) {
468 return it->second;
469 }
470 throw ValueError("Cannot find the short scheme description.");
471}
472
473bool is_valid_scheme(const std::string &scheme_name, schemes &iOutput) {
474 auto& scheme_information = get_scheme_information();
475 auto it = scheme_information.index_map.find(scheme_name);
476 // If equal to end, not found
477 if (it != scheme_information.index_map.end()){
478 // Found, return it
479 iOutput = static_cast<schemes>(it->second);
480 return true;
481 }
482 else{
483 return false;
484 }
485}
486
487schemes get_scheme_index(const std::string &param_name) {
488 schemes iScheme;
489 if (is_valid_scheme(param_name, iScheme)){
490 return iScheme;
491 }
492 else{
493 throw ValueError(format("Your input name [%s] is not valid in get_scheme_index (names are case sensitive)",param_name.c_str()));
494 }
495}
496
497parameters get_parameter_index(const std::string& param_name) {
498 parameters iOutput;
499 if (is_valid_parameter(param_name, iOutput)) {
500 return iOutput;
501 } else {
502 throw ValueError(format("Your input name [%s] is not valid in get_parameter_index (names are case sensitive)", param_name.c_str()));
503 }
504}
505
507{
509 const char *short_desc, *long_desc;
510};
511
513 {QT_INPUTS, "QT_INPUTS", "Molar quality, Temperature in K"},
514 {QSmolar_INPUTS, "QS_INPUTS", "Molar quality, Entropy in J/mol/K"},
515 {QSmass_INPUTS, "QS_INPUTS", "Molar quality, Entropy in J/kg/K"},
516 {HmolarQ_INPUTS, "HQ_INPUTS", "Enthalpy in J/mol, Molar quality"},
517 {HmassQ_INPUTS, "HQ_INPUTS", "Enthalpy in J/kg, Molar quality"},
518 {DmassQ_INPUTS, "DmassQ_INPUTS", "Molar density kg/m^3, Molar quality"},
519 {DmolarQ_INPUTS, "DmolarQ_INPUTS", "Molar density in mol/m^3, Molar quality"},
520
521 {PQ_INPUTS, "PQ_INPUTS", "Pressure in Pa, Molar quality"},
522
523 {PT_INPUTS, "PT_INPUTS", "Pressure in Pa, Temperature in K"},
524
525 {DmassT_INPUTS, "DmassT_INPUTS", "Mass density in kg/m^3, Temperature in K"},
526 {DmolarT_INPUTS, "DmolarT_INPUTS", "Molar density in mol/m^3, Temperature in K"},
527 {HmassT_INPUTS, "HmassT_INPUTS", "Enthalpy in J/kg, Temperature in K"},
528 {HmolarT_INPUTS, "HmolarT_INPUTS", "Enthalpy in J/mol, Temperature in K"},
529 {SmassT_INPUTS, "SmassT_INPUTS", "Entropy in J/kg/K, Temperature in K"},
530 {SmolarT_INPUTS, "SmolarT_INPUTS", "Entropy in J/mol/K, Temperature in K"},
531 {TUmass_INPUTS, "TUmass_INPUTS", "Temperature in K, Internal energy in J/kg"},
532 {TUmolar_INPUTS, "TUmolar_INPUTS", "Temperature in K, Internal energy in J/mol"},
533
534 {DmassP_INPUTS, "DmassP_INPUTS", "Mass density in kg/m^3, Pressure in Pa"},
535 {DmolarP_INPUTS, "DmolarP_INPUTS", "Molar density in mol/m^3, Pressure in Pa"},
536 {HmassP_INPUTS, "HmassP_INPUTS", "Enthalpy in J/kg, Pressure in Pa"},
537 {HmolarP_INPUTS, "HmolarP_INPUTS", "Enthalpy in J/mol, Pressure in Pa"},
538 {PSmass_INPUTS, "PSmass_INPUTS", "Pressure in Pa, Entropy in J/kg/K"},
539 {PSmolar_INPUTS, "PSmolar_INPUTS", "Pressure in Pa, Entropy in J/mol/K "},
540 {PUmass_INPUTS, "PUmass_INPUTS", "Pressure in Pa, Internal energy in J/kg"},
541 {PUmolar_INPUTS, "PUmolar_INPUTS", "Pressure in Pa, Internal energy in J/mol"},
542
543 {DmassHmass_INPUTS, "DmassHmass_INPUTS", "Mass density in kg/m^3, Enthalpy in J/kg"},
544 {DmolarHmolar_INPUTS, "DmolarHmolar_INPUTS", "Molar density in mol/m^3, Enthalpy in J/mol"},
545 {DmassSmass_INPUTS, "DmassSmass_INPUTS", "Mass density in kg/m^3, Entropy in J/kg/K"},
546 {DmolarSmolar_INPUTS, "DmolarSmolar_INPUTS", "Molar density in mol/m^3, Entropy in J/mol/K"},
547 {DmassUmass_INPUTS, "DmassUmass_INPUTS", "Mass density in kg/m^3, Internal energy in J/kg"},
548 {DmolarUmolar_INPUTS, "DmolarUmolar_INPUTS", "Molar density in mol/m^3, Internal energy in J/mol"},
549
550 {HmassSmass_INPUTS, "HmassSmass_INPUTS", "Enthalpy in J/kg, Entropy in J/kg/K"},
551 {HmolarSmolar_INPUTS, "HmolarSmolar_INPUTS", "Enthalpy in J/mol, Entropy in J/mol/K"},
552 {SmassUmass_INPUTS, "SmassUmass_INPUTS", "Entropy in J/kg/K, Internal energy in J/kg"},
553 {SmolarUmolar_INPUTS, "SmolarUmolar_INPUTS", "Entropy in J/mol/K, Internal energy in J/mol"},
554};
555
557{
558 public:
559 std::map<input_pairs, std::string> short_desc_map, long_desc_map;
560 std::map<std::string, input_pairs> index_map;
562 const input_pair_info* const end = input_pair_list + sizeof(input_pair_list) / sizeof(input_pair_list[0]);
563 for (const input_pair_info* el = input_pair_list; el != end; ++el) {
564 short_desc_map.insert(std::pair<input_pairs, std::string>(el->key, el->short_desc));
565 long_desc_map.insert(std::pair<input_pairs, std::string>(el->key, el->long_desc));
566 index_map.insert(std::pair<std::string, input_pairs>(el->short_desc, el->key));
567 }
568 }
569};
570
571std::unique_ptr<InputPairInformation> input_pair_information_p;
574 input_pair_information_p = std::make_unique<InputPairInformation>();
575 }
577}
578
579input_pairs get_input_pair_index(const std::string& input_pair_name) {
580 auto& coolprop_information = get_input_pair_information();
581 auto it = coolprop_information.index_map.find(input_pair_name);
582 if (it != coolprop_information.index_map.end()) {
583 return it->second;
584 }
585 throw ValueError(format("Your input name [%s] is not valid in get_input_pair_index (names are case sensitive)", input_pair_name.c_str()));
586}
587
588const std::string& get_input_pair_short_desc(input_pairs pair) {
589 auto& coolprop_information = get_input_pair_information();
590 auto it = coolprop_information.short_desc_map.find(pair);
591 if (it != coolprop_information.short_desc_map.end()) {
592 return it->second;
593 }
594 throw ValueError("Cannot find the short input pair description.");
595}
596const std::string& get_input_pair_long_desc(input_pairs pair) {
597 auto& coolprop_information = get_input_pair_information();
598 auto it = coolprop_information.long_desc_map.find(pair);
599 if (it != coolprop_information.long_desc_map.end()) {
600 return it->second;
601 }
602 throw ValueError("Cannot find the long input pair description.");
603}
605 switch (pair) {
606 case QT_INPUTS:
607 p1 = iQ;
608 p2 = iT;
609 break;
610 case QSmolar_INPUTS:
611 p1 = iQ;
612 p2 = iSmolar;
613 break;
614 case QSmass_INPUTS:
615 p1 = iQ;
616 p2 = iSmass;
617 break;
618 case HmolarQ_INPUTS:
619 p1 = iHmolar;
620 p2 = iQ;
621 break;
622 case HmassQ_INPUTS:
623 p1 = iHmass;
624 p2 = iQ;
625 break;
626 case PQ_INPUTS:
627 p1 = iP;
628 p2 = iQ;
629 break;
630 case PT_INPUTS:
631 p1 = iP;
632 p2 = iT;
633 break;
634 case DmassT_INPUTS:
635 p1 = iDmass;
636 p2 = iT;
637 break;
638 case DmolarT_INPUTS:
639 p1 = iDmolar;
640 p2 = iT;
641 break;
642 case HmassT_INPUTS:
643 p1 = iHmass;
644 p2 = iT;
645 break;
646 case HmolarT_INPUTS:
647 p1 = iHmolar;
648 p2 = iT;
649 break;
650 case SmassT_INPUTS:
651 p1 = iSmass;
652 p2 = iT;
653 break;
654 case SmolarT_INPUTS:
655 p1 = iSmolar;
656 p2 = iT;
657 break;
658 case TUmass_INPUTS:
659 p1 = iT;
660 p2 = iUmass;
661 break;
662 case TUmolar_INPUTS:
663 p1 = iT;
664 p2 = iUmolar;
665 break;
666 case DmassP_INPUTS:
667 p1 = iDmass;
668 p2 = iP;
669 break;
670 case DmolarP_INPUTS:
671 p1 = iDmolar;
672 p2 = iP;
673 break;
674 case DmassQ_INPUTS:
675 p1 = iDmass;
676 p2 = iQ;
677 break;
678 case DmolarQ_INPUTS:
679 p1 = iDmolar;
680 p2 = iQ;
681 break;
682 case HmassP_INPUTS:
683 p1 = iHmass;
684 p2 = iP;
685 break;
686 case HmolarP_INPUTS:
687 p1 = iHmolar;
688 p2 = iP;
689 break;
690 case PSmass_INPUTS:
691 p1 = iP;
692 p2 = iSmass;
693 break;
694 case PSmolar_INPUTS:
695 p1 = iP;
696 p2 = iSmolar;
697 break;
698 case PUmass_INPUTS:
699 p1 = iP;
700 p2 = iUmass;
701 break;
702 case PUmolar_INPUTS:
703 p1 = iP;
704 p2 = iUmolar;
705 break;
707 p1 = iDmass;
708 p2 = iHmass;
709 break;
711 p1 = iDmolar;
712 p2 = iHmolar;
713 break;
715 p1 = iDmass;
716 p2 = iSmass;
717 break;
719 p1 = iDmolar;
720 p2 = iSmolar;
721 break;
723 p1 = iDmass;
724 p2 = iUmass;
725 break;
727 p1 = iDmolar;
728 p2 = iUmolar;
729 break;
731 p1 = iHmass;
732 p2 = iSmass;
733 break;
735 p1 = iHmolar;
736 p2 = iSmolar;
737 break;
739 p1 = iSmass;
740 p2 = iUmass;
741 break;
743 p1 = iSmolar;
744 p2 = iUmolar;
745 break;
746 default:
747 throw ValueError(format("Invalid input pair"));
748 }
749}
750
752{
754 std::string name;
755};
756
758{
760 std::string name;
762};
763
764const std::vector<backend_family_info> backend_family_list = {
765 {HEOS_BACKEND_FAMILY, "HEOS"}, {REFPROP_BACKEND_FAMILY, "REFPROP"}, {INCOMP_BACKEND_FAMILY, "INCOMP"}, {IF97_BACKEND_FAMILY, "IF97"},
766 {TREND_BACKEND_FAMILY, "TREND"}, {TTSE_BACKEND_FAMILY, "TTSE"}, {BICUBIC_BACKEND_FAMILY, "BICUBIC"}, {SRK_BACKEND_FAMILY, "SRK"},
767 {PR_BACKEND_FAMILY, "PR"}, {VTPR_BACKEND_FAMILY, "VTPR"}, {PCSAFT_BACKEND_FAMILY, "PCSAFT"}};
768
769const std::vector<backend_info> backend_list = {
770 {HEOS_BACKEND_PURE, "HelmholtzEOSBackend", HEOS_BACKEND_FAMILY},
771 {HEOS_BACKEND_MIX, "HelmholtzEOSMixtureBackend", HEOS_BACKEND_FAMILY},
772 {REFPROP_BACKEND_PURE, "REFPROPBackend", REFPROP_BACKEND_FAMILY},
773 {REFPROP_BACKEND_MIX, "REFPROPMixtureBackend", REFPROP_BACKEND_FAMILY},
774 {INCOMP_BACKEND, "IncompressibleBackend", INCOMP_BACKEND_FAMILY},
775 {IF97_BACKEND, "IF97Backend", IF97_BACKEND_FAMILY},
776 {TREND_BACKEND, "TRENDBackend", TREND_BACKEND_FAMILY},
777 {TTSE_BACKEND, "TTSEBackend", TTSE_BACKEND_FAMILY},
778 {BICUBIC_BACKEND, "BicubicBackend", BICUBIC_BACKEND_FAMILY},
779 {SRK_BACKEND, "SRKBackend", SRK_BACKEND_FAMILY},
780 {PR_BACKEND, "PengRobinsonBackend", PR_BACKEND_FAMILY},
781 {VTPR_BACKEND, "VTPRBackend", VTPR_BACKEND_FAMILY},
782 {PCSAFT_BACKEND, "PCSAFTBackend", PCSAFT_BACKEND_FAMILY}
783};
784
786{
787 public:
788 std::map<backend_families, std::string> family_name_map;
789 std::map<backends, backend_families> backend_family_map;
790 std::map<backends, std::string> backend_name_map;
791
792 std::map<std::string, backend_families> family_name_map_r;
793 std::map<std::string, backends> backend_name_map_r;
794
796 for (auto& el : backend_family_list) {
797 family_name_map.insert(std::pair<backend_families, std::string>(el.family, el.name));
798 family_name_map_r.insert(std::pair<std::string, backend_families>(el.name, el.family));
799 }
800 for (auto& el : backend_list) {
801 backend_family_map.insert(std::pair<backends, backend_families>(el.backend, el.family));
802 backend_name_map.insert(std::pair<backends, std::string>(el.backend, el.name));
803 backend_name_map_r.insert(std::pair<std::string, backends>(el.name, el.backend));
804 family_name_map_r.insert(std::pair<std::string, backend_families>(el.name, el.family));
805 }
806 }
807};
808
809std::unique_ptr<BackendInformation> backend_information_p;
812 backend_information_p = std::make_unique<BackendInformation>();
813 }
814 return *backend_information_p;
815}
816
818void extract_backend_families(std::string backend_string, backend_families& f1, backend_families& f2) {
819 auto& backend_information = get_backend_information();
822 std::size_t i = backend_string.find("&");
823 std::map<std::string, backend_families>::const_iterator it;
824 if (i != std::string::npos) {
825 it = backend_information.family_name_map_r.find(backend_string.substr(0, i)); // Before "&"
826 if (it != backend_information.family_name_map_r.end()) f1 = it->second;
827 it = backend_information.family_name_map_r.find(backend_string.substr(i + 1)); // After "&"
828 if (it != backend_information.family_name_map_r.end()) f2 = it->second;
829 } else {
830 it = backend_information.family_name_map_r.find(backend_string);
831 if (it != backend_information.family_name_map_r.end()) f1 = it->second;
832 }
833}
834
835void extract_backend_families_string(std::string backend_string, backend_families& f1, std::string& f2) {
836 auto& backend_information = get_backend_information();
837 backend_families f2_enum;
838 extract_backend_families(backend_string, f1, f2_enum);
839 std::map<backend_families, std::string>::const_iterator it;
840 it = backend_information.family_name_map.find(f2_enum);
841 if (it != backend_information.family_name_map.end())
842 f2 = it->second;
843 else
844 f2.clear();
845}
846
847std::string get_backend_string(backends backend) {
848 auto& backend_information = get_backend_information();
849 std::map<backends, std::string>::const_iterator it;
850 it = backend_information.backend_name_map.find(backend);
851 if (it != backend_information.backend_name_map.end())
852 return it->second;
853 else
854 return std::string("");
855}
856
857} /* namespace CoolProp */
858
859#ifdef ENABLE_CATCH
860# include <catch2/catch_all.hpp>
861# include <sstream>
862
863TEST_CASE("Check that csv list of parameters is possible", "[parameter_list]") {
864 CHECK_NOTHROW(CoolProp::get_csv_parameter_list());
865}
866
867TEST_CASE("Check that all parameters are described", "") {
868 for (int i = 1; i < CoolProp::iundefined_parameter; ++i) {
869 std::ostringstream ss;
870 ss << "Parameter index," << i << "last index:" << CoolProp::iundefined_parameter;
871 SECTION(ss.str(), "") {
872 std::string prior;
873 if (i > 1) {
874 CHECK_NOTHROW(prior = CoolProp::get_parameter_information(i - 1, "short"));
875 CAPTURE(prior);
876 }
877 CHECK_NOTHROW(CoolProp::get_parameter_information(i, "short"));
878 }
879 }
880}
881
882TEST_CASE("Check that all phases are described", "[phase_index]") {
883 for (int i = 0; i < CoolProp::iphase_not_imposed; ++i) {
884 std::ostringstream ss;
885 ss << "Parameter index," << i << "last index:" << CoolProp::iundefined_parameter;
886 SECTION(ss.str(), "") {
887 std::string stringrepr;
888 int key;
889 CHECK_NOTHROW(stringrepr = CoolProp::get_phase_short_desc(static_cast<CoolProp::phases>(i)));
890 CAPTURE(stringrepr);
891 CHECK_NOTHROW(key = CoolProp::get_phase_index(stringrepr));
892 CAPTURE(key);
893 CHECK(key == i);
894 }
895 }
896}
897
898#endif