PERF: Revert Remove large foot print of PDF derivatives.

This reverts commit 4c98ab6355ef578a4bfc66879e88d5467bbcc698.
The previous attempt to address speed issues resulted in
a serious performance penalty for BSpline registration types
due to the size of the derivatives generated.

Lessons learned from investigating this path are are
incorporated into the next set of patches.

Change-Id: I91f5a0efc2025efd37c9861567a2ced46dc13bc8
STYLE: Test against almost equal for floating point values

Comparing floating point values for absolute equals is
nearly always a bad practice.  This patch adds the smallest
of tolerances to ensure that miniscule accumulation differences
due to multi-threading do not cause in-consequential test
failures.

Change-Id: I7636fa5c6d6e8f07ecfa2b1b7a72a525f5ff9af7
STYLE: Non-exact floating point testing

Floating point numbers should not be required to be absolutely the same value
when the accumulations orders can not be strictly enforced.  Use the
itk::Math::FloatAlmostEqual() function to test when floating point
values are nearly identical.

Change-Id: I7ebaff0e8fcdf58d344c7ac8b3c7fcc883c6edee
ENH: Improve precision of the joint PDF sum

In Mattes MI v4 metric, use a compenstated summation
to improve the overall precision of the estimates.

Change-Id: I5a9d5ec3138e423698dabb259fbcc0a898a0ce89
PERF: Distribute initialization per thread buffers

The process of zero'ing out and creating new buffers
across 32 threads is quite time consuming.  By
distributing the load across each of the threads, this can
occur in parallel, thus providing a huge speed increase.

This solution scales to many cores better than alternative
solutions attempted.

Change-Id: If1d15b6ed2045f75fa205dee21bdc3fb2714870a
ENH: Remove unnecessary mutable qualifier.

Change-Id: I56b9692508881708aefdc01472ace20f109e2cab
STYLE: Remove comment with no meaning.

These comments in the implementation file added no value to the code.

Change-Id: Ia3db4822c1ba7370330d20a7c1b324065d0ed2ae
ENH: Moved accumlator logic to main MI class

Do accumualtions with independant accumulator so
that they can be done as each thread completes.

Replace accumulations on the zero buffer with
independant buffer accumulations.

The algorithmic components that are not part of the
ThreadedGetValueAndDerivative are pushed back into
the main Mattes class rather than occuring in the single threaded
AfterThreadedGenerate portion of the computations.

Co-authored-by: Matt McCormick <matt.mccormick@kitware.com>
Co-authored-by: Bradley Lowekamp <blowekamp@mail.nih.gov>

Change-Id: Id6c4dd07fbd1ef4b0eec4320ab16e2285cc42102
BUG: Fix BinShrinkImageFilter for different input/output image types.

The input iterator needs to be defined over the correct type.

Change-Id: I4a47762b4cfdfbea56b144ed576064122c65eb18
ENH: Allow staggering of accumulations per thread.

This patch uses mutex locking so that only the accumulations
for approximages 1/NumThreadss of the accumulator buffer
block for each thread.  As each thread is accumulating onto
the common buffer, the the other portions of the
accumulator remain free for writing by other threads.

Co-authored-by: Matt McCormick <matt.mccormick@kitware.com>

Change-Id: I493c97a3fd816c1fd58c0229023927674e59ceb5
PERF: Zero reset thread buffers during finalize

This patch set moves the zero'ing of thread buffers to occur
at the same time as the accumulation process, thus allowing
for more cache coherence of memory manipulations and
overall improved CPU utilization.

Change-Id: I5464321e0e1181852b69827180d241e85be5addc
Merge topic 'PartialRevertMattesPDFSize_release'

135e9baa PERF: Zero reset thread buffers during finalize
1c6257ed ENH: Allow staggering of accumulations per thread.
7a1474df ENH: Moved accumlator logic to main MI class
804955a6 STYLE: Remove comment with no meaning.
c8718683 ENH: Remove unnecessary mutable qualifier.
0c227638 PERF: Distribute initialization per thread buffers
63b18f62 ENH: Improve precision of the joint PDF sum
94cd9c44 STYLE: Non-exact floating point testing
38c1af06 STYLE: Test against almost equal for floating point values
84c2567b PERF: Revert Remove large foot print of PDF derivatives.
COMP: Fix transform type for ITKv3/IterativeClosestPoint2.

Change-Id: Ibdb86dd73c334c6c57ce70ec7f366eb3f08350f6
Merge branch 'release'

Change-Id: I2f4518a9c63debb4e687d7e6d73dc00d15a9fd27
COMP: missing cast when calling gdcm::DataElement::SetByteValue

Second arguments need to be cast into uint32_t in order to be implicity
converted to gdcm::VL

Change-Id: I0c08d3f94eea88be7fbd2a5fbd633a0688197de6
COMP: Add missing wrapping for TransformIOBaseTemplate.

Change-Id: Iabeaec9ed5f80a9b801d4d9a0303d2fb862b34b3
Merge branch 'release'

Change-Id: Iaf3c1b260845f904ab5edf2b16faad5fd2d9723b
DOC: Improve ImageRegistration4 grammar.

Change-Id: I63dbe80808746b35f72d3148c9d2001cb32ea41d
Merge topic 'registration-doc'

4f25f261 DOC: Improve ImageRegistration4 grammar.
ENH: increase LaplacianDeformation code coverage

Add tests for both area computation type (NONE and MIXEDAREA)

Change-Id: I123904c5d724d273daea69d9a178cad717a08b5e