*! version 1.0.0 18nov2017

Title

[sae] data export -- export sae data (Mata format) to Stata format

Syntax

sae data export, matasource(string) [numfiles(integer 1) prefix(string) saveold datasave(string)]

Description

This sae data export export is useful for bringing in the simulated vectors created by sae into Stata.
It provides the user the ability to further manipulate these vectors. Due to the unique structure of the Mata data, this command will only
work with data created in the simulation stage.

Options

matasource(): The matasource option allows users to specify the source ydump file created by the
sae simulate routine. Because the size of the file can be quite large, it is advisable to use this with
the numfiles option.

numfiles(): The numfiles option is to be used in conjunction with the ydumpdta option; it specifies
the number of datasets to be created from the simulations.

prefix(): The prefix option may be used to give a prefix to the simulated vectors.

saveold: The saveold option can be specified in conjunction with the ydumpdta option, and makes
the files readable by older versions of Stata.

datasave(): The datasave option allows users to specify a path where to save the exported data,
this is recommended when using the numfiles option.

Examples

Due to the unique structure of the Mata data, this command will only work with data created in the simulation stage.

References

Bedi, T., A. Coudouel, and K. Simler (2007). More than a pretty picture: using poverty maps to design
better policies and interventions. World Bank Publications.

Demombynes, G., C. Elbers, J. O. Lanjouw, and P. Lanjouw (2008). How good is a map? putting small
area estimation to the test. Rivista Internazionale di Scienze Sociali, 465–494.

Elbers, C., J. O. Lanjouw, and P. Lanjouw (2002). Micro-level estimation of welfare. 2911.

Elbers, C., J. O. Lanjouw, and P. Lanjouw (2003). Micro–level estimation of poverty and inequality. Econometrica
71 (1), 355–364.

Foster, J., J. Greer, and E. Thorbecke (1984). A class of decomposable poverty measures. Econometrica:
Journal of the Econometric Society, 761–766.

Harvey, A. C. (1976). Estimating regression models with multiplicative heteroscedasticity. Econometrica:
Journal of the Econometric Society, 461–465.

Haslett, S., M. Isidro, and G. Jones (2010). Comparison of survey regression techniques in the context of
small area estimation of poverty. Survey Methodology 36 (2), 157–170.

Henderson, C. R. (1953). Estimation of variance and covariance components. Biometrics 9 (2), 226–252.

Huang, R. and M. Hidiroglou (2003). Design consistent estimators for a mixed linear model on survey data.

Proceedings of the Survey Research Methods Section, American Statistical Association (2003), 1897–1904.

Molina, I. and J. Rao (2010). Small area estimation of poverty indicators. Canadian Journal of Statistics
38 (3), 369–385.

Rao, J. N. and I. Molina (2015). Small area estimation. John Wiley & Sons.

Tarozzi, A. and A. Deaton (2009). Using census and survey data to estimate poverty and inequality for
small areas. The review of economics and statistics 91 (4), 773–792.

Van der Weide, R. (2014). GLS estimation and empirical bayes prediction for linear mixed models with
heteroskedasticity and sampling weights: a background study for the povmap project. World Bank Policy
Research Working Paper (7028).

Zhao, Q. (2006). User manual for povmap. World Bank. http://siteresources.worldbank.org/INTPGI/
Resources/342674-1092157888460/Zhao_ManualPovMap.pdf .

Authors

Minh Cong Nguyen, mnguyen3@worldbank.org

Paul Andres Corral Rodas, pcorralrodas@worldbank.org

Joao Pedro Azevedo, jazevedo@worldbank.org

Qinghua Zhao, qzhao@worldbank.org

World Bank

Thanks for citing sae as follows

sae is a user-written program that is freely distributed to the research community.

Please use the following citation:

World Bank. (2017). “Small Area Estimation: An extended ELL approach.”. World Bank.

Acknowledgements

We would like to thank all the users for their comments during the initial development of the codes.
All errors and ommissions are exclusively our responsibility.