*********************************************** README.txt **************************************************

Title:                      Decreasing Environmental Impact and Cost of ultra low frequency Levitation-based 
				Energy Harvesters : Datasets and scripts
Version:                    1.0
Date of Release:            2025/07/21
Identifier:                 doi:10.5281/zenodo.16280644 (last version)
Permalink:                  http://dx.doi.org/10.5281/zenodo.16280644 (last version)

*************************************************************************************************************

Associated publication:     I. Royo-Silvestre, Jorge Gómez-Hurtado, J. J. Beato-López, D. Gandia, E. Garaio, C. Gómez-Polo 
	"Decreasing Environmental Impact and Cost of ultra low frequency Levitation-based Energy Harvesters" 
	(paper yet to be published)
                              
Link to publication:	    (paper yet to be published)

Suggested citation:         Please reference the associated publication above when using any datasets or
                              materials described in this README file.

Contact information:        Isaac Royo Silvestre, 
							Universidad Pública de Navarra, 
							Pamplona, Spain, 
							isaac.royo@unavarra.es

Funding sources:            This work is funded by Spanish Agencia Estatal de Investigación and Ministerio 
                      de Ciencia e Innovación MCIN/AEI/ 10.13039/501100011033 and 
                      by "European Union NextGenerationEU/PRTR, project TED2021-130884B-I00.
                      Open access funding partially provided by Universidad Pública de Navarra.

License:                    CC BY 4.0

------------------------------------------------------------------------------------------------------------

This directory contains the following datasets and supplementary materials:

    ------------------------------
    SCRIPTS
    ------------------------------

    - scripts.zip               Matlab scripts (compressed zip file) used to calculate the characteristics of
				magnetic levitation based vibration energy harvesters, including resonant
				frequency, Force curves, by analytical and semianalytical methods 							(more information in the associated paper and in the scripts header).
				Scripts are compatible with GNU Octave.    

    --------------------------------
    DATASETS
    --------------------------------

    - data.zip: 		Tabular data required to plot curves (compressed zip file) in csv format,
				also data used to obtain average values, as well as experimental waveforms


Specific documentation of each file is described in readme files.

Refer to the original manuscript (see above) for additional information regarding the collection and generation of these data.

------------------------------------------------------------------------------------------------------------

  ---------------------------------------------------------------------
  DOCUMENTATION FOR 'scripts.zip'
  ---------------------------------------------------------------------

    The zip file contains another readme.txt file (that explains the content of the zip file in detail), 
	and multiple .m files. m files are Matlab scripts, text files that can be read using any text editor. However 		it has to be executed via Matlab (or GNU Octave), scripts contain documentation as comments.

  ---------------------------------------------------------------
  DOCUMENTATION FOR 'data.zip'
  ---------------------------------------------------------------

    The zip file contains two folders, each with another readme.txt file (that explains the content of each folder in detail).
	The waveforms folder contains raw experimental data and also data exported to csv format.
	The curves folder contains tabular data in .csv files, these files can be used to plot the curves
	in the manuscript.