Metadata-Version: 2.1
Name: pyvlasiator
Version: 0.1.4
Summary: Python utilities for processing Vlasiator data
Author: Hongyang Zhou
Author-email: hyzhou@umich.edu
Requires-Python: >=3.11,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: plot
Requires-Dist: matplotlib (>=3.7.2,<4.0.0) ; extra == "plot"
Requires-Dist: numpy (>=1.25.1,<2.0.0)
Description-Content-Type: text/markdown

# pyvlasiator

<p align="center">
  <a href="https://badge.fury.io/py/pyvlasiator">
    <img src="https://badge.fury.io/py/pyvlasiator.svg" alt="PyPI version" height="18">
  </a>
  <a href="https://github.com/henry2004y/pyvlasiator/actions">
    <img src="https://github.com/henry2004y/pyvlasiator/actions/workflows/CI.yml/badge.svg">
  </a>
  <a href="https://henry2004y.github.io/pyvlasiator/">
    <img src="https://img.shields.io/badge/docs-dev-blue">
  </a>
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue">
  </a>
  <a href="https://app.codecov.io/gh/henry2004y/pyvlasiator/">
    <img src="https://img.shields.io/codecov/c/github/henry2004y/pyvlasiator">
  </a>
</p>

Lightweight Python package for processing Vlasiator data.

## Installation

`pyvlasiator` can be installed via

```bash
python -m pip install pyvlasiator
```

## Usage

`pyvlasiator` can be used to process VLSV files generated from Vlasiator.

```python
from pyvlasiator.vlsv import Vlsv

file = "test.vlsv"
meta = Vlsv(file)
```

Plotting is supported via Matplotlib. For more detailed usage, please refer to the [documentation](https://henry2004y.github.io/pyvlasiator/).

## License

`pyvlasiator` was created by Hongyang Zhou. It is licensed under the terms of the MIT license.

