Functions to merge together two tables or maps.

mergeMaps(
  maps,
  method = "table",
  number_of_dimensions,
  number_of_optimizations,
  minimum_column_basis = "none",
  optimizer_options = list(),
  merge_options = list()
)

Arguments

maps

List of acmaps to merge

method

The merge method to use, see details.

number_of_dimensions

For merging that generates new optimization runs, the number of dimensions.

number_of_optimizations

For merging that generates new optimization runs, the number of optimization runs to do.

minimum_column_basis

For merging that generates new optimization runs, the minimum column basis to use.

optimizer_options

For merging that generates new optimization runs, optimizer settings (see RacOptimizer.options()).

merge_options

Options to use when merging titers (see RacMerge.options()).

Value

Returns the merged map object

Details

Maps can be merged in a number of ways depending upon the desired result.

Method 'table'

As you would expect, this merges the tables of the two maps but does not attempt to create any new optimizations and any existing optimizations are lost.

Method 'reoptimized-merge'

This merges the tables and then does a specified number of fresh optimizations from random starting coordinates, ignoring any pre-existing optimization runs. It's exactly the same as doing a 'table' merge and running optimizeMap() on the merged table.

Method 'incremental-merge'

This takes the currently selected optimization in the first map and then merges in the additional maps in turn. Each time any points not already found in the first map (or the last map in the incremental merge chain) are randomised and everything is relaxed, this is repeated the specified number of times and the process is repeated.

Method 'frozen-overlay'

This fixes the positions of points in each map and tries to best match them simply through re-orientation. Once the best re-orientation is found, points that are in common between the maps are moved to the average position.

Method 'relaxed-overlay'

This is the same as the frozen-overlay but points in the resulting map are then allowed to relax.

Method 'frozen-merge'

In this version, positions of all points in the first map are fixed and remain fixed, so the original map does not change. The second map is then realigned to the first as closely as possible and then all the new points appearing in the second map are allowed to relax into their new positions. This is a way to merge in new antigens and sera into a map without affecting the first one at all (and was first implemented in lisp).

See also

Other map merging functions: RacMerge.options(), htmlMergeReport(), mergeReport()