Metadata-Version: 2.4
Name: pandem
Version: 0.3
Summary: A python package for converting between DEM code output formats
Project-URL: Documentation, https://github.com/scigem/pandem/docs/index.html
Project-URL: Repository, https://github.com/scigem/pandem.git
Author-email: Benjy Marks <benjy.marks@sydney.edu.au>, François Guillard <francois.guillard@sydney.edu.au>
License-File: LICENSE.txt
Keywords: DEM,discrete element method,granular materials
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Requires-Python: >=3.8
Requires-Dist: black
Requires-Dist: flake8
Requires-Dist: nbsphinx
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: sphinx
Description-Content-Type: text/markdown

# PanDEM
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[Documentation here](https://scigem.github.io/pandem/), or compile it yourself following the details below.

## Installation
This package can then be installed via `pip install pandem`. If installing from github, try cloning and then running:
```
pip install -e .
```
If you make any changes to the source code, re-run those two lines to have your changes reflected in your installed package.

## Usage

If you are interested in converting a dataset from one DEM file format to antoher, you can use the installed script `pandem`, like so:

```
pandem <path_to_source_file> <path_to_output_file>
```

We support the following file formats:
 <!-- - `.bz2` ([YADE](https://yade-dem.org/doc/introduction.html#saving-and-loading)) -->
 - `.data` ([MercuryDPM](https://mercurydpm.org/))
 <!-- - `.vtk` ([LIGGGHTS](https://www.cfdem.com/media/DEM/docu/liggghts.html)) -->
 - `.csv` ([NDDEM])(https://github.com/franzzzzzzzz/NDDEM/)

## Documentation

We use `sphinx` to manage the docs. Update documentation with:
```
cd docs
make html
```
Once these are built, you can commit and push the changes to github to have them refreshed on github pages. You can also view them locally.