-
Notifications
You must be signed in to change notification settings - Fork 2
/
odksplit.sthlp
105 lines (74 loc) · 4 KB
/
odksplit.sthlp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{smcl}
{* *! version 4.0.0 22jan2019}{...}
{findalias asfradohelp}{...}
{vieweralsosee "" "--"}{...}
{vieweralsosee "[R] help" "help help"}{...}
{viewerjumpto "Syntax" "odksplit##syntax"}{...}
{viewerjumpto "Description" "odksplit##description"}{...}
{viewerjumpto "Options" "odksplit##options"}{...}
{viewerjumpto "Remarks" "odksplit##remarks"}{...}
{viewerjumpto "Examples" "odksplit##examples"}{...}
{title:Title}
{phang}
{bf:odksplit} {hline 2} is a module to label the variables, assign corresponding value labels, and split and label multiple response variables generated from ODK. {bf:odksplit} labels the dataset in all available languages.
{marker syntax}{...}
{title:Syntax}
{p 8 17 2}
{cmdab:odksplit}
[{cmd:,} {it:options}]
{synoptset 20 tabbed}{...}
{synopthdr}
{synoptline}
{syntab:Main}
{synopt:{opt s:urvey}}The name of the XLSform, including the path{p_end}
{synopt:{opt d:ata}}The name of the data file, including the path{p_end}
{synopt:{opt l:abel}}The language specified in the label column in ODK XLSform. For example, if the label column is 'label:English', write English. If 'label' is specified, default language is set. {p_end}
{synopt:{opt date:format}}Specify the date format, either MDY or DMY {p_end}
{synopt:{opt c:lear}}To clear any data in memory{p_end}
{synopt:{opt save}}To save the labelled data {p_end}
{synoptline}
{p2colreset}{...}
{marker description}{...}
{title:Description}
{pstd}
If ODK or SurveyCTO is used for data collection, the multiple response variables are downloaded as string variables.
{cmd:odksplit} can be used to split those variables to create dummy variables as well as label the dummy variables. Additional options allow to do the other labeling excercises.
{pstd}
If "SurveyCTO sync" is used to download data, and the 'Export select_multiple responses as series of 1/0 columns?' option was ticked, the dummy variables are already created in the dataset.
However, {cmd:odksplit} does this again deleting the existing variables. {cmd:odksplit} uses the XLSform to identify the 'select_multiple' variables, and take the value labels from the choices sheet.
{pstd}
{cmd:odksplit} was initially developed to work with the multiple response variables, however, additional options were added based on user feedback.
{marker remarks}{...}
{title:Remarks}
{pstd}
This program will clear any data in memory. Therefore, the program asks whether you really want to clear data from memory. Write ok in the command line and press enter if you want to proceed.
Otherwise, write cancel, and press enter to cancel the program. This will not work if the variable names include the group names as prefix.
{p_end}
{marker options}{...}
{title:Options}
{dlgtab:Main}
{phang}
{opt survey} specifies the XLSform name where 'survey' and 'choices' sheets exist.
{phang}
{opt data} specifies the data file
{phang}
{opt label} The language specified in the label column in ODK XLSform. For example, if the label column is 'label:English', write English. If 'label' is specified, default language is set..
{phang}
{opt dateformat} Specify the date format, either MDY or DMY
{phang}
{opt clear} clear any data from memory
{phang}
{opt save} save the labelled data
{marker examples}{...}
{title:Examples}
{phang}{cmd:. odksplit, survey("X:\Projects 2018\Fieldwork\Tools\SurveyCTO files\Phase one_v1.xlsx") data("X:\Projects 2017\Fieldwork\Data\Data\raw\Phase one data.dta") label(English) dateformat(MDY) clear save("X:\Projects 2017\Fieldwork\Data\Data\raw\Phase one data_labelled.dta")}{p_end}
{phang}{cmd:. odksplit, survey("X:\Projects 2018\Fieldwork\Tools\SurveyCTO files\Phase one_v1.xlsx") data("X:\Projects 2017\Fieldwork\Data\Data\raw\Phase one data.dta") clear save("X:\Projects 2017\Fieldwork\Data\Data\raw\Phase one data_labelled.dta")}{p_end}
{phang}{cmd:. label language }{p_end}
{phang}{cmd:. label language English}{p_end}
{title:Author}
{p 4 4 2}Mehrab Ali, ARCED Foundation{break}
{title:Also see}
{p 4 13 2}Manual: {hi:[D] label}
{psee}Online: {manhelp label D}, if installed
{p_end}