def runSideBySide(self, params, seed=None, learnMode=None, convertEveryIteration=False):
        """
    Run the PY and CPP implementations side by side on random inputs.
    If seed is None a random seed will be chosen based on time, otherwise
    the fixed seed will be used.

    If learnMode is None learning will be randomly turned on and off.
    If it is False or True then set it accordingly.

    If convertEveryIteration is True, the CPP will be copied from the PY
    instance on every iteration just before each compute.
    """
        randomState = getNumpyRandomGenerator(seed)
        cppSp = CreateSP("cpp", params)
        pySp = CreateSP("py", params)
        self.compare(pySp, cppSp)
        numColumns = pySp.getNumColumns()
        numInputs = pySp.getNumInputs()
        threshold = 0.8
        inputMatrix = (randomState.rand(numRecords, numInputs) > threshold).astype(uintType)

        # Run side by side for numRecords iterations
        for i in xrange(numRecords):
            if learnMode is None:
                learn = randomState.rand() > 0.5
            else:
                learn = learnMode
            if self.verbosity > 1:
                print "Iteration:", i, "learn=", learn
            PyActiveArray = numpy.zeros(numColumns).astype(uintType)
            CppActiveArray = numpy.zeros(numColumns).astype(uintType)
            inputVector = inputMatrix[i, :]

            pySp.compute(inputVector, learn, PyActiveArray)
            cppSp.compute(inputVector, learn, CppActiveArray)
            self.assertListEqual(list(PyActiveArray), list(CppActiveArray))
            self.compare(pySp, cppSp)

            # The boost factors were similar enough to get this far.
            # Now make them completely equal so that small variations don't cause
            # columns to have slightly higher boosted overlaps.
            cppBoostFactors = numpy.zeros(numColumns, dtype=realType)
            cppSp.getBoostFactors(cppBoostFactors)
            pySp.setBoostFactors(cppBoostFactors)

            # The permanence values for the two implementations drift ever so slowly
            # over time due to numerical precision issues. This occasionally causes
            # different permanences to be connected. By transferring the permanence
            # values every so often, we can avoid this drift but still check that
            # the logic is applied equally for both implementations.
            if convertEveryIteration or ((i + 1) % 10 == 0):
                convertPermanences(pySp, cppSp)
    def runSideBySide(self, params, seed=None, learnMode=None, convertEveryIteration=False, numRecords=None):
        """
    Run the PY and CPP implementations side by side on random inputs.
    If seed is None a random seed will be chosen based on time, otherwise
    the fixed seed will be used.
    
    If learnMode is None learning will be randomly turned on and off.
    If it is False or True then set it accordingly.
    
    If convertEveryIteration is True, the CPP will be copied from the PY
    instance on every iteration just before each compute.
    
    If numRecords is None, use the default global value NUM_RECORDS
    """
        if numRecords is None:
            numRecords = NUM_RECORDS
        randomState = getNumpyRandomGenerator(seed)
        pySp = self.createSp("py", params)
        numColumns = pySp.getNumColumns()
        numInputs = pySp.getNumInputs()
        cppSp = self.createSp("cpp", params)
        self.compare(pySp, cppSp)
        threshold = 0.8
        # Create numRecords records, each numInputs long, where each input
        # is an unsigned 32 bit integer of either 0 or 1
        inputMatrix = (randomState.rand(numRecords, numInputs) > threshold).astype(uintType)
        for i, inputVector in enumerate(inputMatrix):
            if learnMode is None:
                learn = randomState.rand() > 0.5
            else:
                learn = learnMode
            if self.verbosity > 1:
                print "\nIteration:", i, "learn=", learn
            PyActiveArray = numpy.zeros(numColumns).astype(uintType)
            CppActiveArray = numpy.zeros(numColumns).astype(uintType)
            pySp.compute(inputVector, learn, PyActiveArray)
            cppSp.compute(inputVector, learn, CppActiveArray)
            self.compare(pySp, cppSp)
            self.assertListEqual(list(PyActiveArray), list(CppActiveArray))

            # The permanence values for the two implementations drift ever so slowly
            # over time due to numerical precision issues. This occasionally causes
            # different permanences to be connected. By transferring the permanence
            # values every so often, we can avoid this drift but still check that
            # the logic is applied equally for both implementations.
            if convertEveryIteration or ((i + 1) % 10 == 0):
                convertPermanences(pySp, cppSp)