Development Research Group, Development Economics, World Bank

ADePT

Version 4.1

User’s Guide
1

Table of Contents
1. System Requirements............................................................................................................................ 4 1.1 1.2 1.3 2. Hardware requirements ................................................................................................................ 4 Software requirements .................................................................................................................. 4 Installation of ADePT ................................................................................................................... 5

How does ADePT work? ...................................................................................................................... 7 2.1 2.2 2.3 2.4 2.5 2.6 Starting and closing ADePT ......................................................................................................... 7 How does ADePT work? ............................................................................................................... 9 Loading data into ADePT ........................................................................................................... 10 Specifying variables in ADePT ................................................................................................... 13 Using compound fields in ADePT ............................................................................................... 16 Generating tables and graphs ..................................................................................................... 18

3.

The Output of ADePT ......................................................................................................................... 19 3.1 3.2 3.3 ADePT System messages window ............................................................................................... 19 Error diagnostics in ADePT ....................................................................................................... 20 Understanding the output of ADePT ........................................................................................... 22

4.

Common tasks ..................................................................................................................................... 25 4.1 4.2 4.3 4.4 4.5 4.6 Generating tables on a subsample of observations..................................................................... 25 Generating tables of frequencies and tables with standard errors ............................................. 29 Describing complex survey design in ADePT ............................................................................. 30 Defining missing values in ADePT ............................................................................................. 30 Specifying expressions in variables fields ................................................................................... 32 Simulations with ADePT ............................................................................................................. 33

5.

Adjusting the settings of ADePT ........................................................................................................ 35 5.1 5.2 5.3 5.4 Using ADePT with different languages ...................................................................................... 35 ADePT computational engine ..................................................................................................... 37 Viewer for ADePT output files .................................................................................................... 38 Selecting the computational engine and output viewer............................................................... 38

6.

Working with Projects in ADePT ....................................................................................................... 39 6.1 6.2 Using ADePT project files on a different computer .................................................................... 41 Replicating the results obtained with ADePT ............................................................................. 41

7.

Using ADePT in a batch mode ........................................................................................................... 41 2

8. 9.

Updating ADePT ................................................................................................................................ 43 Troubleshooting ADePT ..................................................................................................................... 44 9.1 9.2 Problems during installation ...................................................................................................... 44 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

3

1. System Requirements
1.1 Hardware requirements CPU: 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 memory that 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.2 Software requirements Operating System: ADePT requires Microsoft Windows operating system. The minimum required operating system is Microsoft Windows XP. ADePT will work on 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 recent Microsoft 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 (typically C:\Windows\), then proceed to folder Microsoft .Net, then to Framework. There will be several subfolders in this folder with names like 1.0.3705,
4

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 Microsoft’s website. At the time of this writing, .Net Framework 3.5 is the latest available version. It can 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 and Numerics by Stata are products of StataCorp LP: http://www.stata.com. Microsoft Excel for Windows (version XP or later) is required to display ADePT’s results. The free Microsoft Excel Viewer can also be used to view the results generated by ADePT.

Output viewer:

1.3 Installation of ADePT ADePT 4.1 installation file www.worldbank.org/adept. adept_install.exe is available from our web page:

To save this file to disk, right-click it with the mouse, select <Save target as…> 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.

5

Click the <Install> button to start copying the files. To start ADePT the next time. Use the <Browse…> button to specify the folder or type the path in the “Destination Folder” box. 6 .You have to accept the license agreement in order to proceed. Note that you must have permission to write to this directory during installation and when it is running. you can close the installation wizard. click on the ADePT icon in the ADePT Software program group in the Windows Start menu. The ADePT program will start automatically after the installation succeeds. After installation (message “Completed” is in the messages window). The installation wizard then asks where ADePT should be installed.

7 . use your mouse to drag the link to ADePT from the Start menu and drop it to your desktop.2. You can also create a shortcut to ADePT on your desktop. go to the Windows Start menu and select the ADePT icon from the ADePT Software program group. Users who work mostly with one module can suppress this choice by unchecking the corresponding check box in the module choice window. On start. How does ADePT work? 2. In this case. ADePT will automatically load the last used module when it starts. use <Select module> item in the <Modules> menu of ADePT(Menu Bar [6]). ADePT provides a choice of modules currently available. To switch to a different module.1 Starting and closing ADePT To start ADePT. To do this.

IF-condition Set/Clear Button 26. Parameters Tab 16. 2. Datasets Tab 8. Data/Variables Window Main Form Window Table and Graph Window Table Description/System Messages Window 5. Selected Table Statistics 20. Frequencies and Standard Errors Check Boxes 22. IF-condition Field 25. Survey Settings Button 18. Status Bar 19. Process Indicator 6. Datafile Type Control 12. 3. Menu Bar 7. Table Description Tab 23.5 6 1 7 8 9 13 12 11 19 3 10 14 15 16 20 21 26 22 2 23 4 17 24 25 18 1. Show Changes Controls 14. Table and Graph Tree 21. Generate/Stop Button 8 . Dataset Control Buttons 11. Variables Tab 15. Global Filter Tab 9. List of Loaded Datasets 13. System Messages Tab 24. 4. Missing Values Tab 17. Variables Tab 10.

2 How does ADePT work? ADePT is a software platform designed to produce sets of tables and graphs based on the microlevel data. the last used module. ADePT signals to the user with error messages. each generating tables in graphs in a particular area of economic research. which restricts the data to a subset of observations satisfying certain conditions (see Generating tables on a subsample of observations). and the settings and content of the input fields. 2. The two (optional) steps here are recoding of missing values [16] (see Defining Missing Values in ADePT) and applying a global filter [8]. ADePT checks whether the entered variables are of a correct type (categorical. Set the auxiliary parameters. It cannot be closed when the computations are running.ADePT can be closed by selecting the <Exit> item in the <File> menu [6] or by clicking the cross-button in the window’s header. First. the user presses the <Generate> button [26] to generate the output. 9 .) and have a proper number of unique values. ADePT prepares the data based on the user’s specifications. From that point ADePT works automatically. Select tables and graphs to create [19]. This process is repeated for all datasets loaded into ADePT. informing the user about the progress and detected problems. Start ADePT. Fill in the Main Form [2]. There are several stages in this process. ADePT checks the consistency of categories for the variables defined in different files. For example. and notifications (see Error diagnostics in ADePT) about all the problems that it finds with the input data. continuous. but the computations can be interrupted with the <Stop> button [26]. In the next stage. 2. If a problem is found in a particular variable. Next. On closing. ADePT checks whether variables entered by the user correspond to the requirements defined for each particular variable. ADePT remembers the size of its window. It consists of modules. 5. After the required inputs are specified. The content of the input fields saved only if tables were successfully produced. 4. While doing that. 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. warnings. 3. At the next start the user finds the program in the same state as it was when ADePT was closed. dummy. etc. Load datasets (one or several) into ADePT. its name is highlighted in the Main Form [2]. To produce the desired set of results a user needs to: 1. and conducts consistency checks on particular variables (see Data checks in ADePT).

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]. 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. By doing so.e. ADePT begins producing tables and graphs. MS Excel Viewer. ADePT generates temporary variables required for calculations. or some other program. MS Excel. When all tables and graphs are generated. Finally. You then need to specify a label for this dataset. ADePT calculates household size and household composition variables from the variables defining household ID and age and gender of household members.sav) formats.. numbers in one table do not contradict the numbers in other tables). The label will be used in the tables and graphs to distinguish the statistics generated from different datasets. To load a dataset into ADePT press the <Add…> button [10] and select the dataset you want to load in the Open dataset dialog.In the next stage. ADePT instructs the output viewer. ADePT makes sure that all tables in a particular module are internally consistent (i. The next sections of this manual discuss all the above steps in detail.dta) or SPSS (. For example. Click the <Open> button and the name of the selected dataset appears in ADePT’s Datasets tab [7]. It tries to use information specified by the user to produce variables that are consistent with each other.3 Loading data into ADePT ADePT can process data in Stata (. 10 . 2. to open the file with tables and graphs (see Viewer for ADePT Output files).

If an individuallevel dataset is loaded in ADePT and you specify its type as a household-level dataset. but we recommend labeling datasets with the numeric date corresponding to the time of data collection. 11 . the output with the changes between any two time periods. each record/observation corresponds to a single household—there is only one observation per household. in addition to the statistics for each loaded dataset. The observations in the individual-level files contain information about individual respondents. Note that this is not an arbitrary parameter and it must correspond to the structure of the data you are loading. Depending on the module. For example. Repeat this process if you want to load more than one dataset into ADePT. Depending on the module. Each household could be represented by several records/observations for the members of this household. In the household-level data. if more than one dataset is loaded you can ask ADePT to produce. you can load one or several datasets into ADePT. you might also need to specify whether the datasets you are loading contain individual.” 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. the statistics calculated by ADePT will be incorrect. To select the type of the data you are loading into ADePT. The datasets in the drop-down lists are identified by their labels. Click the <Show changes between periods> check box [13] and select the datasets between which you want the changes to be outputted.or household-level data [11]. click a corresponding dataset control radio button on the top of the Datasets Tab [7].The label could be any word or number. Several statistics produced by ADePT use this information to calculate the time span between the surveys. 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. In some modules.

You can search for a particular text in variables’ names 12 . Note that the set of required variables might differ depending on whether an individual. If you use Stata as a computational engine for ADePT (as opposed to Numerics by Stata). The Variables tab [9] shows the content of the dataset that is currently selected. 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. the list of Dataset control buttons [10] on the left-hand side will change. The tab title shows the label of the selected dataset.You can adjust this setting after the data is loaded but before the analysis has begun. browse the observations in the dataset. The content of the loaded dataset—the names of the variables and the variables labels—could be shown in the Variables tab [9] located behind the Dataset tab [7]. You can now open the selected dataset in Stata by pressing the <Open in Stata> button. You can remove a dataset from the list of datasets loaded in ADePT by pressing the <Remove> button [10]. modify existing data and create new variables. for example. etc.or household-level of data is specified. Removing all datasets from the list will deactivate the ADePT interface—neither variable fields nor tables and graph trees are accessible. You can use Stata to.

Categorical variables: a categorical variable in ADePT is a numerical or string variable containing less than 50 distinct and integer values. An example of a field that requires a continuous variable is the Welfare aggregate field on the Poverty Module. Continuous variables: in ADePT. ADePT generates a numerical variable with categories 13 . 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. If a string value is entered in such a field. but the process of defining the fields is similar across the modules. Users can enter any variable name from the loaded dataset. ADePT does not require predefined names to be specified in the input fields. if a dataset variable S10_Q12 indicates urban locations. Each module of ADePT has its own set of fields. this variable should exist and have this meaning in all loaded datasets. 2. a variable is considered to be continuous if it has more than 50 distinct numeric values. you need to map variables in your data to the fields on the Main Form [2]. The only assumption ADePT makes is that the variables are named consistently if multiple datasets are loaded. if the user specified S10_Q12 as an urban indicator.4 Specifying variables in ADePT After you load data. ADePT checks if this assumption is true and reports to the user if the varialbe is missing in any of the loaded datasets. In other words.and labels by using the search field located on the bottom of the tab (see Specifying variables in ADePT). the next step is to tell ADePT what variables in the loaded datasets correspond to the fields required to produce the output. Fields for variables of different types: a. In other words. For example. b. There are four types of inputs on the ADePT forms: 1.

one or two poverty lines can be specified in the Poverty module. Dummy variables: a dummy variable in ADePT is a variable with only two distinct values. specify all the variables that allow one to uniquely identify a household in the household ID field of ADePT. In this situation. if regno is the variable containing the region codes and the ID is the variable holding the household identifiers within each region. An example of a categorical variable field is Sector of employment in the Labor module. Compound fields are used when a user is asked to specify not only a name for the variable but also to provide some additional information on that variable. in the Programs tab of SP module. Consider. whether the missing values should be recoded according to the user-specified rules) and spin-edits allow entering of numerical parameters. 2. check boxes are used to specify binary options (for example. 3. The fields requiring dummy variables accept a numerical dummy variable or a logical expression based on an existing variable in the user’s dataset (see Specifying expressions in variables fields). This is the type of household ID that ADePT expects. for example. such as the regional identifier. in the Education module. the household ID field. 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. such as duration of primary schooling. The compound fields are used. Note that some fields allow multiple variables to be specified. For example. 14 . for example. we would specify: HHID=regno id. Some of the ADePT fields allow specifying multiple variables that will be treated as a list.corresponding to the distinct values in the string variable. which would identify each household in the loaded datasets. Other parameter inputs are used to set scalar parameters: as in other Windows programs. The compound fields contain several controls to define multiple characteristics of a variable. or in the Missing Values tab (see Using compound fields in ADePT). In the variables lists. there is no overlaps within each region). and even more variables can be specified in the household ID field in various ADePT modules. but also by taking into account other variables. separate the individual variables with whitespaces. First is a household ID that determines which household the observations belong to regardless of the values of other variables. An example of a dummy variable field is the Gender field in Poverty or Labor modules. and thus overlaps in ID values between different households become possible (however. which is already there. In some datasets. however. ADePT will process this list of variables internally and create its own household ID variable. This can be the case when the household IDs were assigned independently by interviewers in different regions. c. a household is identified not by household ID alone. In the example below. but be appended to it. The typical household ID variable can be of two types.

Drag and drop the selected variables into the corresponding fields on the Main Form [2]. its type. and whether or not the variable is a required variable in the current module. When the cursor is positioned in a field on the Main Form [2]. At the same time.The Main Form [2] with variable fields is located below the Datasets tab [7]. 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]. 15 . 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. the Status bar [18] shows the description and the requirements for the variable to be specified in that field. Note that the type of the selected variable (numeric or string) and its name and label are shown in the Status bar [18]. it tells the user what variable is expected to be specified in this field.

Alternatively. If several datasets are loaded. This check is activated with the <Enable only common variables> check box on the Variables tab. program name.” To clear the search filter. The direct manual entry of variable names could lead to misspelled variable names and thus in errors in ADePT execution. typing “ur” selects variables with names or labels that contain the string “ur.You can search for any part of the variable name or label using the search filter field. etc. The drop-down lists take a long time to navigate if the loaded datasets contain a large number of variables. While the properties of the compound fields might be different for the different modules. and benefits amount as a single element in a list of programs. in the Social Protection module we specify the program type. 2. ADePT treats this information as referring to a single unit: an element of a list. You can also use a drop-down list in the field to specify a variable. For example. 16 . a program. These variables are then shown in grey (disabled) in the Variables tab. and it reduces the possibility of errors when entering the variable names. For example.5 Using compound fields in ADePT Several modules of ADePT use compound fields. Note that variable names are case sensitive and should be specified exactly as they are in the dataset. but typing into the variable field is the only way to specify expressions in the fields (see Specifying expressions in variables fields). ADePT can disable drag-and-drop capabilities for variables that are not present in all datasets. 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. The idea behind these fields is to allow the management of several input elements as a single unit within ADePT. you can type the variable name into the field. all compound fields have common elements and behavior. delete all the characters in the search field.

17 . Similarly to the simple variable fields. To be able to add a unit to the list. Label) of a program are required. For example. Both elements are required. For example. compound fields can be required for analysis. A compound field is considered filled if it contains at least one unit. Variable. the Missing Values tab [16] contains a compound field managing the user-specified list of missing values. and the values that should be replaced to missing — field Missing Value(s). fill in all required elements of that unit and press the <Add> button. 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. one of which is a field where the user has to provide a variable name. not all of the three elements (Type. You can drag and drop a variable from the Variables tab [9] to fill this field. or none of the elements may be required. some. but the field (a program) is required—no analysis can be done if no social protection program is specified. Elements already in the list can be removed with the <Remove> button. All. The whole compound field is considered required if ADePT cannot conduct any analysis without the field filled in. Each unit in the list contains two elements: the names of the variables to be recoded—field Variable(s).The compound fields always contain two or more elements. An element is required if a unit cannot be posted in the list without this element being specified. It is important to make a distinction between required elements of a list unit and the whole compound field that is required. the user needs to specify a variable name and enter a missing value to append the list.

and the variable that identifies the region. poverty line(s). If one of these variables is not specified. Each table or graph in ADePT requires particular variables to be specified and some options to be selected. the number of feasible tables.2. 18 . a table that shows the distribution of poverty rates by geographic regions requires three variables to be specified: welfare aggregate. The choice of tables and graphs is done in a treelike structure where they are grouped together by topic. For example.6 Generating tables and graphs After you load your data into ADePT and specify the corresponding variables you can select tables and graphs for ADePT to generate [20]. 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. contains 38 tables and graphs). 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. The tables stay inactive if any of the variables required for these tables are not specified.

You can select multiple tables/graphs by checking the boxes next to the title of a corresponding group of tables/graphs. If this table is feasible. 19 . After you select tables and graphs you want to produce. press the <Generate> button [26] to start processing the data. ADePT uses the System Messages tab [23] to display information on the data processing to show errors and warnings. which describes the table layout and its intended use. on the Menu bar click Tools → Options [6] and select the Reporting tab. 3. 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. and to indicate the progress of output generation. On pressing.The Table Description tab [22] below the Table and Graph window [3] shows a description for the currently highlighted table. ADePT will select all feasible tables/graphs in this group. the green <Generate> button changes into the red <Stop> button that can be used to interrupt the computations [26]. select the table by checking the check box next to the table’s title. To define the level of reporting in the System Messages window.1 ADePT System messages window The ADePT Table Description/System messages window [4] is located below the Table and Graph window [3]. The Output of ADePT 3. No tables or graphs are outputted if the <Stop> button [26] is pressed.

and reports warnings and error messages. 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. Two other levels of reporting—Detailed messages and progress indication and Service messages (debug mode)—are designed mostly for troubleshooting ADePT and are rarely used. 3. There are three levels of problem/error reporting in ADePT: a.There are three levels of reporting the user can select on that tab. Errors Notifications.2 Error diagnostics in ADePT ADePT conducts an extensive data diagnostic and checks whether the variables specified in the fields satisfy the required conditions. right-click on the window and select a desired option—Clear Output and Select Font—from the menu. If the default level of reporting—Main messages and current status—is selected. Warnings. ADePT displays only the main messages on the progress of data checking. data preparation. 20 . Notifications b. Warnings c. and data analysis. You may find the option of changing the font useful for presentations when you need to make text larger than normal. We recommend using this level of reporting in your work. To change a font or to clear the content of the System Messages window.

. Warnings just inform the users about potential problems with the data. 21 . there are pupils found reporting that they are attending the 5th grade of the primary school. The example of a notification could be a message that informs a user that no weight variable is defined and tables and graphs are produced on unweighted data. d.g. A particular observation violates assumptions imposed by the parameters of ADePT: e. b. for example: a.g. no actions are taken—ADePT uses all non-missing observations in the loaded datasets to produce tables and graphs.g. this value will be outputted as a notification. whereas the duration of primary schooling was specified to be equal to 4. When a warning is issued.. Notifications also serve as a reminder to the user what parameter values were used during the analysis that are not contained within the user’s dataset but reflect the user’s assumptions. a variable 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.Notifications have an informational purpose. ADePT issues a warning if it detects a suspicious situation in the data but cannot be sure that this is an impossible situation. They convey to ADePT users information about the processing of the data and report names of the loaded data files. Inconsistent information is found within a single dataset that is flagged by the checking procedures. ADePT might discover that a two-year-old child is reported to be employed. e. c. e. A particular value of a categorical variable seems too far off compared to other values of this variable (an outlier). For example. if the user specifies that the duration of primary school is five years. ADePT cannot be sure that this value is not legitimate. Notifications have no impact on the content of tables and graphs to be outputted.. Inconsistent definitions of categories between several rounds of the survey.

Please refer to Appendix 1 for the complete list of data checks ADePT performs. e. When ADePT can determine the source of the problem in a particular variable field. Each output file—a workbook—contains:  a sheet with a table of contents. 22 . and indicates to the users if any of the requested tables or graphs have not been created because of an error. a variable does not exist in one of the datasets.. Problems may be resolved in one of two ways: adjusting the parameters/input of ADePT. checking that parameters of the educational system agree with the actual situation in the country under consideration.3 Understanding the output of ADePT After the user clicks the <Generate> button [26] on the main form. this field is highlighted on the form.  a sheet with notifications. Notifications. ADePT also reports on the Contents sheet the time it took to generate the current output. 3. ADePT writes the generated tables and graphs into a new MS Excel xml-type file.g. warnings. after reporting an error ADePT continues as if the variable was not specified.  sheets with requested tables and graphs.ADePT reports an error if the problem it has found prevents the use of the variable in the analysis. 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. for example. In this case. and adjusting the input datasets—the user needs to use Stata or SPSS to correct such problems. 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.

In addition to the table of contents. and notification messages about the problems discovered during the preparation of this output file (see Error diagnostics in ADePT). this table presents information on: the number of nonmissing observations. It provides useful information about the data loaded into ADePT and. To alert users about encountered problems. maximum. can help resolve problems related to the discrepancy of the results generated on different datasets. ADePT always produces a “Notifications” sheet that contains error. We always recommend producing and carefully reviewing the “Original Data Report” before starting analysis of the data with ADePT. minimum. In particular. Each table and graph is placed on its own sheet. in many cases. 23 . and selected percentiles. 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. mean. warning. The rest of the output file comprises sheets with requested tables and graphs. and the number of unique values in the variable. 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. for each variable specified by the user.

The structure of these tables replicates the structure of the main tables. To navigate through the ADePT output you can click on the title of a table or graph in the table of contents. you can open the “Notifications” sheet with the description of these errors by pressing on the NOTE about the error. If some of the tables were not created because of errors. with standard errors Frequencies Color of the tab neutral green blue ADePT formats the output. which facilitates further analysis. but all data are stored with full precision. or scroll through and select the sheet of the workbook where the table or a graph is saved.If tables of standard errors or frequencies are requested. 24 . with the additional information of standard errors or frequencies. they are placed on their own sheets (see Generating tables of frequencies and tables with standard errors). Thus. each table in ADePT can be produced in three versions: Sheet contents Main print-ready tables Same as main.

and will generate tables and graphs only for observations that satisfy specified conditions. For example. “Apply the filter. 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. The Global Filter [8] is used to keep in the analysis only those observations that satisfy certain requirements. ADePT keeps only the observations that satisfy this condition. 25 .” and the field for a logical condition to be used in keeping observations for analysis. Its effect propagates to all tables and graphs in an active module and has the highest priority in ADePT. ADePT will drop all observations where “region” is not equal to 11 and “age” is greater than 40.4. Common tasks 4. In addition to the global filter. individual tables and graphs may have their own specific restrictions on observations that are included in the analysis. to produce tables and graphs for respondents under 40 years of age in a particular region of the country. Applying an “IF” condition to a group of tables (graphs) is equivalent to applying the same “ IF” condition to all tables (graphs) in that group. Note that because the Global Filter is applied to the early stage of data processing. The tab contains a check box. The individual conditions do not replace. using the Global Filter will result in faster calculations compared to specifying IF-condition to all tables or graphs. When an expression for the Global Filter is specified. enter “age < 40.1 Generating tables on a subsample of observations You can focus your analysis on a particular subpopulation either in all or in some tables/graphs. 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. region = 11” in the Global Filter field. You can specify any valid Stata logical expression in that field (see Specifying expressions in variables fields).

Exclude from analysis those individuals who are not landowners (given that the variable sland denotes the area of the land owned). any one of A or B must be true. which is defined differently for men and women.. 65) ((male==1) & inrange(age. 3. (urban=1) & (region!=1) (sland>0) | (rland>0) (edu_yrs>8) | (prof_edu==1) Note that in these expressions we use symbols “&” and “|” to denote logical “ AND” and logical “OR” operations.1. you can specify any of the functions available in Stata in the IF-conditions.g. the country capital). 15. 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 “=. In order for A|B to be true. Each particular observation is included in the analys is if it satisfies the inclusion condition (the Boolean expression evaluates to value “true”). 15. For example: If-condition inlist(region. Finally. 60)) !missing(sector) Interpretation Include only observations from regions with codes 1.The purpose of IF-conditions is to include observations from a particular subgroup of a population in the analysis. the conditions we use are quite simple.3. Consider the following examples: If-condition urban=1 region==5 age_yrs>=16 sland!=0 Interpretation Only those observations having the value of variable urban equal to one will be included in the analysis. 26 . Only those individuals who are 16 years old or older are included in the analysis. Only observations from the region with code 5 are included in the analysis.15. The inclusion condition is formulated as a Boolean expression—a function of the variables existing in the user’s dataset. In many cases . Include skilled individuals only. Include only individuals of working age. Include individuals who own or rent land.” You can specify more narrow groups by restricting several dimensions simultaneously as in the following examples: If-condition Interpretation Include observations from all urban locations. exclude the first region (e. and 6.6) inrange(age. 5.5. In order for A&B to be “true.65)) | (male==0) & inrange(age. Exclude observations with missing values in variable sector.” both A and B must be true. defining a skilled person as one who has more than 8 years of education or received professional education. Include individuals aged between 15 and 65.

then click on the “IFcondition” field [24] in the bottom of the Table description tab. If the IF-condition is based on the place-of-birth variable. Hence the expression (age > 65) evaluates to “true” not only when the age of the responders is greater than 65 years but also if the value of variable age is missing. 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. select a table (group of tables.When you specify IF-conditions. all tables). be aware that ADePT follows Stata’s convention that missing values are considered to be infinitely large numbers. 27 . Use parentheses to indicate the order of evaluation for complex expressions. This means. each observation is treated independently from another. that to exclude all households where the household head was born abroad. When IF-conditions are evaluated. enter the expression to restrict the sample of observations. for example. this will not exclude the children living in the households with foreign-born household heads. and press the <Set> button [25]. To specify an “IF” condition.

IF-conditions may include any variables from the user’s datasets. as ADePT has no prior knowledge to allow it to conduct checks on them. select the object to which the IF-condition was applied and press the <Clear> button [25] next to the IF-condition field. For example. The IF-condition specified for a table is outputted below the table. A combination of the global filter and individual IF-conditions for tables may become too restrictive. For example.Any tables (graphs) that have an IF-condition applied to them are highlighted in yellow. To remove the IF-condition. it is the user’s responsibility to ensure the validity and consistency of these variables. not only those that ADePT has requested in the variables specification form. enter “region < 3” into the IF-condition field. to generate Table 2.2 only for households residing in regions with the codes lower than 3. However. You can use any valid Stata expressions to form IF-conditions. and it is the user’s responsibility to make sure the conditions do not contradict each other and do not remove all the observations from the sample. if the global filter 28 . The definitions of IF-conditions are not saved in the project file.

If a global filter that selects only the working age population is applied. an error message will be added to the list of messages. This has two consequences. While the contradiction may be obvious in this example. even though these observations would later be excluded from that table. in some cases an outlier would have all the individual variables in order. if the problem is caused by a particular value of a certain variable. this difference in time can be in the order of magnitude. as these observations are completely excluded from the analysis before the checks are conducted. that value can be recoded to a missing variable to exclude that outlier. and other factors. Normally. If the effective condition (the combination of the global filter and the individual IF-condition) is so restrictive that no observations satisfy it. In an individual-level dataset. The computation of tables with standard errors takes more time than the time needed to calculate standard tables. We recommend that users start working with ADePT by generating standard 29 . no warning will be issued. the table (graph) will not be constructed. For example.2 Generating tables of frequencies and tables with standard errors ADePT can produce. First. Often. 4. While it may look the same when a global filter is specified and an IF-condition is applied to all tables (graphs). these algorithms require substantial computational resources. 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. which could be different from the number of household members. In some cases. the global filter can be used to remove the observations from the analysis that cause problems with the data checks. the global filter might affect the values of the variables that ADePT derives from the data. it may not be transparent in the population with complex dependencies between. but a combination of their values would be impossible. say. tables with the standard errors for the outputted statistics and tables with frequencies.selects only urban population and an IF-condition applied to a particular table selects only rural population. If we apply this condition. in addition to the standard tables. and the table (graph) will be marked red in the selection tree. If the same condition was applied to a particular table the warning that very young children are attending schools would be displayed. ADePT uses sophisticated algorithms to calculate the standard errors for estimated statistics. then that table may not be constructed because there will not be a single observation that could satisfy both conditions simultaneously. Consider the household size as an example. education level. we may want to apply the global filter to remove all the respondents under age 5 if they report attending a school. However. there are differences that sometimes become important. Second. ADePT constructs a variable for the household size by counting the number of observations with a unique value of the household ID variable(s). the sector of employment. the variable that ADePT creates for the household size will count the number of working age individuals in a household.

In particular. you can input it on the form among the other variables. 4. To output tables with standard errors and tables with frequencies check the check boxes <Standard errors (slow)> and <Frequencies> [21] located next to the <Generate> button [26]. users may specify multiple stratification designs. 4. If weights is the only survey design parameter that you would like to specify in ADePT.4 Defining missing values in ADePT 30 . Consult the survey documentation to determine which weighting variable must be used for your analysis. Tables with frequencies show the unweighted number of observations that were used in the calculation of a particular cell in a table. ADePT always expects household weights irrespective of whether the data is at household or individual level.tables. survey weights. click the <Survey Settings…> button [17] and fill in the form describing a complex survey design. After you obtain the desired results in standard tables. If other parameters of the survey design need to be specified. Most surveys will include one or more weighting variables. you can produce the final set of results with standard errors.3 Describing complex survey design in ADePT ADePT can account for a complex survey design when it calculates standard errors for the estimates. and options of how the standard errors of the estimates must be computed. final population corrections. There is no extra time required to produce tables of frequencies relative to the time to produce standard tables.

The example below shows how to recode values 98 and 99 in the variable defining education. 97. enter one or more variable names into the first field.  one variable and multiple missing values separated by spaces. A particular variable can be mentioned in multiple lists of variables and a particular value can be mentioned in multiple lists of missing values. separate variable names with spaces. 98. To activate the Missing Values tab. separate multiple values with spaces. The missing values tab contains the (initially empty) list of such pairs and controls to append this list. 3. enter 98 and 99 into the Missing Values field.” etc. ignoring the observations with missing values from analysis if the missing values are involved in the analysis for a particular table/graph.  multiple variables separated by spaces and multiple missing values. 31 . You can add as many definitions of missing values for the variables in your dataset as you wish. However. not all data providers use these codes. To do that. For various reasons some datasets contain values 9. To define missing values: 1. and press the <Add> button.ADePT does not remove an observation from the sample if any of the used variables has a missing value in it. The following combinations are possible:  one variable and one missing value. Instead. 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. performing the functions of the missing value code (one variable may use multiple such codes for “refusal . The missing values can be defined in the Missing Values tab [16]. 99.).. etc. 4. Missing values in Stata and SPSS datasets are assigned particular codes that ADePT is aware of. ADePT reacts to missing values intelligently. 997. repeat (if necessary) for other variables and values. ADePT receives information about missing values as a list of pairs of elements: variable(s) and missing value code(s).  multiple variables separated by spaces and one missing value. enter one or more values into the second field.” “don’t know. click the <Add> button. drag and drop the obrazovanje variable into the Variable field. 2.” “not applicable. on the Menu bar [6] click Tools → Show missing value tab—the new tab Missing Value will appear next to the Variables tab [9] in the Main Form window. If this is the case.

the coding of these variables might be different in the user’s datasets.g. Add to project file). Expressions come in handy when a variable does not exist in the dataset exactly in the way ADePT expects it. e. 1 = male. 1 = household head. 1 = urban. 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..g. the Missing Values tab will be shown automatically when this project file is loaded. for example. 32 . If the definitions of missing values were stored in a project file. but can be derived from the existing variables using a simple transformation. If this is the case:  recode original data to match ADePT’s expectations. which ADePT will evaluate and take the result as a corresponding indicator. Internally ADePT assigns specific meaning to particular values of these variables. urban and gender) are treated in ADePT as dummy variables and thus must have only two values (if a variable is used). 1 denotes urban population in the urban variable.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. 4.  specify an expression instead of a variable name..5 Specifying expressions in variables fields Some of the variables (e. However.

The second step involves loading the two files (original and simulated) 33 . It might be easier to specify an expression of the following type: URBAN==2 ADePT generates a new variable in each dataset. modified to simulate the effect of a reform or policy. 1s). one creates a dataset with simulated data.6 Simulations with ADePT In this section we discuss how to perform simulation analysis of a reform or a policy intervention with ADePT. For all other values (in this case.” 4.Consider the following example: in the original dataset variable. The following transformations may be applied: varname == const varname != const varname > const varname >= const varname < const varname <= const Note that the name of a variable must be the first word of the specified expression. it may be cumbersome to recode this variable into the format that ADePT expects. while zero (0) is taken for logical “false. Missing values of URBAN will remain missing. and other data. Some of the examples are the simulations of the impacts of income supplements. unemployment benefits. The variable will take the value 1 whenever URBAN was equal to 2. Because there are several data files (each corresponding to a different year). The process consists of two steps. First. That dataset is based on the actual data. Whenever an expression evaluates to logical “true” a value one (1) is taken. this new variable will take a value of 0. URBAN takes values 1 for rural and 2 for urban population.

Note that ADePT does not take into account the fact that second dataset is simulated.  From this point you can issue Stata commands that modify the dataset according to your assumptions. 1 Refer to the Stata manuals for description of Stata commands. For example. You type command:1 replace v021 = v021 * 1. You will use this file to derive the simulated data. replace   Close the Stata session by typing “exit” in the Stata command prompt and add the simulated dataset into the files list of ADePT. 34 . A new Stata session will start and the dataset will automatically be loaded to Stata. so the standard errors reported by ADePT for simulated indicators and for the differences may be incorrect. If there are only two datasets in the list . The simulations can be quite complex. ADePT assumes that the variable names are the same in all the datasets). For example. you might want to save the simulated data in the file called “simulated” by typing the command in Stata: save simulated. Type “help” in Stata’s command line to bring up the electronic documentation for the installed version of Stata. For example. Make sure that instead of creating new variables you are modifying the original variables (recall that when working with multiple datasets.  Click the <Open in Stata> button [10].  Start ADePT and switch to the module most appropriate for your topic of analysis.into ADePT and generating tables and graphs comparing the statistics between the original and the simulated scenarios. then simulate an increase in education and then re-estimate the income and consumption after the reform. Select “show changes” in the files list. you may want to first model the dependency of income and consumption from education. suppose that each individual’s 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. save it to a new file.10 if rural == 1  When you finish modifying the data. ADePT will automatically select them to be compared. You must have a full version of Stata to continue.  Add the original file to the list of files.

ADePT’s language can be changed. such as the language of interface. Before changing the language. make sure you have saved your input into an ADePT project file (see Working with projects in ADePT) or it will be lost when ADePT is restarted.1 Using ADePT with different languages To provide a comfortable working environment for the users whose native language is not English. Adjusting the settings of ADePT In this section we will discuss the options that affect the work of all modules of ADePT. 35 . choose Tools → Options…) and switch to the localization tab. This change (software localization) affects both the interface of the program (menus.5. etc. error messages. open the options dialog (in the main menu. 5.) and the reports produced with ADePT (table titles. dialogs. table notes. and the output viewer. the computational engine.). To adjust the language setting. sheet names. etc.

ADePT provides a choice of the most common code pages for alphabet-based languages (Cyrillic. ADePT must be closed and reopened (see Starting and Closing ADePT). Right-click on the column header for the value labels and left-click the appropriate encoding name to switch to the proper code page.) The choice of the coding page allows the correct display of variable names and variable labels recorded in non-Latin script. dialogs. etc. select one of the available languages from this list and click <OK>. Stata datasets cannot store labels in character-based languages (Chinese. The selection of the coding page is independent from the choice of the language.). ADePT will display all the menus. or other scripts. (Because ADePT is a fast-developing project.) and thus there is no code page selection for them. and error messages in that language. To apply the change of language. Greek. Greek. The dialog will close. some new parts of the interface might not yet be translated. To change the language. 36 . Thus the user must manually try the different code pages until the localized data labels become readable. Once the new language is set.This tab contains two selections: one is for the code page and one for the language. 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). In this case ADePT will display them in English. The reason for this is that Stata dataset format allows storage of non-English symbols. Arabic. You might need to change the coding page if your datasets contain variable names or labels recorded in Cyrillic. etc.

NBS is a library of computational routines developed and distributed by StataCorp. Greek. Users who have Stata version 10 or later installed on their computers have the option to use ADePT with their own Stata. NBS is included in the ADePT installation package and is set up as a numerical engine on installation. 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. By default. ADePT will remember the code page setting and will use it in all modules until a new code page is specified. 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. 5.2 ADePT computational engine ADePT relies on the Stata numerical engine for computations. 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 uses Numerics by Stata (NBS) to generate tables and graphs.

The functionality of MS Excel Viewer is restricted to an ability to open. ADePT first tries to read the location MS Excel executables from the Windows registry. fields with the paths to Stata executables. ADePT tries to locate the executable file for Microsoft Excel and use it as a viewer for the generated results. The screenshot below shows an example where ADePT has successfully located all the required components and is ready to run—the fields contain paths to required applications and are highlighted in green. 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).4 Selecting the computational engine and output viewer To check the setting of ADePT. view. Users can also copy data from MS Excel Viewer to other programs. This installation requires administrative rights.3 Viewer for ADePT output files ADePT saves generated results (tables and graphs) in Microsoft Excel xml format. as these versions allow faster execution (Stata MP) and an ability to load larger datasets (64-bit Stata SE and MP) compared to NBS. executables for Microsoft Excel or Microsoft Excel Viewer. on the Menu bar [6] click Tools → Options and select the Applications tab. and print files generated in MS Excel-supported formats. ADePT will use NBS for computation and MS Excel installed in C:\Program Files\Microsoft Office\Office12 folder as a viewer for output. The output could be displayed either with Microsoft Excel (MS Excel) or with a free Microsoft Excel Viewer. On installation. Users with 64-bit Stata and users with Stata MP might prefer utilizing their own Stata as a computational engine for ADePT. 5. This tab shows whether during installation ADePT managed to determine the location of the required applications and offers options to install missing components. it searches selected folders on the local drives. 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. 5. MS Excel Viewer does not allow users to modify and save a workbook or to create a new workbook. and the path to the scripting host executable (we plan to remove this component in the later versions of ADePT).microsoft. If ADePT cannot find this information in the registry. 38 . Open Office Calc can also be used to display the output produced by ADePT.The NBS has a computational functionality of the Stata SE 32-bit version 11 (currently the latest version of Stata). The tab contains two radio buttons to switch between Stata and Numeric by Stata.com.

If ADePT fails to find the Stata executable. users can specify the directory with MS Excel or MS Excel Viewer executables on their computers by pointing ADePT to these locations. users can point ADePT to a location of this executable by pressing the <Browse> button on the right of the field with the Stata executable path. The basic commands to work with Project files are located in the Project menu on the Menu bar. Similarly. ADePT tries to locate the Stata 10 or later executable automatically on installation. 39 . The project could be useful if you want to save the information defined in a current session to use again later. ADePT will still produce the output file with tables and graphs and store it in a user-defined location. If no MS Excel or MS Excel Viewer is found on the local computer. Working with Projects in ADePT A project is a configuration file that contains paths for the datasets and names of variables specified by the user in a module of ADePT. 6.This screenshot shows an example where ADePT uses Stata 10 installed on the local (or network) computer as a computational engine.

you can save this information for future use by choosing <Project> and then the <Save Project> command [6]. and standard errors choices because they do not characterize the input information but rather describe the desired output. the project will load the datasets and specify variables that are present in both modules. Specify the destination folder and file name for the project you want to save. For example. ADePT will automatically fill in the fields for welfare aggregate. and the expression used in the Global Filter. and others. 40 . The last successfully run configuration for the current module can be recalled at any time by selecting the corresponding command in the <Project> menu [6]. ADePT saves the settings of the last successfully run configuration (that is. names of specified variables. The saved project will store links to datasets. navigate to the folder containing a previously saved project and double-click its name. To start a new project. If you prefer to start working with the blank project instead. you can change the default behavior by going to <Tools> → <Options> → <Other Options> and unchecking the corresponding check box [6]. A previously saved project can be retrieved by selecting the <Open Project…> element of the <Project> menu [6]. You can reuse projects saved in a particular module in other modules. etc. instead it contains references to the selected datasets. The datasets are not saved into a project file. urban-rural indicator.After uploading data files and specifying variables on the ADePT form. but will not be able to fill in the fields specific only to the Labor module such as work categories. clear all the fields on the form by choosing <Project> and then the <Reset> command from the drop-down menu.. poverty lines. In that case. definitions of the missing values. earnings. some tables or graphs were created) on exit and loads them automatically at startup. Projects do not retain the list of selected tables and graphs. the corresponding IF-conditions and frequencies. You can use the <Save Project As…> command to save the project in a different location. In the window that opens. if the project saved in the Poverty module is opened in Labor module.

the following must be passed to the person replicating: 1) ADePT software: give your colleague a link to the homepage of ADePT. Saved projects could also be used in the batch processing in ADePT (see Using ADePT in a batch mode).worldbank. to download and install ADePT. ADePT will try to load data files from the locations stored in the project file. If ADePT does not find a dataset in the location specified in the project file. 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. 2) project files with input specifications used to obtain the original results. but only the links to their location on the user’s drive). and 3) datasets that were used to generate the results (note that the datasets are not stored in the project file. ADePT projects contain explicit (not relative) paths to the data files. it looks for the datasets in the specified locations. www. 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.2 Replicating the results obtained with ADePT To reproduce the results obtained with ADePT. for 41 . If the person who is using your files is unable or unwilling to re-create your folder structure on his/her computer. it will search for these files in the directory where the project file is located. It might be convenient to pack the project files and the datasets into a single archive.org/adept. Note that the IF-conditions are not saved in the project files. Thus. and if the dataset is found it is taken from there. 6. for example a zip-archive. If ADePT fails to find the data files on the paths specified in the project file. 7. place your data files in the directory where the project file is located. The IF-conditions for each table and graph are displayed below the tables/graphs in the corresponding sheets of the ADePT output. When ADePT opens a saved project file. to reduce the size of the transfer. it checks the folder where the project file itself is located.1 Using ADePT project files on a different computer You can use saved project files on a different computer.6. instruct him/her to place the datasets in the same folder where he/she placed your project files. Using ADePT in a batch mode ADePT 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.

different poverty lines.. Note that not all users may have privileges to schedule tasks. For every report that you intend to produce. Repeat this for every report that you intend to produce. Then save your input into a project file of your choice (note that you do not need to generate the actual report. If any of these three parameters contains a white space. to be able to save your inputs into the project file).example.exe. press the <Generate> button. Note that we do not specify the choice of tables and graphs when ADePT runs in the batch mode.ini “D:\Final To run the created batch file. followed by the name of the ADePT executable: ADePT. you may need to contact your system’s administrator for assistance. ADePT creates output automatically based on the settings prepared and saved into a project file earlier. If this is the case.e. This is the path specified when you installed ADePT to your computer. you will see ADePT running. The batch mode minimizes human involvement in producing the reports. 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. which will call ADePT to produce the reports. After all the project files are prepared. first start ADePT as usual and provide all the inputs as described in the section Specifying variables in ADePT: add the datasets and fill in the variables. To use the batch mode. If you want to schedule an overnight job. If your batch file is written correctly. Note also that since the 42 .ini D:\Reports\FirstReport. At this step you need to create a new batch file.xml The line consists of three components: first is the full file name of the ADePT executable. double-click it in a Windows Explorer window. use the Task Scheduler to schedule this batch file as a new task. i.xml” D:\Projects\FirstProject.exe D:\Projects\FirstProject. the Task Scheduler can usually be found in the Accessories/System Tools subfolder of the Start menu. be sure to enclose that parameter into double quotes like in the next example: “C:\Program Files\ADePT\ADePT. The third parameter is the full name of the file where the report should be saved. close the ADePT program.exe” Reports\FirstReport. you add the following line to ADePT: C:\Software\ADePT\ADePT. The second parameter is the full name of the project file saved earlier. On a Windows Vista-based computer.

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. all the data files in its subfolders. In the dialog window that opens. but you can still specify the global filter. To see the detailed information about the components that have changed and their old and new versions click the <Show details> button.xml. adding new tables and graphs to the existing modules and developing new modules. for example if the project is called “First. there is no way to specify table-specific inclusion conditions in the batch mode. It is also a good idea to bind the project and the report with a common name. Project files can be located in different folders. 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. start ADePT and specify them interactively before running the batch file. and all the produced reports in a special output folder. 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 text with the extension “. Some parameters apply to the ADePT program as a whole and cannot be specified in each project individually. It is thus important to keep the program up-to-date by periodically installing the updates. 43 .IF-conditions are not stored in the project files. ADePT reports if an update is necessary.” name the report “First. To check whether the new version of ADePT is available. Updating ADePT The ADePT team is constantly working on improvements in the functionality of the ADePT Software platform. right-click its icon in the Start menu and the text after the Target parameter is the full file name that you need for the first parameter.ini. It is a good idea to store all the prepared projects in one folder.” Proper organization of the files will help you to navigate and back up your files more easily.      8.BAT” so that the Windows operating system can properly recognize them as batch files. If any of them needs adjustment. If you do not remember where ADePT was installed. reports can be saved into different folders. on the Menu bar [6] click <Help> → <Check for Updates…> ADePT will try to access the developers’ website and check if a newer version is currently available.

You can uninstall ADePT by clicking the corresponding icon in ADePT’s program group in the Windows Start menu. 9. ADePT will download the newer version from the developers’ website. but it is possible to do so. so be sure to save your project file before performing an update. A formal uninstallation of ADePT is not required for updates. its 44 . and an Internet connection must be established before opening the updates dialog.org/adept Carefully study the requirements for hardware and software prerequisites before installing ADePT. indicating the progress in a progress bar.During the update ADePT will close. It is also possible to update ADePT by simply installing the most recent version on top of an existing version. Once the newer version is downloaded. Troubleshooting ADePT 9. After this the process is complete and ADePT restarts automatically.1 Problems during installation The most recent version of ADePT can be downloaded from its homepage: www. and all the ADePT program files are removed from your computer.worldbank. While ADePT itself does not require administrative privileges to be installed. Note that the <Update> button will remain disabled if there is no Internet connection. Also note that all custom settings and values of the parameters are preserved on updates. ADePT closes and replaces its files with the newer ones. Click <Update> to perform the update and change the program files.

g.2 Debug mode ADePT is a complex computer program. To be able to help in the most efficient way we will need the following information about your system: a. Service packs and updates applied to the operating system (e. March 15. 2.g. If you encounter a problem during installation on a system that satisfies all the requirements for ADePT. in particular if some tables are not produced and you see indications of possible bugs. US American). and as in any program bugs and errors are inevitable.3790). 32.. 5. 5. Windows Vista. 9.. Version of the Microsoft Office installed (if applicable). d.2. You may need to contact your system’s administrator in case you do not have such access rights on your system..Net framework installed (e.g.g.g.. Release version (e. b.g. In this mode ADePT will monitor its own behavior during the computations.g. Bit-version (e. 2. c. e. Detailed description of the problem indicating whether the problem is reproducible.402 bytes). Date when downloaded from our site (e. do not hesitate to contact us through the contact form on the website. Version of the ADePT installation that you are trying to install: 1. 4.prerequisites do require such special privileges. Windows XP. f.. logging the commands issued to transform the data. 3. which addresses the common problems and solutions discovered after the creation of this manual. If you experience any strange behavior during the computations. which can provide key evidence in identifying problems with the algorithms on which ADePT is based.5). Type and version of the operating system installed. 3. File size of the installation (e. we recommend checking the FAQ section at ADePT’s homepage. 2010). Language of the operating system (e.. 12.or 64-bit). Any additional information that you think may be helpful in resolving the problem.. Version of the . 45 . etc.g. If the problem is not resolved with this additional information..074. Type (e. activate ADePT’s debug mode.). 1. Service Pack 2).

which were used when the error occurred because of confidentiality reasons.  Any output (perhaps incomplete) that ADePT managed to produce before an error occurred. open each file in the error report archive in a text editor. To do this. Data conversion ADePT can work with files of the two popular formats for storing statistical data: the Stata data file format (file extension “. it will persist until switched off (even if ADePT is restarted). However. wait for the computations being performed as usual. All the information that ADePT puts in the error report file can be checked before submission.sav”).1. In some cases you may find that the datasets are available in different formats that are not supported directly by ADePT. After setting all the inputs and pressing <Generate>. The error report file does not include any unit-record data or user’s datasets.dta”) and the SPSS file format (file extension “.  The messages that ADePT has produced while checking the data and performing computations. Once the debug mode is activated.To activate the debug mode. 46 . 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. this information would be useful for developers in order to reproduce the problem. In this case data conversion becomes necessary. select the corresponding item <Debug Mode> in the <Tools> menu [6] before pressing the <Generate> button [26]. In the end ADePT will suggest saving the error report file.  Trace of the commands that ADePT executed to transform the data and compute the indicators. You can save this file to any location on your computer and send it to the developers as an attachment. Appendix 1: List of data checks Appendix 2: 2. This file (in fact a ziparchive) 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. 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.

gnumeric”). at least for the text files. but usually provides a wider range of supported file formats. Open-Document (“. these labels are shown in the table. When working with 47 . If labels for a variable used in the table are defined. R (with installed package “foreign”) can read-in DBASE (“. ADePT does not provide such a possibility on its own and relies on the users having Stata. 2. You may want to double-check that there is no loss of data during the conversion process.txt. Minitab (“. In contrast to statistical packages. this may be an obvious choice. Popular data conversion programs like Stat\Transfer support output to Stata and SPSS files and can convert statistical.stattransfer. For example. and spreadsheet packages from dozens of file formats.csv) data files. the package that was used to create the dataset in the first place) or using specialized data conversion software. If no labels are defined.dbf”) datasets. Most common points of concern are:    Are the variable and value labels preserved? Are missing values properly converted? Have the variable names or storage types changed during conversion? Having a program that can browse your dataset is very helpful. the table will contain numerical codes for the regions.gnu. Assigning and using labels in ADePT When ADePT creates a table it uses variable labels defined in the user’s datasets.2. R: www. Most of the modern statistical packages have facilities to import/export data from/to various file formats. Otherwise. but not necessarily. and other file formats. ADePT builds the table with actual region names.com Please follow instructions very carefully when working with these packages. Most packages will be able to open ASCII/plain text (.asc) data files and comma-separated (. If Stata or SPSS software is available.r-project. ADePT outputs the numeric codes.ods”) and other files.org PSPP: www.gnm”/”. PSPP can read-in Gnumeric (“. consider a tabulation of poverty by region. .There are two main strategies for converting statistical data: using a statistical package that provides extensive import and export facilities (perhaps. specialized data conversion software focuses solely on data conversion. mathematical.mtp”). If the variable holding region codes is properly labeled.org/software/pspp Stat\Transfer: www. For example.

otherwise. etc. We also advise you to select Numerics By Stata as the computational engine in the options. These meanings are usually contained in a separate document called “codebook” and distributed with the data. as well as Microsoft Office Excel or Microsoft Excel Viewer. The path to ADePT may change (the drive-letter of the mounted drive depends on the presence of other drives and the configuration of the host computer).) and the most recent input settings used in every module. you may have to revise your batch files. 3. For example.multiple datasets. These settings include the options (language. To correctly define the value labels. and so forth. in order to define the labels for regions in Stata. that: 1. The computer where you want to run ADePT must have . you can take your USB-stick with ADePT and run it on a different computer. When ADePT reads the value labels from the user’s dataset. but not in the first dataset. and the second command binds these labels to a particular variable region. reporting level. you can define them yourself using Stata or SPSS. the following commands may be used: label define lregion 1 “North” 2 “South” 3 “East” 4 “West” label values region lregion The first command defines the new system of value labels lregion. Your settings will not be travelling with you. If you are using the batch mode of ADePT. In fact. unless you expect a compatible version of Stata to be present.NET Framework of the proper version as described in the program requirements section. you can select a USB-stick (thumb-drive) during installation and ADePT will install there. If your datasets contain no labels. It is thus important to set this code page value correctly. however. Note. Since administrative privileges are not required to install or run ADePT. 48 . or the labels are lost during data conversion. the meaning of each code needs to be known. adds to it value labels defined in the second. Appendix 3: Portable ADePT You can take ADePT with you when you go to use it on a different computer. 2. the labels may be unreadable. it uses the code page value defined in the options/localization dialog to properly decode the labels. ADePT takes the value labels from the first dataset. path to Excel. Many datasets come with predefined variable and value labels.

26. 8. 27. 38 MS Excel Viewer · 9. 30. 15. 13. 15. 20. 10. 16. 40. 21. 29. 13. 15 I IF-condition · 7. 16 Contents sheet · 21 O Open in Stata button · 11. 22. 38. 28. 39. 12 Compound fields · 13. 34. See Project G Generate button · 7. See Generate button String variable · 12. 30. 40. 43 E Errors · 8. 30. 45. 37 Numerics by Stata · 4. 37. 42. 24. 29. 22. 38 B Batch mode · 40 Browse button · 5. 19. 36. 9. 30 49 . 11. 14. 27. 41. 28. 21. 27. 35. 14. 43 Project · 38. 31 Missing Values · 8. 38. 24 Dummy variable · 8. 39. 39 Stata · 3. 31. 11. 27. 15. 39. 25.Index A Add button · 9. 30. 14. 31. 21. 16. 21. 21. 42. 39. 47 Notifications · 8. 36. 33. 47 Status bar ·7. See Options Reset project · 39. 29. 41. 9. 39. 25. 37. 40. 34. 28. 38 N NBS · 36. 33 Open Project · 39 Options · 18. 42 Project file · 27. 39 R Remove button · 11 Reporting tab · 18. 42. 18. 9. 39. 45 Global Filter · 7. 25. 33. 26. 31. 21. 4. 37. 42. 18. 24. 38. 23 Numeric values · 12 Numerical variable · 12 C Categorical variable · 8. 8. 12. 46. 32. 41. 8. 8. 42 S Search · 11. 24. 14 Stop button · 7. 34. 26. 16. 19. 31 MS Excel · 9. 47 Original Data Report · 22 D Datasets tab · 7. 28. 31 P Programs tab · 13 project · 27. 46 Missing Values tab · 7. 42 M Main Form · 7. 23. 35. 37. 29 F Frequencies · 23. 13. 39. 37. 28. 40 Select Font · 19 Show changes between periods · 10 Standard errors · 7. 23. 18. 29.

15. 22 T Tools · 18. 39. 41. 19 W Warnings · 8. 37. 37. 20. 30. 14.System Messages window · 7. 42 V Variables tab · 7. 21. 45 X xml · 21. 18. 36 50 . 18. 34. 16. 11. 30. 19.

Sign up to vote on this title
UsefulNot useful