+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

----------------------- miceadds NEWS -------------------------

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

miceadds:  Some additional multiple imputation functions, 
           especially for mice


                         (\-.
                         / _`> .---------.
                 _)     / _)=  |'-------'|
                (      / _/    |O   O   o|
                 `-.__(___)_   | o O . o |
                               `---------'
   
                                          oo__
                                         <;___)------
                                    oo__   " "
                                   <;___)------     oo__
                                     " "           <;___)------
                                                     " "

Alexander Robitzsch

Questions or suggestions about miceadds can be sent to
robitzsch@ipn.uni-kiel.de

In case of bug reporting, please always provide a
reproducible script.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
CHANGELOG miceadds
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~



---------------------------------------------------------------------
Versions 1.7  -- 2016-02-18  --  CRAN miceadds 1.7-8
---------------------------------------------------------------------

NOTE  * allowed alternative specification of weighting variable in
        'scale_datlist' which now allows for group-wise 
        standardizations
NOTE  * included arguments 'index' and 'systime' in 'save.data' for
        automatic inclusion of indices and time stamps in saved 
        datasets
NOTE  * included argument 'se' in 'NMIcombine' function which can be
        used if only standard errors instead of covariance matrices
        are available
ADDED * added utility function 'pool_mi' for inference of multiply
        imputed datasets which has the same functionality as
        'mice::pool' or 'mitools::MIcombine'. This function provides
        summary, coef and vcov S3 methods.
NOTE  * function 'datalist2mids' is now also accessible via
        'datlist2mids' (which is more coherent to class 'datlist')
NOTE  * defined 'pool_nmi' synonymously to 'NMIcombine'
NOTE  * added S3 print method for 'datlist', 'nested.datlist',
        'NestedImputationList'
ADDED * added subsetting methods 'subset_datlist' (and the S3 method
        subset) for multiply imputed datasets and 'subset_nested.datlist'
        for nested multiply imputed datasets
NOTE  * added further calculation of fraction of missing information for
        nested multiply imputed datasets according to Harel and 
        Schafer (2002) in 'NMIcombine' which can be assessed by the
        argument 'method=2'.  
NOTE  * extended imputation of latent group means to lme4-based imputation
        in 'mice.impute.2l.latentgroupmean.ML' and MCMCglmm-based 
        imputation in 'mice.impute.2l.latentgroupmean.MCMC'
NOTE  * added with and within methods for objects of class 'datlist'
        and 'nested.datlist'
ADDED * added convenience functions 'withPool_MI' and 'withPool_NMI' for
        pooling (averaging) estimates for (nested) multiply imputed 
        datasets
ADDED * added utility function 'scan0' which is 'scan' with default
        what='character'
ADDED * added utility functions 'nestedList2List' and 'List2nestedList'
        for list conversions
ADDED * added functions 'nested.datlist2datlist' and 'datlist2nested.datlist'
        for converting nested multiply and multiply imputed datasets
NOTE  * extended argument 'type' in 'save.data' for saving a dataset in
        multiple file formats
NOTE  * added example for plausible value imputation in Amelia package
        in draw.pv.ctt.Rd (Example 1) 
NOTE  * added 'print' methods for 'mids.1chain' and 'mids.nmi' objects
        (the method is equivalent to 'summary')
NOTE  * exported 'write.fwf2' and 'read.fwf2' for writing and reading
        files in fixed width format
NOTE  * added utility function 'VariableNames2String' for handling
        variable names which should be converted into strings
ADDED * added utility function 'write.datlist' for writing multiply
        imputed datasets
ADDED * included function 'mi_dstat' for relating missingness
        indicators to covariates

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: scale_datlist (1), save.data (1),
        pool.mids.nmi (1,2), pool_mi (1), subset_datlist (1,2),
        datlist2mids (1), with.miceadds (1,2), scan.vec (1),
        nestedList2List (1), datlist_create (4), save.data (1),
        draw.pv.ctt (1), write.fwf2 (1), data.graham (1,2),
        VariableNames2String (1), write.datlist (1), mi_dstat (1)


---------------------------------------------------------------------
Versions 1.6  -- 2016-01-30  --  CRAN miceadds 1.6-0
---------------------------------------------------------------------

NOTE  * included argument 'X' in 'mids2datlist' and 'mids2mlwin' 
        which allows the inclusion of further variables in list of 
        multiply imputed datasets 
NOTE  * output of function 'mids2datlist' is now of class 'datlist' 
        or 'nested.datlist'
ADDED * extended weighted statistics 'ma.wtd.statNA' to (nested)
        multiply imputed datasets
NOTE  * included 'datlist_create' and 'nested.datlist_create' utility
        function 
NOTE  * changed estimation method in imputation of latent group means
        in 'mice.impute.2l.latentgroupmean' to MCMC estimation using
        the MCMCglmm package
ADDED * added 'scale_datlist' for adding a standardized variable to a
        list of multiply imputed datasets
NOTE  * cleaned namespace file and defined imported functions
        in a more explicit way

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: mids2datlist (3), 
        ma.wtd.statNA (1,2,3), datlist_create (1,2), scale_datlist (1,2), 
        cxxfunction.copy (1) 

---------------------------------------------------------------------
Versions 1.5  -- 2015-11-21  --  CRAN miceadds 1.5-0
---------------------------------------------------------------------

NOTE  * changed function 'save.data' due to changes in recent sjmisc
        package update on CRAN

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: ---

---------------------------------------------------------------------
Versions 1.4  -- 2015-11-04  --  CRAN miceadds 1.4-0
---------------------------------------------------------------------

NOTE  * included argument 'suffix' in 'save.data' for easier 
        inclusion of parts of file names when saving data
FIXED * fixed a bug in imputation method '2l.latentgroupmean'
        (reported by Simon Grund)
ADDED * added Spearman rank correlation for 'micombine.cor' and
        an example for statistical inference for Kendalls
        tau (see 'micombine.cor', Example 2)
        (suggested by Kathleen Gali)    

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: micombine.cor (2)

---------------------------------------------------------------------
Versions 1.3  -- 2015-07-10  --  CRAN miceadds 1.3-0
---------------------------------------------------------------------

ADDED * added imputation method 'grouped' for grouped (coarsed) data
ADDED * included 'NMIcombine' function as an extension to
        'MIcombine' (mitools package) to nested multiply
        imputed datasets
ADDED * included function 'NMIwaldtest' which performs a multi-
        parameter Wald test for nested multiply imputed datasets
NOTE  * added argument 'extend' in 'fast.groupmean' which is useful
        for the inclusion of group means in original datasets
ADDED * added D1 statistic (Wald test) 'MIwaldtest' as a 
        multiparameter test for multiply imputed datasets
FIXED * fixed a bug in 'lm.cluster' and 'glm.cluster'. 
NOTE  * The 'cluster' argument in 'lm.cluster' now allows vector input.
NOTE  * included datasets from missing data book of Graham (data.graham)        
NOTE  * included some examples of the jomo package
NOTE  * added argument 'NMI' in 'NMIcombine' function which now also
        allows input for non-nested multiple imputation
ADDED * added 'NMIextract' function as an extension of 'MIextract'
        (mitools package) to nested multiply imputed datasets
NOTE  * added utility function 'library_install' which loads packages
        and conducts installations if required

DATA  * included/modified datasets: data.ma06, data.graham
EXAMP * included/modified examples: mice.impute.grouped (1),
        pool.mids.nmi (1.4,1.5), NMIwaldtest (1,2), fast.groupmean (1),
        lm.cluster (1,2), jomo2datlist (1), pool.mids.nmi (1),
        library_install (1)

---------------------------------------------------------------------
Versions 1.2  -- 2015-05-20  --  CRAN miceadds 1.2-0
---------------------------------------------------------------------

NOTE  * fixed a bug in 'load.data' for loading datasets of type 'table'
ADDED * included utility function 'mids2mlwin' for writing MLwiN files
        (contributed by Thorsten Luka)
NOTE  * added suggestions to sav file writing functions in haven and
        sjmisc packages
NOTE  * removed dependency on PSPP for writing sav files in 'save.data'.
        Now, the function 'write_spss' from the sjmisc package is used.
NOTE  * added further values in 'systime' function
ADDED * added a utility function 'visitSequence.determine' for 
        determining visit sequence for an imputation model when passive 
        variables are involved
ADDED * added function 'mice.nmi' for conducting nested multiple 
        imputation generating objects of class 'mids.nmi'
ADDED * extended 'complete' function from mice package for objects of
        classes 'mids.1chain' (function 'complete.mids.1chain') and
        'mids.nmi' (function 'complete.mids.nmi')
ADDED * extended 'mids2datlist' for objects of class 'mids.nmi'
ADDED * added 'with' S3 method for objects of class 'mids.1chain' and
        'mids.nmi' producing objects of class 'mira' (defined in mice)
        and 'mira.nmi'. For 'mira.nmi', a summary method is defined. 
ADDED * added 'within' S3 methods for objects of class 'imputationList'
        (which are defined in the mitools package) 
ADDED * added statistical inference for nested multiply imputed datasets
        in 'pool.mids.nmi' function
ADDED * added functions 'lm.cluster' and 'glm.cluster' for cluster robust 
        standard errors for 'lm' and 'glm' functions using the 
        multiwaycov package (and the function 'cluster.vcov' therein)
ADDED * added function 'NestedImputationList' function for creating objects
        of class 'NestedImputationList'. S3 Methods 'with' and 'within' are
        defined for operating on this list of lists of datasets.
        The S3 method 'MIcombine' (from mitools package) is extended
        to objects of class 'Nested ImputationResultList'.        
             
DATA  * included/modified datasets: ---
EXAMP * included/modified examples: write.pspp (1), save.data (1),
        systime (1), visitSequence.determine (1), datalist2mids (1),
        mice.nmi (1), complete.miceadds (1,2), mids2datlist (2),
        with.miceadds (1,2), pool.mids.nmi (1), lm.cluster (1),
        NestedImputationList (1)        

---------------------------------------------------------------------
Versions 1.1  -- 2015-02-23  --  CRAN miceadds 1.1-1
---------------------------------------------------------------------

NOTE  * extended 'datalist2mids' function to handle a single dataset
ADDED * included plausible value imputation via a provided
        individual likelihood 
NOTE  * included row.names argument and missing value argumant
        in 'save.data'
        
DATA  * included/modified datasets: ---
EXAMP * included/modified examples: mice.impute.2l.plausible.values (2)

---------------------------------------------------------------------
Versions 1.0  -- 2014-11-07  --  CRAN miceadds 1.0
---------------------------------------------------------------------

NOTE  * fixed a minor bug in write.pspp when a variable only
        contains values of zero
NOTE  * allow specification of a part of the file name in 'load.data';
        the most recent file is loaded

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: ---

---------------------------------------------------------------------
Versions 0.14 -- 2014-07-30  --  CRAN miceadds 0.14-9
---------------------------------------------------------------------

ADDED * included Type 3 sum of squares in ANOVA in 'mi.anova'
        (thanks to Florian Buchwald)
ADDED * included a function 'load.Rdata2' which prevents from 
        the definition of the output in the global environment
        as in 'load.Rdata'       
ADDED * included utility function 'load.data' and 'save.data'
        for loading and saving data files from and to several formats

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: mi.anova (1), load.Rdata,
        load.data, save.data

---------------------------------------------------------------------
Versions 0.13 -- 2014-06-27  --  CRAN miceadds 0.13-7
---------------------------------------------------------------------

ADDED * included several R utility functions

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: ---

---------------------------------------------------------------------
Versions 0.12 -- 2014-05-08  --  CRAN miceadds 0.12-9
---------------------------------------------------------------------

FIXED * included bug fixes for 'mice.impute.2lonly.pmm' (mice version
        2.21) as 'mice.impute.2lonly.pmm2' in miceadds 
        -> the same for 'mice.impute.2lonly.norm'

DATA  * included/modified datasets: ---
EXAMP * included/modified examples: ---

---------------------------------------------------------------------
Versions 0.11 -- 2014-02-19  --  CRAN miceadds 0.11-121
              [**** FIRST CRAN RELEASE ****]
---------------------------------------------------------------------

FIXED * fixed a bug in tw.mcmc.imputation for rows with only missings
ADDED * included function write.pspp for writing SPSS files using PSPP
ADDED * included predict method for kernelpls.fit2 function
NOTE  * export and extended fast.groupmean function to include weights
NOTE  * export mice.impute.2l.pls and mice.impute.2l.pls2
FIXED * fixed a bug in the creation of interactions in 
        mice.impute.2l.pls (thanks to Takuya Yanagida)
NOTE  * included calculation of weighted covariance matrix with missing
        entries in datasets
ADDED * included mice.impute.pmm3, mice.impute.pmm4, mice.impute.pmm5 and
        mice.impute.pmm6
NOTE  * included scale2 as a faster substitute for the scale function in R
ADDED * included mice.1chain as an alternative to the mice function
        which multiply imputes data from a long chain
ADDED * included imputation function 'mice.impute.2l.eap' for imputation
        from a known (normal) posterior distribution
ADDED * included function mids2datlist for conversion of a mids object
        into a list of datasets 
NOTE  * included datasets: all datasets contained in the package
NOTE  * included examples: for all functions



---------------------------------------------------------------------
#### older miceadds versions (formerly micetrun)

Versions 0.10 -- 2013-08-18
Versions 0.8  -- 2012-10-18
Versions 0.7  -- 2012-06-18
Versions 0.6  -- 2011-11-29
Versions 0.5  -- 2011-06-02
Versions 0.4  -- 2008-05-31
Versions 0.3  -- 2008-04-07
Versions 0.2  -- 2008-03-27
Versions 0.1  -- 2007-10-21