WhgddlmZddlZddlZddlmZmZddlm Z eZ eZ eZ Gddej Zde_eejejeeeefZde_eeejefZd e_dS) ) annotationsN)AnyUnion)SequenceceZdZdZdgZdZeejddZ eejddZ eejdd Z eejdd Z ejdd Z eejddZeejddZeejddZeejddZeejd dZeejddZeejd!dZejdZdS)"ArrayaArray base class for JAX ``jax.Array`` is the public interface for instance checks and type annotation of JAX arrays and tracers. Its main applications are in instance checks and type annotations; for example:: x = jnp.arange(5) isinstance(x, jax.Array) # returns True both inside and outside traced functions. def f(x: Array) -> Array: # type annotations are valid for traced and non-traced types. return x ``jax.Array`` should not be used directly for creation of arrays; instead you should use array creation routines offered in :mod:`jax.numpy`, such as :func:`jax.numpy.array`, :func:`jax.numpy.zeros`, :func:`jax.numpy.ones`, :func:`jax.numpy.full`, :func:`jax.numpy.arange`, etc. __weakref__Nreturnnp.dtypecdS)z2The data type (:class:`numpy.dtype`) of the array.Nselfs X/var/www/html/movieo_spanner_bot/venv/lib/python3.11/site-packages/jax/_src/basearray.pydtypez Array.dtype:intcdS)z&The number of dimensions in the array.Nr rs rndimz Array.ndim?rrcdS)z*The total number of elements in the array.Nr rs rsizez Array.sizeDrrtuple[int, ...]cdS)zThe shape of the array.Nr rs rshapez Array.shapeIrrindexcdS)z>Return an array of the addressable data at a particular index.Nr )rrs raddressable_datazArray.addressable_dataOrrSequence[Shard]cdS)zList of addressable shards.Nr rs raddressable_shardszArray.addressable_shardsSrrcdS)zList of global shards.Nr rs r global_shardszArray.global_shardsXrrboolcdS)aIs this Array fully addressable? A jax.Array is fully addressable if the current process can address all of the devices named in the :class:`Sharding`. ``is_fully_addressable`` is equivalent to "is_local" in multi-process JAX. Note that fully replicated is not equal to fully addressable i.e. a jax.Array which is fully replicated can span across multiple hosts and is not fully addressable. Nr rs ris_fully_addressablezArray.is_fully_addressable]rrcdS)zIs this Array fully replicated?Nr rs ris_fully_replicatedzArray.is_fully_replicatedkrrShardingcdS)zThe sharding for the array.Nr rs rshardingzArray.shardingprrcdS)atWhether the array is committed or not. An array is committed when it is explicitly placed on device(s) via JAX APIs. For example, `jax.device_put(np.arange(8), jax.devices()[0])` is committed to device 0. While `jax.device_put(np.arange(8))` is uncommitted and will be placed on the default device. Computations involving some committed inputs will happen on the committed device(s) and the result will be committed on the same device(s). Invoking an operation on arguments that are committed to different device(s) will raise an error. For example: ``` a = jax.device_put(np.arange(8), jax.devices()[0]) b = jax.device_put(np.arange(8), jax.devices()[1]) a + b # Raises an error ``` See https://jax.readthedocs.io/en/latest/faq.html#controlling-data-and-computation-placement-on-devices for more information. Nr rs r committedzArray.committedurrDevice | ShardingcdS)zArray API-compatible device attribute. For single-device arrays, this returns a Device. For sharded arrays, this returns a Sharding. Nr rs rdevicez Array.devicerrcdS)aCopies an ``Array`` to the host asynchronously. For arrays that live an an accelerator, such as a GPU or a TPU, JAX may cache the value of the array on the host. Normally this happens behind the scenes when the value of an on-device array is requested by the user, but waiting to initiate a device-to-host copy until the value is requested requires that JAX block the caller while waiting for the copy to complete. ``copy_to_host_async`` requests that JAX populate its on-host cache of an array, but does not wait for the copy to complete. This may speed up a future on-host access to the array's contents. Nr rs rcopy_to_host_asynczArray.copy_to_host_asyncrr)r r )r r)r r)rrr r)r r)r r$)r r))r r.)__name__ __module__ __qualname____doc__ __slots____hash__propertyabcabstractmethodrrrrrr!r#r&r(r+r-r0r2r rrrr sk,o) ( === 8= 111 81 555 85 """ 8"IIII &&& 8& !!! 8!     8  *** 8* &&& 8&  82  8     rrjaxz2Type annotation for JAX-compatible static scalars.z+Type annotation for JAX array-like objects.) __future__rr:numpynptypingrrcollections.abcrDeviceShardr)ABCrr4bool_numberr$rfloatcomplex StaticScalarr6ndarray ArrayLiker rrrLs"#""""" $$$$$$    GGGGGCGGGGT(BIUG L  *  B r