RandomState

class numpy::RandomState

Random number generation class.

Example

#include <numpy/np_ndarray.h>
using namespace numpy;

// Create random generator
Generator gen(12345);  // seed

// Generate random values
auto uniform = gen.random({3, 3});
auto normal = gen.standard_normal({10});
auto integers = gen.integers(0, 100, {5});

Constructors

Signature	Location	Example
RandomState(uint64_tseed)	NP_RANDOM.H:37	View

Indexing / Selection

Signature	Return Type	Location	Example
std::mt19937_64 & get_generator()	std::mt19937_64 &	NP_RANDOM.H:46	View

Random

Signature	Return Type	Location	Example
void seed(uint64_tseed)	void	NP_RANDOM.H:40	View

Other Methods

Signature	Return Type	Location	Example
void set_state(const std::vector<uint64_t>&state)	void	NP_RANDOM.H:57	View

Code Examples

The following examples are extracted from the test suite.

RandomState (np_test_1_all.cpp:25186)

      }

      std::cout << " -> tests passed" << std::endl;
    }

    // ============================================================================
    // RANDOMSTATE TESTS (LEGACY)
    // ============================================================================

    void np_test_bitgen_randomstate() {
      std::cout << "========= RandomState (legacy) =======================";

      numpy::random::RandomState rs(99999);

      // Test state management
      auto state = rs.get_state();
      if (state.empty()) {
        std::cout << "  [FAIL] : in np_test_bitgen_randomstate() : state empty";
        throw std::runtime_error("np_test_bitgen_randomstate failed");
      }

get_generator (np_test_1_all.cpp:25201)

      auto state = rs.get_state();
      if (state.empty()) {
        std::cout << "  [FAIL] : in np_test_bitgen_randomstate() : state empty";
        throw std::runtime_error("np_test_bitgen_randomstate failed");
      }

      // Test set_state
      rs.set_state(state);

      // Test that we can use the generator
      auto& gen = rs.get_generator();
      uint64_t val = gen();

      if (val == 0 && gen() == 0 && gen() == 0) {
        std::cout << "  [FAIL] : in np_test_bitgen_randomstate() : generator seems broken";
        throw std::runtime_error("np_test_bitgen_randomstate failed");
      }

      // Test seed
      rs.seed(12345);
      auto state2 = rs.get_state();

seed (np_test_1_all.cpp:14339)

    }
    // std::cout << "[OK] Generator integers method\n";

    std::cout << " -> tests passed\n";
  }

  void test_vsl_reproducibility() {
    std::cout << "========= test_vsl_reproducibility ====";

    // Test seed reproducibility
    seed(42);
    auto arr1 = normal<double>(0.0, 1.0, { {10} });

    seed(42);
    auto arr2 = normal<double>(0.0, 1.0, { {10} });



    for (size_t i = 0; i < 10; ++i) {
      double val1 = arr1.getElementAt({ i });
      double val2 = arr2.getElementAt({ i });

set_state (np_test_1_all.cpp:22363)

    }
    // std::cout << "[OK] Random bytes\n";

    // Test state functions
    std::string state = get_state();
    if (!(!state.empty())) {
        std::string description = std::string("testRandomUtilityFunctions():") + __FILE__ + ":" + std::to_string(__LINE__) + ": !(!state.empty())";
        std::cout << std::string("[FAIL] ") + description << std::endl;
        throw std::runtime_error(description);
    }
    set_state(12345);
    // std::cout << "[OK] State functions\n";

    std::cout << " -> tests passed\n";
  }

  void testGeneratorAPI() {
    std::cout << "========= testGeneratorAPI ====";

    // Test modern Generator API
    auto gen = create_generator(42);