Metadata-Version: 2.4
Name: PYME-extra
Version: 1.0.4.post0
Summary: Plugins and associated code for PYME
Author: Christian Soeller
Author-email: Christian Soeller <christian.soeller@unibe.ch>
License-Expression: GPL-3.0-or-later
Project-URL: Repository, https://github.com/csoeller/PYME-extra
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: python-microscopy
Requires-Dist: statsmodels
Requires-Dist: roifile
Requires-Dist: colorcet
Requires-Dist: zarr<3,>=2
Requires-Dist: seaborn
Requires-Dist: mrcfile
Requires-Dist: circle-fit
Requires-Dist: alphashape
Provides-Extra: opt
Requires-Dist: openpyxl; extra == "opt"
Requires-Dist: tabulate; extra == "opt"
Dynamic: author
Dynamic: license-file

# README #

Plugins and associated code for PYME (AKA [python-microscopy](https://python-microscopy.org/)).

This is a mixed bag of extensions/additions to standard PYME and also used as a testbed/platform for

* recipe based processing of SMLM data
* implementing I/O for new formats
* new ideas for data processing

### Installation ###

#### PYME-test-env

These days we recommend for any development install of `PYME-extra` the installation as part of a [PYME-test-env](https://github.com/csoeller/PYME-test-env) controlled install. All further details please see there.

#### pip install

For users not interested in following development updates and mainly interested in the stable release for usage as is we now recommend a pip based install:

```
	# possibly install python-microscopy first and check that the install succeeds
	pip install-python-microscopy
	pip install PYME-extra # installation from PyPi
	pymex_install_plugins # register the plugins systemwide
```

#### Installing from source

Still achieved with pip but from the source directory in which you unpacked PYME-extra (typically done when you cloned the git repository). A plain install from source is done with

```
	pip install .
```

A development install can be achieved by requesting an install in "editable mode". When a package is installed in editable mode, edits to the project source code become effective without the need of a new installation step.

```
	pip install --no-build-isolation -e . # install in in “development mode”
```

In either case (plain or development install), you may need to register the various plugins to implement the extra functionality provided by `PYME-extra`. This is achieved with the plugin installer that will have been installed with PYME-extra. You register with the command

```
	pymex_install_plugins
```

By default it registers the plugins systemwide but you can supply the `--user` option to register only for the current user:

```
	pymex_install_plugins --user # for further details see also pymex_install_plugins -h
```

#### Requirements

External modules required for full functionality currently include

    python-microscopy
    statsmodels # for FRC smoothing with the lowess filter
    roifile     # to allow using info from ImageJ/Fiji ROIs
    colorcet    # add some colorcet colour tables in PYME
    circle-fit  # needs pip install to get recent version; for 2D NPC analysis
    alphashape # for cluster area and densities in clusters
    zarr>=2,<3 # for MINFLUX I/O
    seaborn # for some prettier plots
    mrcfile # to output 3D data for FSC from a EM FSC server
    
These should be installed by the `pip` based install automatically.

We also often use a couple more dependencies in notebooks, but strictly speaking no functionality in `PYME-extra` depends directly on these:

    openpyxl
    tabulate

### Issues ###

Note that the showErrs modules rely on a mac installation which uses bash scripts and the [platypus app](https://sveinbjorn.org/platypus) app
to capture STDERR into a temporary file which these modules access. 

Bottom line is that these two error display modules will likely not work on anything but a mac with my PYMEapps wrappers. On other systems they will just generate a message that this functionality is not supported.

The PYME mac app wrappers are available at the [PYME-apps repository](https://github.com/csoeller/PYME-apps).

### Author ###

Christian Soeller
