# 4DSTEM Studio

Documentation for 4DSTEM Studio, the native macOS application for 4D-STEM analysis: getting started, data, tutorials, reference and troubleshooting.
<p class="lede">4D-STEM analysis on the Mac: from the open scan to calibrated virtual images, Bragg disks, strain and crystal maps.</p>

## Get started

- [Install](/docs/4dstem-studio/install.html): requirements, download, updating and removing the app.
- [First look](/docs/4dstem-studio/first-look.html): a first virtual image within minutes, with the demo dataset.
- [The window](/docs/4dstem-studio/window.html): where everything is, and the keyboard shortcuts.

## Your data

- [File formats](/docs/4dstem-studio/data/formats.html): what opens, companion files, and what a refusal means.
- [Large datasets](/docs/4dstem-studio/data/large-datasets.html): crop and binning before loading, memory.
- [Sessions](/docs/4dstem-studio/data/sessions.html): how your work is saved beside the dataset.
- [Export](/docs/4dstem-studio/data/export.html): figures, data files and tables.

## Tutorials

The tutorials are being written. They will follow the app's workspaces from top to bottom:

| Workspace | What the tutorial covers |
|---|---|
| Prepare | Inspecting the dataset and calibrating it: origin, distortion, rotation, pixel size |
| Imaging | Virtual bright-field and dark-field images, diffraction from a scan region |
| Bragg Disks | Detecting the disks in every pattern and judging the detection |
| Crystal Maps | Strain, orientation and phases from the detected disks |
| Spectroscopy | EDS spectrum images, alone or beside the 4D scan |
| Results | Reviewing, saving and exporting |

## Reference

Every control of a workspace, under the name the app shows.

- [Prepare](/docs/4dstem-studio/reference/prepare.html): the calibration steps, what each unlocks, and how to read the fits.
- [Imaging](/docs/4dstem-studio/reference/imaging.html): virtual imaging, diffraction from a region, and diffraction groups.
- [Bragg Disks](/docs/4dstem-studio/reference/bragg-disks.html): the probe kernel, the detector, and every detection setting with its default.
- [Strain](/docs/4dstem-studio/reference/strain.html): the reference, the basis, the components and the fit diagnostics.
- [Orientation](/docs/4dstem-studio/reference/orientation.html): the area, the phase model, the quality levels and the display modes.
- [Phase mapping](/docs/4dstem-studio/reference/phase-mapping.html): the phases, the matrix, the matching settings and the evidence.
- [Reconstruction](/docs/4dstem-studio/reference/reconstruction.html): DPC and iDPC, parallax and ptychography, and what each needs.
- [Spectroscopy](/docs/4dstem-studio/reference/spectroscopy.html): EDS maps, elements, regions, quantification and exports.
- [Results](/docs/4dstem-studio/reference/results.html): review, save, compare and export.

## Help

- [Troubleshooting](/docs/4dstem-studio/troubleshooting.html): the app's messages and what to do about each.
- [Support](/support.html): contact and requirements.
