meafs 0.0.1__tar.gz

meafs-0.0.1/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Matheus J. Castro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

meafs-0.0.1/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.1
+Name: meafs
+Version: 0.0.1
+Summary: Multiple Element Abundance Fit Software
+Author: Matheus J. Castro
+Project-URL: Homepage, https://github.com/MatheusJCastro/meafs
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: astropy
+Requires-Dist: specutils
+Requires-Dist: scipy
+Requires-Dist: matplotlib
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: desktop_file
+Requires-Dist: pathlib
+Requires-Dist: PyQt6
+Requires-Dist: dill
+
+![Meafs Logo](meafs_code/images/Meafs_Logo.png)
+
+# Multiple Element Abundance Fit Software - MEAFS
+
+*Written by: Matheus J. Castro*  
+*Under MIT License*  
+
+<hr/>
+<hr/>
+
+## Table of Contents
+
+1. [Aims](#Aims)
+2. [Prerequisites](#Prerequisites)
+3. [Instalation](#Instalation)
+    1. [Creating Anaconda Environment (recommended)](<#creating-anaconda-environment-recommended>)
+    2. [Getting the pip version (recommended)](<#getting-the-pip-version-recommended-not-yet-working>)
+    3. [Cloning from GitHub](<#cloning-from-github>)
+    4. [Adding the PATH (for non Anaconda installations)](<#adding-the-path-for-non-anaconda-installations>)
+    5. [Step-by-Step for Windows (Python + GCC)](<#step-by-step-for-windows-python--gcc>)
+    6. [Compilation](<#compilation>)
+4. [Usage](#Usage)
+    1. [With Installation](<#with-installation>)
+    2. [Without Installation](<#without-installation>)
+    3. [Flags and Arguments](<#flags-and-arguments>)
+    4. [Auto Save](<#auto-save>)
+5. [Uninstall](#Uninstall)
+
+## Aims
+
+The MEAFS is a fitting tool software for spectra abundance analysis. The aims is to provide a medium to high analysis for each individual absorption line in a given spectrum.  
+The software also fits the wavelength shift, continuum and convolution of the spectrum.
+
+![Meafs GUI](meafs_code/images/Meafs_Gui.png)
+
+## Prerequisites
+
+- Python3 and GCC needs to be previously installed in the system (step-by-step to install for Windows users [bellow](<#step-by-step-for-windows-python--gcc>));
+
+- A software for creating a synthetic spectrum also needs to be previously installed. This version of MEAFS is compatible with the following softwares:
+    - Turbospectrum2019: [https://github.com/bertrandplez/Turbospectrum2019](https://github.com/bertrandplez/Turbospectrum2019)
+
+- Optionally: to execute the `unify_plots.py`, a LaTeX installation must be present on the system.
+
+- Optionally: [Anaconda](<#creating-anaconda-environment-recommended>).
+
+## Instalation
+
+There are many options to run MEAFS. We strongly recommend the use of Anaconda environment, but it is not mandatory.  
+You can install it from pip or run directly the source code from the repository.  
+
+All the methods listed below work in Linux, Windows or MacOS **if you have python and gcc installed** (step-by-step to install for Windows users [bellow](<#step-by-step-for-windows-python--gcc>)).
+
+### Creating Anaconda Environment (recommended)
+- First, download anaconda [here](https://www.anaconda.com/products/individual#download-section) and execute the script.
+
+    - For Linux users, if needed, export anaconda to your path by adding the line `export PATH="/home/USERNAME/anaconda3/bin:$PATH"` (changing the `USERNAME` to your user) to the `~/.bashrc` file. Close and open a new terminal to update the path.
+
+    - If desirable, disable autoactivation of anaconda with `conda config --set auto_activate_base false`.
+
+- Create MEAFS enviroment with `conda create python -n meafs`;
+
+- Then, to activate the environment, type `conda activate meafs`;
+
+### Getting the pip version (recommended) (not yet working)
+
+<s>
+You can easily get the pip version by typing in the terminal:
+
+#```bash
+#pip install meafs
+#```
+
+</s>
+
+### Cloning from GitHub
+
+Or you can directly clone from the GitHub page with:
+
+```bash
+git clone https://github.com/MatheusJCastro/meafs.git
+```
+
+After cloning, you can install it with pip or run without any installation at all (see the [Usage](<#without-installation>)  section).  
+
+To build the package and install it with pip from the source, first install the `build` package:  
+
+```bash
+pip install build
+```
+
+Then go to the MEAFS source code directory and type:
+
+```bash
+python3 -m build
+pip install .
+```
+
+### Adding the PATH (for non Anaconda installations)
+If you do not use Anaconda, you need to add the path of the pip scripts into the system path variable if you have not already done so.  
+**This step is not necessary if you are running without installation.**
+
+#### Linux
+For Linux users, you can add the following line in the end of the file `~/.bashrc`, changing `USER` to your own user.
+
+```bash
+export PATH="${PATH}:/home/USER/.local/bin/"
+```
+
+For some Linux distributions and Python installations, the locale of the executables can slightly change. If this does not work out, you can try differents paths such as `/usr/local/bin` and others.
+
+#### Windows
+
+For Windows users, you need to open the menu and search for *path*, click in *Edit the system environment variables*, at the bottom right click in *Environment Variables...*, in the tab *System variables* (attention: not the *User variables for Username*), look for the variable *Path* and click on *Edit*. Add a new line with one of the followings (check the python location first):
+
+```bash
+C:\Users\Windows\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\Scripts
+```
+
+Or:
+
+```bash
+C:\Users\USERNAME\AppData\Local\Programs\Python\Python311\Scripts
+```
+
+**Be aware of different Python versions, the path will change also. Always verify if the current path exists.**
+
+### Step-by-Step for Windows (Python + GCC)
+Obs: this step-by-step guide was made using a fresh new install of Windows 10.
+
+#### Python
+
+Go to [Python Windows Releases](https://www.python.org/downloads/windows/) and download an stable release by clicking on it and downloading the *Windows installer (64-bit) Recommended*. After downloading, exectue the files and follow the installation process.
+
+- Add the Python folder to the path.
+    - Open the menu and search for *path*, click in *Edit the system environment variables*, at the bottom right click in *Environment Variables...*, in the tab *System variables* (attention: not the *User variables for Username*), look for the variable *Path* and click on *Edit*. Add two new lines:
+        - `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311`
+        - `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311\Scripts`
+        - Change `USERNAME` with your username and `Python311` to the actual version that you installed.
+- Go to the python folder (ex: `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311`) and create a copy of the `python.exe` file in the same location with the name `python3.11.exe`
+
+#### GCC
+
+Download the *x64* version of [Winlibs](https://winlibs.com).
+    
+- Choose the x64 MCF **with** all the libraries;
+- After downloading, decompress the file and move the `mingw64` folder to `C:\Program Files\`;
+- Now add the folder `bin` of the `mingw64` folder to the path:
+        - Use the sames steps as before but now add the line: `C:\Program Files\mingw64\bin`.
+
+### Compilation
+
+There is one file written in C Language (`meafs/meafs_code/scripts/bisec_interpol.c`), the compilation directives can be found in the `meafs/meafs_code/scripts/comp.sh`. The C file needs to be compiled as a shared library, when using *GCC Compiler*, this can be achieved by adding the `-shared` flag.
+
+For Linux users just add execution privileges at the `comp.sh` file and execute it in a terminal to create the binary. For that, open a terminal in the `meafs/meafs_code/scripts/` folder and type:
+
+```bash
+chmod +x comp.sh
+./comp.sh
+```
+
+## Usage
+
+### With Installation
+You can create menu entries for MEAFS by typing in the terminal or cmd:  
+
+```bash
+meafs-desktop-create
+```
+
+Then, search in the menu for *MEAFS*, and in Windows, a Desktop link will also be created.  
+But, if you do not want to create menu entries, just type `meafs` or `python -m meafs` in the terminal or cmd to launch it.
+
+### Without Installation
+Simply execute the file `gui.py` and it will power the GUI.
+
+### Flags and Arguments
+
+There are some flags that can be passed with the command-line.
+
+- `-h` or `--help`: Show the help section;
+- `-v` or `--version`: Show version number;
+- `-l` or `--last`: Load the last closed session. Default location is `meafs_code/auto_save_last.pkl`
+- `-s` or `--load-auto-save`: Load the auto saved session. Default location is: `meafs_code/auto_save.pkl`
+
+Also, any saved section can be passed as an argument. It will power the GUI with it. If no argument is given, the GUI will power with a new empty session.
+
+### Auto Save
+In the *File* menu there is an *Auto Save* option. When checked, MEAFS will save the session every 5 seconds in a file named `auto_save.pkl`.  
+Also, if auto save is enabled, when MEAFS is closed, it will save the session in the `auto_save_last.pkl` file.  
+These files are located under the MEAFS directory and the `-h` [flag](<#flags-and-arguments>) will show the location.  
+To load any of these files, simply use the [flags](<#flags-and-arguments>) or load them in the *File* - *Open...* menu
+
+## Uninstall
+
+If you did not install with pip (both directly or by cloning), you can just erase the *meafs* folder.  
+
+Otherwise, first remove the menu entries (if you have added it) and then uninstall:
+
+```bash
+meafs-desktop-remove
+pip uninstall meafs
+```
+
+<hr/>

meafs-0.0.1/README.md

@@ -0,0 +1,205 @@
+![Meafs Logo](meafs_code/images/Meafs_Logo.png)
+
+# Multiple Element Abundance Fit Software - MEAFS
+
+*Written by: Matheus J. Castro*  
+*Under MIT License*  
+
+<hr/>
+<hr/>
+
+## Table of Contents
+
+1. [Aims](#Aims)
+2. [Prerequisites](#Prerequisites)
+3. [Instalation](#Instalation)
+    1. [Creating Anaconda Environment (recommended)](<#creating-anaconda-environment-recommended>)
+    2. [Getting the pip version (recommended)](<#getting-the-pip-version-recommended-not-yet-working>)
+    3. [Cloning from GitHub](<#cloning-from-github>)
+    4. [Adding the PATH (for non Anaconda installations)](<#adding-the-path-for-non-anaconda-installations>)
+    5. [Step-by-Step for Windows (Python + GCC)](<#step-by-step-for-windows-python--gcc>)
+    6. [Compilation](<#compilation>)
+4. [Usage](#Usage)
+    1. [With Installation](<#with-installation>)
+    2. [Without Installation](<#without-installation>)
+    3. [Flags and Arguments](<#flags-and-arguments>)
+    4. [Auto Save](<#auto-save>)
+5. [Uninstall](#Uninstall)
+
+## Aims
+
+The MEAFS is a fitting tool software for spectra abundance analysis. The aims is to provide a medium to high analysis for each individual absorption line in a given spectrum.  
+The software also fits the wavelength shift, continuum and convolution of the spectrum.
+
+![Meafs GUI](meafs_code/images/Meafs_Gui.png)
+
+## Prerequisites
+
+- Python3 and GCC needs to be previously installed in the system (step-by-step to install for Windows users [bellow](<#step-by-step-for-windows-python--gcc>));
+
+- A software for creating a synthetic spectrum also needs to be previously installed. This version of MEAFS is compatible with the following softwares:
+    - Turbospectrum2019: [https://github.com/bertrandplez/Turbospectrum2019](https://github.com/bertrandplez/Turbospectrum2019)
+
+- Optionally: to execute the `unify_plots.py`, a LaTeX installation must be present on the system.
+
+- Optionally: [Anaconda](<#creating-anaconda-environment-recommended>).
+
+## Instalation
+
+There are many options to run MEAFS. We strongly recommend the use of Anaconda environment, but it is not mandatory.  
+You can install it from pip or run directly the source code from the repository.  
+
+All the methods listed below work in Linux, Windows or MacOS **if you have python and gcc installed** (step-by-step to install for Windows users [bellow](<#step-by-step-for-windows-python--gcc>)).
+
+### Creating Anaconda Environment (recommended)
+- First, download anaconda [here](https://www.anaconda.com/products/individual#download-section) and execute the script.
+
+    - For Linux users, if needed, export anaconda to your path by adding the line `export PATH="/home/USERNAME/anaconda3/bin:$PATH"` (changing the `USERNAME` to your user) to the `~/.bashrc` file. Close and open a new terminal to update the path.
+
+    - If desirable, disable autoactivation of anaconda with `conda config --set auto_activate_base false`.
+
+- Create MEAFS enviroment with `conda create python -n meafs`;
+
+- Then, to activate the environment, type `conda activate meafs`;
+
+### Getting the pip version (recommended) (not yet working)
+
+<s>
+You can easily get the pip version by typing in the terminal:
+
+#```bash
+#pip install meafs
+#```
+
+</s>
+
+### Cloning from GitHub
+
+Or you can directly clone from the GitHub page with:
+
+```bash
+git clone https://github.com/MatheusJCastro/meafs.git
+```
+
+After cloning, you can install it with pip or run without any installation at all (see the [Usage](<#without-installation>)  section).  
+
+To build the package and install it with pip from the source, first install the `build` package:  
+
+```bash
+pip install build
+```
+
+Then go to the MEAFS source code directory and type:
+
+```bash
+python3 -m build
+pip install .
+```
+
+### Adding the PATH (for non Anaconda installations)
+If you do not use Anaconda, you need to add the path of the pip scripts into the system path variable if you have not already done so.  
+**This step is not necessary if you are running without installation.**
+
+#### Linux
+For Linux users, you can add the following line in the end of the file `~/.bashrc`, changing `USER` to your own user.
+
+```bash
+export PATH="${PATH}:/home/USER/.local/bin/"
+```
+
+For some Linux distributions and Python installations, the locale of the executables can slightly change. If this does not work out, you can try differents paths such as `/usr/local/bin` and others.
+
+#### Windows
+
+For Windows users, you need to open the menu and search for *path*, click in *Edit the system environment variables*, at the bottom right click in *Environment Variables...*, in the tab *System variables* (attention: not the *User variables for Username*), look for the variable *Path* and click on *Edit*. Add a new line with one of the followings (check the python location first):
+
+```bash
+C:\Users\Windows\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\Scripts
+```
+
+Or:
+
+```bash
+C:\Users\USERNAME\AppData\Local\Programs\Python\Python311\Scripts
+```
+
+**Be aware of different Python versions, the path will change also. Always verify if the current path exists.**
+
+### Step-by-Step for Windows (Python + GCC)
+Obs: this step-by-step guide was made using a fresh new install of Windows 10.
+
+#### Python
+
+Go to [Python Windows Releases](https://www.python.org/downloads/windows/) and download an stable release by clicking on it and downloading the *Windows installer (64-bit) Recommended*. After downloading, exectue the files and follow the installation process.
+
+- Add the Python folder to the path.
+    - Open the menu and search for *path*, click in *Edit the system environment variables*, at the bottom right click in *Environment Variables...*, in the tab *System variables* (attention: not the *User variables for Username*), look for the variable *Path* and click on *Edit*. Add two new lines:
+        - `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311`
+        - `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311\Scripts`
+        - Change `USERNAME` with your username and `Python311` to the actual version that you installed.
+- Go to the python folder (ex: `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311`) and create a copy of the `python.exe` file in the same location with the name `python3.11.exe`
+
+#### GCC
+
+Download the *x64* version of [Winlibs](https://winlibs.com).
+    
+- Choose the x64 MCF **with** all the libraries;
+- After downloading, decompress the file and move the `mingw64` folder to `C:\Program Files\`;
+- Now add the folder `bin` of the `mingw64` folder to the path:
+        - Use the sames steps as before but now add the line: `C:\Program Files\mingw64\bin`.
+
+### Compilation
+
+There is one file written in C Language (`meafs/meafs_code/scripts/bisec_interpol.c`), the compilation directives can be found in the `meafs/meafs_code/scripts/comp.sh`. The C file needs to be compiled as a shared library, when using *GCC Compiler*, this can be achieved by adding the `-shared` flag.
+
+For Linux users just add execution privileges at the `comp.sh` file and execute it in a terminal to create the binary. For that, open a terminal in the `meafs/meafs_code/scripts/` folder and type:
+
+```bash
+chmod +x comp.sh
+./comp.sh
+```
+
+## Usage
+
+### With Installation
+You can create menu entries for MEAFS by typing in the terminal or cmd:  
+
+```bash
+meafs-desktop-create
+```
+
+Then, search in the menu for *MEAFS*, and in Windows, a Desktop link will also be created.  
+But, if you do not want to create menu entries, just type `meafs` or `python -m meafs` in the terminal or cmd to launch it.
+
+### Without Installation
+Simply execute the file `gui.py` and it will power the GUI.
+
+### Flags and Arguments
+
+There are some flags that can be passed with the command-line.
+
+- `-h` or `--help`: Show the help section;
+- `-v` or `--version`: Show version number;
+- `-l` or `--last`: Load the last closed session. Default location is `meafs_code/auto_save_last.pkl`
+- `-s` or `--load-auto-save`: Load the auto saved session. Default location is: `meafs_code/auto_save.pkl`
+
+Also, any saved section can be passed as an argument. It will power the GUI with it. If no argument is given, the GUI will power with a new empty session.
+
+### Auto Save
+In the *File* menu there is an *Auto Save* option. When checked, MEAFS will save the session every 5 seconds in a file named `auto_save.pkl`.  
+Also, if auto save is enabled, when MEAFS is closed, it will save the session in the `auto_save_last.pkl` file.  
+These files are located under the MEAFS directory and the `-h` [flag](<#flags-and-arguments>) will show the location.  
+To load any of these files, simply use the [flags](<#flags-and-arguments>) or load them in the *File* - *Open...* menu
+
+## Uninstall
+
+If you did not install with pip (both directly or by cloning), you can just erase the *meafs* folder.  
+
+Otherwise, first remove the menu entries (if you have added it) and then uninstall:
+
+```bash
+meafs-desktop-remove
+pip uninstall meafs
+```
+
+<hr/>

meafs-0.0.1/meafs.egg-info/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.1
+Name: meafs
+Version: 0.0.1
+Summary: Multiple Element Abundance Fit Software
+Author: Matheus J. Castro
+Project-URL: Homepage, https://github.com/MatheusJCastro/meafs
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: astropy
+Requires-Dist: specutils
+Requires-Dist: scipy
+Requires-Dist: matplotlib
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: desktop_file
+Requires-Dist: pathlib
+Requires-Dist: PyQt6
+Requires-Dist: dill
+
+![Meafs Logo](meafs_code/images/Meafs_Logo.png)
+
+# Multiple Element Abundance Fit Software - MEAFS
+
+*Written by: Matheus J. Castro*  
+*Under MIT License*  
+
+<hr/>
+<hr/>
+
+## Table of Contents
+
+1. [Aims](#Aims)
+2. [Prerequisites](#Prerequisites)
+3. [Instalation](#Instalation)
+    1. [Creating Anaconda Environment (recommended)](<#creating-anaconda-environment-recommended>)
+    2. [Getting the pip version (recommended)](<#getting-the-pip-version-recommended-not-yet-working>)
+    3. [Cloning from GitHub](<#cloning-from-github>)
+    4. [Adding the PATH (for non Anaconda installations)](<#adding-the-path-for-non-anaconda-installations>)
+    5. [Step-by-Step for Windows (Python + GCC)](<#step-by-step-for-windows-python--gcc>)
+    6. [Compilation](<#compilation>)
+4. [Usage](#Usage)
+    1. [With Installation](<#with-installation>)
+    2. [Without Installation](<#without-installation>)
+    3. [Flags and Arguments](<#flags-and-arguments>)
+    4. [Auto Save](<#auto-save>)
+5. [Uninstall](#Uninstall)
+
+## Aims
+
+The MEAFS is a fitting tool software for spectra abundance analysis. The aims is to provide a medium to high analysis for each individual absorption line in a given spectrum.  
+The software also fits the wavelength shift, continuum and convolution of the spectrum.
+
+![Meafs GUI](meafs_code/images/Meafs_Gui.png)
+
+## Prerequisites
+
+- Python3 and GCC needs to be previously installed in the system (step-by-step to install for Windows users [bellow](<#step-by-step-for-windows-python--gcc>));
+
+- A software for creating a synthetic spectrum also needs to be previously installed. This version of MEAFS is compatible with the following softwares:
+    - Turbospectrum2019: [https://github.com/bertrandplez/Turbospectrum2019](https://github.com/bertrandplez/Turbospectrum2019)
+
+- Optionally: to execute the `unify_plots.py`, a LaTeX installation must be present on the system.
+
+- Optionally: [Anaconda](<#creating-anaconda-environment-recommended>).
+
+## Instalation
+
+There are many options to run MEAFS. We strongly recommend the use of Anaconda environment, but it is not mandatory.  
+You can install it from pip or run directly the source code from the repository.  
+
+All the methods listed below work in Linux, Windows or MacOS **if you have python and gcc installed** (step-by-step to install for Windows users [bellow](<#step-by-step-for-windows-python--gcc>)).
+
+### Creating Anaconda Environment (recommended)
+- First, download anaconda [here](https://www.anaconda.com/products/individual#download-section) and execute the script.
+
+    - For Linux users, if needed, export anaconda to your path by adding the line `export PATH="/home/USERNAME/anaconda3/bin:$PATH"` (changing the `USERNAME` to your user) to the `~/.bashrc` file. Close and open a new terminal to update the path.
+
+    - If desirable, disable autoactivation of anaconda with `conda config --set auto_activate_base false`.
+
+- Create MEAFS enviroment with `conda create python -n meafs`;
+
+- Then, to activate the environment, type `conda activate meafs`;
+
+### Getting the pip version (recommended) (not yet working)
+
+<s>
+You can easily get the pip version by typing in the terminal:
+
+#```bash
+#pip install meafs
+#```
+
+</s>
+
+### Cloning from GitHub
+
+Or you can directly clone from the GitHub page with:
+
+```bash
+git clone https://github.com/MatheusJCastro/meafs.git
+```
+
+After cloning, you can install it with pip or run without any installation at all (see the [Usage](<#without-installation>)  section).  
+
+To build the package and install it with pip from the source, first install the `build` package:  
+
+```bash
+pip install build
+```
+
+Then go to the MEAFS source code directory and type:
+
+```bash
+python3 -m build
+pip install .
+```
+
+### Adding the PATH (for non Anaconda installations)
+If you do not use Anaconda, you need to add the path of the pip scripts into the system path variable if you have not already done so.  
+**This step is not necessary if you are running without installation.**
+
+#### Linux
+For Linux users, you can add the following line in the end of the file `~/.bashrc`, changing `USER` to your own user.
+
+```bash
+export PATH="${PATH}:/home/USER/.local/bin/"
+```
+
+For some Linux distributions and Python installations, the locale of the executables can slightly change. If this does not work out, you can try differents paths such as `/usr/local/bin` and others.
+
+#### Windows
+
+For Windows users, you need to open the menu and search for *path*, click in *Edit the system environment variables*, at the bottom right click in *Environment Variables...*, in the tab *System variables* (attention: not the *User variables for Username*), look for the variable *Path* and click on *Edit*. Add a new line with one of the followings (check the python location first):
+
+```bash
+C:\Users\Windows\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\Scripts
+```
+
+Or:
+
+```bash
+C:\Users\USERNAME\AppData\Local\Programs\Python\Python311\Scripts
+```
+
+**Be aware of different Python versions, the path will change also. Always verify if the current path exists.**
+
+### Step-by-Step for Windows (Python + GCC)
+Obs: this step-by-step guide was made using a fresh new install of Windows 10.
+
+#### Python
+
+Go to [Python Windows Releases](https://www.python.org/downloads/windows/) and download an stable release by clicking on it and downloading the *Windows installer (64-bit) Recommended*. After downloading, exectue the files and follow the installation process.
+
+- Add the Python folder to the path.
+    - Open the menu and search for *path*, click in *Edit the system environment variables*, at the bottom right click in *Environment Variables...*, in the tab *System variables* (attention: not the *User variables for Username*), look for the variable *Path* and click on *Edit*. Add two new lines:
+        - `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311`
+        - `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311\Scripts`
+        - Change `USERNAME` with your username and `Python311` to the actual version that you installed.
+- Go to the python folder (ex: `C:\Users\USERNAME\AppData\Local\Programs\Python\Python311`) and create a copy of the `python.exe` file in the same location with the name `python3.11.exe`
+
+#### GCC
+
+Download the *x64* version of [Winlibs](https://winlibs.com).
+    
+- Choose the x64 MCF **with** all the libraries;
+- After downloading, decompress the file and move the `mingw64` folder to `C:\Program Files\`;
+- Now add the folder `bin` of the `mingw64` folder to the path:
+        - Use the sames steps as before but now add the line: `C:\Program Files\mingw64\bin`.
+
+### Compilation
+
+There is one file written in C Language (`meafs/meafs_code/scripts/bisec_interpol.c`), the compilation directives can be found in the `meafs/meafs_code/scripts/comp.sh`. The C file needs to be compiled as a shared library, when using *GCC Compiler*, this can be achieved by adding the `-shared` flag.
+
+For Linux users just add execution privileges at the `comp.sh` file and execute it in a terminal to create the binary. For that, open a terminal in the `meafs/meafs_code/scripts/` folder and type:
+
+```bash
+chmod +x comp.sh
+./comp.sh
+```
+
+## Usage
+
+### With Installation
+You can create menu entries for MEAFS by typing in the terminal or cmd:  
+
+```bash
+meafs-desktop-create
+```
+
+Then, search in the menu for *MEAFS*, and in Windows, a Desktop link will also be created.  
+But, if you do not want to create menu entries, just type `meafs` or `python -m meafs` in the terminal or cmd to launch it.
+
+### Without Installation
+Simply execute the file `gui.py` and it will power the GUI.
+
+### Flags and Arguments
+
+There are some flags that can be passed with the command-line.
+
+- `-h` or `--help`: Show the help section;
+- `-v` or `--version`: Show version number;
+- `-l` or `--last`: Load the last closed session. Default location is `meafs_code/auto_save_last.pkl`
+- `-s` or `--load-auto-save`: Load the auto saved session. Default location is: `meafs_code/auto_save.pkl`
+
+Also, any saved section can be passed as an argument. It will power the GUI with it. If no argument is given, the GUI will power with a new empty session.
+
+### Auto Save
+In the *File* menu there is an *Auto Save* option. When checked, MEAFS will save the session every 5 seconds in a file named `auto_save.pkl`.  
+Also, if auto save is enabled, when MEAFS is closed, it will save the session in the `auto_save_last.pkl` file.  
+These files are located under the MEAFS directory and the `-h` [flag](<#flags-and-arguments>) will show the location.  
+To load any of these files, simply use the [flags](<#flags-and-arguments>) or load them in the *File* - *Open...* menu
+
+## Uninstall
+
+If you did not install with pip (both directly or by cloning), you can just erase the *meafs* folder.  
+
+Otherwise, first remove the menu entries (if you have added it) and then uninstall:
+
+```bash
+meafs-desktop-remove
+pip uninstall meafs
+```
+
+<hr/>

meafs-0.0.1/meafs.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE.txt
+README.md
+pyproject.toml
+meafs.egg-info/PKG-INFO
+meafs.egg-info/SOURCES.txt
+meafs.egg-info/dependency_links.txt
+meafs.egg-info/entry_points.txt
+meafs.egg-info/requires.txt
+meafs.egg-info/top_level.txt

meafs-0.0.1/meafs.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

meafs-0.0.1/meafs.egg-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+meafs = meafs_code.gui:main
+meafs-desktop-create = meafs_code.desktop_entry:create
+meafs-desktop-remove = meafs_code.desktop_entry:remove

meafs-0.0.1/meafs.egg-info/requires.txt

@@ -0,0 +1,10 @@
+astropy
+specutils
+scipy
+matplotlib
+pandas
+numpy
+desktop_file
+pathlib
+PyQt6
+dill

meafs-0.0.1/meafs.egg-info/top_level.txt

@@ -0,0 +1 @@
+

meafs-0.0.1/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "meafs"
+version = "0.0.1"
+authors = [
+    { name="Matheus J. Castro" }
+]
+description="Multiple Element Abundance Fit Software"
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers=[
+ "Programming Language :: Python :: 3",
+ "License :: OSI Approved :: MIT License",
+ "Operating System :: OS Independent",
+]
+license = {file = "LICENSE"}
+dependencies = [
+    "astropy",
+    "specutils",
+    "scipy",
+    "matplotlib",
+    "pandas",
+    "numpy",
+    "desktop_file",
+    "pathlib",
+    "PyQt6",
+    "dill"
+]
+
+[project.scripts]
+meafs = "meafs_code.gui:main"
+meafs-desktop-create = "meafs_code.desktop_entry:create"
+meafs-desktop-remove = "meafs_code.desktop_entry:remove"
+
+[project.urls]
+"Homepage" = "https://github.com/MatheusJCastro/meafs"
+

meafs-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+