@@ -4,103 +4,31 @@ A Neurodata Without Borders (NWB) extension for storing microscopy data and asso
44
55## Features
66
7- - ** Comprehensive Data Types**
8- - Microscope and optical component metadata
9- - Advanced light path configurations
10- - Imaging space definitions
11- - Time series data with variable depth support
12- - ROI/segmentation storage
13-
14- - ** Multiple Modalities**
15- - One-photon microscopy (widefield)
16- - Two-photon microscopy
17- - Three-photon microscopy
18- - Light sheet microscopy
19-
20- - ** Flexible Organization**
21- - Support for 2D and 3D imaging
22- - Multi-channel data handling
23- - Variable depth imaging
24- - Coordinate system management
25-
26- ## Installation
27-
28- ``` bash
29- pip install ndx-microscopy
30- ```
31- ## Basic Usage
32-
33- ``` python
34- from datetime import datetime
35- from uuid import uuid4
36- from pynwb import NWBFile, NWBHDF5IO
37- from ndx_microscopy import Microscope, ExcitationLightPath, EmissionLightPath
38- from ndx_ophys_devices import Indicator
39-
40- # Create NWB file
41- nwbfile = NWBFile(
42- session_description = ' Two-photon calcium imaging session' ,
43- identifier = str (uuid4()),
44- session_start_time = datetime.now()
45- )
46-
47- # Set up microscope
48- microscope = Microscope(
49- name = ' 2p-scope' ,
50- model = ' Custom two-photon microscope'
51- )
52- nwbfile.add_device(microscope)
53-
54- # Create indicator
55- indicator = Indicator(
56- name = ' gcamp6f' ,
57- label = ' GCaMP6f' ,
58- description = ' Calcium indicator'
59- )
60-
61- # Configure light paths
62- excitation = ExcitationLightPath(
63- name = ' 2p_excitation' ,
64- excitation_wavelength_in_nm = 920.0 ,
65- excitation_mode = ' two-photon'
66- )
67- nwbfile.add_lab_meta_data(excitation)
68-
69-
70- emission = EmissionLightPath(
71- name = ' gcamp_emission' ,
72- emission_wavelength_in_nm = 510.0 ,
73- indicator = indicator
74- )
75- nwbfile.add_lab_meta_data(emission)
76-
77- # Define imaging space
78- imaging_space = PlanarImagingSpace(
79- name = ' cortex_plane1' ,
80- description = ' Layer 2/3 of visual cortex' ,
81- grid_spacing_in_um = [1.0 , 1.0 ],
82- origin_coordinates = [100.0 , 200.0 , 300.0 ]
83- )
84-
85- # Create microscopy series
86- imaging_series = PlanarMicroscopySeries(
87- name = ' imaging_data' ,
88- microscope = microscope,
89- excitation_light_path = excitation,
90- emission_light_path = emission,
91- imaging_space = imaging_space,
92- data = data_array, # Your imaging data array
93- unit = ' n.a.' ,
94- rate = 30.0
95- )
96-
97- # Add to file
98- nwbfile.add_acquisition(imaging_series)
99-
100- # Save file
101- with NWBHDF5IO(' calcium_imaging.nwb' , ' w' ) as io:
102- io.write(nwbfile)
103- ```
7+ ** Comprehensive Neurodata Types**
8+ - Microscope and optical component metadata (integration with [ ndx-ophys-devices] ( https://github.com/catalystneuro/ndx-ophys-devices ) ):
9+ - ` Microscope `
10+ - ` ExcitationSource ` / ` PulsedExcitationSource `
11+ - ` BandOpticalFilter ` / ` EdgeOpticalFilter ` /
12+ - ` DichroicMirror `
13+ - ` Photodetector `
14+ - ` Indicator `
15+ - Advanced light path configurations:
16+ - ` ExcitationLightPath `
17+ - ` EmissionLightPath `
18+ - Imaging space definitions:
19+ - ` PlanarImagingSpace `
20+ - ` VolumetricImagingSpace `
21+ - Support for 2D and 3D imaging:
22+ - ` PlanarMicroscopySeries `
23+ - ` VolumetricMicroscopySeries `
24+ - ` MultiPlaneMicroscopyContainer `
25+ - ROI/segmentation storage:
26+ - ` Segmentation2D `
27+ - ` Segmentation3D `
28+ - ` SegmentationContainer `
29+ - ` MicroscopyResponseSeries `
30+ - ` MicroscopyResponseSeriesContainer `
31+ - Abstract Neurodata types: ` ImagingSpace ` , ` MicroscopySeries ` ,` Segmentation `
10432
10533## Entity relationship diagram
10634
@@ -402,17 +330,16 @@ classDiagram
402330---
403331This extension was created using [ ndx-template] ( https://github.com/nwb-extensions/ndx-template ) .
404332
333+ ## Installation
334+
335+ ``` bash
336+ pip install ndx-microscopy
337+ ```
405338
406339## Documentation
407340
408341For detailed documentation, including API reference and additional examples, please visit our [ documentation site] ( https://ndx-microscopy.readthedocs.io/ ) .
409342
410- The documentation includes:
411- - Getting Started Guide
412- - User Guide with Best Practices
413- - Comprehensive Examples
414- - Complete API Reference
415- - Data Format Specifications
416343
417344## Contributing
418345
@@ -424,7 +351,7 @@ From your local copy directory, use the following commands.
424351
425352If you have not already, you will need to clone the repo:
426353``` bash
427- $ git clone https://github.com/catalystneuro/neuroconv
354+ $ git clone https://github.com/catalystneuro/ndx-microscopy
428355```
429356
430357First create a new branch to work on
0 commit comments