Skip to main content

A python package for easily parsing and processing data from MilkyWay@home

Project description

MILKYWAY@HOME PYTHON PACKAGE (MWAHPY)

Copyright Tom Donlon, 2020 RPI

github user: thomasdonlon

Requires Python v.>3.2.3


MilkyWay@home is a computational astrophysics project located at RPI and run by Dr. Heidi Newberg. The project contains two main components, (i) the Separation Application and (ii) the N-body Application. I have worked with both, and over a few years have developed several useful bits of python code to supplement analysis and usage of MilkyWay@home. This code has been cleaned and organized here, so that others can benefit from the work I did and not have to spend time rewriting thing's I've already done.

The purpose of the mwahpy package is to provide a collection of useful tools for people working with/on the MilkyWay@home project at RPI. Ideally, the package will contain tools for both Separation and N-body, although that might not initially be the case.

In practice it would be good for this package to be updated along with the MilkyWay@home project and/or python updates after I'm gone. No clue if that's going to happen, but I plan on maintaining support at least through the spring of 2022 (while I'm in graduate school).

Issues with the package can be directed to my github profile or on the MilkyWay@home forums at milkyway.cs.rpi.edu. Improvements or additions are welcome, just send a pull request to the mwahpy github repository.

CONTENTS

A non-exhaustive list of contents of the package is given below:

  • easy importing of data from N-body output
  • easy manipulation of data after reading in
  • A variety of coordinate transformations for typical coordinate systems used in Galactic astronomy
  • easy visualization of the imported data through plotting functionality
  • a tutorial .pdf document along with documentation for each function in the package

INSTALLATION

FOR USERS:

  1. Open your terminal, and run

python3 -m pip install mwahpy

  1. Insert import statements for the subpackages that you want to use in your .py files:

import mwahpy.{mwahpy subpackage}

import mwahpy.{other mwahpy subpackage}

...

  1. Do science

FOR DEVELOPERS:

  1. Clone the mwahpy github repository

  2. Make the desired changes in the source code

  3. Navigate to the directory where you cloned the repo, and then run

python3 setup.py develop --user

(note, you will probably need to uninstall any previous versions of mwahpy you had on your machine before running this)

  1. To test your changes, insert import statements for the subpackages that you want to use in your .py files as you normally would:

import mwahpy.{mwahpy subpackage}

import mwahpy.{other mwahpy subpackage}

...

Any time you make a change to the source code, you'll have to repeat step 3

  1. Once you are done making changes to the source code, put in a pull request to master

  2. Navigate to the directory where you cloned the repo, and then run

python3 setup.py develop --uninstall

pip3 install mwahpy

Your changes will not be available in the main mwahpy build until a new release comes out.

TODO

MAJOR:

  • Expand plot capabilities
  • Finish refactoring coords.py
  • Finish unit testing of coordinate transformations
  • Refactor and polish orbit_fitting_gc.py

MINOR:

  • Apparently there's a MW@h readout method with a different number of values or different values than normally used? Should probably support that.
  • Inverse (cut out within range) subset_circ() & subset_rect() options
  • Implement better linear algebra to reduce the computation time of coords.get_rvpm()
  • Play around with turning off mwahpy_glob.verbose flag for some things to quiet unnecessary output

BUGS

No known bugs.

Project details


Download files

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

Source Distribution

mwahpy-1.3.4.tar.gz (864.9 kB view details)

Uploaded Source

Built Distribution

mwahpy-1.3.4-py3-none-any.whl (114.5 kB view details)

Uploaded Python 3

File details

Details for the file mwahpy-1.3.4.tar.gz.

File metadata

  • Download URL: mwahpy-1.3.4.tar.gz
  • Upload date:
  • Size: 864.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/51.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.6.9

File hashes

Hashes for mwahpy-1.3.4.tar.gz
Algorithm Hash digest
SHA256 36bf7ea51b901c6770cac9fd832e55dc39ee38ee8d0098e966934fb5b8f566e6
MD5 163a82810db0686b4b96e41b6bedca50
BLAKE2b-256 7e7b28d57b5148a8c56997d39cf1c593606fd474764e3c04cfdd8d34b81740cd

See more details on using hashes here.

File details

Details for the file mwahpy-1.3.4-py3-none-any.whl.

File metadata

  • Download URL: mwahpy-1.3.4-py3-none-any.whl
  • Upload date:
  • Size: 114.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/51.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.6.9

File hashes

Hashes for mwahpy-1.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 5aea38f46b273b0389883f76bf0bfd1c3afc1306dc21e83d3cff736c93f11ec5
MD5 2860af5dd3979d5dd53c49b87d3082ff
BLAKE2b-256 4714b8016e231c733e320f67e2370a580412ad7d81c7f41c1c5324f6381e1d62

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page