{ "info": { "author": "Jacopo Sabbatini", "author_email": "sabbatini@physics.uq.edu.au", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: GNU General Public License v2 (GPLv2)", "Topic :: Scientific/Engineering :: Mathematics", "Topic :: Scientific/Engineering :: Physics", "Topic :: Utilities" ], "description": "pyGRID\n======\n\nPython suite to manage jobs on a Sun Grid Engine computing cluster. Based on [pySGE](https://github.com/jiahao/PySGE), it adds the ability to span a parameter space.\n\nCreate Package\n---------------------\n\npyGRID uses setuptoos to create an installer to be distributed. Type\n```\npython setup.py sdist\n```\nin the repository directory in order to create a package. You can grab the archived file produced by setuptools in the `dist` subdirectory of the repository to distribute pyGRID.\n\nInstallation\n---------------\n\nIf you don't have root privileges on the cluster and you want to install pyGRID in your home directory follow these steps first:\n* Create the path `~/lib/python2.6/site-packages` (assuming you installed python version 2.6) in your home directory.\n* Create the `~/bin` path.\n* Add `export PYTHONPATH=~/lib/python2.6/site-packages:$PYTHONPATH` and `export PATH=~/bin:$PATH` to your `.bashrc` file (and run `. ~/.bashrc`).\n\nTransfer the pyGRID archive file on the cluster and from a terminal run\n```\n$ tar -xzvf pyGRID-0.2.tar.gz\n$ cd pyGRID-0.2\n$ python setup.py develop --prefix=~\n```\nwhere `0.2` is the current version number of pyGRID.\n\nFrom now on you can run pyGRID by simply typing `pyGRID` from anywhere in the cluster.\n\nUsage\n-----\n\npyGRID accepts the path of an xml file as input and the name of simulation defined within it as a `sim_element` xml tag. The `sim_element` xml tag specifies the options of the job you want to run and is used by pyGRID to \n* write a bash file to pass to qsub for running the job\n* pass options to qsub, included the values of parameters as environment variables\n* create an auxilliary xml file, with extentsion `.grid`, holding the properties of a submitted job\n* detect crashed jobs and resubmit them\n\nThe syntax for the xml file used by pyGRID is documented in `pyGRID/examples/basicExample.xml` but in short pyGRID conforms to the syntax used by `qsub` to specify job options.\n\npyGRID command line options can be divided in three groups:\n* XML file option. This option is *Required*.\n * `-f`, specifies the path of the file to load.\n* Simulation options. These are mutually *exlusive* and at least one is *Required*.\n * `-s`, specifies the name of the simulation to load from the XML file.\n * `-a`, loads all the simulations in the file.\n* Action options. Tell pyGRID which action to perform woth the specified simulation. These are mutually *exclusive*.\n * `-w`, write the shell script for the simulation. \n * `-b`, write the shell script and submit a job for every combination of the parameters of the simulation\n * `-c`, scan the output sctream of finished jobs and detect the crashed ones. The `JOB_ID` and `TASK_ID` of the crashed job is saved in the `.grid` auxilliary file. \n * `-r`, resubmit crashed jobs.\n \nTo invoke the documentation for pyGRID command line option type `pyGRID --help`. \n\nTests\n-----\n\nI have created some tests for pyGRID in order to ensure that basic functions are not broken during development.\nBoth these tasks require some sort of system in place to emulate `qsub` and its responses.\n\nTo run the tests install `nose` with `pip install nose` and type\n```\nnosetests\n```\nin the repository main directory.\n", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "UNKNOWN", "keywords": "scientific/engineering simulation", "license": "GPLv2", "maintainer": null, "maintainer_email": null, "name": "pyGRID", "package_url": "https://pypi.org/project/pyGRID/", "platform": "OS Independent", "project_url": "https://pypi.org/project/pyGRID/", "project_urls": { "Download": "UNKNOWN", "Homepage": "UNKNOWN" }, "release_url": "https://pypi.org/project/pyGRID/0.2.5/", "requires_dist": null, "requires_python": null, "summary": "Python utilities to interface with SUN GRID ENNGINE and allow to run\n simulations that span a parameter space", "version": "0.2.5" }, "last_serial": 879649, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "b296d291d08effe362051be4d5321b39", "sha256": "2dcceeacde79b2119e24401ac291e6770ac6256787539e025a6b007964f0e8a4" }, "downloads": -1, "filename": "pyGRID-0.2.tar.gz", "has_sig": false, "md5_digest": "b296d291d08effe362051be4d5321b39", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11968, "upload_time": "2013-10-02T11:48:28", "url": "https://files.pythonhosted.org/packages/f0/29/87e9457f44e3e4ff7fadd9789d25ac7903f1fdd4719990eb8526a160c83c/pyGRID-0.2.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "40cc429adfad255680e195521feddd11", "sha256": "5b137f42ab42f8d72a042d09f59b00e79c0d3b9c077cddbe70c8a60b7737b5fd" }, "downloads": -1, "filename": "pyGRID-0.2.1.tar.gz", "has_sig": false, "md5_digest": "40cc429adfad255680e195521feddd11", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11983, "upload_time": "2013-10-02T11:55:15", "url": "https://files.pythonhosted.org/packages/14/1a/bad64f3b862c4efce0ed3b5f69ad79f127402e39ed845ce2c140ef4d6997/pyGRID-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "639a235ff45d06c21d719e4a9f181f8e", "sha256": "14e696d518573d5a374d0ab3faa754fc01452b86ba7f15d9a8461aa0c6a320bd" }, "downloads": -1, "filename": "pyGRID-0.2.2.tar.gz", "has_sig": false, "md5_digest": "639a235ff45d06c21d719e4a9f181f8e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11992, "upload_time": "2013-10-02T22:50:03", "url": "https://files.pythonhosted.org/packages/5f/24/15380f787e49a19ea0e92ea0ccb65a0cd429bb4ced216b5a7ef232570cf7/pyGRID-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "893e54bdfd4c28812997796c430de0a7", "sha256": "d17a1d05ab680c5e2e1d6b04fae9e516c9936afe96c75301e74a0497aad9bba2" }, "downloads": -1, "filename": "pyGRID-0.2.3.tar.gz", "has_sig": false, "md5_digest": "893e54bdfd4c28812997796c430de0a7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11988, "upload_time": "2013-10-02T22:51:22", "url": "https://files.pythonhosted.org/packages/5c/c2/4e51b37fcb77888bc8662bd67fc1e2f42e81d33c51a07a3ae4b629fe5cac/pyGRID-0.2.3.tar.gz" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "caf9f141847f81ca844646328bbe2d0d", "sha256": "962fc7ecd5dcceec058138ccdec19746951bd03fe5d8f827a6238d39b02ba35f" }, "downloads": -1, "filename": "pyGRID-0.2.4.tar.gz", "has_sig": false, "md5_digest": "caf9f141847f81ca844646328bbe2d0d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12026, "upload_time": "2013-10-03T00:21:23", "url": "https://files.pythonhosted.org/packages/28/7f/707231ba26d937125aa68fcf09652d26fca672c6d880ac73936728eca269/pyGRID-0.2.4.tar.gz" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "0f67f087cb833a09b3fa5149ea5ecc73", "sha256": "d5f7138a62767cfe2b45127814756dc7f9ef93702af9931ee84053797b3fd9e2" }, "downloads": -1, "filename": "pyGRID-0.2.5.tar.gz", "has_sig": false, "md5_digest": "0f67f087cb833a09b3fa5149ea5ecc73", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12021, "upload_time": "2013-10-03T00:26:28", "url": "https://files.pythonhosted.org/packages/31/17/405ff0ed4dfc61b55f832b15129f125c525ea0b91412383a377ac81d4d5d/pyGRID-0.2.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0f67f087cb833a09b3fa5149ea5ecc73", "sha256": "d5f7138a62767cfe2b45127814756dc7f9ef93702af9931ee84053797b3fd9e2" }, "downloads": -1, "filename": "pyGRID-0.2.5.tar.gz", "has_sig": false, "md5_digest": "0f67f087cb833a09b3fa5149ea5ecc73", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12021, "upload_time": "2013-10-03T00:26:28", "url": "https://files.pythonhosted.org/packages/31/17/405ff0ed4dfc61b55f832b15129f125c525ea0b91412383a377ac81d4d5d/pyGRID-0.2.5.tar.gz" } ] }