Guide to ADePT
Transcript of Guide to ADePT
-
7/27/2019 Guide to ADePT
1/50
1
Development Research Group,
Development Economics,
World Bank
ADePT Version 4.1
Users Guide
-
7/27/2019 Guide to ADePT
2/50
2
Table of Contents
1. System Requirements............................................................................................................................ 4
1.1 Hardware requirements ................................................................................................................ 4
1.2 Software requirements .................................................................................................................. 4
1.3 Installation of ADePT................................................................................................................... 5
2. How does ADePT work? ...................................................................................................................... 7
2.1 Starting and closing ADePT......................................................................................................... 7
2.2 How does ADePT work? ............................................................................................................... 9
2.3 Loading data into ADePT........................................................................................................... 10
2.4 Specifying variables in ADePT................................................................................................... 13
2.5 Using compound fields in ADePT............................................................................................... 16
2.6 Generating tables and graphs ..................................................................................................... 18
3. The Output of ADePT......................................................................................................................... 19
3.1 ADePT System messages window ............................................................................................... 19
3.2 Error diagnostics in ADePT....................................................................................................... 20
3.3 Understanding the output of ADePT........................................................................................... 22
4. Common tasks..................................................................................................................................... 25
4.1 Generating tables on a subsample of observations..................................................................... 25
4.2 Generating tables of frequencies and tables with standard errors ............................................. 29
4.3 Describing complex survey design in ADePT............................................................................. 30
4.4 Defining missing values in ADePT............................................................................................. 30
4.5 Specifying expressions in variables fields ................................................................................... 32
4.6 Simulations with ADePT............................................................................................................. 33
5. Adjusting the settings of ADePT ........................................................................................................ 35
5.1 Using ADePT with different languages ...................................................................................... 35
5.2 ADePT computational engine ..................................................................................................... 37
5.3
Viewer for ADePT output files.................................................................................................... 38
5.4 Selecting the computational engine and output viewer............................................................... 38
6. Working with Projects in ADePT ....................................................................................................... 39
6.1 Using ADePT project files on a different computer.................................................................... 41
6.2 Replicating the results obtained with ADePT............................................................................. 41
7. Using ADePT in a batch mode ........................................................................................................... 41
-
7/27/2019 Guide to ADePT
3/50
3
8. Updating ADePT ................................................................................................................................ 43
9. Troubleshooting ADePT ..................................................................................................................... 44
9.1 Problems during installation ...................................................................................................... 44
9.2 Debug mode ................................................................................................................................ 45
Appendix 1: List of data checks.................................................................................................................. 46
Appendix 2:................................................................................................................................................. 46
2.1. Data conversion ................................................................................................................................... 46
2.2. Assigning and using labels in ADePT ................................................................................................. 47
Appendix 3: Portable ADePT ..................................................................................................................... 48
Index............................................................................................................................................................ 49
-
7/27/2019 Guide to ADePT
4/50
4
1.System Requirements1.1Hardware requirementsCPU: ADePT works on any modern computer.
Faster CPUs will reduce the time required for ADePT to process jobs.
ADePT can use the power of multi-processor computers when used with
Stata MP.
Disk space: ADePT requires 40 MB of disk space to install.
However, running ADePT creates temporary copies of your datasets 25%to 50% larger than the originals, so how much disk space you require will
ultimately depend on how large your datasets are.
Memory: ADePT requires a minimum of 512 MB of RAM to operate.
In general it is a good idea to have twice the amount of physical memorythat you will need for your datasets. If you are using a dataset that is more
than 700 MB then you may want to use 64-bit Stata and increase memory.
Display: ADePT requires at least 1024x768 screen resolution.
Internet Connection: ADePT does not require an active Internet connection for generating
output results. An Internet connection is needed for program updates.
1.2Software requirementsOperating System: ADePT requires Microsoft Windows operating system. The minimum
required operating system is Microsoft Windows XP. ADePT will workon Microsoft Windows Vista, Microsoft Windows Server 2003 and later,
and Microsoft Windows 7. It works in both 32- and 64-bit Windows
environments.
ADePT will not work on MAC OS or Linux operating systems.
.Net Framework: ADePT requires Microsoft .Net Framework 2.0 or later. Most recentMicrosoft operating systems come with .Net Framework, or will allow for
its installation.
To check whether your computer has .Net Framework installed, navigate
Windows Explorer to the folder where Windows is installed (typicallyC:\Windows\), then proceed to folder Microsoft .Net, then to Framework.
There will be several subfolders in this folder with names like 1.0.3705,
-
7/27/2019 Guide to ADePT
5/50
5
1.1.4322, and so on. The largest version shows the newest version of .Net
Framework installed. If you do not have any of these folders on your disk,
your computer does not have Microsoft .Net Framework.
If your system does not contain .Net Framework 2.0 or later, please
download and install .Net Framework from Microsofts website. At thetime of this writing, .Net Framework 3.5 is the latest available version. Itcan be downloaded from the Microsoft website.
Note: installation of Microsoft .Net requires administrator rights.
Computations: ADePT uses the Stata computational engine to perform all calculations.
ADePT can use Stata version 10 or later (all flavors except Small Stata) or
Numerics by Stata (included in ADePT) for calculations. Both Stata andNumerics by Stata are products of StataCorp LP:http://www.stata.com.
Output viewer: Microsoft Excel for Windows (version XP or later) is required to displayADePTs results. The free Microsoft Excel Viewer can also be used to
view the results generated by ADePT.
1.3Installation of ADePTADePT 4.1 installation file adept_install.exe is available from our web page:
www.worldbank.org/adept.
To save this file to disk, right-click it with the mouse, select from the menu,
and specify the folder on your disk where you want it to be saved. After the file is downloaded,
execute it. ADePT installation will display the License Agreement.
http://www.stata.com/http://www.stata.com/http://www.stata.com/http://www.worldbank.org/adepthttp://www.worldbank.org/adepthttp://c/AD_data/Manual/screenshots/license_agr.pnghttp://www.worldbank.org/adepthttp://www.stata.com/ -
7/27/2019 Guide to ADePT
6/50
6
You have to accept the license agreement in order to proceed.
The installation wizard then asks where ADePT should be installed. Note that you must havepermission to write to this directory during installation and when it is running. Use the
button to specify the folder or type the path in the Destination Folder box.
Click the button to start copying the files. After installation (message Completed is
in the messages window), you can close the installation wizard.
The ADePT program will start automatically after the installation succeeds. To start ADePT thenext time, click on the ADePT icon in the ADePT Software program group in the Windows Start
menu.
http://c/AD_data/Manual/screenshots/setup_compl.pnghttp://c/AD_data/Manual/screenshots/instal_folder.png -
7/27/2019 Guide to ADePT
7/50
7
2.How does ADePT work?2.1Starting and closing ADePTTo start ADePT, go to the Windows Start menu and select the ADePT icon from the ADePT
Software program group. You can also create a shortcut to ADePT on your desktop. To do this,
use your mouse to drag the link to ADePT from the Start menu and drop it to your desktop.
On start, ADePT provides a choice of modules currently available. Users who work mostly with
one module can suppress this choice by unchecking the corresponding check box in the module
choice window. In this case, ADePT will automatically load the last used module when it starts.
To switch to a different module, use item in the menu of
ADePT(Menu Bar [6]).
http://c/AD_data/Manual/screenshots/ADePT_start.png -
7/27/2019 Guide to ADePT
8/50
8
1. Data/Variables Window2. Main Form Window3. Table and Graph Window4. Table Description/System Messages
Window
5. Process Indicator6. Menu Bar7. Datasets Tab8.
Global Filter Tab9. Variables Tab
10.Dataset Control Buttons11.Datafile Type Control12.List of Loaded Datasets13.Show Changes Controls
14.Variables Tab15.Parameters Tab16.Missing Values Tab17.Survey Settings Button18.Status Bar19.Selected Table Statistics20.Table and Graph Tree21.Frequencies and Standard Errors Check
Boxes22.Table Description Tab23.System Messages Tab24.IF-condition Field25.IF-condition Set/Clear Button26.Generate/Stop Button
87
6
5
1
13 12 11
10
9
2
18
17
16
15
14
23
26
3
22
21
20
19
25
4
24
http://c/AD_data/Manual/screenshots/full_screen.png -
7/27/2019 Guide to ADePT
9/50
9
ADePT can be closed by selecting the item in the menu [6] or by clicking the
cross-button in the windows header. It cannot be closed when the computations are running, but
the computations can be interrupted with the button [26]. On closing, ADePT remembers
the size of its window, the last used module, and the settings and content of the input fields. At
the next start the user finds the program in the same state as it was when ADePT was closed. The
content of the input fields saved only if tables were successfully produced.
2.2How does ADePT work?ADePT is a software platform designed to produce sets of tables and graphs based on the micro-
level data. It consists of modules, each generating tables in graphs in a particular area of
economic research. To produce the desired set of results a user needs to:
1. Start ADePT.2. Load datasets (one or several) into ADePT.3. Fill in the Main Form [2].4. Set the auxiliary parameters.5. Select tables and graphs to create [19].
After the required inputs are specified, the user presses the button [26] to generate
the output. From that point ADePT works automatically, informing the user about the progress
and detected problems. There are several stages in this process.
First, ADePT prepares the data based on the users specifications. The two (optional) steps here
are recoding of missing values [16] (see Defining Missing Values in ADePT) and applying a
global filter [8], which restricts the data to a subset of observations satisfying certain conditions(seeGenerating tables on a subsample of observations). Next, ADePT checks whether variables
entered by the user correspond to the requirements defined for each particular variable. While
doing that, ADePT checks whether the entered variables are of a correct type (categorical,
continuous, dummy, etc.) and have a proper number of unique values, and conducts consistency
checks on particular variables (see Data checks in ADePT). This process is repeated for all
datasets loaded into ADePT.
In the next stage, ADePT checks the consistency of categories for the variables defined in
different files. For example, ADePT checks whether the variable entered into the region field in
the first year file contains the same number of categories as that variable in the second year file.ADePT signals to the user with error messages, warnings, and notifications (see Error
diagnostics in ADePT) about all the problems that it finds with the input data. If a problem is
found in a particular variable, its name is highlighted in the Main Form [2].
-
7/27/2019 Guide to ADePT
10/50
10
In the next stage, ADePT generates temporary variables required for calculations. It tries to use
information specified by the user to produce variables that are consistent with each other. For
example, ADePT calculates household size and household composition variables from the
variables defining household ID and age and gender of household members. By doing so,
ADePT makes sure that all tables in a particular module are internally consistent (i.e., numbers in
one table do not contradict the numbers in other tables).
Finally, ADePT begins producing tables and graphs. ADePT computational kernel conducts
calculations and then sends the results of these calculations to the formatting routine that writes
every table and graph on a separate sheet of an output workbook. When all tables and graphs are
generated, ADePT instructs the output viewer, MS Excel, MS Excel Viewer, or some other
program, to open the file with tables and graphs (seeViewer for ADePT Output files).
The next sections of this manual discuss all the above steps in detail.
2.3Loading data into ADePT
ADePT can process data in Stata (.dta) or SPSS (.sav) formats. To load a dataset into ADePT
press the button [10] and select the dataset you want to load in the Open dataset
dialog.
Click the button and the name of the selected dataset appears in ADePTsDatasets tab
[7]. The full path of the selected dataset and information about the number of variables and
observations in the dataset as well the size of the dataset is shown in the Status bar [18].
You then need to specify a label for this dataset. The label will be used in the tables and graphs
to distinguish the statistics generated from different datasets.
http://c/AD_data/Manual/screenshots/status_bar.pnghttp://c/AD_data/Manual/screenshots/load_data.png -
7/27/2019 Guide to ADePT
11/50
11
The label could be any word or number, but we recommend labeling datasets with the numeric
date corresponding to the time of data collection. Several statistics produced by ADePT use this
information to calculate the time span between the surveys. For example, you might want to
label the dataset from the 2002 survey with the label 2002 and the dataset from the 2005
survey with the label 2005. Then ADePT will calculate the difference of three years between
these two surveys and will be able to calculate the annualized rates of changes for generated
statistics.
Repeat this process if you want to load more than one dataset into ADePT. Depending on the
module, you can load one or several datasets into ADePT.
In some modules, if more than one dataset is loaded you can ask ADePT to produce, in addition
to the statistics for each loaded dataset, the output with the changes between any two time
periods. Click the check box [13] and select the datasets
between which you want the changes to be outputted. The datasets in the drop-down lists are
identified by their labels.
Depending on the module, you might also need to specify whether the datasets you are loading
contain individual- or household-level data [11].
The observations in the individual-level files contain information about individual respondents.
Each household could be represented by several records/observations for the members of this
household. In the household-level data, each record/observation corresponds to a singlehouseholdthere is only one observation per household. Note that this is not an arbitrary
parameter and it must correspond to the structure of the data you are loading. If an individual-
level dataset is loaded in ADePT and you specify its type as a household-level dataset, the
statistics calculated by ADePT will be incorrect. To select the type of the data you are loading
into ADePT, click a corresponding dataset control radio button on the top of the Datasets Tab
[7].
http://c/AD_data/Manual/screenshots/show_changes.pnghttp://c/AD_data/Manual/screenshots/enter_label.png -
7/27/2019 Guide to ADePT
12/50
12
You can adjust this setting after the data is loaded but before the analysis has begun. Note that
the set of required variables might differ depending on whether an individual- or household-level
of data is specified. This is because ADePT is trying to ask as few questions as possible and
depending on the type of the dataset can find some of the required information itself.
If you use Stata as a computational engine for ADePT (as opposed to Numerics by Stata), the list
of Dataset control buttons [10] on the left-hand side will change. You can now open the selected
dataset in Stata by pressing the button. You can use Stata to, for example,
browse the observations in the dataset, modify existing data and create new variables, etc.
You can remove a dataset from the list of datasets loaded in ADePT by pressing the
button [10]. Removing all datasets from the list will deactivate the ADePT interfaceneither
variable fields nor tables and graph trees are accessible.
The content of the loaded datasetthe names of the variables and the variables labelscould be
shown in the Variables tab [9] located behind the Dataset tab [7].
The Variables tab [9] shows the content of the dataset that is currently selected. The tab title
shows the label of the selected dataset. You can search for a particular text in variables names
http://c/AD_data/Manual/screenshots/hh_ind_button.png -
7/27/2019 Guide to ADePT
13/50
13
and labels by using the search field located on the bottom of the tab (seeSpecifying variables in
ADePT).
2.4Specifying variables in ADePTAfter you load data, the next step is to tell ADePT what variables in the loaded datasets
correspond to the fields required to produce the output. In other words, you need to map
variables in your data to the fields on the Main Form [2]. Each module of ADePT has its own set
of fields, but the process of defining the fields is similar across the modules.
ADePT does not require predefined names to be specified in the input fields. Users can enter any
variable name from the loaded dataset. For example, if a dataset variable S10_Q12 indicates
urban locations, this name should be entered into the field that requires an urban indicator. In
another dataset a variable for urban locations could be named CITY and this name should be
entered in the urban indicator field. The only assumption ADePT makes is that the variables are
named consistently if multiple datasets are loaded. In other words, if the user specified S10_Q12
as an urban indicator, this variable should exist and have this meaning in all loaded datasets.
ADePT checks if this assumption is true and reports to the user if the varialbe is missing in any
of the loaded datasets.
There are four types of inputs on the ADePT forms:
1. Fields for variables of different types:a. Continuous variables: in ADePT, a variable is considered to be continuous if it
has more than 50 distinct numeric values. An example of a field that requires a
continuous variable is the Welfare aggregatefield on the Poverty Module.
b. Categorical variables: a categorical variable in ADePT is a numerical or stringvariable containing less than 50 distinct and integer values. If a string value is
entered in such a field, ADePT generates a numerical variable with categories
http://c/AD_data/Manual/screenshots/var_tab.png -
7/27/2019 Guide to ADePT
14/50
14
corresponding to the distinct values in the string variable. An example of a
categorical variable field is Sector of employmentin the Labor module.
c. Dummy variables: a dummy variable in ADePT is a variable with only twodistinct values. The fields requiring dummy variables accept a numerical dummy
variable or a logical expression based on an existing variable in the users dataset
(seeSpecifying expressions in variables fields). An example of a dummy variable
field is the Genderfield in Poverty or Labor modules.
2. Compound fields are used when a user is asked to specify not only a name for thevariable but also to provide some additional information on that variable. The compound
fields contain several controls to define multiple characteristics of a variable. The
compound fields are used, for example, in the Programs tab of SP module, or in the
Missing Values tab (seeUsing compound fields in ADePT).
3. Other parameter inputs are used to set scalar parameters: as in other Windows programs,check boxes are used to specify binary options (for example, whether the missing values
should be recoded according to the user-specified rules) and spin-edits allow entering ofnumerical parameters, such as duration of primary schooling, in the Education module.
Note that some fields allow multiple variables to be specified. For example, one or two poverty
lines can be specified in the Poverty module, and even more variables can be specified in the
household ID field in various ADePT modules.
Some of the ADePT fields allow specifying multiple variables that will be treated as a list.
Consider, for example, the household ID field. The typical household ID variable can be of two
types. First is a household ID that determines which household the observations belong to
regardless of the values of other variables. This is the type of household ID that ADePT expects.In some datasets, however, a household is identified not by household ID alone, but also by
taking into account other variables, such as the regional identifier. This can be the case when the
household IDs were assigned independently by interviewers in different regions, and thus
overlaps in ID values between different households become possible (however, there is no
overlaps within each region). In this situation, specify all the variables that allow one to uniquely
identify a household in the household ID field of ADePT. In the variables lists, separate the
individual variables with whitespaces. In the example below, if regno is the variable containing
the region codes and the ID is the variable holding the household identifiers within each region,
we would specify: HHID=regno id.
ADePT will process this list of variables internally and create its own household ID variable,
which would identify each household in the loaded datasets. Note that when you drag and drop
variables from the list of variables to ADePT fields that support multiple variables specification
they will not replace the value, which is already there, but be appended to it.
-
7/27/2019 Guide to ADePT
15/50
15
The Main Form [2] with variable fields is located below the Datasets tab [7]. When the cursor is
positioned in a field on the Main Form [2], the Status bar [18] shows the description and the
requirements for the variable to be specified in that field; it tells the user what variable is
expected to be specified in this field, its type, and whether or not the variable is a required
variable in the current module.
At the same time, the list of variables in the current dataset will be shown above the Main Form
[2]: the Datasets [7] tab changes to the Variables tab[9], which displays the names and labels of
the variables in the loaded datasets. The tab shows the content of the currently selected dataset
(first dataset in the list by default) and the tab title shows the label of the selected dataset. Drag
and drop the selected variables into the corresponding fields on the Main Form [2]. Note that the
type of the selected variable (numeric or string) and its name and label are shown in the Status
bar [18].
http://c/AD_data/Manual/screenshots/main_form.png -
7/27/2019 Guide to ADePT
16/50
16
You can search for any part of the variable name or label using the search filter field. For
example, typing ur selects variables with names or labels that contain the string ur. To clear
the search filter, delete all the characters in the search field.
You can also use a drop-down list in the field to specify a variable. Alternatively, you can type
the variable name into the field. We recommend using the drag-and-drop method from the
Variables tab [9] because this method is fast and more convenient for the datasets that contain a
large number of variables, and it reduces the possibility of errors when entering the variable
names. The drop-down lists take a long time to navigate if the loaded datasets contain a large
number of variables. The direct manual entry of variable names could lead to misspelled variable
names and thus in errors in ADePT execution, but typing into the variable field is the only way
to specify expressions in the fields (see Specifying expressions in variables fields). Note that
variable names are case sensitive and should be specified exactly as they are in the dataset.
If several datasets are loaded, ADePT can disable drag-and-drop capabilities for variables thatare not present in all datasets. These variables are then shown in grey (disabled) in the Variables
tab. This check is activated with the check box on the
Variables tab.
2.5Using compound fields in ADePTSeveral modules of ADePT use compound fields. The idea behind these fields is to allow the
management of several input elements as a single unit within ADePT. For example, in the Social
Protection module we specify the program type, program name, and benefits amount as a single
element in a list of programs. ADePT treats this information as referring to a single unit: an
element of a list, a program, etc. While the properties of the compound fields might be different
for the different modules, all compound fields have common elements and behavior.
http://c/AD_data/Manual/screenshots/search_field.pnghttp://c/AD_data/Manual/screenshots/dropDown_menu.png -
7/27/2019 Guide to ADePT
17/50
17
The compound fields always contain two or more elements, one of which is a field where the
user has to provide a variable name. You can drag and drop a variable from the Variables tab [9]
to fill this field. To be able to add a unit to the list, fill in all required elements of that unit and
press the button. For example, the Missing Values tab [16] contains a compound field
managing the user-specified list of missing values. Each unit in the list contains two elements:
the names of the variables to be recodedfield Variable(s); and the values that should be
replaced to missing field Missing Value(s). Both elements are required; the user needs to
specify a variable name and enter a missing value to append the list. Elements already in the list
can be removed with the button.
Similarly to the simple variable fields, compound fields can be required for analysis. It is
important to make a distinction between required elements of a list unit and the whole compound
field that is required. An element is required if a unit cannot be posted in the list without this
element being specified. All, some, or none of the elements may be required. The whole
compound field is considered required if ADePT cannot conduct any analysis without the field
filled in. A compound field is considered filled if it contains at least one unit. For example, the
missing values compound field contains two required elements but is not a required field itself(analysis can be done even if the list is empty). For the programs list in the Social Protection
module, not all of the three elements (Type, Variable, Label) of a program are required, but the
field (a program) is requiredno analysis can be done if no social protection program is
specified.
http://c/AD_data/Manual/screenshots/miss_var.png -
7/27/2019 Guide to ADePT
18/50
18
2.6Generating tables and graphsAfter you load your data into ADePT and specify the corresponding variables you can select
tables and graphs for ADePT to generate [20]. The choice of tables and graphs is done in a tree-
like structure where they are grouped together by topic.
Each table or graph in ADePT requires particular variables to be specified and some options to
be selected. For example, a table that shows the distribution of poverty rates by geographic
regions requires three variables to be specified: welfare aggregate, poverty line(s), and the
variable that identifies the region. If one of these variables is not specified, the table cannot be
created. The title of the Table and Graph window [3] in ADePT shows the total number of tables
and graphs in the module (the Poverty module, for example, contains 38 tables and graphs), the
number of feasible tables, and the number of selected tables [19]. The feasible tables (the tables
that are possible to generate) are displayed in black while inactive tables are displayed in grey.
The tables stay inactive if any of the variables required for these tables are not specified.
http://c/AD_data/Manual/screenshots/table_descript.png -
7/27/2019 Guide to ADePT
19/50
19
The Table Description tab [22] below the Table and Graph window [3] shows a description for
the currently highlighted table, which describes the table layout and its intended use. If this table
is feasible, select the table by checking the checkbox next to the tables title. You can select
multiple tables/graphs by checking the boxes next to the title of a corresponding group of
tables/graphs. ADePT will select all feasible tables/graphs in this group.
After you select tables and graphs you want to produce, press the button [26] to
start processing the data. The progress of computations will be displayed in the ADePT System
Messages tab [23] and by the rotation of the ADePT Process indicator icon [5] in the top left
corner of ADePT window. On pressing, the green button changes into the red
button that can be used to interrupt the computations [26].
No tables or graphs are outputted if the button [26] is pressed.
3.The Output of ADePT3.1ADePT System messages windowThe ADePT Table Description/System messages window [4] is located below the Table and
Graph window [3]. ADePT uses the System Messages tab [23] to display information on the data
processing to show errors and warnings, and to indicate the progress of output generation. To
define the level of reporting in the System Messages window, on the Menu bar clickTools
Options [6] and select the Reporting tab.
http://c/AD_data/Manual/screenshots/stop.png -
7/27/2019 Guide to ADePT
20/50
20
There are three levels of reporting the user can select on that tab. If the default level of
reportingMain messages and current statusis selected, ADePT displays only the main
messages on the progress of data checking, data preparation, and data analysis, and reports
warnings and error messages. We recommend using this level of reporting in your work. Two
other levels of reportingDetailed messages and progress indication and Service messages
(debug mode)are designed mostly for troubleshooting ADePT and are rarely used.
To change a font or to clear the content of the System Messages window, right-click on the
window and select a desired optionClear Output and Select Fontfrom the menu. You may
find the option of changing the font useful for presentations when you need to make text larger
than normal.
3.2Error diagnostics in ADePTADePTconducts an extensive data diagnostic and checks whether the variables specified in the
fields satisfy the required conditions. There are three levels of problem/error reporting in
ADePT:
a. Notificationsb. Warningsc. Errors
Notifications, Warnings, and Errors are outputted during computations in the ADePT System
message and after the computations are completed in the Notification sheet of the ADePT output
file.
http://c/AD_data/Manual/screenshots/options_report.png -
7/27/2019 Guide to ADePT
21/50
21
Notifications have an informational purpose. They convey to ADePT users information about the
processing of the data and report names of the loaded data files. Notifications have no impact on
the content of tables and graphs to be outputted. The example of a notification could be amessage that informs a user that no weight variable is defined and tables and graphs are
produced on unweighted data. Notifications also serve as a reminder to the user what parameter
values were used during the analysis that are not contained within the users dataset but reflect
the users assumptions. For example, if the user specifies that the duration of primary school is
five years, this value will be outputted as a notification.
ADePT issues a warning if it detects a suspicious situation in the data but cannot be sure that this
is an impossible situation; for example:
a. A particular observation violates assumptions imposed by the parameters of ADePT: e.g.,there are pupils found reporting that they are attending the 5 th grade of the primary
school, whereas the duration of primary schooling was specified to be equal to 4.
b. A particular value of a categorical variable seems too far off compared to other values ofthis variable (an outlier); ADePT cannot be sure that this value is not legitimate.
c. Inconsistent information is found within a single dataset that is flagged by the checkingprocedures; e.g., ADePT might discover that a two-year-old child is reported to be
employed.
d. Inconsistent definitions of categories between several rounds of the survey, e.g., avariable that contains code for the regions might contain a different number of unique
values in the datasets collected for the same country in two years.
When a warning is issued, no actions are takenADePT uses all non-missing observations in
the loaded datasets to produce tables and graphs. Warnings just inform the users about potential
problems with the data.
http://c/AD_data/Manual/screenshots/notif_tab.png -
7/27/2019 Guide to ADePT
22/50
22
ADePT reports an error if the problem it has found prevents the use of the variable in the
analysis, for example, a variable does not exist in one of the datasets. In this case, after reporting
an error ADePT continues as if the variable was not specified. When ADePT can determine the
source of the problem in a particular variable field, this field is highlighted on the form.
Problems may be resolved in one of two ways: adjusting the parameters/input of ADePT, e.g.,
checking that parameters of the educational system agree with the actual situation in the country
under consideration, and adjusting the input datasetsthe user needs to use Stata or SPSS to
correct such problems.
Notifications, warnings, and errors are just as important as the results that ADePT produces and
should be carefully reviewed before any conclusions are made from the tables and graphs.
Please refer toAppendix 1for the complete list of data checks ADePT performs.
3.3Understanding the output of ADePTAfter the user clicks the button [26] on the main form, ADePT writes the generated
tables and graphs into a new MS Excel xml-type file.
Each output filea workbookcontains:
a sheet with a table of contents. a sheet with notifications. sheets with requested tables and graphs.
The first sheet (Contents) in this workbook displays a table of contents that lists all tables and
graphs contained in this output file produced by ADePT, and indicates to the users if any of the
requested tables or graphs have not been created because of an error. ADePT also reports on the
Contents sheet the time it took to generate the current output.
-
7/27/2019 Guide to ADePT
23/50
23
In addition to the table of contents, ADePT always produces a Notifications sheet that
contains error, warning, and notification messages about the problems discovered during the
preparation of this output file (seeError diagnostics in ADePT). To alert users about encountered
problems, the color of the Notification tab changes from neutral to yellow if it contains any
warnings and to red if it contains any error messages.
The rest of the output file comprises sheets with requested tables and graphs. Each table and
graph is placed on its own sheet.
The list of tables and graphs in every module of ADePT contains the Original Data Report
table that provides basic information on datasets and variables loaded in ADePT. In particular,
for each variable specified by the user, this table presents information on: the number of non-
missing observations; mean, minimum, maximum, and selected percentiles; and the number of
unique values in the variable. It provides useful information about the data loaded into ADePT
and, in many cases, can help resolve problems related to the discrepancy of the results generated
on different datasets. We always recommend producing and carefully reviewing the Original
Data Reportbefore starting analysis of the data with ADePT.
http://c/AD_data/Manual/screenshots/contents_tab.png -
7/27/2019 Guide to ADePT
24/50
24
If tables of standard errors or frequencies are requested, they are placed on their own sheets (see
Generating tables of frequencies and tables with standard errors). The structure of these tables
replicates the structure of the main tables, with the additional information of standard errors or
frequencies. Thus, each table in ADePT can be produced in three versions:
Sheet contents Color of the tab
Main print-ready tables neutral
Same as main, with standard errors green
Frequencies blue
ADePT formats the output, but all data are stored with full precision, which facilitates further
analysis.
To navigate through the ADePT output you can click on the title of a table or graph in the table
of contents, or scroll through and select the sheet of the workbook where the table or a graph is
saved. If some of the tables were not created because of errors, you can open the Notifications
sheet with the description of these errors by pressing on the NOTE about the error.
http://c/AD_data/Manual/screenshots/precis_data.pnghttp://c/AD_data/Manual/screenshots/origRep_tab.png -
7/27/2019 Guide to ADePT
25/50
25
4.Common tasks4.1Generating tables on a subsample of observationsYou can focus your analysis on a particular subpopulation either in all or in some tables/graphs.
The Global Filter [8] is used to keep in the analysis only those observations that satisfy certain
requirements. Its effect propagates to all tables and graphs in an active module and has the
highest priority in ADePT.
The Global Filter tab [8] is located next to the Datasets tab [7] in the Data/Variables window
[1] and becomes visible when at least one dataset is loaded into ADePT. The tab contains a
check box, Apply the filter, and the field for a logical condition to be used in keeping
observations for analysis. You can specify any valid Stata logical expression in that field (see
Specifying expressions in variables fields). When an expression for the Global Filter is specified,
ADePT keeps only the observations that satisfy this condition. Note that because the GlobalFilter is applied to the early stage of data processing, using the Global Filter will result in faster
calculations compared to specifying IF-condition to all tables or graphs.
For example, to produce tables and graphs for respondents under 40 years of age in a particular
region of the country, enter age < 40, region = 11 in the Global Filterfield. ADePT will drop
all observations where region is not equal to 11and age is greater than 40, and will generate
tables and graphs only for observations that satisfy specified conditions.
In addition to the global filter, individual tables and graphs may have their own specific
restrictions on observations that are included in the analysis. The individual conditions do not
replace, but rather augment the global filter so that only observations that satisfy both the global
filter and the individual IF-condition [24] are included in the analysis. Applying an IFcondition to a group of tables (graphs) is equivalent to applying the same IF condition to all
tables (graphs) in that group.
http://c/AD_data/Manual/screenshots/if_cond_bar.pnghttp://c/AD_data/Manual/screenshots/filter.png -
7/27/2019 Guide to ADePT
26/50
26
The purpose of IF-conditions is to include observations from a particular subgroup of a population in the
analysis. The inclusion condition is formulated as a Boolean expressiona function of the variables
existing in the users dataset. Each particular observation is included in the analys is if it satisfies the
inclusion condition (the Boolean expression evaluates to value true). In many cases, the conditions we
use are quite simple. Consider the following examples:
If-condition Interpretation
urban=1 Only those observations having the value of variable urban equal to one will
be included in the analysis.
region==5 Only observations from the region with code 5 are included in the analysis.
age_yrs>=16 Only those individuals who are 16 years old or older are included in the
analysis.
sland!=0 Exclude from analysis those individuals who are not landowners (given that
the variableslanddenotes the area of the land owned).
Stata users will note the difference that there is no need to write the word IF before IF-conditions and
that == can be used interchangeably with =.
You can specify more narrow groups by restricting several dimensions simultaneously as in the following
examples:
If-condition Interpretation
(urban=1) & (region!=1)
Include observations from all urban locations, exclude the first region (e.g.,
the country capital).
(sland>0) | (rland>0) Include individuals who own or rent land.
(edu_yrs>8) | (prof_edu==1)
Include skilled individuals only, defining a skilled person as one who has
more than 8 years of education or received professional education.
Note that in these expressions we use symbols & and | to denote logical AND and logical OR
operations. In order for A&B to be true, both A and B must be true. In order for A|B to be true, any one
of A or B must be true.
Finally, you can specify any of the functions available in Stata in the IF-conditions. For example:
If-condition Interpretation
inlist(region,1,3,5,6) Include only observations from regions with codes 1, 3, 5, and 6.
inrange(age, 15, 65) Include individuals aged between 15 and 65.
((male==1) & inrange(age,15,65)) |
(male==0) & inrange(age, 15, 60))
Include only individuals of working age, which is defined differently for men
and women.
!missing(sector) Exclude observations with missing values in variable sector.
-
7/27/2019 Guide to ADePT
27/50
27
When you specify IF-conditions, be aware that ADePT follows Statas convention that missing
values are considered to be infinitely large numbers. Hence the expression (age > 65) evaluates
to true not only when the age ofthe responders is greater than 65 years but also if the value of
variable age is missing. Use parentheses to indicate the order of evaluation for complex
expressions.
When IF-conditions are evaluated, each observation is treated independently from another. This
means, for example, that to exclude all households where the household head was born abroad,
we must either be working on the household level (then person-specific characteristics refer to
household heads) or we must have a variable place-of-birth-of-household-head defined for each
individual in the dataset (and consistent within each household) instead of the place-of-birth
variable. If the IF-condition is based on the place-of-birth variable, this will not exclude the
children living in the households with foreign-born household heads.
To specify an IF condition, select a table (group of tables, all tables), then click on the IF-
condition field [24] in the bottom of the Table description tab, enter the expression to restrict
the sample of observations, and press the button [25].
-
7/27/2019 Guide to ADePT
28/50
28
Any tables (graphs) that have an IF-condition applied to them are highlighted in yellow. To
remove the IF-condition, select the object to which the IF-condition was applied and press the
button [25] next to the IF-condition field. The IF-condition specified for a table is
outputted below the table. The definitions of IF-conditions are not saved in the project file.
For example, to generate Table 2.2 only for households residing in regions with the codes lower
than 3, enter region < 3 into the IF-condition field. You can use any valid Stataexpressions to
form IF-conditions. IF-conditions may include any variables from the users datasets, not only
those that ADePT has requested in the variables specification form. However, it is the usersresponsibility to ensure the validity and consistency of these variables, as ADePT has no prior
knowledge to allow it to conduct checks on them.
A combination of the global filter and individual IF-conditions for tables may become too
restrictive, and it is the users responsibility to make sure the conditions do not contradict each
other and do not remove all the observations from the sample. For example, if the global filter
http://c/AD_data/Manual/screenshots/if_cond.png -
7/27/2019 Guide to ADePT
29/50
29
selects only urban population and an IF-condition applied to a particular table selects only rural
population, then that table may not be constructed because there will not be a single observation
that could satisfy both conditions simultaneously. While the contradiction may be obvious in this
example, it may not be transparent in the population with complex dependencies between, say,
the sector of employment, education level, and other factors. If the effective condition (the
combination of the global filter and the individual IF-condition) is so restrictive that no
observations satisfy it, the table (graph) will not be constructed, an error message will be added
to the list of messages, and the table (graph) will be marked red in the selection tree.
While it may look the same when a global filter is specified and an IF-condition is applied to all
tables (graphs), there are differences that sometimes become important. The cause of these
differences is the fact that the global filter has the highest priority and is applied on the data
preparation stage before the beginning of the analysis. This has two consequences.
First, the global filter can be used to remove the observations from the analysis that causeproblems with the data checks. Normally, if the problem is caused by a particular value of a
certain variable, that value can be recoded to a missing variable to exclude that outlier. However,
in some cases an outlier would have all the individual variables in order, but a combination of
their values would be impossible. For example, we may want to apply the global filter to remove
all the respondents under age 5 if they report attending a school. If we apply this condition, no
warning will be issued, as these observations are completely excluded from the analysis before
the checks are conducted. If the same condition was applied to a particular table the warning that
very young children are attending schools would be displayed, even though these observations
would later be excluded from that table.
Second, the global filter might affect the values of the variables that ADePT derives from the
data. Consider the household size as an example. In an individual-level dataset, ADePT
constructs a variable for the household size by counting the number of observations with a
unique value of the household ID variable(s). If a global filter that selects only the working age
population is applied, the variable that ADePT creates for the household size will count the
number of working age individuals in a household, which could be different from the number of
household members.
4.2Generating tables of frequencies and tables with standard errorsADePT can produce, in addition to the standard tables, tables with the standard errors for the
outputted statistics and tables with frequencies. ADePT uses sophisticated algorithms to calculate
the standard errors for estimated statistics. Often, these algorithms require substantial
computational resources. The computation of tables with standard errors takes more time than
the time needed to calculate standard tables. In some cases, this difference in time can be in the
order of magnitude. We recommend that users start working with ADePT by generating standard
-
7/27/2019 Guide to ADePT
30/50
30
tables. After you obtain the desired results in standard tables, you can produce the final set of
results with standard errors.
Tables with frequencies show the unweighted number of observations that were used in the
calculation of a particular cell in a table. There is no extra time required to produce tables of
frequencies relative to the time to produce standard tables. To output tables with standard errors
and tables with frequencies check the check boxes and
[21] located next to the button [26].
4.3Describing complex survey design in ADePTADePT can account for a complex survey design when it calculates standard errors for the
estimates. In particular, users may specify multiple stratification designs, final population
corrections, survey weights, and options of how the standard errors of the estimates must be
computed.
Most surveys will include one or more weighting variables. Consult the survey documentation to
determine which weighting variable must be used for your analysis. If weights is the only survey
design parameter that you would like to specify in ADePT, you can input it on the form among
the other variables.
ADePT always expects household weights irrespective of whether the data is at household or
individual level.
If other parameters of the survey design need to be specified, click the
button [17] and fill in the form describing a complex survey design.
4.4Defining missing values in ADePT
http://c/AD_data/Manual/screenshots/hhweights_sset.pnghttp://c/AD_data/Manual/screenshots/stand_errors.png -
7/27/2019 Guide to ADePT
31/50
31
ADePT does not remove an observation from the sample if any of the used variables has a
missing value in it. Instead, ADePT reacts to missing values intelligently, ignoring the
observations with missing values from analysis if the missing values are involved in the analysis
for a particular table/graph. Missing values in Stata and SPSS datasets are assigned particular
codes that ADePT is aware of. However, not all data providers use these codes. For various
reasons some datasets contain values 9, 97, 98, 99, 997, etc., performing the functions of the
missing value code (one variable may use multiple such codes for refusal , dont know, not
applicable, etc.). If this is the case, it is crucial that ADePT be informed about such codes and it
will ensure that they are recoded to missing values before any analysis is undertaken. The
missing values can be defined in the Missing Values tab [16]. To activate the Missing Values
tab, on the Menu bar [6] clickTools Show missing value tabthe new tab Missing Value
will appear next to the Variables tab[9]in the Main Form window.
ADePT receives information about missing values as a list of pairs of elements: variable(s) and
missing value code(s). The following combinations are possible: one variable and one missing value. one variable and multiple missing values separated by spaces. multiple variables separated by spaces and one missing value. multiple variables separated by spaces and multiple missing values.
A particular variable can be mentioned in multiple lists of variables and a particular value can be
mentioned in multiple lists of missing values.
The missing values tab contains the (initially empty) list of such pairs and controls to append this
list. To define missing values:
1. enter one or more variable names into the first field, separate variable names with spaces.2. enter one or more values into the second field, separate multiple values with spaces.3. click the button.4. repeat (if necessary) for other variables and values.
You can add as many definitions of missing values for the variables in your dataset as you wish.
The example below shows how to recode values 98 and 99 in the variable defining education. To
do that, drag and drop the obrazovanjevariable into the Variable field, enter 98 and 99 into theMissingValues field, and press the button.
-
7/27/2019 Guide to ADePT
32/50
32
The information about the user-defined missing values is saved into the project file and will be
invoked when the project file is opened (Check, Add to project file). If the definitions of missing
values were stored in a project file, the Missing Values tab will be shown automatically when
this project file is loaded.
4.5Specifying expressions in variables fieldsSome of the variables (e.g., urban and gender) are treated in ADePT as dummy variables andthus must have only two values (if a variable is used). Internally ADePT assigns specific
meaning to particular values of these variables, for example, 1 denotes urban population in the
urban variable. However, the coding of these variables might be different in the users datasets.
If this is the case:
recode original data to match ADePTs expectations, e.g., 1 = male, 1 = urban, 1 =household head.
specify an expression instead of a variable name, which ADePT will evaluate and takethe result as a corresponding indicator.
Expressions come in handy when a variable does not exist in the dataset exactly in the way
ADePT expects it, but can be derived from the existing variables using a simple transformation.
This applies only to dummy variables (because the result of expression evaluation is binary by its
nature) and to categorical variables to the extent that a categorical variable is a generalization of
a dummy variable.
http://c/AD_data/Manual/screenshots/miss_var.png -
7/27/2019 Guide to ADePT
33/50
33
Consider the following example: in the original dataset variable, URBAN takes values 1 for rural
and 2 for urban population. Because there are several data files (each corresponding to a different
year), it may be cumbersome to recode this variable into the format that ADePT expects. It might
be easier to specify an expression of the following type:
URBAN==2
ADePT generates a new variable in each dataset. The variable will take the value 1 whenever
URBAN was equal to 2. For all other values (in this case, 1s), this new variable will take a value
of 0. Missing values of URBAN will remain missing.
The following transformations may be applied:
varname == const
varname != const
varname > constvarname >= const
varname < const
varname
-
7/27/2019 Guide to ADePT
34/50
34
into ADePT and generating tables and graphs comparing the statistics between the original and
the simulated scenarios.
You must have a full version of Stata to continue.
Start ADePT and switch to the module most appropriate for your topic of analysis. Add the original file to the list of files. You will use this file to derive the simulated data. Click the button [10]. A new Stata session will start and the dataset will
automatically be loaded to Stata.
From this point you can issue Stata commands that modify the dataset according to yourassumptions. Make sure that instead of creating new variables you are modifying the
original variables (recall that when working with multiple datasets, ADePT assumes that
the variable names are the same in all the datasets). For example, suppose that each
individuals consumption is stored in variable v021 and you want to investigate how a 10 percent consumption subsidy to rural households will affect aggregate poverty rates. You
type command:1
replace v021 = v021 * 1.10 if rural == 1
When you finish modifying the data, save it to a new file. For example, you might wantto save the simulated data in the file called simulated by typing the command in Stata:
save simulated, replace
Close the Stata session by typing exit in the Stata command prompt and add thesimulated dataset into the files list of ADePT.
Select show changes in the files list. If there are only two datasets in the list , ADePTwill automatically select them to be compared.
Note that ADePT does not take into account the fact that second dataset is simulated, so the
standard errors reported by ADePT for simulated indicators and for the differences may be
incorrect.
The simulations can be quite complex. For example, you may want to first model the
dependency of income and consumption from education, then simulate an increase in education
and then re-estimate the income and consumption after the reform.
1Refer to the Stata manuals for description of Stata commands. Type help in Statas command line to bring up the
electronic documentation for the installed version of Stata.
-
7/27/2019 Guide to ADePT
35/50
35
5.Adjusting the settings of ADePTIn this section we will discuss the options that affect the work of all modules of ADePT, such as
the language of interface, the computational engine, and the output viewer.
5.1Using ADePT with different languagesTo provide a comfortable working environment for the users whose native language is not
English, ADePTs language can be changed. This change (software localization) affects both the
interface of the program (menus, dialogs, error messages, etc.) and the reports produced with
ADePT (table titles, table notes, sheet names, etc.).
Before changing the language, make sure you have saved your input into an ADePT project file
(seeWorking with projects in ADePT) or it will be lost when ADePT is restarted. To adjust the
language setting, open the options dialog (in the main menu, choose Tools
Options) andswitch to the localization tab.
http://c/AD_data/Manual/screenshots/options_localiz.png -
7/27/2019 Guide to ADePT
36/50
36
This tab contains two selections: one is for the code page and one for the language. To change the
language, select one of the available languages from this list and click . The dialog will close. To
apply the change of language, ADePT must be closed and reopened (see Starting and Closing ADePT).
Once the new language is set, ADePT will display all the menus, dialogs, and error messages in that
language. (Because ADePT is a fast-developing project, some new parts of the interface might not yet be
translated. In this case ADePT will display them in English.)
The choice of the coding page allows the correct display of variable names and variable labels recorded in
non-Latin script. You might need to change the coding page if your datasets contain variable names or
labels recorded in Cyrillic, Arabic, Greek, or other scripts. The reason for this is that Stata dataset format
allows storage of non-English symbols, but does not provide the code page in which they should be
represented (this is a setting on the computer on which the data was saved into the file). Thus the user
must manually try the different code pages until the localized data labels become readable. ADePT
provides a choice of the most common code pages for alphabet-based languages (Cyrillic, Greek, etc.).
Stata datasets cannot store labels in character-based languages (Chinese, etc.) and thus there is no code
page selection for them. The selection of the coding page is independent from the choice of the language.
Right-click on the
column header for the
value labels and left-clickthe appropriate encoding
name to switch to the
proper code page.
http://c/AD_data/Manual/screenshots/ADePT_module_selection_Russian.pnghttp://c/AD_data/Manual/screenshots/ADePT_module_selection_Bahasa.png -
7/27/2019 Guide to ADePT
37/50
37
This panel shows how the
variable labels are
displayed when the code
page is set properly (in
this case Cyrillic).
These panels show how
the same variable labels
as in the first panel are
displayed when the code
page is not set correctly
(Arabic, Greek, and
Hebrew respectively).
ADePT will automatically decode labels using the specified code page and show them in the
variables list panel. It may take several tries to determine which code page is the correct one. An
equivalent but somewhat faster way of switching the code page is to right-click the header of the
variables column on Variables tab [9] and select a code page in the menu that pops up. ADePT
will remember the code page setting and will use it in all modules until a new code page is
specified.
5.2ADePT computational engineADePT relies on the Stata numerical engine for computations. By default, ADePT uses
Numerics by Stata (NBS) to generate tables and graphs. NBS is a library of computational
routines developed and distributed by StataCorp. NBS is included in the ADePT installation
package and is set up as a numerical engine on installation. Users who have Stata version 10 or
later installed on their computers have the option to use ADePT with their own Stata.
-
7/27/2019 Guide to ADePT
38/50
38
The NBS has a computational functionality of the Stata SE 32-bit version 11 (currently the latest
version of Stata). Users with 64-bit Stata and users with Stata MP might prefer utilizing their
own Stata as a computational engine for ADePT, as these versions allow faster execution (Stata
MP) and an ability to load larger datasets (64-bit Stata SE and MP) compared to NBS. Using
Stata with ADePT also extends ADePT functionality by allowing users to open and modify data
files directly from ADePT (see Loading Data into ADePT).
5.3Viewer for ADePT output filesADePT saves generated results (tables and graphs) in Microsoft Excel xml format. The output
could be displayed either with Microsoft Excel (MS Excel) or with a free Microsoft Excel
Viewer. Open Office Calc can also be used to display the output produced by ADePT.
On installation, ADePT tries to locate the executable file for Microsoft Excel and use it as a
viewer for the generated results. Users who do not have Microsoft Excel installed on their
computers have an option to download and install free Microsoft Excel Viewer from the
Microsoft website:http://www.microsoft.com. This installation requires administrative rights.
ADePT first tries to read the location MS Excel executables from the Windows registry. If
ADePT cannot find this information in the registry, it searches selected folders on the local
drives.
The functionality of MS Excel Viewer is restricted to an ability to open, view, and print files
generated in MS Excel-supported formats. Users can also copy data from MS Excel Viewer toother programs. MS Excel Viewer does not allow users to modify and save a workbook or to
create a new workbook.
5.4Selecting the computational engine and output viewerTo check the setting of ADePT, on the Menu bar [6] click Tools Options and select the
Applications tab. This tab shows whether during installation ADePT managed to determine the
location of the required applications and offers options to install missing components. The tab
contains two radio buttons to switch between Stata and Numeric by Stata, fields with the paths to
Stata executables, executables for Microsoft Excel or Microsoft Excel Viewer, and the path tothe scripting host executable (we plan to remove this component in the later versions of ADePT).
The screenshot below shows an example where ADePT has successfully located all the required
components and is ready to runthe fields contain paths to required applications and are
highlighted in green. ADePT will use NBS for computation and MS Excel installed in
C:\Program Files\Microsoft Office\Office12 folder as a viewer for output.
http://www.microsoft.com/http://www.microsoft.com/http://www.microsoft.com/http://www.microsoft.com/ -
7/27/2019 Guide to ADePT
39/50
39
This screenshot shows an example where ADePT uses Stata 10 installed on the local (or
network) computer as a computational engine. ADePT tries to locate the Stata 10 or later
executable automatically on installation. If ADePT fails to find the Stata executable, users can
point ADePT to a location of this executable by pressing the button on the right of the
field with the Stata executable path. Similarly, users can specify the directory with MS Excel or
MS Excel Viewer executables on their computers by pointing ADePT to these locations. If no
MS Excel or MS Excel Viewer is found on the local computer, ADePT will still produce the
output file with tables and graphs and store it in a user-defined location.
6.Working with Projects in ADePTA project is a configuration file that contains paths for the datasets and names of variables
specified by the user in a module of ADePT. The project could be useful if you want to save the
information defined in a current session to use again later. The basic commands to work with
Project files are located in the Project menu on the Menu bar.
http://c/AD_data/Manual/screenshots/options_applic.png -
7/27/2019 Guide to ADePT
40/50
40
After uploading data files and specifying variables on the ADePT form, you can save this
information for future use by choosing and then the command [6].
Specify the destination folder and file name for the project you want to save. You can use the
command to save the project in a different location.
The saved project will store links to datasets, names of specified variables, definitions of themissing values, and the expression used in the Global Filter. Projects do not retain the list of
selected tables and graphs, the corresponding IF-conditions and frequencies, and standard errors
choices because they do not characterize the input information but rather describe the desired
output.
A previously saved project can be retrieved by selecting the element of the
menu [6]. In the window that opens, navigate to the folder containing a previously
saved project and double-click its name. The datasets are not saved into a project file; instead it
contains references to the selected datasets.
To start a new project, clear all the fields on the form by choosing and then the
command from the drop-down menu.
ADePT saves the settings of the last successfully run configuration (that is, some tables or graphs
were created) on exit and loads them automatically at startup. If you prefer to start working with
the blank project instead, you can change the default behavior by going to
and unchecking the corresponding check box [6]. The last
successfully run configuration for the current module can be recalled at any time by selecting the
corresponding command in the menu [6].
You can reuse projects saved in a particular module in other modules. In that case, the project
will load the datasets and specify variables that are present in both modules. For example, if the
project saved in the Poverty module is opened in Labor module, ADePT will automatically fill in
the fields for welfare aggregate, poverty lines, urban-rural indicator, etc., but will not be able to
fill in the fields specific only to the Labor module such as work categories, earnings, and others.
http://c/AD_data/Manual/screenshots/project_menu.png -
7/27/2019 Guide to ADePT
41/50
41
6.1Using ADePT project files on a different computerYou can use saved project files on a different computer. ADePT projects contain explicit (not
relative) paths to the data files. ADePT will try to load data files from the locations stored in the
project file. If ADePT fails to find the data files on the paths specified in the project file, it will
search for these files in the directory where the project file is located. Thus, if you want to use a
project file in a situation where the locations of the data files are different from those saved in the
project file, place your data files in the directory where the project file is located.
Saved projects could also be used in the batch processing in ADePT (see Using ADePT in a
batch mode).
6.2Replicating the results obtained with ADePTTo reproduce the results obtained with ADePT, the following must be passed to the person
replicating:
1) ADePT software: give your colleague a link to the homepage of ADePT,www.worldbank.org/adept, to download and install ADePT;
2) project files with input specifications used to obtain the original results; and3) datasets that were used to generate the results (note that the datasets are not stored in the
project file, but only the links to their location on the users drive).
It might be convenient to pack the project files and the datasets into a single archive, for example
a zip-archive, to reduce the size of the transfer. When ADePT opens a saved project file, it looks
for the datasets in the specified locations. If the person who is using your files is unable or
unwilling to re-create your folder structure on his/her computer, instruct him/her to place the
datasets in the same folder where he/she placed your project files. If ADePT does not find a
dataset in the location specified in the project file, it checks the folder where the project file itself
is located, and if the dataset is found it is taken from there.
Note that the IF-conditions are not saved in the project files. If you used any IF-conditions to
produce the original results you need to provide a description of which IF-conditions were
applied to which tables and graphs. The IF-conditions for each table and graph are displayed
below the tables/graphs in the corresponding sheets of the ADePT output.
7.Using ADePT in a batch modeADePT supports a batch mode of operation that might be helpful if you want to produce several
reports for many countries or a set of reports for the same country with different parameters, for
http://www.worldbank.org/adepthttp://www.worldbank.org/adepthttp://www.worldbank.org/adept -
7/27/2019 Guide to ADePT
42/50
42
example, different poverty lines. The batch mode minimizes human involvement in producing
the reports; ADePT creates output automatically based on the settings prepared and saved into a
project file earlier.
To use the batch mode, first start ADePT as usual and provide all the inputs as described in the
sectionSpecifying variables in ADePT: add the datasets and fill in the variables. Then save your
input into a project file of your choice (note that you do not need to generate the actual report,
i.e., press the button, to be able to save your inputs into the project file). Repeat this
for every report that you intend to produce. After all the project files are prepared, close the
ADePT program.
At this step you need to create a new batch file, which will call ADePT to produce the reports.
For every report that you intend to produce, you add the following line to ADePT:
C:\Software\ADePT\ADePT.exe D:\Projects\FirstProject.ini D:\Reports\FirstReport.xml
The line consists of three components: first is the full file name of the ADePT executable. This is
the path specified when you installed ADePT to your computer, followed by the name of the
ADePT executable: ADePT.exe.
The second parameter is the full name of the project file saved earlier.
The third parameter is the full name of the file where the report should be saved.
If any of these three parameters contains a white space, be sure to enclose that parameter into
double quotes like in the next example:
C:\Program Files\ADePT\ADePT.exe D:\Projects\FirstProject.ini D:\Final
Reports\FirstReport.xml
To run the created batch file, double-click it in a Windows Explorer window. If your batch file is
written correctly, you will see ADePT running. If you want to schedule an overnight job, use the
Task Scheduler to schedule this batch file as a new task. On a Windows Vista-based computer,
the Task Scheduler can usually be found in the Accessories/System Tools subfolder of the Startmenu. Note that not all users may have privileges to schedule tasks. If this is the case, you may
need to contact your systems administrator for assistance.
Note that we do not specify the choice of tables and graphs when ADePT runs in the batch mode.
This is because ADePT automatically determines which tables and graphs can be built based on
the user-specified inputs and creates all of the feasible tables and graphs. Note also that since the
-
7/27/2019 Guide to ADePT
43/50
43
IF-conditions are not stored in the project files, there is no way to specify table-specific inclusion
conditions in the batch mode, but you can still specify the global filter.
Here is some advice on creating batch files:
Use a text editor to create batch files (do not use MS Word) and save them as plain textwith the extension .BAT so that the Windows operating system can properly recognize
them as batch files.
If you do not remember where ADePT was installed, right-click its icon in the Start menuand the text after the Target parameter is the full file name that you need for the first
parameter.
Project files can be located in different folders, reports can be saved into different folders,and data may be located in a third place, but it is a good idea to impose some structure on
the organization of the files. It is a good idea to store all the prepared projects in one
folder, all the data files in its subfolders, and all the produced reports in a special outputfolder.
It is also a good idea to bind the project and the report with a common name, for exampleif the project is called First.ini, name the report First.xml.
Proper organization of the files will help you to navigate and back up your files moreeasily.
Some parameters apply to the ADePT program as a whole and cannot be specified ineach project individually. These are the language and code page settings and the choice
of the Stata executable and other settings that are specified in the Options dialog. If any
of them needs adjustment, start ADePT and specify them interactively before running the
batch file.
8.Updating ADePTThe ADePT team is constantly working on improvements in the functionality of the ADePT
Software platform, adding new tables and graphs to the existing modules and developing new
modules. It is thus important to keep the program up-to-date by periodically installing the
updates.
To check whether the new version of ADePT is available, on the Menu bar [6] click
ADePT will try to access the developers website and check if a newer
version is currently available. In the dialog window that opens, ADePT reports if an update is
necessary. To see the detailed information about the components that have changed and their old
and new versions click the button.
-
7/27/2019 Guide to ADePT
44/50
44
During the update ADePT will close, so be sure to save your project file before performing an
update. Click to perform the update and change the program files. ADePT will
download the newer version from the developers website, indicating the progress in a progress
bar. Once the newer version is downloaded, ADePT closes and replaces its files with the newer
ones. After this the process is complete and ADePT restarts automatically. Note that the
button will remain disabled if there is no Internet connection, and an Internet
connection must be established before opening the updates dialog. Also note that all custom
settings and values of the parameters are preserved on updates.
It is also possible to update ADePT by simply installing the most recent version on top of anexisting version. A formal uninstallation of ADePT is not required for updates, but it is possible
to do so. You can uninstall ADePT by clicking the corresponding icon in ADePTs program
group in the Windows Start menu, and all the ADePT program files are removed from your
computer.
9.Troubleshooting ADePT9.1Problems during installationThe most recent version of ADePT can be downloaded from its homepage:
www.worldbank.org/adept
Carefully study the requirements for hardware and software prerequisites before installing
ADePT. While ADePT itself does not require administrative privileges to be installed, its
http://c/AD_data/Manual/screenshots/update.png -
7/27/2019 Guide to ADePT
45/50
45
prerequisites do require such special privileges. You may need to contact your systems
administrator in case you do not have such access rights on your system. If you encounter a
problem during installation on a system that satisfies all the requirements for ADePT, we
recommend checking the FAQ section at ADePTs homepage, which addresses the common
problems and solutions discovered after the creation of this manual.
If the problem is not resolved with this additional information, do not hesitate to contact us
through the contact form on the website. To be able to help in the most efficient way we will
need the following information about your system:
a. Version of the ADePT installation that you are trying to install:1. Date when downloaded from our site (e.g., March 15, 2010).2. File size of the installation (e.g., 12,074,402 bytes).
b. Type and version of the operating system installed.1. Type (e.g., Windows XP, Windows Vista, etc.).2.
Bit-version (e.g., 32- or 64-bit).
3. Release version (e.g., 5.2.3790).4. Service packs and updates applied to the operating system (e.g., Service Pack 2).5. Language of the operating system (e.g., US American).
c. Version of the .Net framework installed (e.g., 3.5).d. Version of the Microsoft Office installed (if applicable).e. Detailed description of the problem indicating whether the problem is
reproducible.
f. Any additional information that you think may be helpful in resolving theproblem.
9.2Debug modeADePT is a complex computer program, and as in any program bugs and errors are inevitable. If
you experience any strange behavior during the computations, in particular if some tables are not
produced and you see indications of possible bugs, activate ADePTs debug mode. In this mode
ADePT will monitor its own behavior during the computations, logging the commands issued to
transform the data, which can provide key evidence in identifying problems with the algorithms
on which ADePT is based.
http://c/AD_data/Manual/screenshots/tools_menu.png -
7/27/2019 Guide to ADePT
46/50
46
To activate the debug mode, select the corresponding item in the menu
[6] before pressing the button [26]. Once the debug mode is activated, it will persist
until switched off (even if ADePT is restarted). An indication that ADePT is currently in the
debug mode is a checkmark next to the corresponding item in the menu and the words DEBUG
MODE in the title of the main program window.
After setting all the inputs and pressing , wait for the computations being performed
as usual. In the end ADePT will suggest saving the error report file. This file (in fact a zip-
archive) contains the information about the job ADePT was performing that can help the
developers identify the problem and fix the program or suggest a workaround for the users. You
can save this file to any location on your computer and send it to the developers as an
attachment.
The following information is included in the error report file:
The information that the user has put into the fields on the form of ADePT. The messages that ADePT has produced while checking the data and performingcomputations. Any output (perhaps incomplete) that ADePT managed to produce before an error
occurred.
Trace of the commands that ADePT executed to transform the data and compute theindicators.
The error report file does not include any unit-record data or users datasets, which were used
when the error occurred because of confidentiality reasons. However, this information would be
useful for developers in order to reproduce the problem. All the information that ADePT puts in
the error report file can be checked before submission. To do this, open each file in the error
report archive in a text editor.
Appendix 1: List of data checks
Appendix 2:
2.1. Data conversion
ADePT can work with files of the two popular formats for storing statistical data: the Stata data
file format (file extension .dta) and the SPSS file format (file extension .sav). In some cases
you may find that the datasets are available in different formats that are not supported directly by
ADePT. In this case data conversion becomes necessary.
-
7/27/2019 Guide to ADePT
47/50
47
There are two main strategies for converting statistical data: using a statistical package that
provides extensive import and export facilities (perhaps, but not necessarily, the package that
was used to create the dataset in the first place) or using specialized data conversion software.
Most of the modern statistical packages have facilities to import/export data from/to various file
formats. For example, R (with installed package foreign) can read-in DBASE (.dbf) datasets,
Minitab (.mtp), and other file formats; PSPP can read-in Gnumeric (.gnm/.gnumeric),
Open-Document (.ods) and other files. Most packages will be able to open ASCII/plain text
(.txt, .asc) data files and comma-separated (.csv) data files. If Stata or SPSS software is available,
this may be an obvious choice, at least for the text files.
In contrast to statistical packages, specialized data conversion software focuses solely on data
conversion, but usually provides a wider range of supported file formats. Popular data
conversion programs like Stat\Transfer support output to Stata and SPSS files and can convertstatistical, mathematical, and spreadsheet packages from dozens of file formats.
R:www.r-project.org
PSPP:www.gnu.org/software/pspp
Stat\Transfer:www.stattransfer.com
Please follow instructions very carefully when work