{"name":"blik","display_name":"blik","visibility":"public","icon":"","categories":[],"schema_version":"0.2.1","on_activate":null,"on_deactivate":null,"contributions":{"commands":[{"id":"blik.read_files","title":"Open files with blik","python_name":"blik.reader:get_reader","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.sample_hiv_dataset","title":"Open sample HIV VLPs dataset","python_name":"blik.remote_data:load_hiv_dataset","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_image","title":"Save image data with blik","python_name":"blik.writer:write_image","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_labels","title":"Save labels data with blik","python_name":"blik.writer:write_image","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_particles_relion_30","title":"Save particles data with blik (relion 3.0)","python_name":"blik.writer:write_particles_relion_30","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_particles_relion_31","title":"Save particles data with blik (relion 3.1)","python_name":"blik.writer:write_particles_relion_31","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_particles_relion_40","title":"Save particles data with blik (relion 4.0)","python_name":"blik.writer:write_particles_relion_40","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_particles_dynamo","title":"Save particles data with blik (relion 4.0)","python_name":"blik.writer:write_particles_dynamo","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_surface_picks","title":"Save surface picks data with blik","python_name":"blik.writer:write_surface_picks","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.write_surface","title":"Save surface data with blik","python_name":"blik.writer:write_surface","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.main_widget","title":"Open blik main widget","python_name":"blik.widgets.main_widget:MainBlikWidget","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.surface_picking","title":"Open blik surface picking widget","python_name":"blik.widgets.picking:SurfaceWidget","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.sphere_picking","title":"Open sphere picking widget","python_name":"blik.widgets.picking:SphereWidget","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.filament_picking","title":"Open blik filament picking widget","python_name":"blik.widgets.picking:FilamentWidget","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.rotate_particles","title":"Open blik rotate particles widget","python_name":"blik.widgets.picking:rotate_particles","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.file_reader_widget","title":"Open blik file reader widget","python_name":"blik.widgets.file_reader:file_reader","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.bandpass_filter","title":"Open blik bandpass filter widget","python_name":"blik.widgets.filter:bandpass_filter","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.gaussian_filter","title":"Open blik gaussian filter widget","python_name":"blik.widgets.filter:gaussian_filter","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"blik.power_spectrum","title":"Open blik power spectrum widget","python_name":"blik.widgets.power_spectrum:power_spectrum","short_title":null,"category":null,"icon":null,"enablement":null}],"readers":[{"command":"blik.read_files","filename_patterns":["*.mrc","*.mrcs","*.st","*.map","*.hdf","*.em","*.star","*.tbl","*.box","*.cbox","*.picks","*.surf","*.rec"],"accepts_directories":false}],"writers":[{"command":"blik.write_image","layer_types":["image"],"filename_extensions":[".mrc",".mrcs",".st",".rec"],"display_name":"image"},{"command":"blik.write_labels","layer_types":["labels"],"filename_extensions":[".mrc",".mrcs",".st"],"display_name":"segmentation"},{"command":"blik.write_particles_relion_30","layer_types":["points+","vectors*"],"filename_extensions":[".star"],"display_name":"particles (relion 3.0)"},{"command":"blik.write_particles_relion_31","layer_types":["points+","vectors*"],"filename_extensions":[".star"],"display_name":"particles (relion 3.1)"},{"command":"blik.write_particles_relion_40","layer_types":["points+","vectors*"],"filename_extensions":[".star"],"display_name":"particles (relion 4.0)"},{"command":"blik.write_particles_dynamo","layer_types":["points+","vectors*"],"filename_extensions":[".tbl"],"display_name":"particles (dynamo tbl)"},{"command":"blik.write_surface_picks","layer_types":["shapes"],"filename_extensions":[".picks"],"display_name":"surface picks"},{"command":"blik.write_surface","layer_types":["surface"],"filename_extensions":[".surf"],"display_name":"surface mesh"}],"widgets":[{"command":"blik.main_widget","display_name":"Blik main widget","autogenerate":false},{"command":"blik.surface_picking","display_name":"Surface picking","autogenerate":false},{"command":"blik.sphere_picking","display_name":"Sphere picking","autogenerate":false},{"command":"blik.filament_picking","display_name":"Filament picking","autogenerate":false},{"command":"blik.rotate_particles","display_name":"Rotate selected particles","autogenerate":false},{"command":"blik.file_reader_widget","display_name":"File reader","autogenerate":false},{"command":"blik.bandpass_filter","display_name":"Bandpass filter","autogenerate":false},{"command":"blik.gaussian_filter","display_name":"Gaussian filter","autogenerate":false},{"command":"blik.power_spectrum","display_name":"Power spectrum","autogenerate":false}],"sample_data":[{"command":"blik.sample_hiv_dataset","key":"blik_hiv_dataset","display_name":"Tomogram and particles of HIV VLPs"}],"themes":null,"menus":{"napari/file/io_utilities":[{"command":"blik.file_reader_widget","when":null,"group":null,"alt":null}],"napari/layers/measure":[{"command":"blik.power_spectrum","when":null,"group":null,"alt":null}],"napari/layers/annotate":[{"command":"blik.main_widget","when":null,"group":null,"alt":null},{"command":"blik.surface_picking","when":null,"group":null,"alt":null},{"command":"blik.sphere_picking","when":null,"group":null,"alt":null},{"command":"blik.filament_picking","when":null,"group":null,"alt":null},{"command":"blik.rotate_particles","when":null,"group":null,"alt":null}],"napari/layers/filter":[{"command":"blik.bandpass_filter","when":null,"group":null,"alt":null},{"command":"blik.gaussian_filter","when":null,"group":null,"alt":null}]},"submenus":null,"keybindings":null,"configuration":[]},"package_metadata":{"metadata_version":"2.4","name":"blik","version":"0.9.2","dynamic":null,"platform":null,"supported_platform":null,"summary":"Python tool for visualising and interacting with cryo-ET and subtomogram averaging data.","description":"![logo](https://github.com/brisvag/blik/raw/main/docs/images/logo.png)\n\n# blik\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10090438.svg)](https://zenodo.org/doi/10.5281/zenodo.10090438)\n[![Paper DOI](https://zenodo.org/badge/DOI/10.1371/journal.pbio.3002447.svg)](https://doi.org/10.1371/journal.pbio.3002447)\n[![License](https://img.shields.io/pypi/l/blik.svg?color=green)](https://github.com/brisvag/blik/raw/main/LICENSE)\n[![PyPI](https://img.shields.io/pypi/v/blik.svg?color=green)](https://pypi.org/project/blik)\n[![Python Version](https://img.shields.io/pypi/pyversions/blik.svg?color=green)](https://python.org)\n[![CI](https://github.com/brisvag/blik/actions/workflows/ci.yml/badge.svg)](https://github.com/brisvag/blik/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/brisvag/blik/branch/main/graph/badge.svg)](https://codecov.io/gh/brisvag/blik)\n\n\n![blik showcase](https://private-user-images.githubusercontent.com/23482191/361246457-b7447060-7ccd-4a8c-a41c-55c1678bf089.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ2MDQ0OTksIm5iZiI6MTcyNDYwNDE5OSwicGF0aCI6Ii8yMzQ4MjE5MS8zNjEyNDY0NTctYjc0NDcwNjAtN2NjZC00YThjLWE0MWMtNTVjMTY3OGJmMDg5LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MjUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODI1VDE2NDMxOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTRkZTAxMmU0MjViNjA4NTRmMWRlYzRhYmJkYjNkNWRiNjcxZjRjYWI1MWJkYmMxZmFiZjZmNzFhZTE0ODkwY2MmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.ye5hVTZ-yociOCArw2_KSlvde1MZCQuVYH2LQgul4B0)\n\n**`blik`** is a tool for visualising and interacting with cryo-ET and subtomogram averaging data. It leverages the fast, multi-dimensional [napari viewer](https://napari.org) and the scientific python stack.\n\n**DISCLAIMER**: this package is in development phase. Expect bugs and crashes. Please, report them on the issue tracker and ask if anything is unclear!\n\n## Installation\n\nYou can either install `blik` through the [napari plugin system](https://napari.org/plugins/index.html), through pip, or get both napari and blik directly with:\n\n```bash\npip install \"blik[all]\"\n```\n\nThe `[all]` qualifier also installs `pyqt5` as the napari GUI backend, and a few additional napari plugins that you might find useful in your workflow:\n- [napari-properties-plotter](https://github.com/brisvag/napari-properties-plotter)\n- [napari-properties-viewer](https://github.com/kevinyamauchi/napari-properties-viewer)\n- [napari-label-interpolator](https://github.com/brisvag/napari-label-interpolator)\n\n### Nightly build\n\nIf you'd like the most up to date `blik` possible, you can install directly from the `main` branch on github. This also uses napari `main`, so expect some instability!\n\n```\npip install \"git+https://github.com/brisvag/blik.git@main#egg=blik[all]\"\npip install \"git+https://github.com/napari/napari.git@main#egg=napari[all]\"\n```\n\n## Basic Usage\n\nFrom the command line:\n```bash\nnapari -w blik -- /path/to.star /path/to/mrc/files/*\n```\n\nThe `-w blik` is important for proper initialization of all the layers. Always open the main widget open to ensure nothing goes wrong!\n\n*`blik` is just `napari`*. Particles and images are exposed as simple napari layers, which can be analysed and manipulated with simple python, and most importantly other [napari plugins](https://napari-hub.org/).\n\n## Widgets\n\nThe main widget has a few functions:\n\n- `experiment`: quickly switch to a different experiment id (typically, everything related to an individual tomogram such as volume, particles and segmentations)\n- `new`: generate a new `segmentation`, a new manually-picked set of `particles`, or a new `surface`, `sphere`, or `filament picking` for segmentation, particle generation or volume resampling.\n- `add to exp`: add a layer to the currently selected `experiment` (just a shorthand for `layer.metadata['experiment_id'] = current_exp_id`)\n- `slice_thickness`: changes the slicing thickness in all dimensions in napari. Images will be averaged over that thickness, and all particles in the slice will be displayed.\n\nThere are also widgets for picking surfaces, spheres and filaments:\n\n- `surface`: process a previously picked `surface picking` layer to generate a surface mesh and distribute particles on it for subtomogram averaging, or resample a tomogram along the surface.\n- `sphere`: process a previously picked `sphere picking` layer to generate a sphere mesh and distribute particles on it for subtomogram averaging.\n- `filament`: process a previously picked `filament picking` layer to generate a filament and distribute particles on it for subtomogram averaging, or resample a tomogram along the filament.\n\n# References\n\nIf you use `blik`, please cite the repo on zenodo and the paper on Plos Biology: [https://doi.org/10.1371/journal.pbio.3002447](https://doi.org/10.1371/journal.pbio.3002447).\n","description_content_type":"text/markdown","keywords":null,"home_page":null,"download_url":null,"author":null,"author_email":"Lorenzo Gaifas <brisvag@gmail.com>","maintainer":null,"maintainer_email":null,"license":"GPLv3","classifier":["Development Status :: 3 - Alpha","Framework :: napari","License :: OSI Approved :: GNU General Public License v3 (GPLv3)","Natural Language :: English","Programming Language :: Python :: 3","Programming Language :: Python :: 3.9","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Topic :: Scientific/Engineering :: Visualization","Typing :: Typed"],"requires_dist":["cryohub>=0.6.4","cryotypes>=0.2.0","dask","einops","magicgui>=0.4.0","morphosamplers[segment]>=0.0.10","numpy","packaging","pandas","pydantic","scipy","napari-label-interpolator>=0.1.1; extra == 'all'","napari-properties-plotter; extra == 'all'","napari-properties-viewer; extra == 'all'","napari[all]>=0.6.0; extra == 'all'","black; extra == 'dev'","ipython; extra == 'dev'","mypy; extra == 'dev'","napari[all]>=0.6.0; extra == 'dev'","pdbpp; extra == 'dev'","pre-commit; extra == 'dev'","pytest-cov; extra == 'dev'","pytest-qt; extra == 'dev'","pytest>=6.0; extra == 'dev'","rich; extra == 'dev'","ruff; extra == 'dev'","napari[all]>=0.6.0; extra == 'test'","pytest-cov; extra == 'test'","pytest-qt; extra == 'test'","pytest>=6.0; extra == 'test'"],"requires_python":">=3.10","requires_external":null,"project_url":["homepage, https://github.com/brisvag/blik","repository, https://github.com/brisvag/blik"],"provides_extra":["all","dev","test"],"provides_dist":null,"obsoletes_dist":null},"npe1_shim":false}