getfame and putfame read and write scalars (ti,
numeric, character or logical objects of length 1) and
numeric tis (Time Indexed Series) from and to Fame databases.
FAME case series and series with string or FAME "date" types can be
read by getfame, but not written with putfame.
fameWhats returns information about an object in a database,
including its name, class, type, basis and observed attributes, as
well as start (a ti Time Index) and length. If getDoc is
TRUE, it will also include description and
documentation components. fameWhats is a wrapper around the function fameWhat,
which provides the same information in a lower-level form.
fameWildlist returns a list giving the name, class, type and
frequency of the objects in the database with names that match
wildString.
getfame(sernames, db, connection = NULL, save = FALSE, envir = parent.frame(),
start = NULL, end = NULL, getDoc = TRUE)
putfame(serlist, db, access = "shared", update = TRUE,
checkBasisAndObserved = FALSE, envir = parent.frame())
fameWhats(db, fname, connection = NULL, getDoc = TRUE)
fameWildlist(db, wildString = "?", connection = NULL, nMax = 1000, charMode = TRUE)fameLocalPath() function is defined, it
will be called on this argument to obtain a path. To open a remote
database, use a string like "sefameConnection. Leave this at the
default NULL setting for local databases.TRUE the retrieved series are individually saved in the
environment specified by envir.getfame, the environment used by assign to save
the retrieved series if save is TRUE. For
putfame, if serlist is a character vector, the
environment in which toti object, or something that the ti function
can turn into a ti object. The time index for the first
observation in the returned series. The default is the series starti object, or something that the ti function
can turn into a ti object. The time index for the last
observation in the returned series. The default is the series end
TRUE (the default), also get the series description and
documentation attributes, accessible via functions of the
same names.envir, a list containing the objects, or an object itself.
Objects that can be written to tc("create", "overwrite", "read", "shared",
"update"). Warning: Opening an existing database in
"overwrite" mode wipes out the database. You almosTRUE (the default), existing series in the database will
be updated. If FALSE, existing series in the database with
the same names will be replaced by the series in serlist.
Fame scalars (single strinTRUE and update == TRUE, the basis and
observed attributes of any existing series with the same name will
be checked for consistency with the updating series from
serlist. If the basis orTRUE (the default) return class,
type and freq components as strings, rather than
integer codes.getfame returns a list of the retrieved objects. If save
is T, the list is returned invisibly. The names of the list
are the R names described in the details. Fame scalars are returned
as strings, ti dates, or numbers. Case series are returned as
vectors of the appropriate type, with the names attribute of each
vector set to the case numbers. If getDoc
is TRUE (the default), retrieved objects will also have
attributes named description and documentation. putfame invisibly returns an empty string.
fameWhats returns NULL if it can't find fname in
db. Otherwise, it return a list with components
The R names of series may differ from their Fame names. For
getfame, names(sernames) holds the R names of the
retrieved series. If sernames does not have a names
attributes, the R names will be the same as the Fame names.
Naming for putfame is more complicated, because the series
specified by serlist for putfame may be univariate or
multivariate. For a multivariate series, the column names of the matrix
become the Fame names. Not having a name for each column is thus an
error.
A univariate series may be a single-column matrix. If it is, and it
has a column name, that becomes the Fame name of the series.
Otherwise, the Fame name of a univariate series is the corresponding
element of names(serlist). If serlist is an actual list
of series, names(serlist) must be of the same length. For
character vector serlist a names attribute is optional. If
there isn't one, the Fame names will be the same as the R names.
Consistency checking when update == TRUE:
If there is already an existing series in the database with the same
name as one in serlist, the Fame class, type, and frequency
are checked for consistency between the updating series and the
existing series in the database. In addition, if
checkBasisAndObserved is TRUE, those attributes are also
checked. Inconsistencies for any of the checked attributes between
the updating existing series will abort the update. The default value
for checkBasisAndObserved is set to FALSE because this
inconsistency is very common in MRA code.
ti, tis, fameConnectionmydb <- "pathToMyDatabase"
boink <- getfame("gdp.q", db = mydb) ## returns a list
gpd.q <- boink[[1]] ## or boink$gdp.q
getfame("gdp.q", db = mydb, save = TRUE) ## saves gdp.q in the current frame
## saves the series as "nominalIncome"
getfame(c(nominalIncome = "gdp.q"), db = mydb, save = TRUE)
seriesA <- tis(1:24, start = c(2002, 1), freq = 12)
seriesB <- tis(1:104, start = c(2002, 1), tif = "wmonday")
documentation(seriesB) <- paste("Line", 1:4, "of seriesB documentation")
## store them as "mser" and "wser"
putfame(c(mser = "seriesA", wser = "seriesB"), db = "myfame.db")
matrixSeries <- cbind(a = seriesA, b = seriesA + 3)
putfame(matrixSeries, db = "myfame.db") ## stores as "a" and "b" in Fame
## storing a scalar as "myscalar"
putfame(c(myscalar = 42), db = "myfame.db")
fameWildlist("myfame.db")
fameWhats("myfame.db", fname = "wser", getDoc = TRUE)Run the code above in your browser using DataLab