You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/source/philosophy/data_organization.md
+12-14Lines changed: 12 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,10 +58,9 @@ All primary data assets have the following naming convention:
58
58
59
59
A few points:
60
60
61
-
- <acquisition-datetime>: yyyymmddTtz, at start of acquisition,.
62
-
- Acquisition datetime is essential for uniqueness.
63
-
- Acquisition datetime is in the local time zone.
64
-
- Time-zone is documented in metadata files
61
+
- Format <acquisition-start-datetime>: yyyymmdd_HH-MM-SS
62
+
- This should be the start of acquisition, in the local time zone.
63
+
- The local time-zone is documented in metadata files
65
64
- All tokens (e.g. <subject-id>) must not contain underscores or illegal filename characters. Subject ID is not strictly necessary – only the timestamp is essential. However, it is part of the current naming convention because it helps people visually browse for data.
66
65
67
66
Primary data assets are organized as follows:
@@ -96,13 +95,13 @@ Example for simultaneous electrophysiology with optotagging and FIP:
96
95
📦655568_2022-04-26_11-48-09
97
96
┣ 📜<metadata JSON files>
98
97
┣ 📂FIB
99
-
┃ ┣ 📜L415_2022-04-26T11_48_09.csv
100
-
┃ ┣ 📜L470_2022-04-26T11_48_09.csv
101
-
┃ ┣ 📜L560_2022-04-26T11_48_09.3024512-07_00
102
-
┃ ┣ 📜Raw2022-04-26T11_48_09.csv
103
-
┃ ┣ 📜TTL_2022-04-26T11_48_08.1780864-07_00
104
-
┃ ┣ 📜TTL_TS2022-04-26T11_48_08.csv
105
-
┃ ┗ 📜TimeStamp_2022-04-26T11_48_08.csv
98
+
┃ ┣ 📜L415_2022-04-26_11-48-09.csv
99
+
┃ ┣ 📜L470_2022-04-26_11-48-09.csv
100
+
┃ ┣ 📜L560_2022-04-26_11-48-09.3024512
101
+
┃ ┣ 📜Raw2022-04-26_11-48-09.csv
102
+
┃ ┣ 📜TTL_2022-04-26_11-48-08.1780864
103
+
┃ ┣ 📜TTL_TS2022-04-26_11-48-08.csv
104
+
┃ ┗ 📜TimeStamp_2022-04-26_11-48-08.csv
106
105
┣ 📂ecephys
107
106
┃ ┣ 📜220426114809_655568.opto.csv
108
107
┃ ┗ 📂Record Node 104
@@ -167,10 +166,9 @@ When naming files, we should:
167
166
- use terms from vocabularies defined in aind-data-schema, e.g.
168
167
- modalities, institutions
169
168
- behavior video file names
170
-
- use "yyyy-mm-dd" and "hh-mm-ss" in local time zone for dates and times
171
-
- separate tokens with underscores, and not include underscores in tokens, e.g.
169
+
- use "yyyy-mm-dd" and "HH-MM-SS" in local time zone for dates and times
170
+
- separate tokens with underscores, and do not include underscores in tokens, e.g.
172
171
- Do this: EFIP_655568_2022-04-26_11-48-09
173
-
- Not this: EFIP-655568-2022_04_26-11_48_09
174
172
- Do not include illegal filename characters in tokens
0 commit comments