| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697 |
- """
- ``numpy.lib`` is mostly a space for implementing functions that don't
- belong in core or in another NumPy submodule with a clear purpose
- (e.g. ``random``, ``fft``, ``linalg``, ``ma``).
- ``numpy.lib``'s private submodules contain basic functions that are used by
- other public modules and are useful to have in the main name-space.
- """
- # Public submodules
- # Note: recfunctions is public, but not imported
- from numpy._core._multiarray_umath import add_docstring, tracemalloc_domain
- from numpy._core.function_base import add_newdoc
- # Private submodules
- # load module names. See https://github.com/networkx/networkx/issues/5838
- from . import (
- _arraypad_impl,
- _arraysetops_impl,
- _arrayterator_impl,
- _function_base_impl,
- _histograms_impl,
- _index_tricks_impl,
- _nanfunctions_impl,
- _npyio_impl,
- _polynomial_impl,
- _shape_base_impl,
- _stride_tricks_impl,
- _twodim_base_impl,
- _type_check_impl,
- _ufunclike_impl,
- _utils_impl,
- _version,
- array_utils,
- format,
- introspect,
- mixins,
- npyio,
- scimath,
- stride_tricks,
- )
- # numpy.lib namespace members
- from ._arrayterator_impl import Arrayterator
- from ._version import NumpyVersion
- __all__ = [
- "Arrayterator", "add_docstring", "add_newdoc", "array_utils",
- "format", "introspect", "mixins", "NumpyVersion", "npyio", "scimath",
- "stride_tricks", "tracemalloc_domain",
- ]
- add_newdoc.__module__ = "numpy.lib"
- from numpy._pytesttester import PytestTester
- test = PytestTester(__name__)
- del PytestTester
- def __getattr__(attr):
- # Warn for deprecated/removed aliases
- import math
- import warnings
- if attr == "math":
- warnings.warn(
- "`np.lib.math` is a deprecated alias for the standard library "
- "`math` module (Deprecated Numpy 1.25). Replace usages of "
- "`numpy.lib.math` with `math`", DeprecationWarning, stacklevel=2)
- return math
- elif attr == "emath":
- raise AttributeError(
- "numpy.lib.emath was an alias for emath module that was removed "
- "in NumPy 2.0. Replace usages of numpy.lib.emath with "
- "numpy.emath.",
- name=None
- )
- elif attr in (
- "histograms", "type_check", "nanfunctions", "function_base",
- "arraypad", "arraysetops", "ufunclike", "utils", "twodim_base",
- "shape_base", "polynomial", "index_tricks",
- ):
- raise AttributeError(
- f"numpy.lib.{attr} is now private. If you are using a public "
- "function, it should be available in the main numpy namespace, "
- "otherwise check the NumPy 2.0 migration guide.",
- name=None
- )
- elif attr == "arrayterator":
- raise AttributeError(
- "numpy.lib.arrayterator submodule is now private. To access "
- "Arrayterator class use numpy.lib.Arrayterator.",
- name=None
- )
- else:
- raise AttributeError(f"module {__name__!r} has no attribute {attr!r}")
|