Laue

The .laue file format

A Laue document is a crystal, a tiling or a quasicrystal in UTF-8 JSON, described the way a crystallographer would write it down: a group, a cell and the sites of the asymmetric unit. Laue and Laue Plan read and write it on Mac, iPad and Windows; anyone may read and write it too. This page is the specification of version 1; the machine-readable form is the JSON Schema laue-1.schema.json.

A first example

{
  "format": "laue",
  "version": 1,
  "kind": "crystal",
  "title": "Rock salt (NaCl)",
  "group": "Fm-3m",
  "cell": { "a": 5.6402 },
  "sites": [
    { "label": "Na1", "element": "Na", "position": ["0", "0", "0"] },
    { "label": "Cl1", "element": "Cl", "position": ["1/2", "1/2", "1/2"] }
  ]
}

Two sites are enough: the group gives the four sodium and four chlorine atoms of the cell. A file never lists every atom — readers apply the symmetry.

Principles

Members

MemberForMeaning
format, versionallAlways "laue" and 1.
kindall"crystal", "tiling" or "quasicrystal".
title, summaryallTexts; translations gives them in other languages, by language code.
groupcrystal, tilingA space group in any of its 530 settings — Hermann-Mauguin symbol ("P 1 21/c 1", "Fd-3m:2"), number and setting ("227:1") or Hall symbol ("Hall: -P 2ybc") — or a plane group ("p4gm", "p4g", "4*2") or a frieze group ("frieze p2mg"), or a rosette ("rosette D8", "rosette C5": n rotations, with or without n mirrors, n ≤ 24), whose sites and strokes are Cartesian coordinates around the centre, the figure's radius being 1.
cellcrystal, tilinga, b, c in ångström (a tiling uses a = 1), alpha, beta, gamma in degrees.
sitescrystal, tilingThe asymmetric unit: a unique label, fractional position (three or two coordinates, as text), and element for a crystal. A tiling's motif may be a shape, a glyph (a character) or an image (PNG, base64), with color, size (in units of a) and rotation (degrees).
strokestilingLines drawn in one cell, repeated by the group: points in fractional coordinates, color, width; optionally style (dashed, dotted or powder, coloured sand) and, for powder, spread, the fall radius in line widths.
colouring, secondColortilingA two-colour group: one digit per generator of the group, then a and b, 1 where the operation exchanges the colours.
backgroundtiling, quasicrystalThe colour behind the pattern, "#RRGGBB".
backdroptilingA photograph under the pattern (JPEG, base64), its centre, width, turn and opacity.
quasicrystalquasicrystaltiling (penrose, ammannBeenker, dodecagonal), the grid offsets, method (grids or inflation), generations; or a pointSet, the k-free points of a square or triangular lattice. The look of the tiles: tiles, keyed by the acute angle of each kind ("36", "72"…), each with a color and lines (strokes) and motifs drawn in the tile’s own coordinates (s, t), from its origin (for Penrose the corner the matching rules single out) along its two edges taken anticlockwise, so that every tile of the kind carries them turned with it; edgeColor and edgeWidth (0 hides the edges).
viewscrystalViews saved for a presentation: camera frame, zoom, what is shown.
exerciseallSteps for the Tutor, each with a prompt, hints and a check the app verifies (a site on a Wyckoff position, a multiplicity, a site symmetry, the group, the crystal or Laue class, Z, a density, a spacing d, an angle 2θ, the first powder lines, a coordination…), what to hide meanwhile, its audience (design, teaching, science) and its theme.
checkscrystal, tilingExpected multiplicities, site symmetries, atoms in the cell and distances, verified by Laue's tests.

Validating a file

Any JSON Schema validator for draft 2020-12 checks a file against laue-1.schema.json. The schema checks the form; that a position is consistent with the group, or a cell with its crystal system, is for the reader to verify — Laue reports it when it opens the file.

Other formats

Laue also reads and writes the formats of the field, to move a structure to and from other programs: CIF, SHELX (.ins, .res) and POSCAR (VASP); it writes extended XYZ, PDB, and the net of a tiling or a crystal as CGD for Systre and RCSR.