Skip to content

Commit e59f24f

Browse files
Revise README
1 parent 4f74de7 commit e59f24f

File tree

1 file changed

+31
-104
lines changed

1 file changed

+31
-104
lines changed

README.md

Lines changed: 31 additions & 104 deletions
Original file line numberDiff line numberDiff line change
@@ -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
---
403331
This 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

408341
For 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

425352
If 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

430357
First create a new branch to work on

0 commit comments

Comments
 (0)