Skip to main content

Stretched Equal Area Generator

Project description

SEAGen
======

A python implementation of the stretched equal area (SEA) algorithm for
generating spherically symmetric arrangements of particles with accurate
particle densities, e.g. for SPH initial conditions that precisely match an
arbitrary density profile, as presented in Kegerreis et al. (2019).

Jacob Kegerreis (2019) jacob.kegerreis@durham.ac.uk
Josh Borrow

Visit https://github.com/jkeger/seagen to download the code including examples
and for support.

This program has been tested for a wide range of cases but not exhaustively. If
you find any bugs, potential improvements, or features worth adding, then please
do let us know at jacob.kegerreis@durham.ac.uk!


Contents
--------
+ `seagen.py` The main program classes and functions.
+ `examples.py` Examples to demonstrate how to use the SEAGen module.
+ `setup.py`, `setup.cfg`, `__init__.py`, `MANIFEST.in` Python package files.
+ `LICENSE.txt` GNU general public license v3+.


Basic Usage
-----------
+ See the doc strings in `seagen.py` for all the details.
+ Create a single shell of particles and print their positions:
```python
import seagen
N = 100
r = 1

particles = seagen.GenShell(N, r)

print(particles.x, particles.y, particles.z)
```
+ Create a full sphere of particles on a simple density profile and print their
positions and masses:
```python
import seagen
import numpy as np
N = 100000
radii = np.arange(0.01, 10, 0.01)
densities = np.ones(len(radii)) # e.g. constant density

particles = seagen.GenSphere(N, radii, densities)

print(particles.x, particles.y, particles.z, particles.m)
```
+ See `examples.py` for other working examples, e.g. an arbitrary density
profile with multiple layers and extra temperature information.


Installation
------------
+ `PyPI`: Automatically install the package with `pip install seagen`, see
https://pypi.org/project/seagen/
+ Direct download: The single `seagen.py` file can be imported and used without
any extra installation, so you can just download this repository and place
the file in a local directory or wherever your python will look for modules.


Requirements
------------
+ Python 3 (tested with 3.6.0).


Notation etc.
-------------
+ PEP8 is followed in most cases apart from some indentation alignment.
+ Arrays are explicitly labelled with a prefix `A1_`, or `An_` for an
`n`-dimensional array.
+ Particle is abbreviated to `picle`.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for seagen, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size seagen-1.2.0-py3-none-any.whl (28.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size seagen-1.2.0.tar.gz (27.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page