From 0b0ab76333c6ebf764de1ddc058845af30c762c9 Mon Sep 17 00:00:00 2001 From: Carl Philipp Klemm <philipp@uvos.xyz> Date: Tue, 9 Jan 2024 11:26:25 +0100 Subject: [PATCH] fix docs spelling --- README.md | 2 ++ doc/mainpage.txt | 14 +++++++------- eisdrt/eigendrt.h | 20 ++++++++++---------- eisdrt/eisdrt.h | 26 +++++++++++++------------- eisdrt/torchdrt.h | 8 ++++---- eisdrt/types.h | 6 +++--- 6 files changed, 39 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index ac30f37..712c4b6 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +[comment]: \page README Readme + # libeisdrt _libeisdrt_ is a c++ shared library to compute Distribution of Relaxation Times using Tikhonov regularization. diff --git a/doc/mainpage.txt b/doc/mainpage.txt index 353420e..05246e3 100644 --- a/doc/mainpage.txt +++ b/doc/mainpage.txt @@ -12,11 +12,11 @@ This manual is divided in the following sections depending on what datatypes you ## Building -the main devolpment platform of _libeisdrt_ is linux, and _libeisdrt_ works best on UNIX-like systems, however _libeisdrt_ is fully portable and should compile on any platform that supports the requriements below +the main development platform of _libeisdrt_ is Linux, and _libeisdrt_ works best on UNIX-like systems, however _libeisdrt_ is fully portable and should compile on any platform that supports the requirements below -### Requirments -- [git](https://git-scm.com/) is requried to get the source -- a C++20 compliant compiler like [gcc](https://gcc.gnu.org/) +### Requirements +- [git](https://git-scm.com/) is required to get the source +- a C++20 compliant compiler like [GCC](https://gcc.gnu.org/) - [cmake](https://cmake.org/) version 3.19 or later - [libtorch](https://pytorch.org/get-started/locally/) is optional, but is required for libtorch Tensor support - [eisgenerator](https://git-ce.rwth-aachen.de/carl_philipp.klemm/eisgenerator) is optional, but is required for eisgenerator DataPoint support @@ -36,7 +36,7 @@ $ make doc ## Usage -The usage of this library can be infered from the API documentation linked above and from the following eisgenerator based example. +The usage of this library can be inferred from the API documentation linked above and from the following eisgenerator based example. ### Example usage: @@ -112,8 +112,8 @@ int main(int argc, char** argv) } ``` -# Licence +# License -_libeisdrt_ is licenced to you under the LGPL version 3 , or (at your option) any later version. see lgpl-3.0.txt or [LGPL](https://www.gnu.org/licenses/lgpl-3.0.en.html) for details +_libeisdrt_ is licensed to you under the LGPL version 3 , or (at your option) any later version. see lgpl-3.0.txt or [LGPL](https://www.gnu.org/licenses/lgpl-3.0.en.html) for details */ diff --git a/eisdrt/eigendrt.h b/eisdrt/eigendrt.h index 7b4a50a..c112de3 100644 --- a/eisdrt/eigendrt.h +++ b/eisdrt/eigendrt.h @@ -23,9 +23,9 @@ #include "types.h" /** -Api for use with Eigen applications +API for use with Eigen applications * @defgroup EIGENAPI Eigen API -* calculates drts with eigen datatypes +* calculates drts with Eigen datatypes * @{ */ @@ -33,11 +33,11 @@ Api for use with Eigen applications * @brief calculate the drt using Eigen datatypes * * @tparam fv precision to be used, either double or float - * @param impedanceSpectra vector with the complex impedances of your expirament - * @param omegaTensor vector with the omega values that the impedances where mesured at - * @param fm a fit metrics struct where this function returns information on the fit aquired + * @param impedanceSpectra vector with the complex impedances of your experiment + * @param omegaTensor vector with the omega values that the impedances where measured at + * @param fm a fit metrics struct where this function returns information on the fit acquired * @param fp a struct with fit parameters - * @param rSeries an optional paramter where the seires resistance is stored + * @param rSeries an optional parameter where the series resistance is stored * @return a vector with the drt values */ template<typename fv> @@ -46,12 +46,12 @@ Eigen::VectorX<fv> calcDrt(Eigen::VectorX<std::complex<fv>>& impedanceSpectra, E /** - * @brief calculate impedance from drt using eigen datatypes + * @brief calculate impedance from drt using Eigen datatypes * * @tparam fv precision to be used, either double or float - * @param drt the drt to caluclate impedance from - * @param omegaVector vector with the omega values that the impedances where mesured at - * @param rSeries an optional paramter where the seires resistance is stored + * @param drt the drt to calculate impedance from + * @param omegaVector vector with the omega values that the impedances where measured at + * @param rSeries an optional parameter where the series resistance is stored * @return a vector with the drt values */ template<typename fv> diff --git a/eisdrt/eisdrt.h b/eisdrt/eisdrt.h index b45db5b..a14a287 100644 --- a/eisdrt/eisdrt.h +++ b/eisdrt/eisdrt.h @@ -23,7 +23,7 @@ #include "types.h" /** -Api for use with eisgenerator applications +API for use with eisgenerator applications * @defgroup EISAPI eisgenerator API * calculates drts with eisgenerator datatypes * @{ @@ -32,11 +32,11 @@ Api for use with eisgenerator applications /** * @brief calculate a drt on eisgenerator types * - * @param data a vector of eisgenerator datapoints with the values to your expirament, embedded omega values are ignored - * @param omegaVector vector with the omega values that the impedances where mesured at - * @param fm a fit metrics struct where this function returns information on the fit aquired + * @param data a vector of eisgenerator data points with the values to your experiment, embedded omega values are ignored + * @param omegaVector vector with the omega values that the impedances where measured at + * @param fm a fit metrics struct where this function returns information on the fit acquired * @param fp a struct with fit parameters - * @param rSeries an optional paramter where the seires resistance is stored + * @param rSeries an optional parameter where the series resistance is stored * @return a vector with the drt values */ std::vector<fvalue> calcDrt(const std::vector<eis::DataPoint>& data, const std::vector<fvalue>& omegaVector, FitMetics& fm, @@ -45,10 +45,10 @@ std::vector<fvalue> calcDrt(const std::vector<eis::DataPoint>& data, const std:: /** * @brief calculate a drt on eisgenerator types * - * @param data a vector of eisgenerator datapoints with the values to your expirament, embedded omega values are used - * @param fm a fit metrics struct where this function returns information on the fit aquired + * @param data a vector of eisgenerator data points with the values to your experiment, embedded omega values are used + * @param fm a fit metrics struct where this function returns information on the fit acquired * @param fp a struct with fit parameters - * @param rSeries an optional paramter where the seires resistance is stored + * @param rSeries an optional parameter where the series resistance is stored * @return a vector with the drt values */ std::vector<fvalue> calcDrt(const std::vector<eis::DataPoint>& data, FitMetics& fm, const FitParameters& fp, fvalue* rSeries = nullptr); @@ -56,9 +56,9 @@ std::vector<fvalue> calcDrt(const std::vector<eis::DataPoint>& data, FitMetics& /** * @brief calculate impedance from drt using eisgenerator datatypes * - * @param drt the drt to caluclate impedance from - * @param omegaVector vector with the omega values that the impedances where mesured at - * @param rSeries an optional paramter where the seires resistance is stored + * @param drt the drt to calculate impedance from + * @param omegaVector vector with the omega values that the impedances where measured at + * @param rSeries an optional parameter where the series resistance is stored * @return a vector with the impedance values */ std::vector<eis::DataPoint> calcImpedance(const std::vector<fvalue>& drt, fvalue rSeries, const std::vector<fvalue>& omegaVector); @@ -66,9 +66,9 @@ std::vector<eis::DataPoint> calcImpedance(const std::vector<fvalue>& drt, fvalue /** * @brief calculate impedance from drt using eisgenerator datatypes * - * @param drt the drt to caluclate impedance from + * @param drt the drt to calculate impedance from * @param omegaRange range that describes the omega values the drt was taken at - * @param rSeries an optional paramter where the seires resistance is stored + * @param rSeries an optional parameter where the series resistance is stored * @return a vector with the impedance values */ std::vector<eis::DataPoint> calcImpedance(const std::vector<fvalue>& drt, fvalue rSeries, const eis::Range& omegaRange); diff --git a/eisdrt/torchdrt.h b/eisdrt/torchdrt.h index 3888f38..e0aafc8 100644 --- a/eisdrt/torchdrt.h +++ b/eisdrt/torchdrt.h @@ -32,9 +32,9 @@ Api for use with libtorch applications * @brief calculate a drt on eisgenerator types * * @tparam fv precision to be used, either double or float - * @param impedanceSpectra a 1d complex tensor with the impedance mesurement data points - * @param omegaTensor a 1d tensor with the omega values that the impedances where mesured at - * @param fm a fit metrics struct where this function returns information on the fit aquired + * @param impedanceSpectra a 1d complex tensor with the impedance measurement data points + * @param omegaTensor a 1d tensor with the omega values that the impedances where measured at + * @param fm a fit metrics struct where this function returns information on the fit acquired * @param fp a struct with fit parameters * @return a 1d tensor with the drt values */ @@ -45,7 +45,7 @@ torch::Tensor calcDrtTorch(torch::Tensor& impedanceSpectra, torch::Tensor& omega * @brief calculates impedance from drt * * @tparam fv precision to be used, either double or float - * @param drt the drt to calcualte impedance from + * @param drt the drt to calculate impedance from * @return a complex tensor with the impedance spectra */ template<typename fv> diff --git a/eisdrt/types.h b/eisdrt/types.h index 4427b3e..76bb656 100644 --- a/eisdrt/types.h +++ b/eisdrt/types.h @@ -30,7 +30,7 @@ Types for use with all eisdrt apis /** - * @brief Exception thrown if drt could not be calcualted + * @brief Exception thrown if drt could not be calculated */ class drt_errror: public std::exception { @@ -49,9 +49,9 @@ public: */ struct FitMetics { - int iterations; /**< how many itterations where used */ + int iterations; /**< how many iterations where used */ double fx; /**< error function value remaining after fit */ - bool compleated; /**< true if fit compleated sucessfully */ + bool compleated; /**< true if fit completed successfully */ }; struct FitParameters -- GitLab