跳转到主要内容

Crystal Toolkit是Materials Project的一个Web应用程序框架,允许Python

项目描述

Crystal Toolkit

引用

您可以在我们的预印本中了解更多关于Crystal Toolkit的信息,可在此找到

有一个引用.cff文件可用,或BibTeX引用如下

@article{horton2023crystal,
  title={Crystal Toolkit: A Web App Framework to Improve Usability and Accessibility of Materials Science Research Algorithms},
  author={Horton, Matthew and Shen, Jimmy-Xuan and Burns, Jordan and Cohen, Orion and Chabbey, Fran{\c{c}}ois and Ganose, Alex M and Guha, Rishabh and Huck, Patrick and Li, Hamming Howard and McDermott, Matthew and others},
  journal={arXiv preprint arXiv:2302.06147},
  year={2023}
}

如果您使用Crystal Toolkit,无论是用于自己的Web应用程序,还是在工作中包含由Crystal Toolkit生成的图像,请确保适当引用它! 引用是认可Crystal Toolkit开发人员贡献的好方法,并允许我们了解它在社区中的使用情况。

感兴趣于贡献?

可以在此找到当前新贡献者问题的列表。如果您希望分配一个新贡献者问题,请与项目负责人联系!

状态

Tests Visual Regression Test Status Docker Build Status Release pre-commit.ci status arXiv link

安装

pip install crystal-toolkit

文档

文档可在docs.crystaltoolkit.org找到。

示例应用程序

描述        
bandstructure.py
演示了BandstructureAndDosComponent组件的功能
Launch Codespace
basic_hello_structure.py
使用StructureMoleculeComponent显示一个简单的pymatgen结构
Launch Codespace
basic_hello_structure_interactive.py
basic_hello_structure.py添加按钮,以交互式地在两个结构之间切换
Launch Codespace
basic_hello_world.py
裸机示例,展示如何在Dash应用程序中渲染文本“Hello scientist!”
Launch Codespace
diffraction.py
演示了XRayDiffractionComponent组件的功能
Launch Codespace
diffraction_dynamic.py
diffraction.py添加了一个按钮,用于动态加载新结构
Launch Codespace
diffraction_empty.py
显示XRayDiffractionComponent可以在没有传递结构的情况下进行挂载
Launch Codespace
kwarg_inputs.py
展示了布尔输入(又称切换)、矩阵输入和滑动输入组件
Launch Codespace
phase_diagram.py
MPRester.get_entries_in_chemsys()PhaseDiagram组件结合起来,绘制Li-O-Co凸包
Launch Codespace
pourbaix.py
MPRester.get_pourbaix_entries()PourbaixDiagramComponent组件结合起来,绘制Fe-CO Pourbaix图
Launch Codespace
structure.py
展示了StructureMoleculeComponent的多种布局选项
Launch Codespace
structure_magnetic.py
绘制具有磁矩的结构
Launch Codespace
matbench_dielectric_structure_on_hover.py
创建一个与StructureMoleculeComponentDataTable相连的散点图,该图显示结构并突出显示与悬停散点点对应的表格行。
Launch Codespace
matbench_dielectric_datatable_xrd.py
DataTable渲染到与StructureMoleculeComponentXRayDiffractionComponent相连,以便悬停表格行时显示相应的结构和其XRD模式。
Launch Codespace
transformations.py
StructureMoleculeComponentAllTransformationsComponent结合起来,以应用交互式结构变换
Launch Codespace
transformations_minimal.py
显示如何限制允许的变换类型
Launch Codespace
write_structure_screenshot_to_file.py
显示如何将交互式结构视图保存为图像文件
Launch Codespace

团队和贡献政策

Crystal Toolkit 开发团队包括

欢迎新贡献者,请参阅我们的行为准则。如果您是新的贡献者,请在您的Pull Request中修改此README文件,以将您的姓名添加到列表中。

此存储库的未来

Cystal Toolkit存储库是Materials Project采用的模式的对象式Python框架的家园,用于渲染材料科学数据。

为Crystal Toolkit提供动力的自定义Plotly Dash组件现在维护在一个单独的存储库中,以方便开发,以及自定义React组件。这些组件以前包含在Crystal Toolkit存储库中,并且在精神上仍然被认为是Crystal Toolkit的一部分。

还有一些重要问题尚未解决,包括对文档和测试套件的总体改进计划。一些目前为私有代码也计划重新整合到公共Crystal Toolkit库中。

致谢

感谢所有依赖的库的作者和维护者,特别是pymatgen用于晶体学分析,以及来自Plotly的Dash用于他们的Web应用框架。

感谢NERSC Spin服务提供应用托管和他们的技术支持。

联系方式

如有任何疑问,请联系@mkhorton,或在GitHub Issues页面上添加问题。

项目详情


发布历史 发布通知 | RSS订阅

下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

crystal_toolkit-2023.11.3.tar.gz (15.5 MB 查看哈希)

上传时间

构建分布

crystal_toolkit-2023.11.3-py3-none-any.whl (15.9 MB 查看哈希)

上传时间 Python 3

由以下支持