97 lines
2.9 KiB
Python
97 lines
2.9 KiB
Python
"""
|
|
``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}")
|