{ "info": { "author": "Rui Xue", "author_email": "rx.astro@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "casa-proc\n==============================================================\n\n**casa-proc** provides you a quick access of the functions from the `CASA package `_ under Python, i.e., \ncalling CASA tasks or running a user script originally intended for CASA sessions.\nThe program is essentially a basic Python wrapper around the CASA package, by sending data processing \njobs to CASA installed on your OS using its script execution option ``casa -c``.\nHowever, some user-friendly features are built in the wrapper:\n\n- behave like a traditional Python module, easy to use interactively or embed into a Python program\n- no complicated dependency requirement / no modification needed on your CASA package\n- support Python logging\n\nProject links:\n\n* Repo: https://github.com/r-xue/casa-proc\n* PyPI: https://pypi.python.org/pypi/casa-proc\n\n\nInstallation\n~~~~~~~~~~~~\nThe command line script can be installed via::\n\n pip install --user . # from a local copy \n pip install --user --upgrade casa-proc # from PyPI\n pip install https://github.com/r-xue/casa-proc/archive/master.zip # from GitHub\n\nUsage\n~~~~~\n\nTo run a single CASA task::\n\n import casa_proc\n casa_proc.casa_task('listobs','data/hxmm01.band6.ms',field='*')\n\nTo run a user CASA script built into the package or written by yourself::\n\n casa_proc.casa_script('casascript_demo.py',var1='var1_value',var2='var2_value',var3=1,var4=2)\n\nnote: `casascript_demo.py `_ here is a CASA user example script.\n\nMore advanced features (e.g. the logging management) are show in the Jupyter Notebook: `test_casaproc.ipynb `_\n\nCompatibility and Dependency\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n.. _below:\n\nThe program is only tested against Python>=3.6 on MacOS, though I expect no issue under any Unix-like system if the below requirements are met:\n\n* Python (>=3.5)\n* CASA (>=5.x)\n\nThe program will automatically create two customized CASA session startup files (``init.py`` and ``prelude.py``) under a scratch folder beneath the CASA preference directory named ``~/.casa/casa_proc/``.\n\nStatus\n~~~~~~\n\nThe code was originally written as a submodule of another Python-based software program I am working on.\nAlthough the shell/wrapper approach is not an efficient solution to run complicated CASA workflows due to the heavy execution overhead,\nthe program might still be a useful lightweight tool for some user cases.\nIf you realize that you have been switching back/forth between Python/iPython and CASA too often, this module may help.\n\nAnother practice of mixing Python-CASA functions/modules is of course installing various Python modules into \nCASA via `casa-python `_.\nThen you can run your external Python function/modules under the CASA interpreter and call it a day.\nHowever, the Python environment / interpreter / modules (e.g. matplotlib) embedded in the current CASA package (specified v5.6 here) are out-of-date (however, see my CASA6 demo below)\nThen the maintenance of your Python codes may become rather complicated as this requires all your externally installed Python modules to be compatible with the Python bundled with CASA. \n\n**This package may become unnecessary in near future**. As part of the ongoing development of \n`CASA 6 `_, and `the transition from Python 2 to 3 `_, \nCASA will allow to integrate its tasks/tools into your existing Python workflows. The CASA tools and tasks will become standard Python modules as I demonstrate in this Jupyter Notebook:\n`test_casa6.ipynb `_\n\nNote:\n\n* if your sole purpose is to access/manipulate a Measurement Set from Python, `python-casacore `_ will be the best solution.\n* Some other solutions are available for resolving the same issue (accessing CASA functions from Python). I list some of them here as references:\n\n * `drive-casa `_\n * `pkgw-forge `_ \n\n\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/r-xue/casa-proc", "keywords": "CASA", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "casa-proc", "package_url": "https://pypi.org/project/casa-proc/", "platform": "", "project_url": "https://pypi.org/project/casa-proc/", "project_urls": { "Bug Reports": "https://github.com/r-xue/casa-proc/issues", "Homepage": "http://github.com/r-xue/casa-proc", "Source": "https://github.com/r-xue/casa-proc/" }, "release_url": "https://pypi.org/project/casa-proc/0.1.dev2/", "requires_dist": null, "requires_python": ">=3.6, <4", "summary": "Run CASA scripts within Python", "version": "0.1.dev2" }, "last_serial": 5816087, "releases": { "0.1.dev2": [ { "comment_text": "", "digests": { "md5": "e7c8e1a790de432b60856dc05bd7febd", "sha256": "b317b6d5842d635d9a83173fbaacf2fefea0c8dae03d29bcbb40f89e33cd4f23" }, "downloads": -1, "filename": "casa_proc-0.1.dev2-py3-none-any.whl", "has_sig": false, "md5_digest": "e7c8e1a790de432b60856dc05bd7febd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6, <4", "size": 8436, "upload_time": "2019-09-11T17:16:05", "url": "https://files.pythonhosted.org/packages/3c/f5/531eaa56484bb5b04db5a7925ea46293b90ca10b8908effdf5fff81f4459/casa_proc-0.1.dev2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "44ea8a3b094ab3fc212c9e760cd18e65", "sha256": "e189e383343b35af95924857ca9e5766e3639e042e9f745c2ac3dbdc7edaf3de" }, "downloads": -1, "filename": "casa-proc-0.1.dev2.tar.gz", "has_sig": false, "md5_digest": "44ea8a3b094ab3fc212c9e760cd18e65", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <4", "size": 170961, "upload_time": "2019-09-11T17:18:17", "url": "https://files.pythonhosted.org/packages/22/2d/0f7fce8e222a3ffe8aa87ee426e902d66f99ca2709bc253a09dfb17047cc/casa-proc-0.1.dev2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e7c8e1a790de432b60856dc05bd7febd", "sha256": "b317b6d5842d635d9a83173fbaacf2fefea0c8dae03d29bcbb40f89e33cd4f23" }, "downloads": -1, "filename": "casa_proc-0.1.dev2-py3-none-any.whl", "has_sig": false, "md5_digest": "e7c8e1a790de432b60856dc05bd7febd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6, <4", "size": 8436, "upload_time": "2019-09-11T17:16:05", "url": "https://files.pythonhosted.org/packages/3c/f5/531eaa56484bb5b04db5a7925ea46293b90ca10b8908effdf5fff81f4459/casa_proc-0.1.dev2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "44ea8a3b094ab3fc212c9e760cd18e65", "sha256": "e189e383343b35af95924857ca9e5766e3639e042e9f745c2ac3dbdc7edaf3de" }, "downloads": -1, "filename": "casa-proc-0.1.dev2.tar.gz", "has_sig": false, "md5_digest": "44ea8a3b094ab3fc212c9e760cd18e65", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <4", "size": 170961, "upload_time": "2019-09-11T17:18:17", "url": "https://files.pythonhosted.org/packages/22/2d/0f7fce8e222a3ffe8aa87ee426e902d66f99ca2709bc253a09dfb17047cc/casa-proc-0.1.dev2.tar.gz" } ] }