relaxisloader.h

/*
 * relaxisloader.h
 * Copyright (C) Carl Philipp Klemm 2023 <carl@uvos.xyz>
 *
 * relaxisloader is free software: you can redistribute it and/or modify it
 * under the terms of the lesser GNU General Public License as published by the
 * Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * relaxisloader is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details.
 *
 * You should have received a copy of the lesser GNU General Public License along
 * with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#pragma once
#include <stdbool.h>
#include <time.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct rlxfile;
 
struct rlx_project {
        int id; 
        char* name; 
        time_t date; 
};
 
void rlx_project_free(struct rlx_project* proj);
 
void rlx_project_free_array(struct rlx_project** proj_array);
 
struct rlx_datapoint {
        double im; 
        double re; 
        double omega; 
};
 
struct rlx_spectra {
        int id; 
        struct rlx_datapoint* datapoints; 
        size_t length; 
        char* circuit; 
        bool fitted; 
        int project_id; 
        double freq_lower_limit; 
        double freq_upper_limit; 
        time_t date_added; 
        time_t date_fitted; 
};
 
void rlx_spectra_free(struct rlx_spectra* spectra);
 
void rlx_spectra_free_array(struct rlx_spectra** spectra_array);
 
struct rlx_fitparam {
        int spectra_id;
        int p_index;
        char* name;
        double value;
        double error;
        double lower_limit;
        double upper_limit;
};
 
void rlx_fitparam_free(struct rlx_fitparam* param);
 
void rlx_fitparam_free_array(struct rlx_fitparam** param_array);
 
struct rlxfile* rlx_open_file(const char* path, const char** error);
 
void rlx_close_file(struct rlxfile* file);
 
struct rlx_project** rlx_get_projects(struct rlxfile* file, size_t* length);
 
struct rlx_spectra** rlx_get_all_spectra(struct rlxfile* file, const struct rlx_project* project);
 
int* rlx_get_spectra_ids(struct rlxfile* file, const struct rlx_project* project, size_t* length);
 
struct rlx_spectra* rlx_get_spectra(struct rlxfile* file, const struct rlx_project* project, int id);
 
int rlx_get_float_arrays(const struct rlx_spectra *spectra, float **re, float **im, float **omega);
 
int rlx_get_double_arrays(const struct rlx_spectra *spectra, double **re, double **im, double **omega);
 
struct rlx_fitparam** rlx_get_fit_parameters(struct rlxfile* file, const struct rlx_project* project, int id, size_t *length);
 
int rlx_get_errnum(const struct rlxfile* file);
 
const char* rlx_get_errnum_str(int errnum);
 
#ifdef __cplusplus
}
#endif