How to select a random...

Select a random agent from a population

AnyLogic provides functions to select a random agent from a given population. These functions are defined in the class Utilities and are global (accessible from each place of model code). You call any function from the list below by typing just its name, without a prefix with the population name: randomWhere( people, p -> p.income > 10000 );

Agent randomWhere( population, condition ) - Returns one randomly selected agent within the given population satisfying the specified condition. If the population is empty, or no agents satisfy the specified condition(s), the function returns null.

Examples: Person wealthyPerson = randomWhere( people, p -> p.income > 10000 );

Person wealthyMan = randomWhere( people, p -> p.income > 10000 && p.sex == MALE );

Here we check two conditions (we use logical AND operator && to tell AnyLogic that both the first AND the second condition should be true). The function returns a randomly selected agent that satisifes both conditions.

Person wealthyYoungMan = randomWhere( people, p -> p.income > 10000 && p.sex == MALE && p.age < 21 );

There is another function, enabling the user to use a custom random number generator instead of the default one:

Agent randomWhere( population, condition, java.util.Random r ) - Similar to randomWhere( population, condition ). Uses the specified custom random number generator to choose the element.

Select a random element from a collection

AnyLogic provides functions to select a random element from a given collection. These functions are defined in the class Utilities and are global (accessible from each place of model code). You call any function from the list below by typing just its name, without a prefix with the collection name: randomWhere( people, p -> p.income > 10000 );

randomWhere( collection, condition ) - Returns one randomly selected element within the given collection satisfying the specified condition. If the collection is empty, or none elements satisfy the specified condition(s), the function returns null.

Examples: Person wealthyPerson = randomWhere( people, p -> p.income > 10000 );

Person wealthyMan = randomWhere( people, p -> p.income > 10000 && p.sex == MALE );

Here we check two conditions (we use logical AND operator && to tell AnyLogic that both the first AND the second condition should be true). The function returns a randomly selected element that satisfies both conditions.

Person wealthyYoungMan = randomWhere( people, p -> p.income > 10000 && p.sex == MALE && p.age < 21 );

There is another function, enabling the user to use a custom random number generator instead of the default one:

randomWhere( collection, condition, java.util.Random r ) - Similar to randomWhere( population, condition ). Uses the specified random number generator to choose the element.

Select a random element from an array

AnyLogic provides functions to select a random element from a given array. These functions are defined in the class Utilities and are global (accessible from each place of model code). You call any function from the list below by typing just its name, without a prefix with the array name: randomWhere( people, p -> p.income > 10000 );

T randomFrom( T[] array ) - Returns a randomly chosen element of the given array (or null if the array is empty). This result of this method is an equivalent of calling: array[ uniform_discr( array.length - 1 ) ]

T randomFrom( T[] array, java.util.Random r ) - Similar to randomFrom( T[] array ). Uses the specified custom random number generator to choose the element.

T randomWhere( T[] array, condition ) - Returns a randomly chosen element within the given array satisfying the specified condition. If the array is empty or no elements satisfy the specified condition(s), the function returns null.

T randomWhere( T[] array, condition, java.util.Random r ) - Similar to randomWhere( T[] array, condition ). Uses the specified custom random number generator to choose the element.

Select a random option from an option list

For example, you have the option list named Gender. To randomly select one option from this option list, use one of the following functions:

Create a random object from a given list of objects

AnyLogic provides functions to create a randomly chosen object from a given list of objects. These functions are defined in the Utilities class and are global (accessible from each place of model code). You call any function from the list below by typing just its name, without a prefix with the collection name.