gin commit from med068pc183

New files: 1

check.md

@@ -0,0 +1,90 @@
+# Comparative microelectrode array dataset of functional development of human PSC-derived and rat neuronal networks 
+
+## Summary
+
+We provide a dataset of microelectrode array recordings (MEA) from human pluripotent stem cell (hPSC)-derived and rat embryonic cortical neurons during in vitro maturation and pharmacological treatment at their mature stage([Kapucu et al., to be published 2021](http://doi.org/to-be-inserted-after-publication)). Together with the recorded raw MEA data, we share the analysis code that produces the key scientific findings published previously with this dataset ([Hyvärinen et al., 2019](https://doi.org/10.1038/s41598-019-53647-8)), including PCA analysis to reveal the distinction between rat and human cell activity features. The data enables evaluation and comparison of hPSC-derived and rat cortical cultures in terms of functional development and response to pharmacological treatment. The data is recorded with Axion 12-well plates (developmental tracking) and 48-well plates (pharmacology), sampled at 12500 Hz. Raw data constitute time series of extracellularly recorded voltage valeus in Volts. The duration of the recordings varies from 10 to 30 minutes depending on the experimental set-up. Each raw MEA data file contains organised meta-data. This dataset may be advantageous for experimental and computational neuroscientists and any signal analyst with interest for neuronal signalling. The accurate detailed description of data is delivered in the corresponding publication. Please, refer to the publication as the current instructions deliver only a brief introduction of the data and relevant procedures.
+
+## Downloading the data
+
+there are several ways to upload the data using GIN command line client, git annex and web browser. Short instructions for web browser and GIN CLI are described below.
+
+### Web browser
+The clear way to get a particular file from the repositorye using the web interface is to proceed to its folder, click the file and then click the "Download" link below it. The files containing raw MEA signals are quite large, so the downloading time may be extensive in case of slow Internet connection. The robustness of the connection is important as it happes so that browsers sometimes can not continue the file downloading after abrupt connection loss.
+
+### GIN CLI
+
+Create an account on GIN and download the GIN client [(instructions)](https://gin.g-node.org/G-Node/Info/wiki/GIN+CLI+Usage+Tutorial). Log in using CLI:
+```bash
+gin login
+```
+
+Clone the repository:
+```bash
+gin get AndreyVinogradov/attempt2 (to be changed)
+```
+
+Big data files are not downloaded automatically. The following command should be used to get their contents:
+```bash
+gin get-content <filename>
+```
+
+Downloaded big files will be locked. You have to unlock the file with the following command:
+```bash
+gin unlock <filename>
+```
+
+To remove the contents of a big file: 
+```bash
+gin lock <filename>
+gin remove-content <filename>
+```
+
+Please, refer to the detailed GIN CLI [Usage Tutorial](https://gin.g-node.org/G-Node/Info/wiki/GIN+CLI+Usage+Tutorial).
+
+## Repository contents
+
+### Directory Data
+hPSC_MEA1, hPSC_MEA2, Rat_MEA1 
+hPSC_MEA3_Pharmacology, Rat_MEA2_Pharmacology
+PCA folder contains 7 folders with pre-selected MEA sets used in PCA analysis (3 timepoints for each set): hPSC_MEA1_PCA, hPSC_MEA2_PCA, hPSC_MEA4_PCA, hPSC_MEA5_PCA, Rat_MEA1_PCA, Rat_MEA3_PCA, Rat_MEA4_PCA.
+PCA folder also includes PCA_table.xlsx file which contains extracted meaRtools analysis output features of the sets for running MATLAB PCA analysis code (may be found in the Codes directory : \Codes\PCA_code\PCA.m).
+
+Each folder contains raw MEA recordings in HDF5 format (used, for example as an input for MATLAB spike detection).
+Each .h5 file accomodate two groups: Data and DataInfo. Data group embeds subgroups for each well of MEA plate. Each of these subgroups contains a number of datasets for each electrode in the well. For example, to access the recording of electode 11 of well A1 of ... .h5, the following command should be executed:
+
+DataInfo group provides meta-data for the recording. It contains two datasets: ... and a list of attributes which together deliver the detailed description of ...
+To load the dataset of excluded wells the following  command should be exectuted:
+
+The attribute reading command is a bit different: 
+
+.
+
+
+
+
+
+folder with spike files (Matlab outputs) explog and noisy electrode files which together comprise meaRtools input. 
+and folder with selected meaRtools outputs
+Pharmacology folders contain separate set folder for each stage of the pharmacological experiment (Baseline Pharmacology and TTX treatment). To check which well of MEA plate has undergone which specific treatment (e.g. drug or control) during Pharmacology and TTX stage it is recommended to take a glance into explog .csv file.
+
+
+
+
+Codes directory contains the following folders:
+MATLAB spike detection
+meaRtools 
+Connectivity Analysis
+PCA code 
+The implementational details can be found in the original publication.
+
+## Related Publications
+* Kapucu, F.E., Vinogradov A., Hyvärinen T., Ylä-Outinen L., Narkilahti S. (2021, submitted, to be published soon). Comparative microelectrode array dataset of functional development of human PSC-derived and rat neuronal networks
+* Hyvärinen, T., Hyysalo, A., Kapucu, F.E., Aarnos, L., Vinogradov, A., Eglen, J.E., Ylä-Outinen, L., Narkilahti, S. (2019). Functional characterization of human pluripotent stem cell-derived cortical networks differentiated on laminin-521 substrate: comparison to rat cortical cultures. Scientific Reports volume 9, 17125. https://doi.org/10.1038/s41598-019-53647-8
+
+## Licensing
+<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">
+??????
+
+
+
+