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

Christine Rogers christine.rogers at mcgill.ca
Fri Mar 10 11:41:34 EST 2017 

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://github.com/aces/Loris/wiki/Project-Customization#4-define-study-sites>
means Site or Centre. Sites and their abbreviations are defined in the *psc*
table.
- PSCID
<https://github.com/aces/Loris/wiki/Project-Customization#v-customizable-participant-identifiers>
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://github.com/aces/Loris/wiki/Project-Customization#v-customizable-participant-identifiers>
(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://github.com/aces/Loris/wiki/Project-Customization#iii-visit-labels>:
 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>
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]
> *Sent:* March 9, 2017 1:42 PM
> *To:* Michael Joseph
> *Cc:* 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
> 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
> http://www.bic.mni.mcgill.ca/mailman/listinfo/loris-dev
>
>


-- 

christine.rogers at mcgill.ca
LORIS data systems | loris.ca
McGill Centre for Integrative Neuroscience | MCIN.ca
McConnell Brain Imaging Centre
Montreal Neurological Institute
McGill University | Montreal | Canada
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.bic.mni.mcgill.ca/pipermail/loris-dev/attachments/20170310/d529ff95/attachment.html>

More information about the Loris-dev mailing list