Comment on page

Subject object

A subject represents a human being who is the subject of a record (ie an experiment).
Description
A subject object includes these fields:
Name
Type
Description
subjectName
string
The name of the subject.
dateOfBirth
string
The date of birth of the subject. The format is "YYYY-MM-DD", e.g. "1980-12-25".
sex
string
Can be "M", "F" or "U". These letters stands for male, female and unknown respectively.
experimentsCount
number
​
countryCode
string
The Alpha-2 ISO code of the country the subject lives in.
countryName
string
The name of the country the subject lives in.
state
string
The state the subject lives in.
city
string
The city the subject lives in.
attributes
array of objects
A list of demographic attribute objects. See below.
Demographic attribute object
The field attributes is a list of attributes. A demographic attribute is an object with 2 fields:
Name
Type
Required
Description
name
string
yes
The name of the attribute.
value
string
yes
The value of the attribute.
You must call getDemographicAttributes to know what are the valid attribute names, and what are the possible values for each attribute.
For example, to tell that the subject is right handed, you can add the attribute { "name":"Handedness", "value":"Right"}
Example
{
    "attributes": [
        {
            "name": "Handedness",
            "value": "Left"
        },
        {
            "name": "Education",
            "value": "Master's degree"
        }
    ],
    "city": "London",
    "countryCode": "GB",
    "countryName": "",
    "dateOfBirth": "1980-12-25",
    "experimentsCount": 3,
    "modifiedDatetime": "2019-07-01T11:23:11.644+07:00",
    "sex": "F",
    "state": "",
    "subjectName": "Alice Smith"
}

getDemographicAttributes

BCI

Last modified 4yr ago

Name	Type	Description
subjectName	`string`	The name of the subject.
dateOfBirth	`string`	The date of birth of the subject. The format is "YYYY-MM-DD", e.g. "1980-12-25".
sex	`string`	Can be "M", "F" or "U". These letters stands for male, female and unknown respectively.
experimentsCount	`number`
countryCode	`string`	The Alpha-2 ISO code of the country the subject lives in.
countryName	`string`	The name of the country the subject lives in.
state	`string`	The state the subject lives in.
city	`string`	The city the subject lives in.
attributes	`array of objects`	A list of demographic attribute objects. See below.

Name	Type	Required	Description
name	`string`	yes	The name of the attribute.
value	`string`	yes	The value of the attribute.