Convert a Time Series to BIMETS
This function tries to convert a time series of class ts()
or xts()
into a BIMETS time series that satisfy the compliance control check defined in is.bimets
All the information in the input time series will be preserved.
Input time series must be of class ts()
or xts()
, and will be converted in the BIMETS class-type specified in the global option BIMETS_CONF_CCT
(see BIMETS configuration
).
If the input time series has a temporal discontinuity (i.e. a missing pair Date-Value in the case of xts()
time series) then the missing pair Date-Value is inserted in the output time series with a missing value NA
, or with the value provided in the FILLVALUE
argument.
If BIMETS_CONF_CCT='XTS'
, in the case of a monthly time series the .indexCLASS
is converted to the class yearmon()
; in the case of a quarterly time series the .indexCLASS
is converted to yearqtr()
; in the case of other input frequency the .indexCLASS
is converted to Date()
. If BIMETS_CONF_CCT='XTS'
the dates of all the output observations are set accordingly to the BIMETS global option BIMETS_CONF_DIP
, i.e. the first or the last dates in the period (see BIMETS configuration
).
If the input time series has multiple observations in the same date, e.g. an xts()
with a two or more observations in the same date, the duplication is removed and the output time series will contain only the later observation (see examples).
If the input time series is multivariate the output time series will contain only the first column of the input matrix of data (where the matrix of data is the matrix built with the aligned input time series as columns).
If the input time series is a daily time series of class xts()
and the global option BIMETS_CONF_CCT='TS'
then the 366 period of the output time series in each non-bissextile year will have the value of the 365 period in the same year (duplicated value).
as.bimets(x=NULL, FILLVALUE=NA, VERBOSE=FALSE, ...)
x |
Input time series of class |
FILLVALUE |
Value inserted in the output time series in the case of temporal discontinuity. Defaults to missing NA. |
VERBOSE |
If |
... |
Backward compatibility. |
This function returns a BIMETS time series (see also BIMETS configuration
)
.
#xts series with dates equal to the first date in the period, #and some missing observations #first...set option and work with xts setBIMETSconf('BIMETS_CONF_CCT','XTS') #create xts xt=xts(1:10,order.by=seq(as.Date('2000-01-01'),len=10,by='year')) #remove some data xt=xt[-5] xt=xt[-3] #convert to bimets xtBimets=as.bimets(xt) #print before and after... print(xt) print(xtBimets) #ts bivariate series into xts setBIMETSconf('BIMETS_CONF_CCT','XTS') ts=ts(matrix(c(1,2,3,4,5,6),nrow=3,ncol=2),start=c(2000,1),frequency=1) print(ts) xtsBimets=as.bimets(ts) print(xtsBimets) #reset defaults setBIMETSconf('BIMETS_CONF_DIP','LAST') setBIMETSconf('BIMETS_CONF_CCT','TS') #xts quarterly with irregular dates and missings data xt=xts(1:10,order.by=seq(as.Date('2000-01-03'),len=10,by='3 months')) #remove some data xt=xt[-5] xt=xt[-3] #convert tsBimets=as.bimets(xt) #print before and after print(xt) print(tsBimets) #xts daily with duplicated observations and missing data xt=xts(1:11,order.by=c(as.Date('2000-01-01'), seq(as.Date('2000-01-01'), len=10,by='day'))) xt=xt[-5] xt=xt[-3] #convert tsBimets=as.bimets(xt) #print before and after print(xt) print(tsBimets) #verbose and fillvalue xt=xts(1:11,order.by=c(as.Date('2000-01-01'), seq(as.Date('2000-01-01'), len=10,by='day'))) xt=xt[-5] xt=xt[-3] as.bimets(xt,FILLVALUE=99.99,VERBOSE=TRUE)
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.