gri-plot 0.2.0.post1__py3-none-any.whl

gri_plot-0.2.0.post1.dist-info/METADATA

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: gri-plot
+Version: 0.2.0.post1
+Project-URL: repository, https://gitlab.com/geosol-foss/python/gri-plot
+Project-URL: homepage, https://geosolresearch.com
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.14
+Requires-Dist: gri-utils
+Requires-Dist: numpy>=2.3.3
+Requires-Dist: plotly>=6.3.0
+Requires-Dist: scikit-image>=0.25.0
+Description-Content-Type: text/markdown
+
+[![GeoSol Research Logo](https://geosolresearch.com/logos/foss_logo.png "GeoSol Research")](https://geosolresearch.com)
+
+# Plot (3D Geolocation Visualization)
+
+3D geolocation visualization and 2D plotting utilities built on Plotly. Requires Python 3.14+.
+
+## Overview
+
+This library renders implicit surfaces (TDOA hyperboloids, FDOA iso-Doppler surfaces, AOA cones, range spheres, terrain) and geometric shapes (ellipsoids, spheres, cones, cylinders) as interactive 3D meshes. It also provides shorthand functions for 2D scatter plots and geographic maps.
+
+## Installation
+
+```bash
+pip install gri-plot
+```
+
+For development:
+
+```bash
+git clone https://gitlab.com/geosol-foss/python/gri-plot.git
+cd gri-plot
+. .init_venv.sh
+```
+
+## Quick Start
+
+```python
+from gri_plot import scatter
+
+# Simple 2D scatter plot -- pass traces as (y,), (x,y), or (x,y,kwargs)
+scatter(
+    ([1, 2, 3, 4],),                         # y-only trace
+    ([0, 1, 2, 3], [1, 4, 2, 5]),            # x,y trace
+    ([0, 1, 2, 3], [2, 3, 1, 4], {"name": "Series B"}),
+    title="Example Plot",
+)
+```
+
+## Scatter
+
+Plotly scatter plots with flexible input formats. Accepts variable-length trace info as `(y,)`, `(x,y)`, or `(x,y,trace_args)`. All traces must consistently define or omit x. Uses `plotly_dark` template by default.
+
+## Scatter Map
+
+Geographic scatter maps using Plotly's Scattermapbox. Takes lat/lon sequences, uses ArcGIS World Imagery as the base layer, and auto-centers the map based on data bounds.
+
+```python
+from gri_plot import scatter_map
+
+scatter_map(
+    lats=[40.0, 40.1, 40.2],
+    lons=[-105.0, -104.9, -104.8],
+    title="Station Locations",
+)
+```
+
+## Figure3D
+
+Scene builder for composing 3D visualizations from multiple surfaces and points:
+
+- **`add_surface()`**: Add any `ImplicitShape` (shapes or observables)
+- **`add_points()`**: Add labeled scatter points
+- **`add_line()`**: Add line segments connecting points
+- **`add_intersection()`**: Highlight where multiple surfaces intersect
+- **`plot_surfaces()`**: Convenience function for quick multi-surface plots
+- Method chaining, automatic color cycling from D3 palette, `plotly_dark` template
+
+```python
+from gri_plot import Figure3D
+from gri_plot.shapes import Sphere
+from gri_plot.observables import TdoaSurface
+import numpy as np
+
+fig = Figure3D()
+fig.add_surface(Sphere(center=np.array([0, 0, 0]), radius=100))
+fig.add_points(np.array([[50, 50, 50]]), labels=["Target"])
+fig.show()
+```
+
+## Frames
+
+Coordinate frame handling for 3D display:
+
+- **Frame enum**: XYZ (ECEF), ENU (local tangent plane), LLA (lat/lon/alt)
+- **FrameTransformer**: Converts between XYZ and display frame using gri-utils coordinate conversions
+- **Bounds**: Named tuple for axis-aligned bounding boxes with frame metadata
+- All internal computation in XYZ; frame conversion applied only for display
+
+## Shapes
+
+Geometric primitives implementing the `ImplicitShape` ABC. Each supports parametric mesh generation (fast, exact geometry) and implicit residual evaluation (for intersection calculations).
+
+- **Ellipsoid**: From center + covariance matrix, or center + semi-axes + rotation matrix
+- **Sphere**: From center + radius
+- **Cone**: From apex + axis direction + half-angle + height
+- **Cylinder**: From center + axis direction + radius + height
+- **Mesh generators**: Standalone functions (`sphere_mesh`, `ellipsoid_mesh`, `cone_mesh`, `cylinder_mesh`) for direct vertex/face generation
+
+## Observables
+
+Geolocation-specific surfaces for visualizing measurement iso-surfaces. Some inherit from shapes (reusing parametric rendering), others use marching cubes for mesh extraction.
+
+- **TdoaSurface**: TDOA hyperboloid where range_1 - range_2 = c x tdoa, from two collector positions + time difference
+- **FdoaSurface**: FDOA iso-Doppler surface from two collector positions/velocities + carrier frequency + frequency difference
+- **AoaSurface**: AOA cone (extends Cone) from collector position + measured direction + angular error
+- **LosSurface**: Line of sight ray (extends Cylinder) from start point + direction + length; also provides `to_line_trace()` for simple line rendering
+- **RangeSphere**: Range/TOA sphere (extends Sphere) from collector position + range measurement
+- **TerrainSurface**: Terrain from XYZ vertex grid with interpolated residual evaluation; factory methods `from_xyz_grids()` and `from_elevation_grid()`
+
+## Surfaces
+
+Low-level infrastructure for implicit surface rendering:
+
+- **ImplicitShape ABC**: Interface requiring `residual_fn()`, `get_bounds_xyz()`, `to_mesh()`, `to_trace()`, `is_volume`, `label`; also provides `contains()` for point-in-shape testing
+- **Mesh utilities**: `field_to_mesh()` (marching cubes with Newton-Raphson surface projection and adaptive refinement), `grid_to_mesh()` (parametric grid triangulation), `vertices_to_mesh3d()` (vertices/faces to Plotly Mesh3d trace)
+- **IntersectionField**: Euclidean distance in residual space for highlighting multi-surface intersections; distinguishes volumes (interior contribution) from surfaces (boundary contribution)
+- **Gradient functions**: Intensity calculators for mesh coloring -- `distance_from_point`, `distance_from_line`, `distance_from_line_segment`, `distance_from_plane`, `distance_from_axis`, `axis_value`
+
+## Dependencies
+
+- **plotly**: Interactive 2D and 3D visualization
+- **matplotlib**: Static plot support
+- **numpy**: Array operations
+- **scipy**: Marching cubes mesh extraction
+- **scikit-image**: Additional mesh processing
+- **gri-utils**: Coordinate conversions and constants
+
+
+## Other Projects
+
+Current list of other [GRI FOSS Projects](https://gitlab.com/geosol-foss/python/gri-plot/-/blob/main/.docs_other_projects.md) we are building and maintaining.
+
+## License
+
+MIT License. See [LICENSE](https://gitlab.com/geosol-foss/python/gri-plot/-/blob/main/LICENSE) for details.

gri_plot-0.2.0.post1.dist-info/RECORD

@@ -0,0 +1,33 @@
+gri_plot/__init__.py,sha256=wb1mKBMZa6Kfu9SoIggElw1fRY_uPVblNM-RJCm7UVE,2262
+gri_plot/figure3d.py,sha256=7nBFAuLsq51iVSd1jCcBbwVwiSgX5pe22zMvI_v5SCw,14717
+gri_plot/frames.py,sha256=2TBWq0JSNDd3kUlcOBRsXdlqUegDT6pPZddx9dnmUwU,6363
+gri_plot/plot_ellipse.py,sha256=5shgaVQFZNZ97OWfRSBv0YJasI8TdJqPFWwzwjA1evU,5088
+gri_plot/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gri_plot/scatter.py,sha256=JtT8CW2vvuolh39zdk6FDyidRFSqTfW2guRFfCHX0N4,2978
+gri_plot/scatter_map.py,sha256=pXclsSKtAFGaU7JaCXnlyS2Ldu1hPFX-DyjpeNXha-s,3403
+gri_plot/observables/__init__.py,sha256=cOaUDT9PQZULgiyFN_vBMe3pGAYM5PfPR10jrwNZ85s,485
+gri_plot/observables/aoa.py,sha256=-FRqe6aHlARTDuHGLmOx2i2bpsJ6KHUmT0Rfj3kiiBQ,3823
+gri_plot/observables/fdoa.py,sha256=fEJZffdcqXAYPoUzdFU5zSaZa6TAvQI151DIMy0YHGM,8289
+gri_plot/observables/los.py,sha256=AMI2NbKtReCBUUL-zrWtgjc2Z8xqdvi4oaHU0Y33r9c,4409
+gri_plot/observables/range_sphere.py,sha256=bkEV1b_WN_Pq1JshtdHG9IhGL3GJrg7IT6-wv9oEqZ8,2088
+gri_plot/observables/tdoa.py,sha256=IUNV1bkFl4ADBJafZPIOXT6Dn4uIZmUFSJ86f4P19vA,6527
+gri_plot/observables/terrain.py,sha256=SO4rmCgOAfz2P6ZP71wp8fxA-MAkS08aWrXN3MYq_YM,9614
+gri_plot/shapes/__init__.py,sha256=a5FowzknIpt9HYloqGkTvPkGrJoV74X21_bZJP7GxLE,412
+gri_plot/shapes/cone.py,sha256=D86ZSqXf-lpKZwx2wlh_EwR22oRW1vYRGMXvbNEeAgs,7269
+gri_plot/shapes/cylinder.py,sha256=eFzlVk7FamQaQCcz4CsMZuOYsZgp2PGIduXUFeWRVvo,6701
+gri_plot/shapes/ellipse.py,sha256=QCsbAKfChU-ON78qYFFU4asi-Lpmn9Ud-LalU3JUBRw,3894
+gri_plot/shapes/ellipsoid.py,sha256=ngS-0Nh5KIyzImz9sWd1Hb_ATKivaWulX-XOFqA0Wx8,7696
+gri_plot/shapes/meshgen.py,sha256=JeePyndIqbhuf4LvjwQZGOGL3_fg-BscP12blgrZoA8,7380
+gri_plot/shapes/sphere.py,sha256=tgM9stgvBltjPeDtoDRcK63eklR6TNlgYylq2X2zsbw,4400
+gri_plot/surfaces/__init__.py,sha256=KJeIdIu8Gn-yeerw_3cW8-7h77efh0H4GsY1pb_rbuI,4846
+gri_plot/surfaces/intersection.py,sha256=UAL4n1Tr6_8pw8I_L6A3Ta1Me_R9ZrwC39BPthPmqJc,7393
+gri_plot/surfaces/mesh.py,sha256=hDUMUvYN71tAxiAXNImlqEX-TW_29FgHL10ut9QFKek,20759
+gri_plot/surfaces/gradients/__init__.py,sha256=TYTTHL0YIFqswu16uw5SmUCLlzJIHboW2e5I3PqK2-Y,1171
+gri_plot/surfaces/gradients/axis.py,sha256=jmt4pC3j6I8pxbVw4fKPPiF1PQpagLjai8OGaZ0cD9o,1983
+gri_plot/surfaces/gradients/line.py,sha256=8DACh5yMwdJOQeDkXcygC7-RLqxWmuCU1BVTEIcxnvA,2662
+gri_plot/surfaces/gradients/plane.py,sha256=fIbowGxnhd20mqtE2DlxKGwP-ROhao1Kkcac3rKc-0U,1539
+gri_plot/surfaces/gradients/point.py,sha256=PPR-zdFm7LA-TLAbz8yQhL-sofFafL7Ec-IcGSLi2ko,970
+gri_plot-0.2.0.post1.dist-info/METADATA,sha256=NBNz91Ot4MSFkCjyvgxwUdY95JNtEiZiVjgdZE2Gpqs,6246
+gri_plot-0.2.0.post1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+gri_plot-0.2.0.post1.dist-info/licenses/LICENSE,sha256=Noh51pACFQty7ATtDK2D_6HNrc_UIcsyCFYJY0I9zEM,1077
+gri_plot-0.2.0.post1.dist-info/RECORD,,

gri_plot-0.2.0.post1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

gri_plot-0.2.0.post1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GeoSol Research Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.