diffpy.structure


Namediffpy.structure JSON
Version 3.1.0 PyPI version JSON
download
home_pagehttps://github.com/diffpy/diffpy.structure
SummaryCrystal structure container and parsers for structure formats.
upload_time2022-12-06 10:38:49
maintainerPavol Juhas
docs_urlNone
authorSimon J.L. Billinge group
requires_python
licenseBSD-style license
keywords crystal structure data storage cif pdb
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage
            .. image:: https://travis-ci.org/diffpy/diffpy.structure.svg?branch=master
   :target: https://travis-ci.org/diffpy/diffpy.structure

.. image:: https://codecov.io/gh/diffpy/diffpy.structure/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/diffpy/diffpy.structure


diffpy.structure
========================================================================

storage and manipulation of crystal structure data

The diffpy.structure package provides objects for storing atomic
coordinates, displacement parameters and other crystal structure data.
diffpy.structure supports import and export of structure data in several
structure formats such as CIF, PDB, and xyz.  It provides conversion
between fractional and absolute Cartesian coordinates, functions for
symmetry expansion of atom sites in the asymmetric unit and generation
of symmetry constraints for atom positions and displacement parameters.
diffpy.structure includes definitions of all space groups in over 500
symmetry settings.

To learn more about diffpy.structure library see the
user manual at http://diffpy.github.io/diffpy.structure.


REQUIREMENTS
------------------------------------------------------------------------

The diffpy.structure package requires Python 3.7 or later or 2.7 and
the following software:

* ``setuptools`` - software distribution tools for Python
* ``NumPy`` - numerical mathematics and fast array operations for Python

We recommend to use `Anaconda Python <https://www.anaconda.com/download>`_
as it allows to install all software dependencies together with
diffpy.structure.  For other Python distributions it is necessary to
install the required software separately.  As an example on Ubuntu
Linux the required software can be installed with ::

   sudo aptitude install python3-setuptools python3-numpy

diffpy.structure also uses the
`PyCifRW <https://bitbucket.org/jamesrhester/pycifrw>`_
library, which is automatically deployed during the
installation process.


INSTALLATION
------------------------------------------------------------------------

The preferred method is to use Anaconda Python and install from the
"diffpy" channel of Anaconda packages ::

   conda config --add channels diffpy
   conda install diffpy.structure

diffpy.structure is also included in the "diffpy-cmi" collection
of packages for structure analysis ::

   conda install diffpy-cmi

Another installation option is to use ``easy_install`` to download and
install the latest release from
`Python Package Index <https://pypi.python.org>`_ ::

   easy_install diffpy.structure

If you prefer to install from sources, navigate to the source archive
directory and run ::

   python setup.py install

You may need to use ``sudo`` with system Python so it is allowed to
copy files to system directories.  If sudo is not available, check
the usage info from ``python setup.py install --help`` for options to
install to user-writable locations.  The installation integrity can be
verified by changing to the HOME directory and running ::

   python -m diffpy.structure.tests.run


DEVELOPMENT
------------------------------------------------------------------------

diffpy.structure is an open-source software developed as a part of the
DiffPy-CMI complex modeling initiative at the Brookhaven National
Laboratory.  The diffpy.structure sources are hosted at
https://github.com/diffpy/diffpy.structure.

Feel free to fork the project and contribute.  To install diffpy.structure
in a development mode, where the sources are directly used by Python
rather than copied to a system directory, use ::

   python setup.py develop --user


ACKNOWLEDGEMENT
------------------------------------------------------------------------

Space group codes in *spacegroupmod.py* and *mmlibspacegroups.py*
originate from the pymmlib project, http://pymmlib.sourceforge.net.


CONTACTS
------------------------------------------------------------------------

For more information on diffpy.structure please visit the project web-page

http://www.diffpy.org/

or email Prof. Simon Billinge at sb2896@columbia.edu.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/diffpy/diffpy.structure",
    "name": "diffpy.structure",
    "maintainer": "Pavol Juhas",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "pavol.juhas@gmail.com",
    "keywords": "crystal structure data storage CIF PDB",
    "author": "Simon J.L. Billinge group",
    "author_email": "sb2896@columbia.edu",
    "download_url": "https://files.pythonhosted.org/packages/a3/a4/95f681c6432d23df9e7d6284e2650624e1f49bc46c76b253d1c20edada16/diffpy.structure-3.1.0.tar.gz",
    "platform": null,
    "description": ".. image:: https://travis-ci.org/diffpy/diffpy.structure.svg?branch=master\n   :target: https://travis-ci.org/diffpy/diffpy.structure\n\n.. image:: https://codecov.io/gh/diffpy/diffpy.structure/branch/master/graph/badge.svg\n   :target: https://codecov.io/gh/diffpy/diffpy.structure\n\n\ndiffpy.structure\n========================================================================\n\nstorage and manipulation of crystal structure data\n\nThe diffpy.structure package provides objects for storing atomic\ncoordinates, displacement parameters and other crystal structure data.\ndiffpy.structure supports import and export of structure data in several\nstructure formats such as CIF, PDB, and xyz.  It provides conversion\nbetween fractional and absolute Cartesian coordinates, functions for\nsymmetry expansion of atom sites in the asymmetric unit and generation\nof symmetry constraints for atom positions and displacement parameters.\ndiffpy.structure includes definitions of all space groups in over 500\nsymmetry settings.\n\nTo learn more about diffpy.structure library see the\nuser manual at http://diffpy.github.io/diffpy.structure.\n\n\nREQUIREMENTS\n------------------------------------------------------------------------\n\nThe diffpy.structure package requires Python 3.7 or later or 2.7 and\nthe following software:\n\n* ``setuptools`` - software distribution tools for Python\n* ``NumPy`` - numerical mathematics and fast array operations for Python\n\nWe recommend to use `Anaconda Python <https://www.anaconda.com/download>`_\nas it allows to install all software dependencies together with\ndiffpy.structure.  For other Python distributions it is necessary to\ninstall the required software separately.  As an example on Ubuntu\nLinux the required software can be installed with ::\n\n   sudo aptitude install python3-setuptools python3-numpy\n\ndiffpy.structure also uses the\n`PyCifRW <https://bitbucket.org/jamesrhester/pycifrw>`_\nlibrary, which is automatically deployed during the\ninstallation process.\n\n\nINSTALLATION\n------------------------------------------------------------------------\n\nThe preferred method is to use Anaconda Python and install from the\n\"diffpy\" channel of Anaconda packages ::\n\n   conda config --add channels diffpy\n   conda install diffpy.structure\n\ndiffpy.structure is also included in the \"diffpy-cmi\" collection\nof packages for structure analysis ::\n\n   conda install diffpy-cmi\n\nAnother installation option is to use ``easy_install`` to download and\ninstall the latest release from\n`Python Package Index <https://pypi.python.org>`_ ::\n\n   easy_install diffpy.structure\n\nIf you prefer to install from sources, navigate to the source archive\ndirectory and run ::\n\n   python setup.py install\n\nYou may need to use ``sudo`` with system Python so it is allowed to\ncopy files to system directories.  If sudo is not available, check\nthe usage info from ``python setup.py install --help`` for options to\ninstall to user-writable locations.  The installation integrity can be\nverified by changing to the HOME directory and running ::\n\n   python -m diffpy.structure.tests.run\n\n\nDEVELOPMENT\n------------------------------------------------------------------------\n\ndiffpy.structure is an open-source software developed as a part of the\nDiffPy-CMI complex modeling initiative at the Brookhaven National\nLaboratory.  The diffpy.structure sources are hosted at\nhttps://github.com/diffpy/diffpy.structure.\n\nFeel free to fork the project and contribute.  To install diffpy.structure\nin a development mode, where the sources are directly used by Python\nrather than copied to a system directory, use ::\n\n   python setup.py develop --user\n\n\nACKNOWLEDGEMENT\n------------------------------------------------------------------------\n\nSpace group codes in *spacegroupmod.py* and *mmlibspacegroups.py*\noriginate from the pymmlib project, http://pymmlib.sourceforge.net.\n\n\nCONTACTS\n------------------------------------------------------------------------\n\nFor more information on diffpy.structure please visit the project web-page\n\nhttp://www.diffpy.org/\n\nor email Prof. Simon Billinge at sb2896@columbia.edu.\n",
    "bugtrack_url": null,
    "license": "BSD-style license",
    "summary": "Crystal structure container and parsers for structure formats.",
    "version": "3.1.0",
    "project_urls": {
        "Homepage": "https://github.com/diffpy/diffpy.structure"
    },
    "split_keywords": [
        "crystal",
        "structure",
        "data",
        "storage",
        "cif",
        "pdb"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a3a495f681c6432d23df9e7d6284e2650624e1f49bc46c76b253d1c20edada16",
                "md5": "c7e3b4f7ec7f693dd8a2dc7063255005",
                "sha256": "a8d6dee028ed864ca01a395212ace090734ee17cebf988f635333c619312db87"
            },
            "downloads": -1,
            "filename": "diffpy.structure-3.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "c7e3b4f7ec7f693dd8a2dc7063255005",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 136618,
            "upload_time": "2022-12-06T10:38:49",
            "upload_time_iso_8601": "2022-12-06T10:38:49.577840Z",
            "url": "https://files.pythonhosted.org/packages/a3/a4/95f681c6432d23df9e7d6284e2650624e1f49bc46c76b253d1c20edada16/diffpy.structure-3.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-12-06 10:38:49",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "diffpy",
    "github_project": "diffpy.structure",
    "travis_ci": true,
    "coveralls": true,
    "github_actions": false,
    "lcname": "diffpy.structure"
}
        
Elapsed time: 0.24183s