SASxport-package          package:SASxport          R Documentation

_R_e_a_d _a_n_d _W_r_i_t_e _S_A_S _E_x_p_o_r_t _F_i_l_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     This package provides functions to read, list contents of, and
     write SAS export files.

_D_e_t_a_i_l_s:

     The 'read.xport' function reads SAS xport formatted files,
     augmenting the functionality of the 'read.xport' function provided
     in the 'foreign' package with additional features borrowed from
     'sasxport.get' in Frank Harrell's 'Hmisc' package.  Namely,
     variables are properly coerced into the types specified by the
     format field. All standard numeric and string SAS formats are
     supported automatically, while user-defined formats are supported
     when the user has included the appropriate format data in the
     xport file via:


          PROC FORMAT CNTLOUT=format;

     The 'write.xport' function writes one or more data sets into a SAS
     xport formatted file.  Standard R data types, including date and
     time objects (e.g. 'Date', and 'POSIX.t') are stored with proper
     SAS format types. Handling of object formatting is customizable by
     providing methods for the function 'toSAS'. This is accomplished
     by writing a new method for 'toSAS' for the object class of
     interest. The 'toSAS' method is responsible for converting its
     argument to either a simple floating point or character variable
     (the only basic types permitted by the xport format) and adding
     the appropriate SAS format code in the '"SASformat"' attribute.

     The 'write.xport' function also allows the user to override the
     operating system type and SAS version information, as well as
     object creation and modification times.

_I_n_d_e_x:


     lookup.xport            Lookup Information on a SAS XPORT Format
                             Library
     read.xport              Import SAS XPORT files
     toSAS.default           Convert R data object for storage in SAS 
                             xport file
     units                   Set or Retrieve the label, SASformat, 
                             SASiformat, or units Attribute of a Vector
     write.xport             Write data to a SAS XPORT file


_F_u_n_d_i_n_g:

     This creation of this package was partially funded by Metrum
     Institute <URL: http://metruminstitute.org>.

_M_a_i_n_t_a_i_n_e_r:

     Gregory R. Warnes greg@random-technologies-llc.com

_S_u_p_p_o_r_t:

     Technical support contracts and other services for R, this
     package, and other packages are available from Random Technologies
     LLC <URL: http://random-technologies-llc.com>.

_A_u_t_h_o_r(_s):

     Unless otherwise noted, the contents of this package were written
     by Gregory R. Warnes greg@random-technologies-llc.com, are
     Copyright (c) 2007 by Random Technologies LLC 
      <URL: http://random-technologies-llc.com>, and are provided under
     the terms of the GNU General Public License, version 2.0 or later. 

     The file 'htond.c' is extracted from BRL-CAD <URL:
     http://www.brlcad.org/>, written by Michael John Muuss, and is 
     Copyright (c) 2004-2007 United States Government as represented by
     the U.S. Army Research Laboratory, and is utilized and
     redistributed under the terms of the  GNU Lesser General Public
     License, version 2.1.

     The files 'AFirst.lib.s', 'all.is.numeric.R',
     'importConvertDateTime.R', 'in.opererator.R', 'makeNames.R', 
     'read.xport.R', and 'testDateTime.R' are copied or adapted from
     the 'Hmisc' package created by Frank E. Harrell, Jr. 
     f.harrell@vanderbilt.edu, and are utilized and redistributed under
     the terms of the GNU General Public License, version 2.0 or later.

