GY-63_MS5611/libraries/AtomicWeight/AtomicWeight.h
2023-10-17 19:50:25 +02:00

99 lines
2.6 KiB
C++

#pragma once
//
// FILE: AtomicWeight.h
// AUTHOR: Rob Tillaart
// DATE: 2022-03-09
// VERSION: 0.2.1
// PURPOSE: Arduino library for atomic weights
// URL: https://github.com/RobTillaart/AtomicWeight
#include "Arduino.h"
#define ATOMIC_WEIGHT_LIB_VERSION (F("0.2.1"))
#ifndef ATOMIC_WEIGHT_MAX_SPLIT_LIST
#define ATOMIC_WEIGHT_MAX_SPLIT_LIST 20
#endif
// Miscellaneous related constants.
const float AVOGADRO = 6.02214076e+23; // 1.0 / DALTON.
const float DALTON = 1.66053907e-24; // weight in grams of one nucleon.
const float ELEKTRON_VOLT_JOULE = 1.602176565e-19; // eV in Joule
const float ELEKTRON_VOLT_GRAM = 1.7826619e-39; // eV in grams
const float DALTON_EV = DALTON / ELEKTRON_VOLT_GRAM;
const float DALTON_JOULE = DALTON / ELEKTRON_VOLT_JOULE;
/////////////////////////////////////////////////////////////////////////
//
// PERIODIC TABLE OF ELEMENTS Class
//
class PTOE
{
public:
PTOE(const uint8_t size = 118); // all by default
uint8_t size();
// BASIC
char * name(const uint8_t el);
uint8_t find(const char * abbrev);
uint8_t electrons(const uint8_t el);
uint8_t neutrons(const uint8_t el);
uint8_t protons(const uint8_t el);
// WEIGHT of one atom
float weight(const uint8_t el);
// if (el != NULL) weights one element in a formula, e.g el == "H"
// if (el == NULL) weights the whole formula
float weight(const char * formula, const char * abbrev = NULL);
// mass percentage of one element in a formula.
float massPercentage(const char * formula, const char * abbrev);
// CONVERSION
float moles2grams(const char * formula, float moles = 1.0);
float grams2moles(const char * formula, float grams = 1.0);
// SPLIT FORMULA IN ELEMENTS
uint8_t splitElements(const char * formula);
uint8_t element(uint8_t el);
// COUNT
// if (el != NULL) count atoms of one element in a formula, e.g el == "H"
// if (el == NULL) count all atoms in the whole formula
uint32_t count(const char * formula, const char * el = NULL);
// atom percentage of one element in a formula.
float atomPercentage(const char * formula, const char * el);
// DEBUG
float weightFactor();
private:
uint8_t _size;
// if (el == NULL) ==> whole weight otherwise only of element.
float _weight(char sep, const char * abbrev);
uint32_t _count(const char sep, const char * abbrev);
char *p; // for _weight() and _count()
// for splitElements
uint8_t _splitList[ATOMIC_WEIGHT_MAX_SPLIT_LIST]; // default 20
uint8_t _found;
};
// -- END OF FILE --