This README file describes the `v1` exported properties for the MICrONS digital twin.

# Contents
```
    function.nc                            (32GB)
    units_visual_properties.csv            (22MB)
    load_functional_data_tutorial.ipynb
    README.md
```

## function.nc
A netCDF xarray dataset containing the digital twin neural responses and derived characteristics

## units_visual_properties.csv
A flat .csv table containing a subset of `function.nc`, including receptive field, orientation selectivity, and direction selectivity

## load_functional_data_tutorial.ipynb
A Jupyter notebook demonstrating how to load the data

## README.md
This file

# Variable descriptions
```
NAME                                  DESCRIPTION
session                               session ID for the recording. The combination of session and scan_idx uniquely identifies the recording
scan_idx                              scan ID for the recording. The combination of session and scan_idx uniquely identifies the recording scan
unit_id                               functional unit ID, unique per recording scan
pref_ori                              preferred orientation in radians (0 - pi), horizontal bar moving upward is 0 and orientation increases clockwise, 
                                        extracted from model responses to oriented noise stimuli
pref_dir                              preferred direction in radians (0 - 2pi), horizontal bar moving upward is 0 and orientation increases clockwise, 
                                        extracted from model responses to oriented noise stimuli
gOSI                                  global orientation selectivity index
gDSI                                  global direction selectivity index
readout_weight                        readout weight vector
readout_location_x                    x coordinate of the readout location per unit, in a 128 * 72 downsampled stimulus space, 
                                        this is an approximation of a neuron's receptive field center
readout_location_y                    y coordinate of the readout location per unit, in a 128 * 72 downsampled stimulus space, 
                                        this is an approximation of a neuron's receptive field center
cc_abs                                prediction performance of the model, higher is better
cc_max                                tuning reliability of functional units, higher is better
natural_movie                         a concatenated collection of 10-sec naturalistic movie clips (netCDF file only)
natural_response                      model responses to natural_movie, each 10-sec movie clip is fed independently to the model, and the responses are concatenated (netCDF file only)
oracle_scan_set_hash                  metadata to lookup the matching the visual stimulus set (csv file only)
ori_scan_set_hash                     metadata to lookup the matching the visual stimulus set (csv file only)
dynamic_model_scan_set_hash           metadata to lookup the matching the digital twin model responses (csv file only)
```

# Citations
```
    ID        NAME                                          DOI
    1         Wang et al., 2025                             https://doi.org/10.1038/s41586-025-08829-y
    2         Ding, Fahey, and Papadopoulos et al., 2025    https://doi.org/10.1038/s41586-025-08840-3
    3         MICrONS Consortium et al., 2025               https://doi.org/10.1038/s41586-025-08790-w

For use of the digital twin and any properties please cite [1, 2]
For use of the anatomical properties please cite [3]
```