GY-63_MS5611/libraries/AtomicWeight/AtomicWeight.h

#pragma once
//
//    FILE: AtomicWeight.h
//  AUTHOR: Rob Tillaart
//    DATE: 2022-03-09
// VERSION: 0.2.0
// PURPOSE: Arduino library for atomic weights
//     URL: https://github.com/RobTillaart/AtomicWeight


#include "Arduino.h"


#define ATOMIC_WEIGHT_LIB_VERSION         (F("0.2.0"))


#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 --