pm_arrayChange Module Reference

This module contains procedures and generic interfaces for selecting uniformly-distributed random choices from a given character or integer range.
More...

Data Types
interface	getChange
	Generate and return a randomly-uniform selected sequence of elements from a scalar character or integer range specified via the input limits [start, stop]. More...
interface	setChange
	Return a randomly-uniform uniquely-selected sequence of elements from a scalar character or integer range specified via the input limits [start, stop]. More...

Variables
character(*, SK), parameter	MODULE_NAME = "@pm_arrayChange"

Detailed Description

This module contains procedures and generic interfaces for selecting uniformly-distributed random choices from a given character or integer range.

The functionality of the procedures of this module are identical to those of pm_arrayShuffle, except that

1. the procedure within this module compute a shuffling of a (subset of a) range specified by lower and upper limits.
   
2. the procedure within this module additionally can compute a random sequence from a range with replacement (non-unique).
   

Remarks

The word change in naming of this generic interface and its output stands for CHoice in rANGE.

Note

The case of length of the output sequence of unique elements being equal to the length of the specified range [start, stop] is equivalent to a random shuffling of all values within the specified range.

See also

pm_arrayRemap
pm_arrayChange
pm_arrayChoice
pm_arrayShuffle
pm_distUnif

Test:

test_pm_arrayChange

Final Remarks ⛓

---

If you believe this algorithm or its documentation can be improved, we appreciate your contribution and help to edit this page's documentation and source file on GitHub.
For details on the naming abbreviations, see this page.
For details on the naming conventions, see this page.
This software is distributed under the MIT license with additional terms outlined below.

1. If you use any parts or concepts from this library to any extent, please acknowledge the usage by citing the relevant publications of the ParaMonte library.
   
2. If you regenerate any parts/ideas from this library in a programming environment other than those currently supported by this ParaMonte library (i.e., other than C, C++, Fortran, MATLAB, Python, R), please also ask the end users to cite this original ParaMonte library.
   

This software is available to the public under a highly permissive license.
Help us justify its continued development and maintenance by acknowledging its benefit to society, distributing it, and contributing to it.

Copyright

Computational Data Science Lab

Author:

Amir Shahmoradi, Monday March 6, 2017, 3:22 pm, Institute for Computational Engineering and Sciences (ICES), The University of Texas at Austin.

Variable Documentation

MODULE_NAME

character(*,SK), parameter pm_arrayChange::MODULE_NAME = "@pm_arrayChange"

Definition at line 59 of file pm_arrayChange.F90.