Metadata-Version: 2.4
Name: surfsci
Version: 0.2.0
Summary: A suite of tools for handling surface science related x-ray data
Project-URL: Documentation, https://gitlab.com/ddkn/surfsci#readme
Project-URL: Issues, https://gitlab.com/ddkn/surfsci/issues
Project-URL: Source, https://gitlab.com/ddkn/surfsci
Author-email: David Kalliecharan <david@david.science>
License-Expression: BSD-2-Clause
License-File: LICENSE.txt
Keywords: Surface Science
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.8
Requires-Dist: xps
Description-Content-Type: text/markdown

# surfsci

`surfsci` is a set of scripts for handling and maniplulating surface science x-ray data.

[![PyPI - Version](https://img.shields.io/pypi/v/surfsci.svg)](https://pypi.org/project/surfsci)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/surfsci.svg)](https://pypi.org/project/surfsci)

-----

## Table of Contents

- [Installation](#installation)
- [X-ray](#x-ray)
- [License](#license)

## Installation

```console
pip install surfsci
```

## X-ray Photoelectron Spectroscopy

This is just a convenience wrapper around [xps](https://pypi.org/project/xps/)

```python
from surfsci import xps
```

## X-ray

### X-ray Diffratometer 500 / 5000

Conversion script for _asc_ to _xy_ format. Handy if you want easily parsable data or want to use [fityk](https://fityk.nieto.pl/).

```sh
surfsci-xy-conv my_xrd_data.asc
```

This will generate _my_xrd_data.xy_

### MAX3D G-Pol 2D X-ray data

Plot and x-y data for the _*.gpol_ files produced by the [MAX3D detector at McMaster](https://max3d.mcmaster.ca/doc/index.html). Usage,

```sh
surfsci-gpol my_data_file.gpol
```

## License

`surfsci` is distributed under the terms of the [BSD-2-Clause](https://spdx.org/licenses/BSD-2-Clause.html) license.
