eci2ecef,ecef2eci: vectorize. Employ initial partial type annotation

remove unneeded asarray

Author: scivision

pyproject.toml

@@ -25,8 +25,8 @@ version = {attr = "pymap3d.__version__"}
 tests = ["pytest", "mypy"]
 coverage = ["pytest-cov"]
 format = ["black[jupyter]", "isort"]
-core = ["python-dateutil", "numpy >= 1.10.0"]
-full = ["astropy", "xarray"]
+core = ["python-dateutil", "numpy >= 1.21.0"]
+full = ["astropy"]
 proj = ["pyproj"]
 
 [tool.black]

src/pymap3d/__init__.py

@@ -16,9 +16,7 @@
 
 deg : bool = True means degrees. False = radians.
 
-Most functions accept NumPy arrays of any shape, as well as compatible data types
-including AstroPy, Pandas and Xarray that have Numpy-like data properties.
-For clarity, we omit all these types in the docs, and just specify the scalar type.
+Most functions accept scalar float or NumPy NDArray.
 
 Other languages
 ---------------

src/pymap3d/_dummy.py

@@ -1,7 +1,9 @@
 from datetime import datetime
 
+
 def eci2ecef(x, y, z, time: datetime, force_non_astropy: bool = False) -> tuple:
     raise ImportError("Numpy required for eci2ecef")
 
+
 def ecef2eci(x, y, z, time: datetime, force_non_astropy: bool = False) -> tuple:
     raise ImportError("Numpy required for ecef2eci")

src/pymap3d/_typing.py

@@ -0,0 +1,37 @@
+"""Typing helpers for pymap3d.
+
+NumPy is strictly optional at runtime.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import TYPE_CHECKING, Any, Union
+
+# typing.Union is for Python 3.9. Python 3.10+ can use the | operator for unions.
+
+if TYPE_CHECKING:
+    # Only loaded by type checkers (mypy, pyright, etc.)
+    import numpy as np
+    import numpy.typing as npt
+
+    ArrayLike = npt.ArrayLike
+    NDArray = npt.NDArray
+
+    DatetimeLike = Union[str, datetime, np.datetime64]
+    FloatLike = Union[float, np.floating]
+
+    FloatArray = npt.NDArray[np.floating]
+    DatetimeArray = Union[npt.NDArray[np.datetime64], np.datetime64, datetime]
+else:
+    ArrayLike = Any
+    NDArray = Any
+
+    DatetimeLike = Union[str, datetime]
+    FloatLike = float
+
+    FloatArray = float
+    DatetimeArray = datetime
+
+
+__all__ = ["ArrayLike", "NDArray", "FloatArray", "FloatLike", "DatetimeArray", "DatetimeLike"]