Metadata-Version: 2.1
Name: APAV
Version: 1.2.0
Summary: A Python library for Atom Probe Tomography analysis
Home-page: https://gitlab.com/jesseds/apav
Author: Jesse Smith
Author-email: jesseds@protonmail.com
License: UNKNOWN
Keywords: atom probe,tomography,field evaporation,leap,apt,materials,science
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: numpy (>=1.17)
Requires-Dist: pyqtgraph (>=0.11.0)
Requires-Dist: numba
Requires-Dist: lmfit (>=1.0)
Requires-Dist: fast-histogram
Requires-Dist: tabulate
Requires-Dist: PyQt5 (>=5.11)
Requires-Dist: periodictable
Requires-Dist: pytest (>=5)
Requires-Dist: pytest-qt (>=3)

# APAV: Python analysis for atom probe tomography
[![Documentation Status](https://readthedocs.org/projects/apav/badge/?version=latest)](https://apav.readthedocs.io/en/latest/?badge=latest)
[![coverage report](https://gitlab.com/jesseds/apav/badges/master/coverage.svg)](https://gitlab.com/jesseds/apav/commits/master)
[![pipeline status](https://gitlab.com/jesseds/apav/badges/master/pipeline.svg)](https://gitlab.com/jesseds/apav/-/commits/master)

APAV (Atom Probe Analysis and Visualization) is a Python library for the analysis and
visualization of atom probe tomography experiments.

* Multiple event dependent mass or time-of-flight spectra
* Correlation histograms
* Molecular isotopic calculations
* .pos, .epos, .ato files or synthetic data
* Mass spectrum quantification with multiple fitting schemes
* Interactive visualizations

APAV can perform a number of analyses common in field evaporation science, although it focuses
on analyses relating to detector multiple events. A "Multiple event" refers to a phenomenon where
multiple ions (elemental or molecular) strike the micro-channel plates between pulses.

APAV is open source (GPLv2_ or greater) and runs on Windows, Linux, Mac OS - or anything able to run a python
interpreter. It is written in Python 3 using NumPy to accelerate mathematical computations, and other math tools
for more niche calculations. Visualizations leverage pyqtgraph and other custom Qt widgets.

# Support
Post issues and questions to the [GitLab issue tracker](https://gitlab.com/jesseds/apav/-/issues)

# Documentation
Documentation is found at: https://apav.readthedocs.io/

# FAQ
**Why use this over IVAS or program X?**

APAV was never intended to be used as an IVAS substitute or replacement. While much of the 
functionality may be similar/redundant, APAV fills feature gaps in IVAS found lacking (or simply non-existent).
Specifically:
1. Multiple-event analysis (correlation histograms, multiple event histograms, multiple event mass quantifications.
2. Full control over mass spectrum analysis (background models, fitting, binning).
3. Provide an interface for developing custom analyses through common ePOS, POS, ATO, RNG, RRNG files.

**Why is there no GUI for APAV?**

As APAV is a python *library*, there is no plan for a graphical user interface for APAV. It does, however, include
custom interactive visualization tools using pyqtgraph and custom Qt widgets (for various graphing).




