/* ****************************************************************************** * * * This program and the accompanying materials are made available under the * terms of the Apache License, Version 2.0 which is available at * https://www.apache.org/licenses/LICENSE-2.0. * * See the NOTICE file distributed with this work for additional * information regarding copyright ownership. * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * * SPDX-License-Identifier: Apache-2.0 ******************************************************************************/ // // @author Yurii Shyrma (iuriish@yahoo.com), created on 20.04.2018 // implementation is based on following article: // "MergeShuffle: A Very Fast, Parallel Random Permutation Algorithm", https://arxiv.org/abs/1508.03167 #include #include #include #include #include #if NOT_EXCLUDED(OP_random_shuffle) namespace sd { namespace ops { namespace helpers { ////////////////////////////////////////////////////////////////////////// // Fisher-Yates shuffle template static void fisherYates(sd::graph::RandomGenerator& rng, T* buff, const sd::LongType& len, const sd::LongType& ews, sd::LongType ind) { for (sd::LongType i = len - 1; i > 0; --i) { const sd::LongType j = rng.relativeLong(ind++) % (i + 1); if (i != j) math::sd_swap(buff[i * ews], buff[j * ews]); } } ////////////////////////////////////////////////////////////////////////// // mutual shuffle of two adjacent already shuffled ranges with length len1 and (totLen - len1) correspondingly template static void mergeShuffle(sd::graph::RandomGenerator& rng, T* buff, const sd::LongType& len1, const sd::LongType& totLen, const sd::LongType& ews, sd::LongType ind) { sd::LongType beg = 0; // beginning sd::LongType mid = len1; // middle while (true) { if (rng.relativeLong(ind++) % 2) { if (mid == totLen) break; math::sd_swap(buff[ews * beg], buff[ews * mid++]); } else { if (beg == mid) break; } ++beg; } // fisherYates while (beg < totLen) { const sd::LongType j = rng.relativeLong(ind++) % (beg + 1); if (beg != j) math::sd_swap(buff[ews * beg], buff[ews * j]); ++beg; } } ////////////////////////////////////////////////////////////////////////// template static void randomShuffle_(NDArray& input, NDArray& output, sd::graph::RandomGenerator& rng, const bool isInplace) { const int firstDim = input.sizeAt(0); sd::LongType temp; if (input.lengthOf() == 1 || firstDim == 1) { if (!isInplace) output.assign(&input); } else if (shape::isCommonVector(input.shapeInfo(), temp)) { NDArray* arr = &input; if (!isInplace) { output.assign(&input); arr = &output; } const sd::LongType ews = arr->ews(); const sd::LongType len = arr->lengthOf(); const sd::LongType threshold = 1 << 22; // this number was deduced from diagram in article int power = 0; while ((len >> power) > threshold) ++power; const sd::LongType numChunks = 1 << power; auto funcFisherYates = PRAGMA_THREADS_FOR { for (auto i = start; i < stop; ++i) { sd::LongType offset = (len * i) >> power; sd::LongType currLen = ((len * (i + 1)) >> power) - offset; fisherYates(rng, arr->bufferAsT() + offset * ews, currLen, ews, offset); } }; auto funcMerge = PRAGMA_THREADS_FOR { for (int64_t i = start, k = 1; i < stop; i += increment, ++k) { sd::LongType offset = len * i >> power; sd::LongType len1 = (len * (i + increment / 2) >> power) - offset; sd::LongType totLen = (len * (i + increment) >> power) - offset; mergeShuffle(rng, arr->bufferAsT() + offset * ews, len1, totLen, ews, len * k + offset); } }; samediff::Threads::parallel_for(funcFisherYates, 0, numChunks); for (int j = 1; j < numChunks; j += j) samediff::Threads::parallel_for(funcMerge, 0, numChunks, 2 * j); rng.rewindH((len + 1) * power); } else { std::vector zeroDim = {0}; auto dimsToExclude = ShapeUtils::evalDimsToExclude(input.rankOf(), 1,zeroDim.data()); if (isInplace) { auto subArrsList = input.allTensorsAlongDimension(*dimsToExclude); // Fisher-Yates shuffle for (int i = firstDim - 1; i > 0; --i) { const int j = rng.relativeInt(i) % (i + 1); if (i != j) subArrsList.at(i)->swapUnsafe(*subArrsList.at(j)); } } else { auto subArrsListIn = input.allTensorsAlongDimension(*dimsToExclude); auto subArrsListOut = output.allTensorsAlongDimension(*dimsToExclude); delete dimsToExclude; std::vector indices(firstDim); std::iota(indices.begin(), indices.end(), 0); // 0,1,2,3, ... firstDim-1 // shuffle indices fisherYates(rng, indices.data(), firstDim, 1, 0); auto func = PRAGMA_THREADS_FOR { for (auto i = start; i < stop; ++i) subArrsListOut.at(i)->assign(subArrsListIn.at(indices[i])); }; samediff::Threads::parallel_for(func, 0, firstDim); } rng.rewindH(firstDim - 1); } } void randomShuffle(sd::LaunchContext* context, NDArray& input, NDArray& output, sd::graph::RandomGenerator& rng, const bool isInplace) { BUILD_SINGLE_SELECTOR(input.dataType(), randomShuffle_, (input, output, rng, isInplace), SD_COMMON_TYPES); } } // namespace helpers } // namespace ops } // namespace sd #endif