Review of PCS draft: matrices & example names

[wibeasley]

(Related to #39)

Two questions from @Maleeha in an email:

1. How about we do a matrix for this field. It seem too crowded?
2. Should not this be the examples in the parenthesis? (e.g, serial7, …)

[wibeasley]

• [x] That's a good idea, but I think REDCap needs two dimensions for the matrix. I don't think it will wrap around the list of checkboxes (like a long sentence wraps around multiple lines in a letter). If it can wrap around, try it out with a few items, and see what you think.
• [x] The example names are a great idea. It helps them get a feel quicker. Also, the example may influence them towards a naming convention that's more consistent with our preferences.
• [ ] don't forget to add the free text boxes for all the cognitive variables too

• [x] looking at the cognitive variables, the variable names don't stand out much from the rest of the question. Unless you have a better idea, for now, enclose each with square brackets. Later we might experiment with html/css decoration.

  

[Maleeha]

• [x] Matrix does not make sense because (e.g. for attention for instant, serial7 & digit span forward are just examples of the names they could have for their dataset.) As in the example below, they can check these but then again there is a greater probability of them not having exactly these names for their datasets so I am dropping matrix idea.

• [x] Leaving the examples names the way they are.
• [ ] don't forget to add the free text boxes for all the cognitive variables too, @wibeasley , don't get it. Did not I do this already?
• [x] Square bracket' ing dataset names in the PCS is done.

[andkov]

Page 1: Introductions . Page 2: Temporal design Page 3: Demographics Page 4: Physical measures Page 5: Cognitive measures Page 6: Clinical measures Page 7: Thank you!

Page 1: Introductions

1) Now : What is a common name for your investigation? Change to: Please indicate the longitudinal study that you will be driving during this Coordinated Analysis with Replication (CAR) workshop.

2, 3, 4, 5, 6) Ok

Page 2 : Temporal design

(If the variables is not available, leave the respective text box blank)

.) How many waves does [your study] contain? (include the baseline, enter as an integer, e.g. "3","7", etc., without the quotes).

.) What is the sample size at each wave? Enter as integers (starting with baseline) separated by spaces (e.g. "659 560 424", "1120 1058 998 845 724 667 301", etc.)

.) Enter the [calendar year] of the baseline measure (e.g. "1978", without the quotes)

.) In your dataset, what is the exact name (case sensitive) of the variable measuring the respondents' [year of birth]?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring the respondents' [age at death]?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring the [age] of respondents at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [age at wave]? Enter only the stem, without the wave indicator and the separator character. For example, if your variable names are "Age_at_visit_1", "Age_at_visit_3", and "Age_at_visit_6" then enter "Age_at_visit" into the text box (without the quotes)

.) Enter each wave for which [age at wave] is available in your dataset using numbers separated by spaces. For example: "1 2 3 4 5", "2 4 6", "1 3 7", etc. (without the quotes).

Page 3: Demographics

.) In your dataset, what is the exact name (case sensitive) of the variable of respondent's [Unique identifier]?

.) In your dataset, what is the exact name (case sensitive) of the variable of respondent's [Twin identifier]? (if any)

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [Sex] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [Education] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [Socio-economic Status] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [Marital status] at baseline?

Page 4: Physical measures

.) In your dataset, what is the exact name (case sensitive) of the variable that measures [PEF], operationalizing the construct [pulmonary]? Enter only the stem, without the wave indicator and the separator character. For example, if your variable names are "PEF_1", "PEF_3", and "PEF_6" then enter "PEF" into the text box (without the quotes)

Simplified version to be repeated for the rest of the items: In your dataset, what is the exact name (case sensitive) of the variable that measures [xxx], operationalizing the construct [zzz]?

.) Enter each wave for which [PEF] is available in your dataset using numbers separated by spaces. For example: "1 2 3 4 5", "2 4 6", "1 3 7", etc. (without the quotes). Feel free to copy paste this response into the blanks of the remaining items, if time points are the same.

Simplified version to be repeated for the rest of the items: Enter each wave for which [xxx] is available in your dataset using numbers separated by spaces.

.)Do you have other measures of [physical] performance or ability? Please name them.

Page 5: Cognitive measures:

20 - 31) remove, we don't ask for domains

.) In your dataset, what is the exact name (case sensitive) of the variable that measures [Analogies], operationalizing the construct [consult the graph for the proper domain]? Enter only the stem, without the wave indicator and the separator character. For example, if your variable names are "Analogies_1", "Analogies_3", and "Analogies_6" then enter "Analogies" into the text box (without the quotes).

Simplified Formula for repetitions until the end of the page: In your dataset, what is the exact name (case sensitive) of the variable that measures [xxx], operationalizing the construct [zzz]?

.) Enter each wave for which [Analogies] is available in your dataset using numbers separated by spaces. For example: "1 2 3 4 5", "2 4 6", "1 3 7", etc., without the quotes. Feel free to copy paste this response into the blanks of the remaining items, if time points are the same.

Simplified version to be repeated for the rest of the items: Enter each wave for which [xxx] is available in your dataset using numbers separated by spaces.

.) Do you have other measures of [cognitive] performance or ability? Please name them.

Page 6: Clinical measures

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [Height in cm] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [Weight in kg] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [calculated BMI] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [dementia diagnosis] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [smoking history] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [cardiovascular history] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [diabetes diagnosis] at baseline?

.) In your dataset, what is the exact name (case sensitive) of the variable measuring respondents' [alcohol use] at baseline?

Page 7: Thank you!

Thank you for you attention on such a detail-oriented survey. The thoroughness of the items is critical for the workshop to proceed efficiently.

We hope that future surveys will pre-populate most items with the responses you provided today.

If you have questions, talk to Andrey.

[Maleeha]

@wibeasley i just updated/replaced the data dictionary.csv, i am working with. I am not sure what's going on with the cosmetics and the structure but i will look into it right now. Thanks @andkov, this is very helpful!

[Maleeha]

@wibeasley and @andkov, this is done. The only thing that's left is naming the domains in the cognitive questions. Let me know what you think!

[Maleeha]

@wibeasley, question # 7 below, is somehow asking for a value and not accepting a text field. Its not letting the survey move beyond the 2nd page. What do you recommend i do?

@andkov

[andkov]

@Maleeha , looks great! thanks for the attention to the details.

I was able to find only a handful of cosmetic corrections:

• 7 - is the same as 8. drop 7.
• 8 - and the like - keep examples consistently under the text boxes
• 9 - move e.g. to under the box
• 16, 17, 18 - move to "Demographics" page
• 31 through 108 - need to go on the "Cognitive measure" page
• 109 - needs to go to the next page, "Clinical measures"

The rest looks clean and nice to me. I think after these changes are implemented the PCS is ready.

[wibeasley]

@andkov, do you have everything you need now to start on the syntax generator?

[andkov]

Yes, thanks for checking. I am midway through having ELSA example going. Might even be in time for Thursday meeting

Sent from my iPhone, please excuse typing and T9 errors.

On May 11, 2016, at 7:21 AM, Will Beasley notifications@github.com wrote:

@andkov, do you have everything you need now to start on the syntax generator?

— You are receiving this because you were mentioned. Reply to this email directly or view it on GitHub

[Maleeha]

Looking at the cosmetic mistakes right now. Thanks!

[Maleeha]

Those were some lazy mistakes! I think I got them all. @andkov,

1. Should not [Unique identifiers] be in demographics as well? You asked me to move 16, 17, 18. It was question 15.
2. Does question 3 needs to be changed with respect to dates?

[Maleeha]

Notes on PCS:

• [x] On question # 3, change the title of the conference to ialsa-2015-portland (all lower case).
• [x] Change the position of question # 15, move it to demographics.
• [x] Add a comment general to the entire page (i.e., clearly defined rules about the shape of the date). For this particular wide data specification, please refer to the data specification document which should essentially be a hyperlink. ./manipulation/data-specification.md
• [x] Or may be next time point them to the READ.ME. In a given situation, situate the READ.ME to the base repo- Noted (future reference).
• [x] The comment to q # 29; change them to: please name them, separating by spaces
• [x] Repeat the same title specification maneuver under individual headers.
• [x] Where in the questions there are line-breaks, either take them out or give them an extra line-break. Noted (future reference). Also I applied this to Q # 30 and did not move what you asked me for # 32 and later, to the field note since there is already a huge example designated to that space.
• [x] From question # 32, move the sentence starting with "Enter", to field label.
• [x] Break the page up from 30 to 49 should be on a single page and 50-79 should be on page 2 and then 80-99 is page 3 and then 100-107 is page 4.

[Maleeha]

• @andkov, everything above has been attended to, I have applied the following to pulmonary measures as well, where possible.
• Where in the questions there are line-breaks, either take them out or give them an extra line-break. Noted (future reference). Also I applied this to Q # 30 and did not move what you asked me for # 32 and later, to the field note since there is already a huge example designated to that space.*
• Please see if the page numbers have been communicated in the section headers of the cognitive measures, the way you wanted them.
• Regarding referring data specification folder via link in a comment, I have only applied it to temporal design and it looks super weird. Could you please advice on that @wibeasley
• I am updating the .csv on github/stencil.

[Maleeha]

@andkov @wibeasley, this is done!

[wibeasley]

@andkov, do you have a URL for the "data specification document"? Otherwise, is it ready for you to enter ELSA and/or MAP info into it?

https://bbmc.ouhsc.edu/redcap/redcap_v6.11.5/Design/online_designer.php?pid=262&page=preconference_survey

[andkov]

I think sending it to the README is a good idea. I can redirect from they, and now that I'm thinking about more that might be preferable to allow some flexibility.

[Maleeha]

So, what do I change on pre-conference survey? Direct it to README? I think @andkov

[andkov]

Yes

Sent from my iPhone, please excuse typing and T9 errors.

On May 20, 2016, at 9:45 AM, Maleeha Shahid notifications@github.com wrote:

So, what do I change on pre-conference survey? Direct it to README? I think @andkov

— You are receiving this because you were mentioned. Reply to this email directly or view it on GitHub