Metadata-Version: 2.1
Name: DuSC_explorer
Version: 1.1.1
Summary: Graphical user interface to view Dual Space Crystallography data from the 4D Camera of the Molecular Foundry.
Author-email: Peter Ercius <percius@lbl.gov>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: stempy >=3.0
Requires-Dist: pyqtgraph >=0.13
Requires-Dist: tifffile
Requires-Dist: h5py >=2.9.0
Requires-Dist: numpy
Requires-Dist: qtpy
Requires-Dist: numba >=0.56
Requires-Dist: PyQt5

# Dual Space Crystallography Explorer (DuSC_explorer)

A graphical user interface based on stempy and pyqtgraph to visualize sparse 4D-STEM data sets.

# Installation

## Using `pip`

The easiest way to install is to use python's pip command:

 - (Optional) Set up a virtual environment (e.g. using conda)
 - Run `$ pip install DuSC_explorer` at a command prompt

## From source

If you want to develop or get the newest changes:

 - Clone the repository using git.
 - Change directories to the base directory containing the `pyproject.toml` file
 - Install locally and editable using ``bash $ pip install -e .``

# Compatibility

This program requires pyqtgraph >=0.13. You may also need to install different versions of QT depending on your operating system. Python 3.9 and PyQt6 have been tested to work as specified in the table on the [pyqtgaph Github README](https://github.com/pyqtgraph/pyqtgraph?tab=readme-ov-file#requirements)

# Running the program

If you installed using pip or from source (see above) then you can run

``$ DuSC_explorer``

in a terminal or command prompt in the correct virtual environment and the GUI should start.

Alternatively, in a python interpreter for the correct environment you can run these commands to start the GUI:

```python
>>> import DuSC_explorer
>>> DuSC_explorer.open_file()
```

![GUI example](images/dusc_explorer2.png)
