Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

(warning) Using proper KCNI naming convention to label projects, participants, experiments, and files is extremely important as data is routed through the Neuroinformatics Platform according to these labels. Please take great case in ensuring data is properly labelled at every level, codes are consistent throughout the project life cycle and typos are avoided. Thank you!



Project Label


Include Page
Project Label
Project Label

Study Participant

Label

ID


Include Page
Study Participant ID
Study Participant ID

Experiment Label


NOTEIt's important that the MRI or PET operator use the Experiment Label as the Patient Name in the DICOM header during an MRI or PET session.

Please ensure the Experiment Label is entered correctly at all data entry occurences as a misspelled Experiment Label can have significant consequences throughout the Neuroinformatics Platform system.


The Experiment Label must be the Study Participant Label ID concatenated with the visit code, session code and modality code using underscores.

Ex. ABC01_CMH_00000001_02_SE03_MR

ExampleDefinititionRestrictions/RulesNotes
ABCProject Code3 Uppercase LettersChosen in coordination with KCNI admin. Preferably a project acronym. Cannot match existing project.
01Study Code2 DigitsTypically '01', unless describing divisions within a project
CMHSite Code3 Uppercase LettersMust be chosen from the Site Code List
00000001Participant Code4-8 Alphanumeric CharactersSee Participant Code Guidelines
02Visit Code2 DigitsIncrement each visit
SE03Session CodeSE followed by 2 DigitsIncement each session within a visit
MRModality Code2-4 Uppercase LettersMust be chosen from the Modality Code List


The Visit Code is 2 integers that represent the visit number. For example, 01 is first baseline visit, 02 is a follow-up visit, etc..

The Session Code is the letters 'SE' followed by 2 integers which distinguish different data capture sessions in a single visit. For example, if you are conducting an MRI experiment and you collect data before some intervention, the participant leaves the scanner for the intervention, then the participant returns to the scanner the session code should be incremented by 1. Notice the difference between visit and session where a visit denotes a participant coming to the institution for data acquisition where a session is denoted as a continuous acquisition of scans.

The Modality Code is 2 to 4 characters, denoting the modality with which the data was acquired. See the list of image modality codes below. For example, MR = Magnetic Resonance Imaging which includes fMRI, MRI, MRS etc.


EEG Data Filename


When saving an EEG data file that is to uploaded by automated data upload processes in XNAT it is important to properly label the file to ensure the data can be organized into its proper XNAT storage location.

The data files should follow the Experiment Label convention followed by an underscore, then a trial code.

Ex. ABC01_CMH_00000001_02_SE03_EEG_rest.cnt

ExampleDefinititionRestrictions/RulesNotes
ABCProject Code3 Uppercase LettersChosen in coordination with KCNI admin. Preferably a project acronym. Cannot match existing project.
01Study Code2 DigitsTypically '01', unless describing divisions within a project
CMHSite Code3 Uppercase LettersMust be chosen from the Site Code List
00000001Participant Code4-8 Alphanumeric CharactersSee Participant Code Guidelines
02Visit Code2 DigitsIncrement each visit
SE03Session CodeSE followed by 2 DigitsIncement each session within a visit
EEGModality Code2-4 Uppercase LettersMust be chosen from the Modality Code List
restTrial Code1+ Alphanumeric CharactersUsed to describe the trial experiment 


The Trial code is usually used to describe different runs within a session. For example rest is common to describe continuous resting data. Other popular examples are single or lici for TMS trials and 1Back, 0Back, etc. for NBack trials.

Notes:

  • DO NOT use commas, periods, underscores, spaces, dashes, slashes or other punctuation in the trial code. Instead use camel case (ex. thisIsACamelCaseExample)
  • Ensure that the trial code is consistent across experiments and scans. For example, using 0Back, zeroBack or 0back will cause errors later on


Phantom Naming Convention



Phantom data is used in imaging studies to measure scanner variability over time. On the KCNI XNAT, phantom data must be labelled slightly differently compared to in-vivo data. 

Phantom Participant Label


The Phantom Participant Label must be the concatenation of the Project Label and the combination of the phantom type with the phantom identifier joined by an underscore.

Ex. ABC01_CMH_LEGPHA

ExampleDefinititionRestrictions/RulesNotes
ABCProject Code3 Uppercase LettersChosen in coordination with KCNI admin. Preferably a project acronym. Cannot match existing project.
01Study Code2 DigitsTypically '01', unless describing divisions within a project
CMHSite Code3 Uppercase LettersMust be chosen from the Site Code List
LEGPhantom Type Code3 Uppercase LettersMust be chosen from Phantom Type List
PHAPhantom Identifier CodeAlways PHA


The Phantom Type is a 3 character code that describes the construction of the phantom. This code must be chosen from the Phantom Types List below. Ex: LEG = Lego phantom

The Phantom Identifier is the letters 'PHA' that identifies the subject as a phantom


Phantom Experiment Label


The Phantom Experiment Label must be the Phantom Experiment Label concatenated with the session code and modality code using underscores.

Ex. ABC01_CMH_LEGPHA_200511_MR

ExampleDefinititionRestrictions/RulesNotes
ABCProject Code3 Uppercase LettersChosen in coordination with KCNI admin. Preferably a project acronym. Cannot match existing project.
01Study Code2 DigitsTypically '01', unless describing divisions within a project
CMHSite Code3 Uppercase LettersMust be chosen from the Site Code List
LEGPhantom Type Code3 Uppercase LettersMust be chosen from Phantom Type List
PHAPhantom Identifier CodeAlways PHA
200511Date Code6 DigitsDate of data acquisition (YYMMDD)
MRModality Code2-4 LettersMust be chosen from Modality Code List


The Phantom Date code is 6 digits representing the date of your scan (ex. yymmdd).

The Modality code is the same as the human Modality code. It is a string of 2 to 4 characters which denotes the modality with which the data was captured.


Modality Codes
Anchor
modalityCodes
modalityCodes


The Modality Code denotes the apparatus with which the imaging data was acquired and is appended to the end of the Experiment Label. Only Modality Codes chosen from the list below are considered acceptable. If you are collecting data that is not well described by one of the listed modalities, please contact XNAT Admin and your imaging modality can be added.


Imaging ModalityModality Code
Computed RadiographyCR
Computed TomographyCT
Digital RadiographyDX
3d Digital RadiographyDX3D
ElectrocardiographyECG
ElectroencephalographyEEG
ElectrophysiologyEPS
Visible Light EndoscopyES
Video EndoscopyESV
Visible Light MicroscopyGM
Video MicroscopyGMV
HemodynamicHD
Intraoral RadiographyIO
MagnetoencephalographyMEG
Digital MammographyMG
Magnetic ResonanceMR
Nuclear Medicine ImageNM
Ophthalmic PhotographyOP
Opthalmic TomographyOPT
Positron Emission TomographyPET
RadiofluoroscopyRF
RadiotherapyRT
Visible Light Slide-Coordinates MicroscopySM
UltrasoundUS
X-ray AngiographyXA
X-ray 3d AngiographyXA3D
Visible Light PhotographyXC
Video PhotographyXCV

Phantom Type Codes
Anchor
phantomCodes
phantomCodes


Below is a list of acceptable Image Phantom Types. If you have a phantom that is not well described by one of the codes in this list, then please contact XNAT Admin and your phantom can be added.

DescriptionPhantom Code
Lego PhantomLEG
fBIRN PhantomFBN
Hoffman PhantomHOF
GE PhantomGE
ADNI Magphan PhantomADN
ACR PhantomACR