AVhdZddlZddlmZddlmZddlmZddlmZddlmZddlm Z dd lm Z dd lm Z dd l m Z e d d GddejZdZdZdZdZdZdZy)z0Utilities for random ops to share common usages.N) constant_op)dtypes)tensor) array_ops)array_ops_stack) bitwise_ops)gen_stateless_random_ops_v2)math_ops) tf_exportzrandom.Algorithmzrandom.experimental.AlgorithmceZdZdZdZdZdZy) AlgorithmaA random-number-generation (RNG) algorithm. Many random-number generators (e.g. the `alg` argument of `tf.random.Generator` and `tf.random.stateless_uniform`) in TF allow you to choose the algorithm used to generate the (pseudo-)random numbers. You can set the algorithm to be one of the options below. * `PHILOX`: The Philox algorithm introduced in the paper ["Parallel Random Numbers: As Easy as 1, 2, 3"](https://www.thesalmons.org/john/random123/papers/random123sc11.pdf). * `THREEFRY`: The ThreeFry algorithm introduced in the paper ["Parallel Random Numbers: As Easy as 1, 2, 3"](https://www.thesalmons.org/john/random123/papers/random123sc11.pdf). * `AUTO_SELECT`: Allow TF to automatically select the algorithm depending on the accelerator device. Note that with this option, running the same TF program on different devices may result in different random numbers. Also note that TF may select an algorithm that is different from `PHILOX` and `THREEFRY`. N)__name__ __module__ __qualname____doc__PHILOXTHREEFRY AUTO_SELECTU/home/dcms/DCMS/lib/python3.12/site-packages/tensorflow/python/ops/random_ops_util.pyr r s* & (+rr cJt|tr|St|tr |jSt|tj r|St|t r|jjjddjdd}|dk(rtjjS|dk(rtjjS|dk(rtjjStt|td|dt!|d ) aConverts algorithm to an integer. Args: alg: can be one of these types: integer, Algorithm, Tensor, string. Allowed strings are "philox" and "threefry". Returns: An integer, unless the input is a Tensor in which case a Tensor is returned. -_philoxthreefry autoselectz'Can't convert argument `alg` (of value z and type z ) to int.) isinstanceintr valuerTensorstrstriplowerreplacerrr ValueErrorunsupported_alg_error_msg TypeErrortype)alg canon_algs rconvert_alg_to_intr0:sS JY 99V]]# JS !!#++C4<\s& I ! ! ' ''.OO LC g i$$$(.LC g i  &&&   8==v}}=> Cooqc6==1G g .s3 44rcx|tjj}t|}t ||\}}|||fS)aCalculates the key, counter and algorithm to pass to raw RNG ops. This function calculates the key and counter, and determines the algorithm that will be passed to the raw RNG ops like `StatelessRandomUniformV2`. Depending on the input `alg`, the key and counter may be scrambled or copied from `seed`. If `alg` is `"auto_select"`, the key and counter will be determined at runtime based on device type. Args: seed: An integer tensor of shape [2]. The seed to calculate the key and counter from. alg: The RNG algorithm. See `tf.random.stateless_uniform` for an explanation. Returns: A pair (key, counter, algorithm) suitable for V2 stateless RNG ops like `StatelessRandomUniformV2`. )r rr$r0r>r:s rget_key_counter_algr@sA& [    % %C3#!$,,#w gs rc .tjtj|dtj tj tj|dtj tjdtj S)Nrr ) r bitwise_orr r6rr9 left_shiftrconstant)xs rr5r5sc   mmAaD&--( --!fmm ,   r6== 1 rc lt|trOtjj}tj j}tj j}nGt|trd}d}d}n0tj}tj }tj }d|d|d|d|d S) z1Produces the unsupported-algorithm error message.rr auto_selectz%Argument `alg` got unsupported value z. Supported values are z for the Philox algorithm, z! for the ThreeFry algorithm, and z for auto-selection.)r"r#r rr$rrr&)r.rr rHs rr+r+sS    # #F!!''H''--K#s FHK   F!!H''K-cU2I +  3  )+rctjdgtj}t j |tj}t jdg||tjtjj}tjt|dddg}tj dt|ddgd}||fS) aDetermines the key and counter for Philox PRNG with the given seed. Args: seed: An integer tensor of shape [2]. The seed to calculate the key and counter from. Returns: A pair (key, counter) suitable for V2 stateless RNG ops like `StatelessRandomUniformV2`. l w}x0)r<r=dtyper.Nrrr)axis)rrErr9r r6r $stateless_random_uniform_full_int_v2r7r rr$rr4r5rstack)r;r<r=mixs rr3r3s 016==A# MM$ .'#HHc  MM     # ,S!W5s;#  ! !1&8QR&A"B K' gr)renumtensorflow.python.frameworkrrrtensorflow.python.opsrrrr r tensorflow.python.util.tf_exportr Enumr r0r>r@r5r+r3rrrrUsq7 3..+1-=*6 >? @6D F4,r