from __future__ import annotations
import numpy as np
from .arrays import ImgArray
from .array_api import xp
from .core import asarray
def wraps(npfunc):
def _wraps(ipfunc):
ipfunc.__doc__ = npfunc.__doc__
return ipfunc
return _wraps
def __getattr__(name: str):
xpfunc = getattr(xp.random, name)
@wraps(xpfunc)
def _func(*args, **kwargs) -> ImgArray:
name = kwargs.pop("name", xpfunc.__name__)
axes = kwargs.pop("axes", None)
out = xp.asnumpy(xpfunc(*args, **kwargs))
return asarray(out, name=name, axes=axes)
return _func
[docs]@wraps(np.random.random)
def random(
size,
*,
name: str = None,
axes: str = None,
) -> ImgArray:
name = name or "random"
return asarray(xp.asnumpy(xp.random.random(size)), name=name, axes=axes)
[docs]@wraps(np.random.normal)
def normal(
loc: float = 0.0,
scale: float = 1.0,
size=None,
*,
name: str = None,
axes: str = None,
) -> ImgArray:
name = name or f"normal({loc}, {scale})"
return asarray(xp.asnumpy(xp.random.normal(loc, scale, size)), name=name, axes=axes)
[docs]def random_uint8(
size: int | tuple[int],
*,
name: str = None,
axes: str = None,
) -> ImgArray:
"""
Return a random uint8 image, ranging 0-255.
Parameters
----------
size : int or tuple of int
Image shape.
name : str, optional
Image name.
axes : str, optional
Image axes.
Returns
-------
ImgArray
Random Image in dtype ``np.uint8``.
"""
arr = xp.random.randint(0, 255, size, dtype=np.uint8)
name = name or "random_uint8"
return asarray(xp.asnumpy(arr), name=name, axes=axes)
[docs]def random_uint16(
size,
*,
name: str = None,
axes: str = None,
) -> ImgArray:
"""
Return a random uint16 image, ranging 0-65535.
Parameters
----------
size : int or tuple of int
Image shape.
name : str, optional
Image name.
axes : str, optional
Image axes.
Returns
-------
ImgArray
Random Image in dtype ``np.uint16``.
"""
arr = xp.random.randint(0, 65535, size, dtype=np.uint16)
name = name or "random_uint16"
return asarray(xp.asnumpy(arr), name=name, axes=axes)
del wraps