gtrack 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

gtrack/point_rotation.py

@@ -148,6 +148,55 @@ class PointCloud:
         xyz = LatLon2XYZ(latlon)
         return cls(xyz=xyz, properties=properties or {})
 
+    @classmethod
+    def from_xyz(
+        cls,
+        xyz: np.ndarray,
+        properties: Optional[Dict[str, np.ndarray]] = None,
+        normalize_to_earth: bool = False
+    ) -> "PointCloud":
+        """
+        Create PointCloud from Cartesian XYZ coordinates.
+
+        This is a convenience classmethod that provides symmetry with from_latlon.
+        It can optionally normalize points to Earth's surface.
+
+        Parameters
+        ----------
+        xyz : np.ndarray
+            Cartesian coordinates, shape (N, 3).
+        properties : dict, optional
+            Properties to attach to the points.
+        normalize_to_earth : bool, default=False
+            If True, normalize points to Earth's radius (~6.3781e6 m).
+            Useful when input points are on a unit sphere.
+
+        Returns
+        -------
+        PointCloud
+            New PointCloud with the given XYZ coordinates.
+
+        Examples
+        --------
+        >>> # Points already at Earth's radius
+        >>> xyz = np.array([[6378100, 0, 0], [0, 6378100, 0]])
+        >>> cloud = PointCloud.from_xyz(xyz)
+        >>>
+        >>> # Points on unit sphere, scale to Earth
+        >>> xyz_unit = np.array([[1, 0, 0], [0, 1, 0]])
+        >>> cloud = PointCloud.from_xyz(xyz_unit, normalize_to_earth=True)
+        """
+        from .geometry import EARTH_RADIUS
+        xyz = np.asarray(xyz)
+
+        if normalize_to_earth:
+            # Normalize to unit sphere, then scale to Earth's radius
+            norms = np.linalg.norm(xyz, axis=1, keepdims=True)
+            norms = np.maximum(norms, 1e-10)  # Avoid division by zero
+            xyz = xyz / norms * EARTH_RADIUS
+
+        return cls(xyz=xyz, properties=properties or {})
+
     def add_property(self, name: str, values: np.ndarray) -> None:
         """
         Add or update a property.

{gtrack-0.3.1.dist-info → gtrack-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gtrack
-Version: 0.3.1
+Version: 0.3.2
 Summary: GPlates-based Tracking of Lithosphere and Kinematics
 Author: S. Ghelichkhani
 License: MIT

{gtrack-0.3.1.dist-info → gtrack-0.3.2.dist-info}/RECORD

@@ -8,10 +8,10 @@ gtrack/io_formats.py,sha256=_zXOdn7rqlcD0fORNQmh8hemYKzABCax1X1W-WVGpiE,12769
 gtrack/logging.py,sha256=6N8QivpVq0oahwi0K62zUgQici-rK40V9CEOPDSpwp0,4930
 gtrack/mesh.py,sha256=BCgGWXLnflK_aiD9B6GBY0X_OJur645Sc1lVX6O4Q6Q,2733
 gtrack/mor_seeds.py,sha256=mFF89nKOq7yIEOIE41AnNTJdbQ3Q5OLYGnAu6KbeXg8,13395
-gtrack/point_rotation.py,sha256=FPmOZWKhaySsTZKTWlXIVPEtmcXjX-ufsDM0NPbg9gU,26304
+gtrack/point_rotation.py,sha256=WKnpbQWR_KR1DkfIi2YlNP94GnW3B2VocoBrr17ok9U,28014
 gtrack/polygon_filter.py,sha256=5wDChgkxF7IU7of2JfkAWVbzxOHSgnuIQsg-eA0Yyoo,6333
 gtrack/spatial.py,sha256=70UXaH1TyaQDR1P_1j2FoCdUTTa8a921h7Wt6kj1hZw,14475
-gtrack-0.3.1.dist-info/METADATA,sha256=DUD53bcLE_q6jtlg3mM-h8JUCJyzVQXfPIrZxLNyLSc,2268
-gtrack-0.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-gtrack-0.3.1.dist-info/top_level.txt,sha256=x1GottZL9pxdL8Ff3ARhF6tAhM4-CIKgnS9Hl7PZzyQ,7
-gtrack-0.3.1.dist-info/RECORD,,
+gtrack-0.3.2.dist-info/METADATA,sha256=mQYXx_Z18QUTixWhcZtZCWpEJemwcG0rx5mYFST1Xk0,2268
+gtrack-0.3.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+gtrack-0.3.2.dist-info/top_level.txt,sha256=x1GottZL9pxdL8Ff3ARhF6tAhM4-CIKgnS9Hl7PZzyQ,7
+gtrack-0.3.2.dist-info/RECORD,,