| Name | mwahpy JSON |
| Version |
2.0.0
JSON |
| download |
| home_page | https://github.com/thomasdonlon/mwahpy |
| Summary | A python package for easily parsing and processing data from MilkyWay@home |
| upload_time | 2023-09-25 16:54:08 |
| maintainer | |
| docs_url | None |
| author | Tom Donlon |
| requires_python | >=3.6.0 |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
MILKYWAY@HOME PYTHON PACKAGE (MWAHPY)
========================================
Copyright Tom Donlon, 2020 RPI
github user: thomasdonlon
Requires Python v.>3.6.0
-----------------------------------------
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 avoid having to constantly reinvent the wheel.
The purpose of the mwahpy package is to provide a collection of useful tools for people working with/on the MilkyWay@home N-body project at RPI.
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 2023 (while I'm in grad 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 wide variety of useful scripts and routines for working with N-body simulations, especially those with dwarf galaxies
- 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
2. Insert import statements for the subpackages that you want to use in your .py files:
> import mwahpy.{mwahpy subpackage}
> import mwahpy.{other mwahpy subpackage}
> ...
3. 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)
4. 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}
> ...
5. Once you are done making changes to the source code, put in a pull request to master
6. 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
- add animate() for the Nbody struct for nice animations
- update documentation so it is current (probably last thing I'll do during summer 2023)
MINOR:
- Inverse (cut out within range) subset_circ() & subset_rect() options
- Let subset_circ() and subset_rect() handle None as bounds
- 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
- Add levels of verbosity, and make this changeable by running a command
ISSUES
========================================
- output_handler.make_nbody_input() has to set all particles types to dark matter. This is because MilkyWay@home N-Body can only read .in files that only contain dark matter (#ignore = 1) files. This is more of a bug in the N-Body client than mwahpy, but doesn't change the physics at all.
Raw data
{
"_id": null,
"home_page": "https://github.com/thomasdonlon/mwahpy",
"name": "mwahpy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6.0",
"maintainer_email": "",
"keywords": "",
"author": "Tom Donlon",
"author_email": "donlot@rpi.edu",
"download_url": "https://files.pythonhosted.org/packages/76/78/2577529a89daaf2ca18672f75cea59187d0a477405a1c7d4479aaf9d286c/mwahpy-2.0.0.tar.gz",
"platform": null,
"description": " MILKYWAY@HOME PYTHON PACKAGE (MWAHPY)\n========================================\n\nCopyright Tom Donlon, 2020 RPI\n\ngithub user: thomasdonlon\n\nRequires Python v.>3.6.0\n\n-----------------------------------------\n\nMilkyWay@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 avoid having to constantly reinvent the wheel.\n\nThe purpose of the mwahpy package is to provide a collection of useful tools for people working with/on the MilkyWay@home N-body project at RPI.\n\nIn 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 2023 (while I'm in grad school).\n\nIssues 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.\n\nCONTENTS\n========================================\n\nA non-exhaustive list of contents of the package is given below:\n\n - easy importing of data from N-body output\n - easy manipulation of data after reading in\n - A variety of coordinate transformations for typical coordinate systems used in Galactic astronomy\n - easy visualization of the imported data through plotting functionality\n - a wide variety of useful scripts and routines for working with N-body simulations, especially those with dwarf galaxies\n - a tutorial .pdf document along with documentation for each function in the package\n\nINSTALLATION\n========================================\n\nFOR USERS:\n\n1. Open your terminal, and run\n\n> python3 -m pip install mwahpy\n\n2. Insert import statements for the subpackages that you want to use in your .py files:\n\n> import mwahpy.{mwahpy subpackage}\n\n> import mwahpy.{other mwahpy subpackage}\n\n> ...\n\n3. Do science\n\nFOR DEVELOPERS:\n\n1. Clone the mwahpy github repository\n\n2. Make the desired changes in the source code\n\n3. Navigate to the directory where you cloned the repo, and then run\n\n> python3 setup.py develop --user\n\n(note, you will probably need to uninstall any previous versions of mwahpy you had on your machine before running this)\n\n4. To test your changes, insert import statements for the subpackages that you want to use in your .py files as you normally would:\n\n> import mwahpy.{mwahpy subpackage}\n\n> import mwahpy.{other mwahpy subpackage}\n\n> ...\n\n5. Once you are done making changes to the source code, put in a pull request to master\n\n6. Navigate to the directory where you cloned the repo, and then run\n\n> python3 setup.py develop --uninstall\n\n> pip3 install mwahpy\n\nYour changes will not be available in the main mwahpy build until a new release comes out.\n\nTODO\n========================================\n\nMAJOR:\n - Expand plot capabilities\n - Finish refactoring coords.py\n - Finish unit testing of coordinate transformations\n - add animate() for the Nbody struct for nice animations\n - update documentation so it is current (probably last thing I'll do during summer 2023)\n\nMINOR:\n- Inverse (cut out within range) subset_circ() & subset_rect() options\n- Let subset_circ() and subset_rect() handle None as bounds\n- Implement better linear algebra to reduce the computation time of coords.get_rvpm()\n- Play around with turning off mwahpy_glob.verbose flag for some things to quiet unnecessary output\n- Add levels of verbosity, and make this changeable by running a command\n\nISSUES\n========================================\n\n- output_handler.make_nbody_input() has to set all particles types to dark matter. This is because MilkyWay@home N-Body can only read .in files that only contain dark matter (#ignore = 1) files. This is more of a bug in the N-Body client than mwahpy, but doesn't change the physics at all. \n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "A python package for easily parsing and processing data from MilkyWay@home",
"version": "2.0.0",
"project_urls": {
"Homepage": "https://github.com/thomasdonlon/mwahpy"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5dcde9a2f09d9e3abd4b5446d307793278e52b99656eca109c9c1060a2747272",
"md5": "f13cc5bbb45eb19b027396bba2dbbddc",
"sha256": "2bc4f261b137fdb311b5b742e4d9d283f3f46aa52180bf12e61cf26fe1f6e69c"
},
"downloads": -1,
"filename": "mwahpy-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f13cc5bbb45eb19b027396bba2dbbddc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6.0",
"size": 150226,
"upload_time": "2023-09-25T16:54:06",
"upload_time_iso_8601": "2023-09-25T16:54:06.029552Z",
"url": "https://files.pythonhosted.org/packages/5d/cd/e9a2f09d9e3abd4b5446d307793278e52b99656eca109c9c1060a2747272/mwahpy-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "76782577529a89daaf2ca18672f75cea59187d0a477405a1c7d4479aaf9d286c",
"md5": "d15d0cace2178c9ce1544cdcca46e6ca",
"sha256": "ffdda6dc1186024cf810cb1c6db45e490a0a25c27fcb2b22463c6decd789f43a"
},
"downloads": -1,
"filename": "mwahpy-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "d15d0cace2178c9ce1544cdcca46e6ca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6.0",
"size": 1007792,
"upload_time": "2023-09-25T16:54:08",
"upload_time_iso_8601": "2023-09-25T16:54:08.714389Z",
"url": "https://files.pythonhosted.org/packages/76/78/2577529a89daaf2ca18672f75cea59187d0a477405a1c7d4479aaf9d286c/mwahpy-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-25 16:54:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "thomasdonlon",
"github_project": "mwahpy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mwahpy"
}
