| NEWS | R Documentation |
Version 2.0.5 was not released
function Linelines.episodes Updated to accommodate different time measurements (cmc, calendar time, age, etc.)
function TransitionAB format.born <- attr(Bdata,"format.born") and arguments of function date_convert
function date_b format.born <- attr (Bdata,"param")$format.born replaced by format.born <- attr (Bdata,"format.born")$format.born
function OverviewTransitions format.born added
function transitions ormat.born <- attr (Bdata,"param")$format.born replaced by format.born <- attr (Bdata,"format.born")
function Biograph.long Updated: zx <- reshape and code Bdata2$start2 <- Bdata2$start removed
NAMESPACE importFrom() is used to import functions from designated packaged
The Biograph object has an additional attribute: format.born (format of date of birth). The format may differ from the format of dates of other transitions.
function Parameters: variable newnamstates added to control the sequence of states in the state space
function Parameters: the attribute 'format.born' added to the Biograph object. The attribute is added
function date_b: the argument format.in removed. The value is taken from the attribute param of the Biograph object instead. Format.born replaces format.date in case of birth.
function Remove.intrastate: the function produced attr(par), a redundant attribute of the Biograph object.
function age_as_year: a condition added: if (format.born=="CMC"|format.born=="cmc") b<- cmc_as_Date (born,selectday=1,format.out="
function Lexis.lines: attr (Dlong1,”trans”) replaced by attr(Dlong2,"param") <- attr(Bdata,"param")
function Lexis.lines: format.born replaces format.date in y <-date_convert (Dlong2$born,format.in=format.born,format.out="year")
function Parameters: Bug in iagelow and iagehigh corrected (due to variable 'born')
function Parameters: ncovariates: number of covariates is locpat-5 instead of locpat-7. And : covariates <- colnames(Bdata)[5:(locpat-1)] (1 was 3)
function Samplepath: variables Start and end removed (redundant)
function Remove.intrastate: Bdata2 is dd (and 'removed') instead of dd$D (and 'removed$D'). Further: removed$par is removed and replaced by attr(removed,"param"). This has effect on calling of na function of mvna package (see Biograph manual)
function plot.MSLT.S : argument S$S instead of S
function Biograph.long: zloc = 9 instead of 10
Date conversion functions. In Biograph 1.0, calendar dates were in Century Month Code (CMC) or decimal year (calendar year and fraction of year). In Biograph 2.0, dates may be given as calendar date (year, month, day). Several function are added to convert one representation of date into another representation. The following representations are distinguished in Biograph 2.0.1 and higher: date of Gregorian calendar (year, month, day), Julian date (days since reference point in time), decimal year, CMC, and age. To compute the precise age in years, months and day in the Gregorian calendar, Biograph 2.0.2 distinguishes different classes of date objects (instant, interval, period and duration). The classes are implemented in functions of the lubridate package. These functions are used in Biograph 2.0. For details, see Willekens (2013) Chronological objects in demographic research. Demographic Research, Vol 28, Article 23.
Occup . In Biograph 2.0.1 the function Occup is split in two functions: i. state_age determines for each subject the state occupancy by age, and aggregates the result to produce (sample) population state occupancies by age. ii. state_time determines for each individual state occupation times (sojourn times) by age and state and aggregates the result to produce (sample) population state occupation times by age. The states displayed include the (a) the state space and (b) the fictitious states ‘not-yet-in-observation’ and ‘observation right censored’. The functions state_age and state_time are called by the function Occup. The state ‘not-yet-in-observation’ is dropped in objects returned by the function Occup.
In Biograph object, the variables idem and ns are deleted. The variable idim denotes the domain of life. It has never been used (idim=1) and is not deleted. The variable ns (number of states a subject occupies during the observation period) can be determined from the path variable, e.g. nchar(GLHS$path) The removal of idem and ns has consequences for several functions including Parameters, transitions, GLHS.Biograph, OverviewTransitions and OverviewEpisodes. The functions have been updated.
The graphics is improved using the ggplot2 package.
A distinction is made between Biograph functions and utilities used by Biograph functions. Utilities are generic. The package includes about 20 utilities.
\ item ChangeObservationWindow.e attr(Bdata3,"format.dat") <- attr(Bdata,"format.date") replaced by attr(Bdata3,"format.date") <- attr(Bdata,"format.date")
With the publication of Version 2.0, a utility is distributed to assist the production of a Biograph object (in the doc subdirectory of the package). The code that applies the utility to different data sets is published too.
In Biograph 2.0.2, the date functions have been renamed: a . is replaced by _. The reason for renaming is the possible confusion with S3 methods in R that determine the dispatching methods based upon an attribute (class) of objects.
In Version 2.0.2 global variables are not longer used. Instead, the attribute "param" is added to the Biograph object. The attribute consists of the object produced by the Parameters function. The attribute "trans" is omitted because it is included in "param".