help for ^outseries^                    (Internal BC distribution, 31 May 2001)

Write timeseries to external files ----------------------------------

^outseries^ [varlist] [using], [^Dir^(string) ^Tin^(string) Matlab ]

Description -----------

^outseries^ writes quarterly or monthly timeseries currently in memory to external files, one file per series. A ^varlist^ (using wildcards or hyphenated syntax) may be used to write a subset of variables. Alternatively, a ^using^ clause may specify the name of a file in which series names are provided, one per line. Unless ^dir^ is specified, a new directory will be created, timestamped (e.g. ^29-May-2001^) and each retrieved series will be written to that directory via ^outfile^ as an ASCII text file (comma-delimited format), with the filename containing the series mnemonic.

^outseries^ is for use with time-series data. You must ^tsset^ your data before using ^outseries^.

^outseries^ makes use of the ^file^ command, added to Stata version 7 on 8 May 2001. If you do not have this command, update your copy of Stata.

Options -------

^dir^ specifies that the files for each data series should be placed in the existing subdirectory named in the option. The subdirectory must exist in the current working directory, and you must have write access to it. If files of the same names exist, they will be replaced.

^tin^ allows the first month and last month of data retrieval to be specified. Using the same format as the ^tin(first,last)^ function, you would specify ^tin(1964m1,1979m10)^ to limit the retrieved data to that time range. If missing values exist within the specified range, they will be coded as such (.) in the output file.

^matlab^ indicates that the series are to be written to files with extension ^.dat^ and missing value codes of ^NaN^ used in place of ^.^ within the data series. If this option is specified, the ordinary text series are not created in ^.txt^ files. The resulting ^.dat^ files may be read into MATLAB via ^load SERIES.dat^ or ^A = load('SERIES.dat')^.

Examples --------

. ^outseries D*^ . ^outseries using series.list, matlab^

. ^outseries D* , dir(dvars) tin(1959m1,1970m12) matlab^

. ^outseries, tin(1959m1,)^

Author ------

Christopher F Baum, Boston College, USA baum@@bc.edu

Also see --------

On-line: help for @outfile@