[Loris-dev] Setting up LORIS instance -- help with PSCID

Michael Joseph michael.joseph at sickkids.ca
Fri Mar 10 12:43:17 EST 2017 

Hi Christine,

Yes, this helps a lot. I wasn't quite sure what the reasoning behind the DCCID was before. A lot of our subjects already have Subject IDs and I see that it's best to use the PSCID for these IDs and add the DCCID as a unique candidate ID.

Thanks,
Michael


________________________________
From: Christine Rogers [christine.rogers at mcgill.ca]
Sent: March 10, 2017 11:41 AM
To: Michael Joseph
Cc: loris-dev at bic.mni.mcgill.ca
Subject: Re: [Loris-dev] Setting up LORIS instance -- help with PSCID

Hi Michael,
I can point to some clarifications on these IDs and terms, with links included to the Wiki documentation:

- PSC (Project Study Centre)<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_aces_Loris_wiki_Project-2DCustomization-234-2Ddefine-2Dstudy-2Dsites&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=0mh9q0Bwg9g-Q1zZJZybWOG7pWh_SaBrNFE5HHR0M5Y&s=cNxjd_dwL6_gbaVE-Rwwa9L9JGELq3eYpwv769_JdEY&e=> means Site or Centre. Sites and their abbreviations are defined in the psc table.
- PSCID<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_aces_Loris_wiki_Project-2DCustomization-23v-2Dcustomizable-2Dparticipant-2Didentifiers&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=0mh9q0Bwg9g-Q1zZJZybWOG7pWh_SaBrNFE5HHR0M5Y&s=Co0LNZuCc3HDovMDuciDVPZDdPxK5CruFd4xD0XXKrs&e=> is the candidate(subject) ID usually assigned/used by data collection site staff.  For example, a recruiting coordinator would typically refer to a subject by their PSCID.   It is customizable in config.xml, and is typically composed of the SiteAbbreviation (from psc table) + a sequence of digits (e.g. AAA0001)

In contrast, DCCID<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_aces_Loris_wiki_Project-2DCustomization-23v-2Dcustomizable-2Dparticipant-2Didentifiers&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=0mh9q0Bwg9g-Q1zZJZybWOG7pWh_SaBrNFE5HHR0M5Y&s=Co0LNZuCc3HDovMDuciDVPZDdPxK5CruFd4xD0XXKrs&e=> (aka table column: CandID) is a 6-digit randomized ID generated for each candidate, and serves as a second unique (and blind) candidate ID, separate from PSCID.  It can be used as a double-check on the PSCID, and so will be required in certain contexts (like the Imaging Uploader) to confirm the exact candidate.
 And the DCCID could be changed to manual entry of a 4 digit code instead of a randomly generated 6 digit code.
The DCCID could theoretically be changed to a 4 digit code, by modifying all schema tables where CandID is defined as an int(6) field, and all code which is impacted -- and it also limits candidate registration to 9999 individuals.  For these reasons, we don't recommend this modification.

- Visit label<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_aces_Loris_wiki_Project-2DCustomization-23iii-2Dvisit-2Dlabels&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=0mh9q0Bwg9g-Q1zZJZybWOG7pWh_SaBrNFE5HHR0M5Y&s=EC01HUkzlG3aXSEY3wy68GP2_x88Fk5m-UmI7h8usTQ&e=>:  is the name given for the subject's visit or timepoint (or session).

In your example, $PSCID_$DCCID_$Visitlabel (used in Imaging file uploads) -- this string identifies a specific subject-visit, using both IDs to ensure absolute clarity about the subject/candidate indicated.

To add a project ID in the PSCID (meaning a subject cannot participate in more than one study/project) -- please see my previous email (below about customizing the PSCID composition.

Hope this helps,
Christine




On Thu, Mar 9, 2017 at 2:14 PM, Michael Joseph <michael.joseph at sickkids.ca<mailto:michael.joseph at sickkids.ca>> wrote:
Thank you for your reply Christine.

I think I was a little confused earlier by the PSCID and DCCID. From what I understand now, the PSCID is static for each site and the DCCID changes for each subject. The full subject ID is a combination of $PSCID_$DCCID_$Visit_label. So to suit our study, the PSCID could be $projectname_$sitename. And the DCCID could be changed to manual entry of a 4 digit code instead of a randomly generated 6 digit code. Is this correct?

Thanks,
Michael

________________________________
From: Christine Rogers [christine.rogers at mcgill.ca<mailto:christine.rogers at mcgill.ca>]
Sent: March 9, 2017 1:42 PM
To: Michael Joseph
Cc: loris-dev at bic.mni.mcgill.ca<mailto:loris-dev at bic.mni.mcgill.ca>
Subject: Re: Setting up LORIS instance -- help with PSCID

Hi Michael,
Thanks for your question - since this is a technical/setup issue, I'm responding to you as well as the Loris-dev listserv for any further input from the Loris team and community, since another Loris project out there may have already implemented the solution you're looking for.

I'm setting up a LORIS instance and am having trouble setting up the rules for the PSCID. I'd like the PSCID to have the structure: $projectname_$sitename_4digitcode (eg. AAA01_CDE_0001). Is there a way to do this in the config.xml?
This is what I have currently. Is there a way to call the "Name" column in Project and the "Alias" column in psc to get all the site codes (instead of siteAbbrev which only lets you register candidates from your site)?
<PSCID>
    <generation>user</generation>
    <structure>
        <seq type="????" />
        <seq type="static" "_"/>
        <seq type="set" CDE|FGH|IJK|LMN/>
        <seq type="static" "_"/>
        <seq type="numeric" minLength="4"/>
    </structure>
</PSCID>

Someone with a little coding knowledge can easily customize and adapt the Candidate:validatePSCID()<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_aces_Loris_blob_17.0-2Ddev_php_libraries_Candidate.class.inc-23L797&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=voTamHhVFeA68lzguNPR1MFyiko8C7fz0dVJ7bvvBGk&s=mYq2BZomO_PPb8HEzj5YhDzhbmrgFj6Zn4-rUJaHArQ&e=> and Utility class functions<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_aces_Loris_blob_17.0-2Ddev_php_libraries_Utility.class.inc-23L377&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=voTamHhVFeA68lzguNPR1MFyiko8C7fz0dVJ7bvvBGk&s=GSuRWnRM11fsR7hdFCuplAdY6XZgjVCVaHj6eHVaMyA&e=> that check for a specific pattern in user-input PSCID formatting.

E.g. you could adapt these functions to check all site abbreviations (or Alias), and could define in config.xml a new <seq> type for project, and add a little code to validate this (across all valid projects).

Also note we're currently adapting the User-Site relationship<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_aces_Loris_pull_2468&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=voTamHhVFeA68lzguNPR1MFyiko8C7fz0dVJ7bvvBGk&s=zyBC0cnDG8PWDloVj0J1cI2pVXC-uTfW6Es7nkvG-Bs&e=> for Loris 17.1 to allow users to register a candidate at any site the user is appropriately attached to.

Best,
Christine

--
christine.rogers at mcgill.ca<mailto:christine.rogers at mcgill.ca>
LORIS data systems | loris.ca<https://urldefense.proofpoint.com/v2/url?u=http-3A__loris.ca_&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=voTamHhVFeA68lzguNPR1MFyiko8C7fz0dVJ7bvvBGk&s=Fmbualp3ONKJHGEDB1HZmqMGePP4L3SfI0oPhv8V6GU&e=>
McGill Centre for Integrative Neuroscience | MCIN.ca
McConnell Brain Imaging Centre
Montreal Neurological Institute
McGill University | Montreal | Canada


On Wed, Mar 8, 2017 at 3:59 PM, Michael Joseph> wrote:
Hi all,

I'm setting up a LORIS instance and am having trouble setting up the rules for the PSCID. I'd like the PSCID to have the structure: $projectname_$sitename_4digitcode (eg. AAA01_CDE_0001). Is there a way to do this in the config.xml?

This is what I have currently. Is there a way to call the "Name" column in Project and the "Alias" column in psc to get all the site codes (instead of siteAbbrev which only lets you register candidates from your site)?

<PSCID>
    <generation>user</generation>
    <structure>
        <seq type="????" />
        <seq type="static" "_"/>
        <seq type="set" CDE|FGH|IJK|LMN/>
        <seq type="static" "_"/>
        <seq type="numeric" minLength="4"/>
    </structure>
</PSCID>

Thanks,
Michael

________________________________

This e-mail may contain confidential, personal and/or health information(information which may be subject to legal restrictions on use, retention and/or disclosure) for the sole use of the intended recipient. Any review or distribution by anyone other than the person for whom it was originally intended is strictly prohibited. If you have received this e-mail in error, please contact the sender and delete all copies.




________________________________

This e-mail may contain confidential, personal and/or health information(information which may be subject to legal restrictions on use, retention and/or disclosure) for the sole use of the intended recipient. Any review or distribution by anyone other than the person for whom it was originally intended is strictly prohibited. If you have received this e-mail in error, please contact the sender and delete all copies.

_______________________________________________
Loris-dev mailing list
Loris-dev at bic.mni.mcgill.ca<mailto:Loris-dev at bic.mni.mcgill.ca>
http://www.bic.mni.mcgill.ca/mailman/listinfo/loris-dev<https://urldefense.proofpoint.com/v2/url?u=http-3A__www.bic.mni.mcgill.ca_mailman_listinfo_loris-2Ddev&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=0mh9q0Bwg9g-Q1zZJZybWOG7pWh_SaBrNFE5HHR0M5Y&s=XpgI0SxuShsZUlhS6ZIMvYqJDBEQ1oG2tyAmi0sCaSw&e=>




--

christine.rogers at mcgill.ca<mailto:christine.rogers at mcgill.ca>
LORIS data systems | loris.ca<https://urldefense.proofpoint.com/v2/url?u=http-3A__loris.ca&d=DQMFaQ&c=Dvjge31PR3JZstzk2paJYiflTxRSxp35GBhsbHdd2Zw&r=tKjGFUipnzrGVnXuVE1v6Q1Z3FG_u0KhQBt7AXF9Blk&m=0mh9q0Bwg9g-Q1zZJZybWOG7pWh_SaBrNFE5HHR0M5Y&s=aS6uPrPXASkauaM2mOUIA8G7dkBz9_S_v3uNAI0qOlw&e=>
McGill Centre for Integrative Neuroscience | MCIN.ca
McConnell Brain Imaging Centre
Montreal Neurological Institute
McGill University | Montreal | Canada

________________________________

This e-mail may contain confidential, personal and/or health information(information which may be subject to legal restrictions on use, retention and/or disclosure) for the sole use of the intended recipient. Any review or distribution by anyone other than the person for whom it was originally intended is strictly prohibited. If you have received this e-mail in error, please contact the sender and delete all copies.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.bic.mni.mcgill.ca/pipermail/loris-dev/attachments/20170310/8a511945/attachment-0001.html>

More information about the Loris-dev mailing list