Skip to main content

Python code for generation of crystal structures based on symmetry constraints.

Project description

PyXtal

Documentation Status Test Status Download Status Download Status Downloads DOI Gitter

Table of content

Introduction

PyXtal is an open source Python package which was initiated by Qiang Zhu and Scott Fredericks at department of Physics and Astronomy, University of Nevada Las Vegas. The goal of PyXtal is to develop a fundamental library to allow one to design the material structure with a certain symmetry constraint. These structures can exported to various structural formats for further study. See the documentation for more information.

To contribute to this project, please check How to contribute?.

Quick Start

Current Features

  • Generation of atomic structures for a given symmetry and stoichiometry (0-3D)
  • Generation of molecular crystals (1-3D) with the support of special Wyckoff positions.
  • Structure manipulation via subgroup/supergroup symmetry relation
  • Geometry optimization from built-in and external optimization methods.
  • Internal support of cif file and many other formats via pymatgen or ASE.
  • Easy access to symmetry information (e.g., Wyckoff, site symmetry and international symbols).
  • X-ray diffraction analysis and its online application

Installation

To install the code, one just needs to do

pip install pyxtal

or

pip install --upgrade git+https://github.com/qzhu2017/PyXtal.git@master

Citation

Fredericks S, Parrish K, Sayre D, Zhu Q*(2020) PyXtal: a Python Library for Crystal Structure Generation and Symmetry Analysis. [arXiv link]

@article{pyxtal,
title = "PyXtal: A Python library for crystal structure generation and symmetry analysis",
journal = "Computer Physics Communications",
volume = "261",
pages = "107810",
year = "2021",
issn = "0010-4655",
doi = "https://doi.org/10.1016/j.cpc.2020.107810",
url = "http://www.sciencedirect.com/science/article/pii/S0010465520304057",
author = "Scott Fredericks and Kevin Parrish and Dean Sayre and Qiang Zhu",
}

How to contribute?

This is an open-source project. Its growth depends on the community. To contribute to PyXtal, you don't necessarily have to write the code. Any contributions from the following list will be helpful.

  • Star on GitHub the PyXtal project and recommend it to your colleagues/friends
  • Open an GitHub issues to report the bug or address your wishlist or improve our documentation
  • GitHub forks the repository and send us the pull request

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyxtal-0.5.0.tar.gz (2.5 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pyxtal-0.5.0-py3.7.egg (2.9 MB view details)

Uploaded Egg

pyxtal-0.5.0-py3-none-any.whl (2.7 MB view details)

Uploaded Python 3

File details

Details for the file pyxtal-0.5.0.tar.gz.

File metadata

  • Download URL: pyxtal-0.5.0.tar.gz
  • Upload date:
  • Size: 2.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.12

File hashes

Hashes for pyxtal-0.5.0.tar.gz
Algorithm Hash digest
SHA256 f925b0bcd6e6ffef7c2b2ed30ff491e1b536e797e5ac0927765caa03076d15b8
MD5 d615dde37c22a6dc64702f0b1072c257
BLAKE2b-256 b1ef1d16337b313536e5e84b88c7babed959c3a4f45df63182a673797431afc0

See more details on using hashes here.

File details

Details for the file pyxtal-0.5.0-py3.7.egg.

File metadata

  • Download URL: pyxtal-0.5.0-py3.7.egg
  • Upload date:
  • Size: 2.9 MB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.12

File hashes

Hashes for pyxtal-0.5.0-py3.7.egg
Algorithm Hash digest
SHA256 96363fff014bdde10b578099ea6c1debd1aa4e9f841f88f2a0ccc3201c032d20
MD5 49290bfd53f54e7d175b4b59d35f146a
BLAKE2b-256 b9786e4eb7426d5a97746c9bb73ba1621ca8ace2b685f661d5c4ac0fc7d71357

See more details on using hashes here.

File details

Details for the file pyxtal-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: pyxtal-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 2.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.12

File hashes

Hashes for pyxtal-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 633a4f346321b5da0f9ac958604768b4987b2e5e57c152871a5f1764c95ea71b
MD5 422971a2b9792da9852bed4e1a63a8f3
BLAKE2b-256 3a516d918103d124f8970cff7141f8f1da7dd5b4b5bad9139f25e8ef89f787d8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page