---
title: "deCIFer User Guide"
description: "High-level guide for using deCIFer in Ouro, with embedded starter PXRD example files."
url: "https://ouro.foundation/posts/mmoderwell/decifer-user-guide"
id: "019cd915-f18b-760f-8027-3ea2c42ffd4e"
type: "post"
---

# deCIFer User Guide

Post by @mmoderwell in #materials-science (all) · 2026-03-10

- Asset id: `019cd915-f18b-760f-8027-3ea2c42ffd4e`
- Page: https://ouro.foundation/posts/mmoderwell/decifer-user-guide

deCIFer predicts a candidate crystal structure in CIF format from a powder X-ray diffraction (PXRD) pattern. It is useful when you already have an experimental or simulated diffraction pattern and want a fast starting structure to inspect, compare, or refine.

The model conditions on **Q = 4π sin(θ)/λ** in Å⁻¹, resampled onto 0–10 Å⁻¹. If column 1 of your file is **2θ in degrees**, the route converts it to Q first. Set `x_axis` to `q` or `2theta` when you know the axis. For 2θ files, pass `wavelength` in Å (Cu Kα `1.5406` is the default).

Open the service

> Embedded service: [deCIFer API](https://ouro.foundation/services/fupperlidt/decifer-api)

> Embedded route: [Predict CIF from PXRD](https://ouro.foundation/routes/fupperlidt/predict-cif-from-pxrd)

What to upload

A text-based PXRD file in `.xy` or `.xye` format, with two numeric columns for position and intensity, covering the main peaks of interest.

Helpful inputs:

- `composition`, when you know the chemical formula. This is the most important optional field — without it the model often invents chemistry even when the cell is right.
- `spacegroup`, when you already have a strong symmetry prior.
- `x_axis`: `auto`, `q`, or `2theta`.
- `wavelength`: Å, used for 2θ data.

What you get back

One generated CIF file per run. Treat it as a candidate structure, not a final answer. The app runs asynchronously in Ouro, so the request is accepted first and the CIF appears after the run completes.

Quick start

1. Open the deCIFer service.
2. Upload a PXRD file.
3. Add a composition prompt if you know it.
4. Set `x_axis` to `2theta` and `wavelength` if the file is in degrees.
5. Submit the run.
6. Review the returned CIF as a candidate structure, not a final answer.

Example files

These uploaded files are good starting points for first runs.

Si.xy — already Q-space. Suggested composition prompt: `Si`

> Embedded file: [Si.xy](https://ouro.foundation/files/mmoderwell/sixy)

Fe2O3.xy — **2θ** (about 5–80°). Suggested composition prompt: `Fe2O3`

> Embedded file: [Fe2O3.xy](https://ouro.foundation/files/mmoderwell/fe2o3xy)

CrystallineCeO2.xye — already Q-space. Suggested composition prompt: `Ce4O8`

> Embedded file: [CrystallineCeO2.xye](https://ouro.foundation/files/mmoderwell/crystallineceo2xye)

Tips for better results

- Start with the composition prompt when you know it.
- Set `x_axis` explicitly when you know whether column 1 is Q or 2θ.
- Only add a space group prompt when you have a strong prior.
- Use a few trials (`n_trials=3` or more). The published experimental protocol draws many samples.
- Compare the generated CIF against known phases, symmetry expectations, and peak positions.

Practical note

deCIFer is best used as a structure proposal tool. Experimental validation and downstream refinement are still important before treating the output as a final structure solution. `q_min_crop` / `q_max_crop` are Q bounds in Å⁻¹, applied after any 2θ conversion.

## Assets in this post

- [deCIFer API](https://ouro.foundation/services/fupperlidt/decifer-api) (service, id `efe09c61-b84c-4b60-a0b0-ec9e82f3a64b`)
- [Predict CIF from PXRD](https://ouro.foundation/routes/fupperlidt/predict-cif-from-pxrd) (route, id `ff5d5921-5cc5-4a5f-8322-4f25cc3cd460`)
- [Si.xy](https://ouro.foundation/files/mmoderwell/sixy) (file, id `97663226-45c2-44a3-a851-2ba2a32de507`)
- [Fe2O3.xy](https://ouro.foundation/files/mmoderwell/fe2o3xy) (file, id `f13740b2-6024-40ac-bf51-475cae3b6ad8`)
- [CrystallineCeO2.xye](https://ouro.foundation/files/mmoderwell/crystallineceo2xye) (file, id `ada3ec1e-9ebb-4ad9-bc5e-52931eeeb036`)
