Package: aroma.core
===================

Version: 2.3.2 [2011-11-14]
o BUG FIX: process() of ChromosomeExplorer would throw "Error in
  file(file, ifelse(append, "a", "w")) : [...] cannot open file '/
  [...] (new Array(': No such file or directory".  Importing
  the R.rsp namespace in the aroma.core namespace solved this.
  Thanks Qian Liu for reporting on this.


Version: 2.3.1 [2011-11-11]
o Added extractPSCNArray() for AromaUnitTotalCnBinary{File|Set}.


Version: 2.3.0 [2011-10-28]
o Added a namespace to the package, which will be more or less
  a requirement starting with R v2.14.0.


Version: 2.2.2 [2011-09-29]
o Added alpha version of the AromaRepository class.


Version: 2.2.1 [2011-09-24]
o readHeader(), readRawFooter() and writeRawFooter() of 
  AromaTabularBinaryFile would try to read non-signed 4-byte integers,
  which is not supported and would instead be read as signed integers.
  From R v2.13.1 this would generated warnings.


Version: 2.2.0 [2011-09-01]
o Submitted to CRAN.
o The package passes all redundancy tests.


Version: 2.1.5 [2011-08-30]
o BUG FIX: After introducing a sanity check in aroma.core v2.1.2
  (2011-05-11), getSnpPositions() of AromaCellSequenceFile would throw
  "Error: length(pos) == ncol(cells) is not TRUE".  However, it was not
  until aroma.core v2.1.3 (2011-08-01) was release that some people got
  problem with this.  It turns out that the sanity check catches an
  error in how getSnpPositions() of AromaCellSequenceFile allocates
  the result vector, a bug that has been there for a very long time.
  Luckily, this bug has had no effect on the results for anyone.
  Thanks to David Goode (Stanford) and Irina Ostrovnaya (MSKCC) for
  reporting on this.


Version: 2.1.4 [2011-08-02]
o The aroma.core v2.1.3 tar ball uploaded to CRAN mistakenly
  contained a NAMESPACE file, which shouldn't have been there.


Version: 2.1.3 [2011-07-27]
o WORKAROUND: In order for the package to work with the most recent
  version of R devel, which automatically add namespaces to packages
  who do not have one, we explicitly have specify that this package
  should use cat() and getOption() of R.utils (instead of 'base').


Version: 2.1.2 [2011-07-24]
o Bumped up the package dependencies, especially since R will
  soon (in practice) require namespaces for all packages.


Version: 2.1.1 [2011-05-10]
o ROBUSTNESS: Added more sanity checks and more verbose output
  to getSnpNucleotides() for AromaCellSequenceFile.


Version: 2.1.0 [2011-04-08]
o No updates.  Submitted to CRAN.


Version: 2.0.8 [2011-04-03]
o CLEANUP: Utilizing hpaste() internally wherever applicable. 


Version: 2.0.7 [2011-03-28]
o BUG FIX: allocateFromUnitAnnotationDataFile() for 
  AromaUnitTabularBinaryFile would include chip type tags in the
  path, e.g. annotationData/chipTypes/GenomeWidesSNP_6,Full.


Version: 2.0.6 [2011-03-14]
o Now ChromosomeExplorer does a better job of listing
  chromosomes that are specific to the genome/organism used.
o Added getChromosomeLabels() for ChromosomeExplorer.


Version: 2.0.5 [2011-03-04]
o BUG FIX: lapplyInChunks(idxs) for numeric did not correctly handle
  the case when length(idxs) == 0, because of a typo.


Version: 2.0.4 [2011-03-03]
o Added static loadAll() for SampleAnnotationSet.
o Updated the default filename patterns used by findByGenome() for
  AromaGenomeTextFile to "^%s,chromosomes(|,.*)*[.]txt$".
o Now getGenomeFile() for ChromosomalModel utilizes byGenome() for
  AromaGenomeTextFile to locate the genome annotation file.
o GENERALIZATION: Now findByGenome() for AromaGenomeTextFile follows 
  the new aroma search conventions.
o GENERALIZATION: In addition to search <rootPath>/<set>/<name> paths,
  findAnnotationData() can also search <rootPath>/<set>/ by not 
  specifying argument 'name' (or setting it to NULL).  Also, if it
  cannot locate any files, it falls back to annotation data available
  in any of the aroma.* packages.
o ROBUSTNESS: Added a return contract/sanity check asserting that
  getUnitsOnChromosomes() for AromaUnitChromosomeTabularBinaryFile
  truly returns valid 'unit' indices.  Thanks to Emilie Sohier, 
  France for reporting on a problem related to this.


Version: 2.0.3 [2011-03-02]
o GENERALIZATION: Now the default for createImage() for matrix is to 
  test to create images according to aroma settings option
  'output/ImageClasses'.
o GENERALIZATION: getAverageFile() for AromaUnitTotalCnBinarySet first
  searches for an existing result file according to the new search
  conventions.  If not found, then it's created.
o STANDARDIZATION: Now the default output path for all 
  allocateFromUnitAnnotationDataFile() is
  annotationData/chipTypes/<chipType>/.  Before it was the same
  directory as the original annotation data file, which may for
  instance have been in a deeper subdirectory, or recently also
  in a sibling root path.
o ROBUSTNESS: Now getAverageFile() for AromaUnitTotalCnBinarySet creates
  the result file atomically by writing to a temporary file which is
  renamed afterward.
o Now write() and read() for RasterImage throws an informative error
  message explaining that the 'png' package is needed.
o BUG FIX: colorize() for Image would throw '<simpleError in ...: could
  not find function "colorMode">', because the colorMode() function
  needs to be explicitly imported after the recent package cleanups.
o BUG FIX: colorize() for Image tried to call createImage() using a
  vector instead of a matrix.
o BUG FIX: createImage() for matrix would not return the first possible
  image created (when testing different image classes) but instead
  continue trying to create image for all possible classes. 
  For instance, this meant that although you had the 'EBImage' package
  installed, but not the 'png' package, it would still in the end try
  to (also) use 'png' package.  If writing PNG images to file, say via
  ArrayExplorer, this would result in "Error in loadNamespace(name) : 
  there is no package called 'png'".  Thanks Richard Beyer at
  University of Washington for reporting on this.


Version: 2.0.2 [2011-02-19]
o GENERALIZATION: Extended the default root paths of findAnnotationData()
  to be annotationData/ and annotationData,<tags>/


Version: 2.0.1 [2011-02-19]
o CLEANUP: Moved static getTags() to Arguments to R.filesets v0.9.3.
o CLEANUP: Deprecated static method importFromTable() for FileMatrix.
o CLEANUP: Removed several deprecated methods.


Version: 2.0.0 [2011-02-16]
o No updates.  Submitted to CRAN.


Version: 1.9.4 [2011-02-07]
o CLARIFICATION: Now the exception thrown by getRawCopyNumbers() for
  CopyNumberSegmentationModel, when there are too many non-finite 
  signals, gives a more informative error message containing 
  information also on which sample, reference and chromosome the
  problem was detected on.
o BUG FIX: Now fit() for CopyNumberSegmentationModel passes 
  down argument 'maxNAFraction' to the internal sanity test
  as it used to do before aroma.core v1.3.4 (November 2009).


Version: 1.9.3 [2011-02-01]
o GENERALIZATION: Now spatial PNG image files can also be created
  utilizing the 'png' package as an alternative to the 'EBImage' 
  package.  The EBImage package can be tricky to install on 
  some OSes, e.g. Windows 7 64-bit.
o Added alpha version of an internal RasterImage class.
o Added an internal writeImage() for Image objects as defined by
  the EBImage package.  This made it possible to remove the remaining
  explicit dependencies on EBImage in the aroma.affymetrix package.
o ROBUSTNESS: Removed some remaining partial argument calls.
o CLEAN UP: Removed deprecated internal rgbTransform() for Image.
o CLEAN UP: Deprecated internal as.TrueColorImage() for the Image
  class and for matrices.


Version: 1.9.2 [2011-01-30]
o SPEED UP: The memoization/caching mechanisms should now be faster
  on Windows, because digest() uses the faster serialize() of
  R v2.12.0.  The earlier version was orders of magnitude slower
  on Windows, which we have been patching in the aroma framework
  since v0.9.3.4.  That patch wrote to file, which was slower than
  the recent fix.  This Windows-only patch is no longer needed,
  and hence neither applied, on R v2.12.0 and beyond.


Version: 1.9.1 [2011-01-14]
o Added argument 'flavor' to segmentByGLAD() for RawGenomicSignals,
  which makes it possible to specify whether daglad() or glad() of
  the GLAD package will be used.  The 'flavor' argument can also
  be passed as for instance GladModel(..., flavor="daglad").


Version: 1.9.0 [2011-01-10]
o No updates.  Submitted to CRAN.


Version: 1.8.3 [2010-12-27]
o Added genome annotation file Mouse,chromosomes.txt to
  system.file("annotationData/genomes/Mouse", package="aroma.core").


Version: 1.8.2 [2010-12-07]
o ROBUSTNESS: Whenever the GLAD package is tried to be loaded and it 
  fails due to failure of loading a shared library, then this will be
  remembered for 24 hours while it will not be loaded again.
o Added requireWithMemory().


Version: 1.8.1 [2010-12-02]
o BUG FIX: plot() for CopyNumberSegmentationModel would throw exception
  "Cannot infer number of bases in chromosome. No such chromosome: 25"
  for chromosome 25.
o BUG FIX: drawCytoband2() would throw an error if argument 'cytoband'
  was an empty data frame, which could happen if there is no cytoband
  annotation data for the requested chromosome.  Now it returns quietly.


Version: 1.8.0 [2010-11-07]
o Committed to CRAN.
o CLEANUP: Dropped non-used Javascript toolkit code that was intended
  to be used for a future version of ChromosomeExplorer.


Version: 1.7.6 [2010-11-06]
o ROBUSTNESS: Now subsample() for BinnedScatter utilizes resample().
o CLEANUP: Removed stext().  It is in R.utils.
o CLEANUP: Removed some outdated patches for R v2.7.0 and before.
o CLEANUP: Package no longer need to "suggest" geneplotter.


Version: 1.7.5 [2010-10-25]
o Now fit() for CopyNumberSegmentationModel also passed the optional
  arguments ('...') passed to the constructor function.  This makes it
  possible to specify all arguments while initiating the model, e.g.
  sm <- CbsModel(..., min.width=5, alpha=0.05).
o Now optional arguments '...' to CopyNumberChromosomalModel are recorded.


Version: 1.7.4 [2010-10-13]
o ROBUSTNESS/BUG FIX: The internal drawCytoband2() used to annotate 
  chromosomal plots with cytobands tries to utilize GLAD package,
  if available.  However, even when GLAD is installed it may still be
  broken due to missing dynamic libraries, e.g. 'Error in 
  library.dynam(lib, package, package.lib) : DLL 'GLAD' not found: maybe
  not installed for this architecture?'.  We now avoid this too.


Version: 1.7.3 [2010-09-12]
o Added drawDensity() for CopyNumberRegions and RawGenomicSignals.
o Added getDensity() for CopyNumberRegions which returns the 
  empirical density of the mean levels weighted by the region lengths.
o Added getLength() for CopyNumberRegions, which returns a vector
  of region lengths.
o Now the ylim defaults to c(0,5) for plot() for RawCopyNumbers.
o Added basic support for operators +, - and * to RawGenomicSignals.


Version: 1.7.2 [2010-08-22]
o Added the AromaGenomeTextFile class.
o Added genome annotation file Canine,chromosomes,UGP,HB20100822.txt to
  system.file("annotationData/genomes/Canine", package="aroma.core").
o BUG FIX: annotationData/genomes/Human/Human,chromosomes.txt had
  an extra TAB on the ChrM row.


Version: 1.7.1 [2010-08-06]
o Added abstract classes SegmentationDataFile and SegmentationDataSet
  to represent segmentation data results.  Current subclasses are
  CbsSegmentationData(File|Set).
o Added more utility methods for CopyNumberRegions.


Version: 1.7.0 [2010-07-26]
o Committed to CRAN. No updates.


Version: 1.6.8 [2010-07-24]
o Added several methods for CopyNumberRegions, e.g. xRange(), prune(), 
  simulateRawCopyNumbers(), "+"(), "-"() and "*"().


Version: 1.6.7 [2010-07-20]
o Added writeDataFrame() for AromaUnitTotalCnBinarySet and
  AromaUnitFracBCnBinarySet to get the correct filename extension.
  Thanks Nicolas Vergne at the Curie Institute for reporting this.


Version: 1.6.6 [2010-07-19]
o Added subset() for CopyNumberRegions.
o Now extractRegion() for RawGenomicSignals also accepts a
  CopyNumberRegions object for argument 'regions'.
o Added extractRegions() for RawGenomicSignals.


Version: 1.6.5 [2010-07-08]
o BUG FIX: writeDateFrame() for AromaUnitSignalBinarySet would 
  write the same data chunk over and over.


Version: 1.6.4 [2010-07-06]
o BUG FIX: indexOf() for ChromosomalModel would return NA if a search
  pattern contained parenthesis '(' and ')'.  There was a similar issue
  in indexOf() for GenericDataFileSet/List in R.filesets, which was
  solved in R.filesets 0.8.3.  Now indexOf() for ChromosomalModel 
  utilizes ditto for GenericDataFileSet for its solution.


Version: 1.6.3 [2010-06-22]
o BUG FIX: as.GrayscaleImage(..., transforms=NULL) for 'matrix' would
  throw "Exception: Argument 'transforms' contains a non-function: NULL".


Version: 1.6.2 [2010-06-02]
o BUG FIX: updateDataColumn() of AromaTabularBinaryFile would 
  censor *signed integers* incorrectly; it should censor at/to
  [-(n+1),n], but did it at [-n,(n+1)] ("two's complement").
  This caused it to write too large values as n+1, which then
  would be read as -(n+1), e.g. writing 130 would be censored
  to 128 (should be 127), which then would be read as -128.
  Added more detailed information on how many values were censored.
  Thanks Robert Ivanek for report on this.


Version: 1.6.1 [2010-05-27]
o Added trial version of fullname translator files.
o doCBS() for character:s support data set tuples.
o Added doCBS() for CopyNumberDataSetTuple:s.


Version: 1.6.0 [2010-05-14]
o Package submitted to CRAN.
o Package pass R CMD check on R v2.11.0 and v2.12.0 devel.


Version: 1.5.8 [2010-05-13]
o Now argument 'path' of all writeDataFrame() methods defaults 
  to <rootPath>,txt/<dataSet>/<chipType>/.


Version: 1.5.7 [2010-04-27]
o Added writeDataFrame() for AromaUnitTabularBinaryFile.
o Added argument 'columnNamesPrefix' to all writeDataFrame().
o AD HOC: Now getUnitAnnotationDataFile() of AromaPlatformInterface 
  load aroma.affymetrix if needed and if installed.


Version: 1.5.6 [2010-04-22]
o Added writeDataFrame() for AromaUnitSignalBinary{File|Set}.


Version: 1.5.5 [2010-04-12]
o BUG FIX: getFitFunction() of CbsModel would return a function that
  would give "Error in segmentByCBS.RawGenomicSignals(..., seed = seed):
  formal argument "seed" matched by multiple actual arguments".


Version: 1.5.4 [2010-04-06]
o Added equals() for CopyNumberRegions.
o Added argument 'seed' to CbsModel, which will, if specified, set
  the random seed (temporarily) each time (per sample and chromosome)
  before calling the segmentation method.


Version: 1.5.3 [2010-04-05]
o Added argument 'seed' to segmentByCBS() for RawGenomicSignals.


Version: 1.5.2 [2010-03-29]
o ROBUSTNESS: Increased the requirements of support packages.


Version: 1.5.1 [2010-03-02]
o Now segmentByMPCBS() can be used to segment data from a single source.
o CHANGE: Argument 'arrays' of doCBS() for CopyNumberDataSet no longer
  subset the input data set, but instead is passed to the fit() function
  of the segmentation model.  This way all arrays in the input data set 
  are still used for calculating the pooled reference.
o ROBUSTNESS: Added more sanity checks to segmentByMPCBS() for
  RawGenomicSignals.
o BUG FIX: Forgot argument 'verbose' of getOutputSet() of ChromosomalModel.


Version: 1.5.0 [2010-02-22]
o Submitted to CRAN.  No changes since v1.4.7.
o Package passes R CMD check on R v2.10.1 patch and R v2.11.0 devel.
o Package passes all redundancy tests.


Version: 1.4.7 [2010-02-21]
o Added the AromaCellCpgFile class.
o Added Rd help for AromaCellPositionFile class.


Version: 1.4.6 [2010-02-19]
o SIMPLIFICATION: Now it is possible to use ChromosomeExplorer without
  having to install the GLAD package (used before for cytobands).
o SIMPLIFICATION: Now it is possible to plot cytobands without having
  to install the GLAD package.
o Argument 'zooms' of ChromosomeExplorer now default to 2^(0:6), 
  instead of 2^(0:7), because the images for zoom 2^7=128 would not 
  display in Firefox for the largest chromosomes.
o Updated getGenomeFile() for ChromosomalModel such that it can be used
  to locate other types of genome annotation files as well, files that
  may be optional (without giving an error).
o Added Human cytoband files to annotationData/genomes/.
o Added annotationData/genomes/ to aroma.core (from aroma.affymetrix).
o Added getOutputSet() for ChromosomalModel.
o Added alpha version of a doCBS().


Version: 1.4.5 [2010-02-10]
o ROBUSTNESS: Now also patches for R.filesets and R.utils are loaded, 
  if available, when aroma.core is loaded.
o CLEANUP: Removed debug print() statements in isCompatibleWith().


Version: 1.4.4 [2010-02-03]
o ROBUSTNESS: Package now requires matrixStats v0.1.9 or newer,
  due to a bug in the earlier versions that would affect smoothing
  of chromosomal signals that contains missing values.
o Package passes R CMD check and all redundancy tests.


Version: 1.4.3 [2010-01-25]
o ROBUSTNESS: Added a sanity check getChromosomes() for class
  AromaUnitChromosomeTabularBinaryFile validating that the file 
  has a 'chromosome' column.
o CLEANUP: Using new Arguments$getTags() where ever possible.


Version: 1.4.2 [2010-01-13]
o ChromosomalModel:s (and and the ChromosomeExplorer) no
  longer require unit names files. 
o getListOfAromaUgpFiles() for ChromosomalModel no longer goes via 
  getListOfUnitNamesFiles().  This opens up the possibility to work 
  with data files without unit names files, e.g. smoothed CN data.
o Added getAromaUgpFile() for AromaPlatformInterface.
o Now getUnitNamesFile() for AromaPlatformInterface utilizes the 
  generic getUnitAnnotationDataFile() method.


Version: 1.4.1 [2010-01-06]
o Added argument 'defaults' to allocate() of AromaTabularBinaryFile.


Version: 1.4.0 [2010-01-04]
o Added trial version of segmentByMPCBS() via the 'mpcbs' package.
o BUG FIX: Added getDefaultFullName() for AromaMicroarrayDataSet and 
  AromaTabularBinarySet in order to override (parent=1) the new default 
  of GenericDataFileSet in R.filesets v0.7.0, which would return the
  chip type (parent=0) as the name.
o Package passes R CMD check on R v2.10.1 and R v2.11.0 devel and
  all of its redundancy tests.


Version: 1.3.8 [2010-01-02]
o Added getPairedNames() to CopyNumberChromosomalModel which returns
  combined '<test>vs<ref>' names, e.g. 'TumorvsNormal'.  The default
  behavior is that if <ref> is the average of a pool, then the
  paired name is '<test>', e.g. 'Tumor'.
o CLEAN UP: Moved all GenericSummary code to R.utils.


Version: 1.3.7 [2010-01-01]
o Added argument 'pattern' to byName() for AromaUnitTotalCnBinarySet
  and AromaUnitFracBCnBinarySet.
o getSets() of AromaMicroarrayDataSetTuple overrides the default method
  by adding the chip types as the names of the returns list.
o CLEAN UP: Removed getSetTuple() from ChromosomeExplorer.
o ROBUSTNESS: Using new Arguments$getInstanceOf() were possible.
o ROBUSTNESS: Now CopyNumberChromosomalModel() asserts that none of the
  test samples have duplicated names.
o ROBUSTNESS: Now all index arguments are validated correctly 
  using the new 'max' argument of Arguments$getIndices().  Before
  the case where "max == 0" was not handled correctly. 
o BUG FIX: translateFullNames() of ChromosomeExplorer would translate the
  full names, but return the original ones.
o BUG FIX: getFullNames() of ChromosomeExplorer reported: Error in 
  UseMethod("translateFullNames") : no applicable method for 
  'translateFullNames' applied to an object of class "character".


Version: 1.3.6 [2009-12-08]
o BUG FIX: extractMatrix() of AromaUnitCallFile did not recognize NoCalls.


Version: 1.3.5 [2009-12-02]
o BUG FIX: extractRawCopyNumbers() for RawCopyNumbers would give 
  an error if the internal logBase was NULL.


Version: 1.3.4 [2009-11-24]
o Moved ChromosomeExplorer to aroma.core from aroma.affymetrix.
o Moved several method for 'profileCGH' objects to aroma.core
  from aroma.affymetrix.
o Added extractRawCopyNumbers(, ...logBase=2) to RawCopyNumbers, 
  which can be used to change the logarithmic base of CN ratios, 
  if any.
o Added getAverageFile() for AromaUnitTotalCnBinarySet.
o Now all chromosome plot functions have xScale=1e-6 by default.


Version: 1.3.3 [2009-11-19]
o ALPHA: First successful run of segmentation with CbsModel 
  with AromaUnitTotalCnBinarySet data sets.
o Added isAverageFile() for AromaUnitSignalBinaryFile.
o Added class AromaUnitTotalCnBinarySetTuple.
o GENERALIZATION: Moved CbsModel, GladModel and HaarSegModel
  (all segmentation models) of aroma.affymetrix to here.
o GENERALIZATION: Moved all (generalized) ChromosomalModel, 
  CopyNumberChromosomalModel, and CopyNumberSegmentationModel
  from aroma.affymetrix to here.
o Added interfaces CopyNumberDataFile, CopyNumberDataSet,
  and CopyNumberDataSetTuple (internal for now).


Version: 1.3.2 [2009-11-12]
o Now AromaUflFile$allocateFromUnitNamesFile() works.
o Added getAromaUflFile() to UnitAnnotationDataFile.
o Moved AromaUflFile to aroma.core (from aroma.affymetrix).
o BUG FIX: importFrom(ufl, dat, ...) where 'ufl' was an
  AromaUflFile and 'dat' a GenericTabularFile gave an
  error reporting that importFromGenericTabularFile() 
  is abstract/not defined for AromaUflFile:s.  
  Thanks Paolo Guarnieri for reporting this.


Version: 1.3.1 [2009-11-03]
o Replaced Rd cross references to sfit and HaarSeg packages with
  plain text in order to meet the CRAN requirements that all
  Rd links must exist on the CRAN servers.


Version: 1.3.0 [2009-11-01]
o New public release. 
o More recent dependencies on Bioconductor packages.
o Package passes R CMD check on R v2.10.0 and all redundancy tests.


Version: 1.2.3 [2009-10-25]
o Added getExtensionPattern() to most GenericDataFile classes.


Version: 1.2.2 [2009-10-16]
o Added setName() for RawGenomicSignals.
o Stricter dependencies.


Version: 1.2.1 [2009-10-02]
o CLEAN UP: Updated to use byPath() instead fromFiles().
o CLEAN UP: Move the Interface class to the R.oo package.


Version: 1.2.0 [2009-09-09]
o New public release. 
o Fixed broken/missing Rd links.
o Package passes R CMD check on R v2.9.2 and all redundancy tests.


Version: 1.1.7 [2009-09-07]
o Now getUnitsOnChromosomes() for AromaUnitChromosomeTabularBinaryFile
  returns a vector by default (unlist=TRUE).


Version: 1.1.6 [2009-09-07]
o Added yRange(), yMin() and yMax() for RawGenomicSignals.
o Added extractRawCopyNumbers() for RawSequenceReads.
o BUG FIX/WORKAROUND: smoothScatter(), which is used in for 
  instance aroma.affymetrix, is in the graphics package from 
  R v2.9.0.  It was previously in geneplotter v1.2.4 and before(!).
  The code imported it from geneplotter would therefore give an 
  error of a missing function with geneplotter v1.2.5.  We
  are now assuming R v2.9.0 by default, but if not available,
  but geneplotter v1.2.4 or earlier is, geneplotter is loaded.
  If neither are available, a dummy smoothScatter() is setup
  reporting an error.


Version: 1.1.5 [2009-08-29]
o Added totalAndFracBData/ to the search path of byName() for
  AromaUnit(FracB|Total)CnBinarySet.


Version: 1.1.4 [2009-07-22]
o Added allocateFromUnitAnnotationDataFile() for
  AromaUnitSignalBinaryFile and AromaUnitTabularBinaryFile.
o Added getUnitTypesFile() for AromaPlatform and AromaPlatformInterface.
o Added UnitAnnotationDataFile, which now the UnitNamesFile and the new
  UnitTypesFile inherits from.
o Now uses() for Interface takes multiple Interface:s.


Version: 1.1.3 [2009-07-03]
o Added class RawSequenceReads.
o Added support for argument 'byCount' to binnedSmoothingByState() of 
  SegmentedCopyNumbers.  It is rather complex how it works, but we tried
  to immitate how it works with byCount=FALSE.
o Now binnedSmoothing() of RawGenomicSignals demark locus fields 
  that were not binned to be regular fields.  Ideally all locus fields
  (including custom ones) should be binned, but we leave that for a 
  future implementation.
o Added get-, setStateColorMap(), and getStateColors() for class
  SegmentedGenomicSignalsInterface.


Version: 1.1.2 [2009-06-14]
o Added argument keepUnits=FALSE to extractRawGenomicSignals() of
  AromaUnitSignalBinaryFile.
o Now RawGenomicSignals(y=rgs) sets all locus fields in 'rgs' if it is
  a RawGenomicSignals object.
o BUG FIX: exportTotalCnRatioSet() would return a AromaUnitFracBCnBinarySet.
o Updated examples() that requires "suggested" packages to be ran 
  conditionally, so that it does not throw an error (in R CMD check)
  if the packages is not available.  This is required for a package
  to be put on CRAN.


Version: 1.1.1 [2009-06-10]
o ADDED: Added support for "birdseed" encoding in extractGenotypes() 
  and updateGenotypes() of AromaUnitGenotypeCallFile.
o SPEED UP: updateGenotypes() of AromaUnitGenotypeCallFile is now much
  faster in counting A:s and B:s.
o Added SegmentedGenomicSignalsInterface, which implements all the 
  methods for SegmentedCopyNumbers and the new SegmentedAlleleBFractions.
o Added getFields() to Interface as an ad hoc solutions to avoid
  print(<Interface>) throwing 'Error in UseMethod("getFields") : no 
  applicable method for "getFields"'.
o GRAMMAR FIX: is(Homo|Hetero)zygous(), not is(Homo|Hetero)zygote().
o BUG FIX: isHomozygote() of AromaUnitGenotypeCallFile was not correct.
o BUG FIX: getOutputDataSet() of AromaTransform failed to identify the
  output files if (and only if) a filename translator was applied to
  the input data set.


Version: 1.1.0 [2009-05-29]
o New public release. No updates.
o Package passes R CMD check on R v2.9.0 and all redundancy tests.


Version: 1.0.8 [2009-05-25]
o GENERALIZATION: The AromaTransforms class was generalized further
  to handle cases where the number of output files does not map
  one to one to the input files.


Version: 1.0.7 [2009-05-18]
o Added extractRawAlleleBFractions() for AromaUnitFracBCnBinaryFile.
o Added exportFracBDiffSet() for AromaUnitFracBCnBinarySet.
o Moved the Explorer class and its support files under inst/ from
  aroma.affymetrix to aroma.core.
o Moved the AromaCellPositionFile class from aroma.affymetrix 
  to aroma.core.
o ADDED: Now all segmentByNnn() for RawGenomicSignals also returns
  so called 'aromaEstimates', which are additional parameter 
  estimates, e.g. robust estimates of the standard deviation of
  all full-resolution CNs as well as per identified region.
o CLEAN UP: Moved all file set specific classes and methods to
  the new R.filesets package.
o MEMORY OPTIMIZATION: Where ever possible/applicable, we now use
  Arguments$getNumerics(), which, in R utils v1.1.5 and new, corces
  to doubles only if the input is not already doubles.  This will 
  lower the memory usage in some cases since an integers use 4 bytes
  and doubles 8 bytes.  This also save disk space if object is saved
  to disk, e.g. a DNAcopy fit object with integer genomic positions 
  instead of double ones, save approx 5-7% disk space.
o ROBUSTNESS: Now allocate() for AromaTabularBinaryFile first allocates
  a temporary file which is then renamed.  This makes the file allocation
  more atomic, and therefore less error prone to interrupts etc.
o ROBUSTNESS: Now indexOf() for UnitNamesFile assert that exactly one
  of the 'pattern' and 'names' arguments is given.  It also gives an 
  informative error message if 'pattern' is a vector.
o ROBUSTNESS: Now all arguments that are expected to be exactly one
  character string (not an empty vector or a vector of length two)
  are asserted to be that too.  This closes some potential bugs.
o EXCEPTION HANDLING: All methods that modifies an existing file, are 
  now asserting that the file permissions allow modifying it, and if not
  gives a clear error message that this is the case.
o BUG FIX: allocateFromUnitNamesFile() for AromaUnitSignalBinaryFile
  would not call generic allocate() but the one for this class.
o BUG FIX: extractMergedRawCopyNumbers(..., unshift=TRUE) would estimate
  the relative shifts between platforms using smoothed CNs over the
  genomic region defined by the first data set.  Now it is done over the
  region defined by the union of all data sets.  The impact of this
  bug should be neglectable or zero.


Version: 1.0.6 [2009-05-14]
o Now binnedSmoothing() of RawGenomicSignals uses weighted estimates
  (by default) if weights exists.
o Added RawAlleleBFractions() extending RawGenomicSignals.
o Added extractCopyNumberRegions() for profileCGH, DNAcopy, and 
  HaarSeg segmentation object. Before they were in aroma.affymetrix.
o Added segmentByCBS(), segmentByGLAD(), and segmentByHarSeeg() 
  to RawGenomicSignals, which all support weights if the underlying
  segmentation method does.  To date, it is only CBS and HaarSeg
  that supports weights.  These methods also support memoization.
o Added extractRegion() to RawGenomicSignals.
o Added getWeights() and hasWeights() to RawGenomicSignals.
o Added {add,subtract,multiply,divide}By() for RawGenomicSignals all
  utilizing support method applyBinaryOperator().
o ALPHA: Added classes GenericDataFile{Set}List.
o ALPHA: Added class AromaUnitTotalCnBinaryFileList with methods 
  extractRawCopyNumbers() and extractMergedRawCopyNumbers().
o SPEED UP: Now TextUnitNamesFile caches all unit names in memory.
o BUG FIX: Now aroma.core works with the IRanges and grid packages,
  regardless on the order they were loaded.
o BUG FIX: getPlatform() of TextUnitNamesFile would sometimes return
  a list of length one, instead of an single character string.
o BUG FIX: extractSubset() of RawGenomicSignals did not recognize all
  locus fields.


Version: 1.0.5 [2009-05-10]
o Now getOutputDataSet() of AromaTransform returns a data set with files
  ordered such that the fullnames are ordered the same way as the input
  data set.  Suggested by Xin (Victoria) Wang at UC Berkeley.
o Now getOutputDataSet() of AromaTransform scans for the output data 
  files with fullnames matching those of the input data set.  This is
  one step closer to being able to batch process subsets of data sets
  when the method is, say, a single-array method.
o Now static fromFiles() of GenericDataFileSet supports empty data sets.
o Now readDataFrame() of AromaUgpFile and AromaUnitTabularBinaryFile
  accepts rows=integer(0).
o Added abstract class AromaUnitChromosomeTabularBinaryFile to make it
  easier to setup up new annotation file formats based on chromosomes.
  AromaUgpFile is now inheriting from this class.
  getUnitsOnChromosomes() now returns a list stratified by chromosome.
o Added extractByChromosomes() for AromaUgpFile.
o Added argument 'translate' to getColumnNames() of TabularTextFile.
o UPDATE: Replace argument 'robust' of colBinnedSmoothing()
  with a more generic 'FUN' argument.  The default arguments
  give identical results.
o BUG FIX: Our internal interleave() for Image (defined by EBImage) gave
  'Error in z[idxOdd,, ] : incorrect number of dimensions'. This was
  because internal image structure of the Image class changed (back) to
  being a 2-dim array. Now interleave() handles both 2d and 3d arrays.
o BUG FIX: lines() of RawGenomicSignals did not recognize x/yScale.
o BUG FIX: as.character() of GenericDataFile would throw 
  'Error in sprintf("%d", getFileSize(db, "numeric")) : use 
  format %f, %e, %g or %a for numeric objects' whenever the
  file size is returned as a double, which happens for very
  large files (> 2^31-1 bytes).
o BUG FIX: as.character() of GenericDataFileSet would throw an error if
  the data set was empty, because then there was no path.
o Package passes R CMD check on R v2.9.0.


Version: 1.0.4 [2009-04-07]
o BUG FIX: getUnitNames(..., units=NULL) of TextUnitNamesFile would 
  make the object believe there are zero units in the file. 
  Thanks Shermane Teo at the National University of Singapore 
  for reporting this.
o BUG FIX: binnedSmoothing(..., byCount=TRUE) of RawGenomicSignals 
  would give error "[...] object "ys" not found".
o BUG FIX: When passing a single data points to colBinnedSmoothing(),
  it would throw the exception: "Range of argument 'by' is out 
  of range [0,0]: [<by>,<by>]".


Version: 1.0.3 [2009-03-23]
o Added the TextUnitNamesFile class.


Version: 1.0.2 [2009-02-26]
o Added argument 'units' to extractRawCopyNumbers() of
  AromaUnitSignalBinaryFile.
o Added RawGenomicSignals which RawCopyNumbers now inherits from.
o Added readDataFrame(..., units=NULL) to AromaUnitSignalBinaryFile.
o Added optional argument/field 'name' to RawCopyNumbers, which
  is also used by SegmentedCopyNumbers when querying the "truth"
  function(s) for the copy-number state.  This makes it possible
  to use one (conditional) truth functions for all samples.
o Added hasBeenModified() to GenericDataFile.
o Now hasTags(..., tags) of GenericData{File|Set} splits the
  'tags' argument.
o Now RawCopyNumbers() takes RawCopyNumbers objects as input.
o Now getChecksum() of GenericDataFile caches results unless the 
  file has been modified since last time.
o Now as.character() of GenericDataFile also reports the exact file 
  size in case the file size is reported in kB, MB, etc.  It also 
  tries to report the relative pathname rather than the absolute.



Version: 1.0.1 [2009-02-12]
o Now byName() of AromaUnit(FracB|Total)CnBinarySet searches 
  rawCnData/ then cnData/.
o Added SegmentedCopyNumbers class.
o Added various smoothing methods to RawCopyNumbers.
o Added colBinnedSmoothing() and colKernelSmoothing().
o Added getAromaUgpFile() to UnitNamesFile.
o Added shakyText().
o Added static byChipType() to UnitNamesFile.
o Added argument 'fullname' to getChipType() of AromaUnitSignalBinaryFile.
o Now argument 'files' in extract() of GenericDataFileSet can 
  also be a vector of string.
o ROBUSTNESS: Added support for optional validation/selection by the
  number of units/cells to all static byChipType() methods.  This is
  done by specifying argument nbrOfUnits/nbrOfCells.  This is intend
  for internal use only.
o ROBUSTNESS: Added a sanity check to getAromaUgpFile() of
  UnitNamesFile and AromaUnitSignalBinaryFile, which asserts that 
  the number of units in the located UGP file match that the number
  of units in the data file.
o ROBUSTNESS: Now findAnnotationData() always returns pathnames 
  ordered by the length of their fullnames. Before this was only 
  done if 'firstOnly=TRUE'.
o ALPHA: Added support for "smart" (e.g. "*") subdirectories in static 
  findByName() of GenericDataFileSet.


Version: 1.0.0 [2009-01-12]
o Added getMaxLengthRepeats() to AromaCellSequenceFile.
o Added AromaUnitSignalBinary{File|Set}, AromaUnitTotalCnBinary{File|Set},
  AromaUnitFracBCnFinary{File|Set}, AromaUnitCall{File|Set}, and
  AromaUnitGenotypeCall{File|Set}.
o BUG FIX: readFooter() of AromaTabularBinaryFile did not return the
  correct list for nested structures.
o BUG FIX: groupBySnpNucleotides() of AromaCellSequenceFile would return
  an empty element 'missing' for some chip types, e.g. Mapping10K_Xba142.
  Now that empty elements are dropped.
o BUG FIX: getAttributes() for GenericDataFile:s would give an error
  if there were no attributes.


Version: 0.9.6 [2008-12-04]
o SPEED UP: Now predict() of ProbePositionEffects is 6-7 times faster.
o SPEED UP: Now the result of isMissing() for AromaCellSequenceFile 
  can be cached.
o ALPHA: Added the BinnedScatter class with methods.
o CLEAN UP: readDataFrame() of AromaTabularBinaryFile would forget to
  close the connection if verbose output was activated.  When R later
  would close such connections, a warning would be generated.


Version: 0.9.5 [2008-10-17]
o Package passes R CMD check on R v2.7.2 and R v2.8.0rc.


Version: 0.9.4.5 [2008-10-16]
o BUG FIX: Tried to turn a function passed to as.GrayscaleImage()
  in argument 'transforms' to a list using as.list() and not list().


Version: 0.9.4.4 [2008-09-18]
o Added argument 'skip' to writeChecksum() of GenericDataFile.


Version: 0.9.4.3 [2008-09-03]
o Added getSnpPositions(), getSnpShifts(), getSnpNucleotides() and
  groupBySnpNucleotides() to AromaCellSequenceFile.


Version: 0.9.4.2 [2008-08-31]
o Update fitGenotypeCone() to support both flavors 'sfit' (old)
  and 'expectile' (new).


Version: 0.9.4.1 [2008-08-12]
o Added support for argument 'positions' to countBases() for
  AromaCellSequenceFile.
o ALPHA: Added fitMultiDimensionalCone().
o BUG FIX: readSequences() for AromaCellSequenceFile translated
  raw values to incorrect nucleotides.
o TESTING: Added redundancy tests to aroma.core.


Version: 0.9.4 [2008-08-02]
o Public release.  Package passes R CMD check on R v2.7.1
  and R v2.8.0 devel on WinXP.


Version: 0.9.3.4 [2008-07-24]
o SPEED UP: Added patch for base::serialize() on Windows, 
  which in turn will speed up digest::digest() and all
  methods that use the latter to generate hashcodes.
o SPEED UP: Now as.character() for GenericTabularFile:s
  and TabularTextFile:s reports the number of data rows
  and the number of text lines as NA if the files are too
  large and cached results are not already available.
o SPEED UP: Replaced all which() with faster whichVector().
o Added getCreatedOn(), getLastModifiedOn(), and
  getLastAccessedOn() to GenericDataFile.  These a just
  wrapper accessing file.info() fields.


Version: 0.9.3.3 [2008-07-21]
o Now countBases() of AromaCellSequenceFile returns "raw" 
  counts if argument 'mode="raw"'.
o Now updateDataColumn() coerce values to doubles before 
  censoring them for raw and integer columns.
o Now findByName() assert that the data set name is not empty.
o ALPHA: Added setFullName() and setName() to GenericDataFile
  and GenericDataFileSet. The plan is to have these replace
  what getAlias() and setAlias() do today.
o BETA: Added setFullNameTranslator() to GenericDataFileSet.


Version: 0.9.3.2 [2008-07-16]
o BETA: Added setFullNamesTranslator() (for the files) 
  to AromaGenericFileSet.
o ALPHA: Added protected update2() to GenericDataFileSet.
o ALPHA: Added private ProbePositionEffects et al.


Version: 0.9.3.1 [2008-07-12]
o SPEED UP: Now all AromaTabularBinaryFile:s, such as AromaUgpFile,
  read data much faster after two modifications to readDataFrame():
  (i) rownames are no longer generate, if not asked for explicitly,
  and (ii) garbage collection is no longer done after each column.
o Added a general importFrom() for AromaTabularBinaryFile, which
  calls matching importFrom<ClassName>(), if found.
o Added support for 'raw' data columns in AromaTabularBinaryFile.
o BETA: Added readTableHeader().
o BETA: Added AromaCellSequenceFile.
o BETA: Added classes AromaMicroarrayTabularBinaryFile and 
  AromaCellTabularBinaryFile.


Version: 0.9.3 [2008-06-08]
o Package passes R CMD check on R v2.7.0 patched.


Version: 0.9.2.6 [2008-06-07]
o Update filename pattern for getOutputFiles() of AromaTransform.


Version: 0.9.2.5 [2008-05-25]
o Added AromaTransform (extracted from aroma.affymetrix::Transform).
o Added nbrOfArrays() to AromaMicroarrayDataSet.
o Now private xmlToList() handles more complex XML strings.


Version: 0.9.2.4 [2008-05-22]
o Added member 'chromosome' to RawCopyNumbers.
o Added gaussianSmoothing() to RawCopyNumbers.
o Added argument 'xOut' to gaussianSmoothing() in order to specify
  at what loci the smoothed signals should be calculated.


Version: 0.9.2.3 [2008-05-21]
o Now findPngDevice() search for a working PNG device in the following
  order: png(..., type="cairo"), png(..., type="cairo1"), 
  Cairo::CairoPNG(), R.utils::png2(), and finally plain png().
o Added gzip()/gunzip() to GenericDataFile.
o Added static findByName() and byName() to GenericDataFileSet.
o Added static getFileClass() to GenericDataFileSet.  This makes it
  possible to remove most fromFiles() from subclasses but also
  the validation of argument 'files' of their constructors.
o Added validate() to GenericDataFileSet, which is called at the
  end of fromFiles(..., .validate=TRUE).
o Added extractMatrix to GenericTabular(File|Set) and 
  AromaTabularBinary(File|Set).
o Added equals() and hasFile() to GenericDataFileSet.
o Added classes GenericTabularFileSet and AromaTabularBinarySet.
o Added stextChipType() for strings.
o CLEAN UP: Moved more classes and methods from aroma.affymetrix to 
  aroma.core: RawCopyNumbers, CopyNumberRegions, CopyNumberOutliers.
  Moved attribute methods from AffymetrixCel{File|Set} to 
  AromaMicroarrayDataSet.  Moved stextNnn() methods from AffymetrixFile
  to AffymetrixMicroarrayDataSet.
  Created superclass AromaMicroarrayDataSetTuple of AffymetrixCelSetTuple.
o BUG FIX: readDataFrame() did not read the first data row if there 
  was no column header; it was eaten up by a preceeding readHeader().
o BUG FIX: findAnnotationDataByChipType(chipType="GenomeWideSNP_6", 
  pattern="^GenomeWideSNP_6.*[.]ugp$") would find file 
  'GenomeWideSNP_6,Full,na24.ugp' before 'GenomeWideSNP_6,na24.ugp'.
  Now we return the one with the shortest full name.
o ALPHA: Now equals() for GenericDataFile:s uses the class, 
  pathname, file size and file-contents checksum to do the 
  comparison.  Similarly, for GenericDataFileSet:s, the class, 
  path, number of files, pathnames, and finally equals() for 
  each file pair is used for the comparison.  
o ALPHA: Added full name translation for GenericDataFile:s.
o ALPHA: Added UnitNamesFile.
o Package passes R CMD check on R v2.7.0 patched.


Version: 0.9.2 [2008-05-10]
o Took all core classes and core methods in aroma.affymetrix that
  are independent of the Affymetrix platform and placed the here.
o The version is numbered starting from the current version of
  aroma.affymetrix.
o BUG FIX: interleave() for Image gave 'Error in z[idxOdd, ] : 
  incorrect number of dimensions'.  The internal image structure
  is a 3-dim array.
o BUG FIX: When searching with 'firstOnly=FALSE', findAnnotationData() 
  was identifying files that are in "private" directory.  This is how
  affxparser::findFiles() works.  Such files are now filtered out.
o Created.
