1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41
|
# Slicing examples
The examples in this directory are for developers to test various aspects
of layer slicing. These are primarily designed to aid in the async effort ([NAP 4](../../../docs/naps/4-async-slicing.md)).
## Examples
Examples using [pooch](https://pypi.org/project/pooch/) will cache data locally, with an [OS-dependant path](https://www.fatiando.org/pooch/latest/api/generated/pooch.os_cache.html?highlight=cache#pooch.os_cache).
### Examples of desirable behavior
These are a set of examples which are easy and non-frustrating to interact in napari
without async support. We want to ensure that these examples continue to be performant.
* ebi_empiar_3D_with_labels.py [EMPIAR-10982](https://www.ebi.ac.uk/empiar/EMPIAR-10982/)
* Real-world image & labels data (downloaded locally)
* points_example_smlm.py
* Real-world points data (downloaded locally)
Additional examples from the main napari examples:
* add_multiscale_image.py
* Access to in-memory multi-scale data
### Examples of undesirable behavior
These are a set of examples which currently cause undesirable behavior in napari, typically
resulting in non-responsive user interface due to synchronous slicing on large or remote data.
* random_shapes.py
* A large number of shapes to stress slicing on a shapes layer
* random_points.py
* A large number of random points to stress slicing on a points layer
* janelia_s3_n5_multiscale.py
* Multi-scale remote image data in zarr format
## Performance monitoring
The [perfmon](../../../tools/perfmon/README.md) tooling can be used to monitor the data
access performance on these examples.
|