12 releases
0.4.0 | Nov 21, 2022 |
---|---|
0.3.9 | Nov 10, 2020 |
0.3.7 | Oct 26, 2020 |
0.3.4 | Jul 20, 2020 |
0.2.0 | Oct 24, 2018 |
#896 in Science
28 downloads per month
120KB
3K
SLoC
n5gest
CLI utilities for working with N5 files.
Written in Rust using the Rust N5 crate.
$ cargo install n5gest
$ n5gest -h
n5gest = "0.4.0"
Andrew Champion <andrew.champion@gmail.com>
Utilities for N5 files.
USAGE:
n5gest [OPTIONS] <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-t, --threads <threads> Number of threads for parallel processing. By default, the number of CPU
cores is used.
SUBCOMMANDS:
bench-read Benchmark reading an entire dataset.
cast Cast an existing dataset into a new dataset with a given data type.
crop-blocks Crop wrongly sized blocks to match dataset dimensions at the end of a given axis.
delete-uniform-blocks
Delete blocks uniformly filled with a given value, such as empty blocks.
export Export a sequence of image files from a series of z-sections.
help Prints this message or the help of the given subcommand(s)
import Import a sequence of image files as a series of z-sections into a 3D N5 dataset.
import-tiff Import a single file TIFF stack as a series of z-sections into a 3D N5 dataset
ls List all datasets under an N5 root.
map Run simple math expressions mapping values to new datasets. For example, to clip
values in a dataset: `map example.n5 dataset_in example.n5 dataset_out "min(128, x)"`
Note that this converts back and forth to `f64` for the calculation.
map-fold Run simple math expressions as folds over blocks. For example, to find the
maximum value in a positive dataset: `map-fold example.n5 dataset 0 "max(acc, x)"`
recompress Recompress an existing dataset into a new dataset with a given compression.
slice-img Export a 2D subslice of an ND dataset to an image file. For exporting sequences of
images see `export`
stat Retrieve metadata about the number of blocks that exists and their timestamps.
validate-blocks Report malformed blocks.
Installation options:
- Compile and install using cargo:
cargo install n5gest
- Download a precompiled binary from the latest GitHub releases
- Install a precompiled binary using cargo-binstall:
cargo binstall n5gest
Development
Version bumping (including changelog release section versioning) is handled by cargo-release, e.g.:
cargo release --dev-version minor
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~16–26MB
~340K SLoC