Merge pull request #65 from kabilar/main

Add `ephys_precluster` module

Author: dimitri-yatsenko

CHANGELOG.md

@@ -1,20 +1,28 @@
 # Changelog
 
-Observes [Semantic Versioning](https://semver.org/spec/v2.0.0.html) standard and [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) convention.
+Observes [Semantic Versioning](https://semver.org/spec/v2.0.0.html) standard and
+ [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) convention.
 
+## [0.1.0] - 2022-05-26
+
++ Update - Rename module for acute probe insertions from `ephys.py` to `ephys_acute.py`.
++ Add - Module for pre-clustering steps (`ephys_precluster.py`), which is built off of `ephys_acute.py`.
++ Add - Module for chronic probe insertions (`ephys_chronic.py`).  
++ Bugfix - Missing `fileTimeSecs` key in SpikeGLX meta file.
++ Update - Move common functions to `element-interface` package.
++ Add - NWB export function
 
 ## [0.1.0b0] - 2021-05-07
-### Added
-+ First beta release
 
++ Update - First beta release
 
 ## [0.1.0a5] - 2021-05-05
-### Added 
-+ Added GitHub Action release process
-+ `probe` and `ephys` elements
-+ Readers for: `SpikeGLX`, `Open Ephys`, `Kilosort`
-+ Probe table supporting: Neuropixels probes 1.0 - 3A, 1.0 - 3B, 2.0 - SS, 2.0 - MS
 
++ Add - GitHub Action release process
++ Add - `probe` and `ephys` elements
++ Add - Readers for: `SpikeGLX`, `Open Ephys`, `Kilosort`
++ Add - Probe table supporting: Neuropixels probes 1.0 - 3A, 1.0 - 3B, 2.0 - SS, 2.0 - MS
 
+[0.1.0b1]: https://github.com/datajoint/element-array-ephys/compare/0.1.0b0...0.1.0
 [0.1.0b0]: https://github.com/datajoint/element-array-ephys/compare/0.1.0a5...0.1.0b0
 [0.1.0a5]: https://github.com/datajoint/element-array-ephys/releases/tag/0.1.0a5

README.md

@@ -16,7 +16,30 @@ ephys pipeline.
 
 ## Element architecture
 
-![element-array-ephys diagram](images/attached_array_ephys_element.svg)
+`element-array-ephys` is comprised of two schemas, `probe` and `ephys`.  To handle 
+several use cases of this pipeline, we have designed several `ephys` schemas, including 
+`ephys_acute`, `ephys_chronic`, and `ephys_precluster`.
+
++ `ephys_acute` - A probe(s) is inserted into a new location during each session.
+
++ `ephys_chronic` - A probe(s) is inserted once and used to record across multiple 
+sessions.
+
++ `ephys_precluster` - A probe(s) is inserted into a new location during each session.  
+And pre-clustering steps (e.g. CatGT) are performed on the data from each probe prior 
+to Kilosort analysis.
+
+### `ephys_acute` module
+![element-array-ephys acute diagram](images/attached_array_ephys_element_acute.svg)
+
+
+### `ephys_chronic` module
+![element-array-ephys chronic diagram](images/attached_array_ephys_element_chronic.svg)
+
+### `ephys_precluster` module
+![element-array-ephys precluster diagram](
+    images/attached_array_ephys_element_precluster.svg)
+
 
 As the diagram depicts, the array ephys element starts immediately downstream from `Session`, 
 and also requires some notion of `Location` as a dependency for `InsertionLocation`. We