File: README.md

package info (click to toggle)
napari 0.6.6-3
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 12,036 kB
  • sloc: python: 112,264; xml: 72; makefile: 44; sh: 5
file content (41 lines) | stat: -rw-r--r-- 1,632 bytes parent folder | download
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.