Skip to content

Commit 4329e0c

Browse files
committed
update
1 parent 1c02e49 commit 4329e0c

4 files changed

Lines changed: 109 additions & 3 deletions

File tree

.DS_Store

0 Bytes
Binary file not shown.

.github/workflows/links.yml

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
name: Link Check
2+
3+
on:
4+
push:
5+
branches: [main]
6+
paths:
7+
- '**/*.md'
8+
- '.github/workflows/links.yml'
9+
- '.lycheeignore'
10+
- 'lychee.toml'
11+
pull_request:
12+
paths:
13+
- '**/*.md'
14+
- '.github/workflows/links.yml'
15+
- '.lycheeignore'
16+
- 'lychee.toml'
17+
schedule:
18+
- cron: '0 3 * * 1' # weekly, Monday 03:00 UTC
19+
workflow_dispatch:
20+
21+
permissions:
22+
contents: read
23+
issues: write # needed only by the "auto-issue" step below
24+
25+
jobs:
26+
link-check:
27+
runs-on: ubuntu-latest
28+
steps:
29+
- name: Checkout
30+
uses: actions/checkout@v4
31+
32+
- name: Restore lychee cache
33+
uses: actions/cache@v4
34+
with:
35+
path: .lycheecache
36+
key: cache-lychee-${{ github.sha }}
37+
restore-keys: cache-lychee-
38+
39+
- name: Run lychee
40+
id: lychee
41+
uses: lycheeverse/lychee-action@v2
42+
with:
43+
args: >-
44+
--config lychee.toml
45+
--cache
46+
--max-cache-age 7d
47+
--no-progress
48+
'./**/*.md'
49+
fail: false # don't fail the job; let the issue creator handle it
50+
output: ./lychee-report.md
51+
52+
- name: Create / update issue on failure (scheduled runs only)
53+
if: steps.lychee.outputs.exit_code != '0' && github.event_name == 'schedule'
54+
uses: peter-evans/create-issue-from-file@v5
55+
with:
56+
title: 'Broken links detected by weekly link check'
57+
content-filepath: ./lychee-report.md
58+
labels: |
59+
link-check
60+
documentation
61+
62+
- name: Fail job on PR / push if links broken
63+
if: steps.lychee.outputs.exit_code != '0' && github.event_name != 'schedule'
64+
run: |
65+
echo "Lychee reported broken links. See report:"
66+
cat ./lychee-report.md
67+
exit 1

CITATION.cff

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
cff-version: 1.2.0
2+
message: "If you use this curated list in your research, please cite it as below."
3+
title: "Awesome XRD → Crystal"
4+
abstract: >-
5+
A curated, chronologically organized collection of papers, code, and
6+
datasets on (powder) X-ray diffraction (XRD/PXRD) → crystal structure —
7+
identification, symmetry classification, ab-initio structure determination,
8+
generative modeling, multi-phase decomposition, refinement, and related
9+
machine-learning topics.
10+
type: dataset
11+
authors:
12+
- name: "awesome-xrd2crystal contributors"
13+
website: "https://github.com/Bin-Cao/awesome-xrd2crystal/graphs/contributors"
14+
contact:
15+
- family-names: Cao
16+
given-names: Bin
17+
alias: Bin-Cao
18+
affiliation: "HKUST (Guangzhou)"
19+
repository-code: "https://github.com/Bin-Cao/awesome-xrd2crystal"
20+
url: "https://github.com/Bin-Cao/awesome-xrd2crystal"
21+
license: MIT
22+
keywords:
23+
- PXRD
24+
- crystal structure
25+
- phase identification
26+
- multi-phase decomposition
27+
- Rietveld refinement
28+
- generative models
29+
- machine learning
30+
- materials science
31+
- awesome list
32+
date-released: 2026-06-01

README.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Awesome XRD → Crystal [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
1+
# Awesome XRD → Crystal [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Link Check](https://github.com/Bin-Cao/awesome-xrd2crystal/actions/workflows/links.yml/badge.svg)](https://github.com/Bin-Cao/awesome-xrd2crystal/actions/workflows/links.yml)
22

33
> A curated, chronologically organized collection of papers, code, and datasets on **(powder) X-ray diffraction (XRD/PXRD) → crystal structure** — identification, symmetry classification, ab-initio structure determination, generative modeling, multi-phase decomposition, refinement, and related machine-learning topics.
44
@@ -64,6 +64,13 @@ Within every section, entries are listed **chronologically (oldest → newest)**
6464
</a><br/>
6565
<sub>@Licht0812</sub>
6666
</td>
67+
<td align="center" width="120">
68+
<a href="https://github.com/RaymondZhurm">
69+
<img src="https://github.com/RaymondZhurm.png?size=96" width="72" alt="Ruiming Zhu"/><br/>
70+
<sub><b>Ruiming Zhu</b></sub>
71+
</a><br/>
72+
<sub>@RaymondZhurm</sub>
73+
</td>
6774
</tr>
6875
</table>
6976

@@ -558,7 +565,7 @@ Listed chronologically. *(Reference databases (RRUFF, COD, Materials Project, IC
558565

559566
- **Materials Project / MP-20 / MP-PXRD**<https://next-gen.materialsproject.org/> · MP-20: <https://github.com/txie-93/cdvae/tree/main/data/mp_20> · MP-20-PXRD: <https://github.com/gabeguo/cdvae_xrd>
560567
- **Crystallography Open Database (COD)**<http://www.crystallography.net/cod/> (~500 k CIFs; free alternative to ICSD).
561-
- **JARVIS-DFT XRD**<https://jarvis.nist.gov/jarvisxrd/> (simulated XRD over JARVIS-DFT structures; used by DiffractGPT).
568+
- **JARVIS-DFT XRD**JARVIS-DFT structure hub: <https://jarvis.nist.gov/jarvisdft> · interactive XRD-to-structure app (DiffractGPT backend): <https://jarvis.nist.gov/jxrd>
562569
- **ICSD**<https://icsd.fiz-karlsruhe.de/> (licensed inorganic structures; common training source for Park 2017, Lee 2020, Schopmans 2023).
563570
- **CSD**<https://www.ccdc.cam.ac.uk/structures/> (licensed organic / metal-organic structures; used by DeepLPnet 2021 alongside ICSD).
564571
- **PDF-4+ / ICDD PDF**<https://www.icdd.com/> (commercial Powder Diffraction File; experimental benchmark for Crystalyze, XRDSol, RealPXRD-Solver).
@@ -570,7 +577,7 @@ Listed chronologically. *(Reference databases (RRUFF, COD, Materials Project, IC
570577
- **pymatgen XRDCalculator** — Python simulation of PXRD from CIF. <https://pymatgen.org/pymatgen.analysis.diffraction.html>
571578
- **GSAS-II** — Open-source Rietveld refinement and structure determination (used by PXRDGen, RAPID, AlphaDiffract, etc.). Home: <https://advancedphotonsource.github.io/GSAS-II-tutorials/> · source: <https://github.com/AdvancedPhotonSource/GSAS-II> · docs: <https://gsas-ii.readthedocs.io/>
572579
- **FullProf** — Classical Rietveld suite. <https://www.ill.eu/sites/fullprof/>
573-
- **TOPAS-Academic** — Macro-language Rietveld engine. <http://www.topas-academic.net/>
580+
- **TOPAS-Academic** — Macro-language Rietveld engine by Alan Coelho (v8, 2025). <https://topas-academic.com/> · community wiki & tutorials (Durham): <https://topas.webspace.durham.ac.uk/>
574581
- **diffpy-cmi / PDFfit2** — Pair distribution function modeling. <https://www.diffpy.org/>
575582
- **xrdpattern** — Python package shipped with opXRD for unified PXRD I/O and curation. <https://github.com/aimat-lab/xrdpattern>
576583
- **pysimxrd** — Domain-specific Python simulator behind SimXRD-4M; models peak broadening, lattice perturbation, instrumental and orientation effects. <https://pypi.org/project/pysimxrd/> · source: <https://github.com/Bin-Cao/SimXRD>

0 commit comments

Comments
 (0)