# README
PyMGal is a package that uses simple stellar synthesis models to generate mock observations of galaxies from hydrodynamical simulations. If you want a more detailed explanation of PyMGal than can be provided in a short readme file, see the documentation at [https://pymgal.readthedocs.io](https://pymgal.readthedocs.io).
If you're viewing this from the Github page, you may wish to view PyMGal's official page at the [Python Package Index (PyPI)](https://pypi.org/project/pymgal/).
If you're viewing this from the PyPI page, you may want to see the full [Github repository](https://github.com/pjanul/pymgal).
Installation
============
Since PyMGal is registered with PyPI, you can simply pip install the latest stable version. Make sure you have all the necessary prerequisites from the requirements.txt file beforehand.
```python
pip install pymgal
```
Usage
============
In most cases, the only API needed for PyMGal is the MockObservation object. MockObservation objects require two mandatory parameters: the path to your snapshot file and the coordinates and radius of the region you want to consider. If you don't know the coordinates of your object, you'll probably need to obtain some catalogue data.
Once you initialize the object, you can calculate magnitudes of particles in your preferred output unit using the get_mags() function. You can also save projection files using the project() function. If you call project() before calling get_mags(), the magnitudes will automatically be calculated.
Here is a sample to get you started.
```python
from pymgal import MockObservation
obs = MockObservation("/path/to/snapshot", [x_c, y_c, z_c, r])
obs.params["out_val"] = "luminosity"
obs.get_mags()
obs.project("/path/to/output")
```
If all goes well, you should see at least one newly formed snap_{XYZ}-{proj_angle}-{filter}.fits file in your output directory.
Modifiable parameters
-------------
There are many different parameters you can modify for your magnitude calculations and your projections. Here is a list of them. For more information, see the [documentation website](https://pymgal.readthedocs.io).
```python
class MockObservation(object):
def __init__(self, sim_file, coords, args=None):
# Default parameter values
defaults = {
"model": SSP_models('bc03', IMF='chab', has_masses=True),
"dustf": None,
"filters": ["sdss_r"],
"out_val": "flux",
"mag_type": "AB",
"proj_vecs": "z",
"proj_angs": None,
"proj_rand": 0,
"rest_frame": True,
"AR": 1.2,
"npx": 512,
"z_obs": 0.1,
"ksmooth": 100,
"g_soft": None,
"p_thick": None,
"add_spec": False,
"spec_res": None,
"ncpu": 16,
"noise": None,
"outmas": True,
"outage": False,
"outmet": False
"quiet": False
}
```
* **Note: If you're working with data from The Three Hundred Project, we've included a script called pymgal/doc/the300_helper.py which helps you get positions from AHF halos. Open it and read the comments at the top for instructions. Fair warning: PyMGal has been modified quite a bit since this script was written, so you may need to make some modifications.**
Who do I talk to?
-----------
* Please report any issue to Weiguang Cui (cuiweiguang@gmail.com) or Patrick Janulewicz (patrick.janulewicz@gmail.com).
* Or report a bug through issues.
Acknowledgement
----------
* This package borrowed a lot things from ezgal (<http://www.baryons.org/ezgal/>). Please make your acknowledgement to their work when you use this package.
Raw data
{
"_id": null,
"home_page": null,
"name": "pymgal",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "astronomy astrophysics hydrodynamical simulation mock observation",
"author": "Weiguang Cui, Patrick Janulewicz",
"author_email": "cuiweiguang@gmail.com, patrick.janulewicz@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/55/bc/d06f5b38aadfe97149ec4146ac877301a10ca7fa5e9ff7f9121723f06e22/pymgal-1.1.tar.gz",
"platform": null,
"description": "# README\n\nPyMGal is a package that uses simple stellar synthesis models to generate mock observations of galaxies from hydrodynamical simulations. If you want a more detailed explanation of PyMGal than can be provided in a short readme file, see the documentation at [https://pymgal.readthedocs.io](https://pymgal.readthedocs.io).\n\n\nIf you're viewing this from the Github page, you may wish to view PyMGal's official page at the [Python Package Index (PyPI)](https://pypi.org/project/pymgal/).\n\nIf you're viewing this from the PyPI page, you may want to see the full [Github repository](https://github.com/pjanul/pymgal).\n\n\n\n\n\nInstallation \n============\n\nSince PyMGal is registered with PyPI, you can simply pip install the latest stable version. Make sure you have all the necessary prerequisites from the requirements.txt file beforehand. \n\n```python\npip install pymgal\n```\n \nUsage\n============\n\nIn most cases, the only API needed for PyMGal is the MockObservation object. MockObservation objects require two mandatory parameters: the path to your snapshot file and the coordinates and radius of the region you want to consider. If you don't know the coordinates of your object, you'll probably need to obtain some catalogue data.\n\nOnce you initialize the object, you can calculate magnitudes of particles in your preferred output unit using the get_mags() function. You can also save projection files using the project() function. If you call project() before calling get_mags(), the magnitudes will automatically be calculated.\n\nHere is a sample to get you started. \n\n```python\nfrom pymgal import MockObservation\n\nobs = MockObservation(\"/path/to/snapshot\", [x_c, y_c, z_c, r]) \nobs.params[\"out_val\"] = \"luminosity\"\nobs.get_mags()\nobs.project(\"/path/to/output\")\n```\n\nIf all goes well, you should see at least one newly formed snap_{XYZ}-{proj_angle}-{filter}.fits file in your output directory. \n\n\nModifiable parameters\n-------------\n\nThere are many different parameters you can modify for your magnitude calculations and your projections. Here is a list of them. For more information, see the [documentation website](https://pymgal.readthedocs.io). \n\n```python\nclass MockObservation(object):\n def __init__(self, sim_file, coords, args=None):\n # Default parameter values\n defaults = {\n \"model\": SSP_models('bc03', IMF='chab', has_masses=True),\n \"dustf\": None,\n \"filters\": [\"sdss_r\"],\n \"out_val\": \"flux\",\n \"mag_type\": \"AB\",\n \"proj_vecs\": \"z\",\n \"proj_angs\": None,\n \"proj_rand\": 0,\n \"rest_frame\": True,\n \"AR\": 1.2,\n \"npx\": 512,\n \"z_obs\": 0.1,\n \"ksmooth\": 100,\n \"g_soft\": None,\n \"p_thick\": None,\n \"add_spec\": False,\n \"spec_res\": None,\n \"ncpu\": 16,\n \"noise\": None,\n \"outmas\": True,\n \"outage\": False,\n \"outmet\": False\n \"quiet\": False\n }\n```\n* **Note: If you're working with data from The Three Hundred Project, we've included a script called pymgal/doc/the300_helper.py which helps you get positions from AHF halos. Open it and read the comments at the top for instructions. Fair warning: PyMGal has been modified quite a bit since this script was written, so you may need to make some modifications.**\n\nWho do I talk to?\n-----------\n\n* Please report any issue to Weiguang Cui (cuiweiguang@gmail.com) or Patrick Janulewicz (patrick.janulewicz@gmail.com).\n* Or report a bug through issues.\n\nAcknowledgement\n----------\n* This package borrowed a lot things from ezgal (<http://www.baryons.org/ezgal/>). Please make your acknowledgement to their work when you use this package.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Package for Mock Observations in optical bands",
"version": "1.1",
"project_urls": null,
"split_keywords": [
"astronomy",
"astrophysics",
"hydrodynamical",
"simulation",
"mock",
"observation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "55bcd06f5b38aadfe97149ec4146ac877301a10ca7fa5e9ff7f9121723f06e22",
"md5": "f4125a26710d80db5c9d1b5752d7e1f7",
"sha256": "51d062b463f62f9175ec8e7374c0cb2e412b8a81b9dfc541fcbcc72c2c8ca7c6"
},
"downloads": -1,
"filename": "pymgal-1.1.tar.gz",
"has_sig": false,
"md5_digest": "f4125a26710d80db5c9d1b5752d7e1f7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 67115463,
"upload_time": "2024-10-10T12:50:22",
"upload_time_iso_8601": "2024-10-10T12:50:22.475354Z",
"url": "https://files.pythonhosted.org/packages/55/bc/d06f5b38aadfe97149ec4146ac877301a10ca7fa5e9ff7f9121723f06e22/pymgal-1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-10 12:50:22",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pymgal"
}
JSON