{ "info": { "author": "Liam Deacon", "author_email": "liam.deacon@diamond.ac.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Environment :: X11 Applications :: Qt", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Scientific/Engineering :: Chemistry", "Topic :: Scientific/Engineering :: Physics" ], "description": "===================\r\nPHASESHIFTS PACKAGE\r\n===================\r\n\r\nThis package is a Python-based implementation of the Barbieri/Van Hove \r\nphase shift (a.k.a. *phshift*) calculation package needed to produce phase shifts for \r\nvarious LEED packages (including CLEED), as well as for certain XPD packages. \r\nTo quote the original authors' site: \r\n\r\n\"The phase shift calculation is performed in several steps:\r\n\r\n1. Calculation of the radial charge density for a free atom.\r\n\r\n2. Calculation of the radial muffin-tin potential for atoms embedded in a \r\n surface defined by the user (the surface is represented by a slab that \r\n is periodically repeated in 3 dimensions, within vacuum between the \r\n repeated slabs); various approximations to the exchange potential \r\n are available; relativistic effects are taken into account.\r\n\r\n3. Calculation of phase shifts from the muffin-tin potential.\r\n\r\n4. Elimination of pi-jumps in the energy dependence of the phase shifts.\"\r\n\r\n.. note:: You can get the original Fortran source (& learn more about the *phshift* programs) from:\r\n\r\n http://www.icts.hkbu.edu.hk/surfstructinfo/SurfStrucInfo_files/leed/leedpack.html\r\n\r\nThe `phsh.py` script aims to simplify these steps with a single command. For more \r\ninformation please read the documentation at ``_\r\n\r\nInstall\r\n=======\r\n\r\nThe `phaseshifts `_ package \r\nrequires CPython 2.6 or later and also uses the `numpy \r\n`_, `scipy \r\n`_ and `periodictable \r\n`_ packages. \r\nCurrently, it has only been tested extensively with Python 2.7 on Windows, so \r\nthere are no guarantees with other platforms. To perform a setup follow the \r\nsteps below.\r\n\r\n 1. Install the numpy, scipy and periodictable packages. \r\n \r\n On systems compatible with PyPI this can be done using the command::\r\n \r\n pip install numpy scipy periodictable\r\n\r\n Or if you have the easy_install package::\r\n \r\n easy_install install numpy scipy periodictable\r\n\r\n Older versions of numpy & scipy did not allow simultaneous installation -\r\n if you experience problems then try first installing numpy before \r\n attempting to install scipy. \r\n\t\r\n The periodictable package allows lookup of the most common crystal \r\n structure for a given element and is instrumental in many of the \r\n convenience functions contained in the model module.\r\n \r\n Alternatively download and install these packages manually following the\r\n instructions provided for the respective packages.\r\n\r\n 2. To install the phaseshifts package::\r\n \r\n python setup.py install \r\n\r\n With any luck the package has been installed successfully. A set of test scripts\r\n are provided, however a few simple checks may suffice using the command and an interactive session of the python interpreter::\r\n\r\n phsh.py --help\r\n python\r\n >>> import phaseshifts\r\n >>> from phaseshifts.lib import libphsh # compiled FORTRAN .pyd or .so using f2py\r\n >>> libphsh.hartfock\r\n \r\n >>> exit(0) # okay if no errors found above\r\n\r\n If these execute without errors then it is likely that all is well, but in case of \r\n problems or bugs please use the contact provided below and I will do my best to \r\n address the problem quickly.\r\n\r\n.. tip:: On Windows systems it may be easier to install a scientific python distibution \r\n rather than install the dependencies from source - `Python(x,y) \r\n `_ with mingw (gcc & gfortran) \r\n installed is highly recommended.\r\n\r\nUbuntu\r\n------\r\n\r\nOn Ubuntu (14.04 LTS) some dependencies were needed, which can be installed using the following bash commands::\r\n\r\n $ sudo apt-get install python-pip python-numpy python-scipy python-dev libblas-dev gfortran # should install f2py as a dependency of numpy/scipy \r\n $ sudo pip install phaseshifts==0.1.5-dev | tee phaseshifts.log # explicit version needed\r\n $ sudo ln -s /usr/bin/python2.7 /usr/bin/python # can skip if only a single version of python is installed \r\n\r\nYou may need to verifiy whether the ``phsh.py`` script is installed on the system $PATH and therefore please check by typing::\r\n\r\n $ python /usr/local/bin/phsh.py --help # should work okay\r\n $ phsh.py --help # may not work: phsh.py should be on the $PATH and executable\r\n\r\n.. note:: You may need to specify an explicit version of ``python`` when trying the above commands e.g. ``python2.7``\r\n\r\nAbout the code\r\n==============\r\n\r\nThe example source codes provided in this package are intended to be \r\ninstructional in calculating phase shifts. While it is not recommended to \r\nuse the example code in production, the code\r\nshould be sufficient to explain the general use of the library.\r\n\r\nIf you aren't familiar with the phase shift calculation process, you can \r\nread further information in ``doc/`` folder:\r\n\r\n+ ``phshift2007.rst`` - a brief user guide/documentation concerning the input files \r\n (& details of the original fortran `phshift` package).\r\n+ ``phaseshifts.pdf`` - a more detailed overview of the library functions and how to\r\n calculate phase shifts using the convenience functions in this package. This is not\r\n yet finished and so the reader is referred to the above document for the time being.\r\n\r\nFor those wanting a crash course of the Van Hove / Tong programs, I advise reading the \r\nphsh2007.txt document.\r\nSee the ``examples/`` directory to get an idea of the structure of the input files \r\n(for a random selection of models & elements). In particular see the ``cluster_Ni.i``\r\nfile for helpful comments regarding each line of input.\r\n\r\nThose of you who are eager to generate phase shifts - first look at the example\r\ncluster files for a bulk and slab calculation, noting that the atoms in the model\r\nare in fractional units of the *a* basis vector for the unitcell (SPA units). Next, \r\nafter creating a bulk and slab model in the ``cluster.i`` format, simply use \r\nthe following python code:\r\n \r\n >>> from phaseshifts.phsh import Wrapper as phsh\r\n >>> phsh.autogen_from_inputs(bulk_file, slab_file)\r\n\r\nThis will hopefully produce the desired phase shift output files (at least for \r\nsimple models) and works by assessing the two models to determine what output to\r\nproduce. For more detailed documentation and function use refer to the pdf manual. \r\n\r\n.. tip:: A standalone command line utility **phsh.py** is provided as a way of \r\n automating the generation of phase shifts as part of a script. For more \r\n information use:\r\n \r\n .. code:: bash\r\n \r\n phsh.py --help\r\n \r\n.. note:: The `leed.py` module provides a conversion class for CLEED .inp and \r\n .bul files. This is included as part of the `phsh.py` module, \r\n however the file extension is important (needs .inp, .pmin, .bul, or .bmin) \r\n and error checking is limited. There are also plans to include a \r\n validator to check the files for malformatted input at some point in the \r\n future.\r\n \r\nDevelopment\r\n===========\r\n\r\nFor those wishing to see the latest code, please visit: ``_ \r\n\r\nDisclaimer: The latest code is actively developed and may potentially be bug ridden... It is recommended that you use it with caution and a great deal of skepticism!\r\n\r\nAcknowledgements\r\n================\r\n\r\nAs with all scientific progress, we stand on the shoulders of giants. If this \r\npackage is of use to you in publishing papers then please acknowledge the \r\nfollowing people who have made this package a reality:\r\n\r\n - **A. Barbieri** and **M.A. Van Hove** - who developed most of the original \r\n fortran code. Use *A. Barbieri and M.A. Van Hove, private communication.* \r\n (see ``doc/phsh2007.txt`` for further details).\r\n \r\n - **E.L. Shirley** - who developed part of the fortran code during work towards his\r\n PhD thesis (refer to the thesis: *E.L. Shirley, \"Quasiparticle calculations in \r\n atoms and many-body core-valence partitioning\", University of Illinois, Urbana, 1991*).\r\n\r\n - **Christoph Gohlke** - who developed the elements.py module used extensively throughout\r\n for the modelling convenience functions (see 'elements.py' for license details). \r\n\r\n I would also be grateful if you acknowledge this python package (*phaseshifts*) as: \r\n *L.M. Deacon, private communication.*\r\n\r\n\r\nThanks\r\n------\r\n\r\nI wish to personally add a heart-felt thanks to both Eric Shirley and Michel Van Hove \r\nwho have kindly allowed the use of their code in the ``libphsh.f`` file needed for the\r\nunderlying low-level functions in this package. \r\n\r\nContact\r\n=======\r\n\r\nThis package is developed/maintained in my spare time so any bug reports, patches, \r\nor other feedback are very welcome and should be sent to: liam.deacon@diamond.ac.uk\r\n\r\nThe project is in the early developmental stages and so anyone who wishes to get \r\ninvolved are most welcome (simply contact me using the email above).\r\n\r\nTo do\r\n=====\r\n\r\n 1. Documentation - the manual has been started, but is not complete and thus is a \r\n high priority. The current aim is to use sphinx to generate html and latex documents\r\n for semi-automated generation of both the tutorial and supporting website. If\r\n you have the phaseshifts source and the `sphinx `_ \r\n and the `numpydoc `_ PyPi packages then you \r\n can try making html or latex manuals using ``make html`` or ``make latexpdf`` commands \r\n from the ``doc/`` directory.\r\n\r\n 2. Test suit to verify the package is working as expected.\r\n\r\n 3. GUI frontend (Qt ui files are provided in the ``gui/`` directory for anyone \r\n wishing to undertake this challenge). Other frontends are welcome (I use Qt \r\n due to familiarity/experience). For those wishing a sneak preview, try executing\r\n ``main.pyw``\r\n\r\nSee ``TODO.rst`` for more information.\r\n\r\nAuthor list\r\n===========\r\n\r\n - `Liam Deacon `_ - *current maintainer*", "description_content_type": null, "docs_url": "https://pythonhosted.org/phaseshifts/", "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://pypi.python.org/pypi/phaseshifts", "keywords": "phaseshifts atomic scattering muffin-tin diffraction", "license": "MIT License", "maintainer": "", "maintainer_email": "", "name": "phaseshifts", "package_url": "https://pypi.org/project/phaseshifts/", "platform": "Ubuntu Linux/Windows 7", "project_url": "https://pypi.org/project/phaseshifts/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://pypi.python.org/pypi/phaseshifts" }, "release_url": "https://pypi.org/project/phaseshifts/0.1.5-dev/", "requires_dist": null, "requires_python": null, "summary": "Python-based version of the Barbieri/Van Hove phase shift calculation package for LEED/XPD modelling", "version": "0.1.5-dev" }, "last_serial": 1484670, "releases": { "0.1.0-dev": [ { "comment_text": "", "digests": { "md5": "5a49f246abd109d102b54465e8a8b9b8", "sha256": "8558af66a935ac3ad096cb028628471c6727b61d19d1959b04426441df8190c1" }, "downloads": -1, "filename": "phaseshifts-0.1.0-dev.zip", "has_sig": false, "md5_digest": "5a49f246abd109d102b54465e8a8b9b8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 386750, "upload_time": "2013-10-25T21:28:36", "url": "https://files.pythonhosted.org/packages/18/49/469a1ce78064cfa39ed4e386aee3827ce58670b05b8c6c64adcf07aa4cd0/phaseshifts-0.1.0-dev.zip" } ], "0.1.1-dev": [ { "comment_text": "", "digests": { "md5": "a203380372eebe0de4b290c7515e3c21", "sha256": "b90937581f7c3e2e429d5cb22bcf26980c078cef4a935d0bea92f44eaa16bfb8" }, "downloads": -1, "filename": "phaseshifts-0.1.1-dev.zip", "has_sig": false, "md5_digest": "a203380372eebe0de4b290c7515e3c21", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 522573, "upload_time": "2014-02-24T10:02:06", "url": "https://files.pythonhosted.org/packages/ec/d1/ae61ab7f0d7852734b43454755ddf4fafaca456b3126db2dc040c0363c3e/phaseshifts-0.1.1-dev.zip" } ], "0.1.2-dev": [ { "comment_text": "", "digests": { "md5": "c35a1eb72247800b69a4cdafaeb82fa0", "sha256": "d541beaeb619f14e58d43ce4869b38242fbc01afa7e856d94fc7c4fab21fc8e8" }, "downloads": -1, "filename": "phaseshifts-0.1.2-dev.win32-py2.7.exe", "has_sig": false, "md5_digest": "c35a1eb72247800b69a4cdafaeb82fa0", "packagetype": "bdist_wininst", "python_version": "2.7", "requires_python": null, "size": 538197, "upload_time": "2014-04-03T08:41:30", "url": "https://files.pythonhosted.org/packages/05/cb/49538f7f64e793cae1a1171542b7450bf0cd07f9b3ce494d7a354a765e14/phaseshifts-0.1.2-dev.win32-py2.7.exe" }, { "comment_text": "", "digests": { "md5": "d909f9792a66a57e39bd1397f07c4b4c", "sha256": "163dd0b9141e3d3055fd57376111842680bdfbcb6f27f2246e2feaea0c4bd018" }, "downloads": -1, "filename": "phaseshifts-0.1.2-dev.zip", "has_sig": false, "md5_digest": "d909f9792a66a57e39bd1397f07c4b4c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1804331, "upload_time": "2014-04-03T08:41:22", "url": "https://files.pythonhosted.org/packages/f3/70/4e2c88dfd6f8b504f2bf42d3933721e67e3888964ef62960f1aa51d8ab0a/phaseshifts-0.1.2-dev.zip" } ], "0.1.3-dev": [ { "comment_text": "", "digests": { "md5": "2e1e4c4f1a36efac58062d2906ad0e3d", "sha256": "5811e90e7d98651e6fb97259e1430c3299315bd0a20fd9bdb152e072d4c5113c" }, "downloads": -1, "filename": "phaseshifts-0.1.3-dev.win32-py2.7.exe", "has_sig": false, "md5_digest": "2e1e4c4f1a36efac58062d2906ad0e3d", "packagetype": "bdist_wininst", "python_version": "2.7", "requires_python": null, "size": 568753, "upload_time": "2014-06-05T15:37:31", "url": "https://files.pythonhosted.org/packages/5c/a0/a419417fb4f25cc87ed0286685d42416be0d91192a9e288869a1706b61dd/phaseshifts-0.1.3-dev.win32-py2.7.exe" }, { "comment_text": "built for Windows-7", "digests": { "md5": "eda1767762ed66a38ade3446aa8d3248", "sha256": "e479402af114a4415056aac12e620115c470a64924188c601fbc33bd86cc6bd5" }, "downloads": -1, "filename": "phaseshifts-0.1.3-dev.win32.zip", "has_sig": false, "md5_digest": "eda1767762ed66a38ade3446aa8d3248", "packagetype": "bdist_dumb", "python_version": "2.7", "requires_python": null, "size": 552572, "upload_time": "2014-06-05T15:37:29", "url": "https://files.pythonhosted.org/packages/85/7e/c8ad5e9b47bd3d6e9e1ce6e1ced896d911f5445c1e24c6fb2f5b558563d5/phaseshifts-0.1.3-dev.win32.zip" }, { "comment_text": "", "digests": { "md5": "49b273e750f6211aa7f6756b2802243b", "sha256": "a2a056f51a998383a14d3281240e7cdb7aeecf9d0a1fe77c1b63f91732844def" }, "downloads": -1, "filename": "phaseshifts-0.1.3-dev.zip", "has_sig": false, "md5_digest": "49b273e750f6211aa7f6756b2802243b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2134608, "upload_time": "2014-06-05T15:37:26", "url": "https://files.pythonhosted.org/packages/37/bb/1f790ee1fe3457dd40b7e336ae980e447a7258992f335b41290fe60067a0/phaseshifts-0.1.3-dev.zip" } ], "0.1.4-dev": [ { "comment_text": "", "digests": { "md5": "e9b9d8befc416f8e9ccf5325b7dbb580", "sha256": "2cc577df17d14b001caf181e62cc4713c238ddcccc041d20b0b23119367d272d" }, "downloads": -1, "filename": "phaseshifts-0.1.4-dev.win32-py2.7.exe", "has_sig": false, "md5_digest": "e9b9d8befc416f8e9ccf5325b7dbb580", "packagetype": "bdist_wininst", "python_version": "2.7", "requires_python": null, "size": 565884, "upload_time": "2014-07-23T17:27:12", "url": "https://files.pythonhosted.org/packages/6d/53/4802d4c42b6c619d0066768abb361c5a3faf86af565b8830dd467c57fde4/phaseshifts-0.1.4-dev.win32-py2.7.exe" }, { "comment_text": "built for Windows-7", "digests": { "md5": "7e99c491b635a39b7ec8f9544b487767", "sha256": "9d03e632191e47af9ab116da7295c87820aed40fd059a52fdfe9e60cc34f7edf" }, "downloads": -1, "filename": "phaseshifts-0.1.4-dev.win32.tar.gz", "has_sig": false, "md5_digest": "7e99c491b635a39b7ec8f9544b487767", "packagetype": "bdist_dumb", "python_version": "2.7", "requires_python": null, "size": 512385, "upload_time": "2014-07-23T17:26:57", "url": "https://files.pythonhosted.org/packages/e9/d7/19777767d7dd3070da150be49acff59eed229d3566b693233c09b594cb9c/phaseshifts-0.1.4-dev.win32.tar.gz" }, { "comment_text": "built for Windows-7", "digests": { "md5": "8c391909d27af2aa2019d8eb166f9af2", "sha256": "ea3d6e505ec575fb8f30cdfa79a408f2bc7e60cd06a35b2570466d98029b8e7c" }, "downloads": -1, "filename": "phaseshifts-0.1.4-dev.win32.zip", "has_sig": false, "md5_digest": "8c391909d27af2aa2019d8eb166f9af2", "packagetype": "bdist_dumb", "python_version": "2.7", "requires_python": null, "size": 552055, "upload_time": "2014-07-23T17:27:04", "url": "https://files.pythonhosted.org/packages/72/7d/f278224ad066ae47bf1810bfbea7e769cf999c949d8ce3e34664df3414b2/phaseshifts-0.1.4-dev.win32.zip" }, { "comment_text": "", "digests": { "md5": "3a8e1c2b3a26dfa5f9efafab853c4a09", "sha256": "c958586d1c82d0a050b907004c5f74b123a191b6040144879ead4d6b46516c8d" }, "downloads": -1, "filename": "phaseshifts-0.1.4-dev.zip", "has_sig": false, "md5_digest": "3a8e1c2b3a26dfa5f9efafab853c4a09", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2780660, "upload_time": "2014-07-23T17:26:50", "url": "https://files.pythonhosted.org/packages/b7/70/194143a24ad064d61ccccc60794f7275bcc512d2f846b49dfdd56b6635fc/phaseshifts-0.1.4-dev.zip" } ], "0.1.5-dev": [ { "comment_text": "", "digests": { "md5": "7c479b691c41bbc838ba9fbf9aa10f76", "sha256": "4583e4e468060476fe084205f2e1bc35721fba3313fc78887c64685a03c423c4" }, "downloads": -1, "filename": "phaseshifts-0.1.5_dev-py2.7-win32.egg", "has_sig": false, "md5_digest": "7c479b691c41bbc838ba9fbf9aa10f76", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 551023, "upload_time": "2014-09-04T21:30:45", "url": "https://files.pythonhosted.org/packages/41/c2/5ebe909e105cc54e9db31e48176b442798f434ed12b62d50d1918c680a20/phaseshifts-0.1.5_dev-py2.7-win32.egg" }, { "comment_text": "", "digests": { "md5": "828ee07faf8bd8ffd4d8651547d11c86", "sha256": "6e11047529ef65dba85fd0263f9b292bbc39e15a40555e96e3714db16fd0395e" }, "downloads": -1, "filename": "phaseshifts-0.1.5-dev.win32-py2.7.exe", "has_sig": false, "md5_digest": "828ee07faf8bd8ffd4d8651547d11c86", "packagetype": "bdist_wininst", "python_version": "2.7", "requires_python": null, "size": 567327, "upload_time": "2014-09-04T21:31:26", "url": "https://files.pythonhosted.org/packages/83/51/b88b79a48e99453fd7ed978ea6ad4f331c36877bf928ef995ad5a1ae8d37/phaseshifts-0.1.5-dev.win32-py2.7.exe" }, { "comment_text": "", "digests": { "md5": "01302e250e4e310faf252395cc4fdc4c", "sha256": "a1f869e03673f4f7b7704fac1bb6b4224c2cf00f6b573b7ef23063bd9ef6848f" }, "downloads": -1, "filename": "phaseshifts-0.1.5-dev.zip", "has_sig": false, "md5_digest": "01302e250e4e310faf252395cc4fdc4c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2814830, "upload_time": "2014-09-04T21:31:17", "url": "https://files.pythonhosted.org/packages/69/c2/d9ba5a61a37208a68a937bfacfb6f8c1b1a0698472e47f6d59b476c4414f/phaseshifts-0.1.5-dev.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "7c479b691c41bbc838ba9fbf9aa10f76", "sha256": "4583e4e468060476fe084205f2e1bc35721fba3313fc78887c64685a03c423c4" }, "downloads": -1, "filename": "phaseshifts-0.1.5_dev-py2.7-win32.egg", "has_sig": false, "md5_digest": "7c479b691c41bbc838ba9fbf9aa10f76", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 551023, "upload_time": "2014-09-04T21:30:45", "url": "https://files.pythonhosted.org/packages/41/c2/5ebe909e105cc54e9db31e48176b442798f434ed12b62d50d1918c680a20/phaseshifts-0.1.5_dev-py2.7-win32.egg" }, { "comment_text": "", "digests": { "md5": "828ee07faf8bd8ffd4d8651547d11c86", "sha256": "6e11047529ef65dba85fd0263f9b292bbc39e15a40555e96e3714db16fd0395e" }, "downloads": -1, "filename": "phaseshifts-0.1.5-dev.win32-py2.7.exe", "has_sig": false, "md5_digest": "828ee07faf8bd8ffd4d8651547d11c86", "packagetype": "bdist_wininst", "python_version": "2.7", "requires_python": null, "size": 567327, "upload_time": "2014-09-04T21:31:26", "url": "https://files.pythonhosted.org/packages/83/51/b88b79a48e99453fd7ed978ea6ad4f331c36877bf928ef995ad5a1ae8d37/phaseshifts-0.1.5-dev.win32-py2.7.exe" }, { "comment_text": "", "digests": { "md5": "01302e250e4e310faf252395cc4fdc4c", "sha256": "a1f869e03673f4f7b7704fac1bb6b4224c2cf00f6b573b7ef23063bd9ef6848f" }, "downloads": -1, "filename": "phaseshifts-0.1.5-dev.zip", "has_sig": false, "md5_digest": "01302e250e4e310faf252395cc4fdc4c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2814830, "upload_time": "2014-09-04T21:31:17", "url": "https://files.pythonhosted.org/packages/69/c2/d9ba5a61a37208a68a937bfacfb6f8c1b1a0698472e47f6d59b476c4414f/phaseshifts-0.1.5-dev.zip" } ] }