Upload pyproj/PYPROJ_USER_GUIDE.txt with huggingface_hub

pyproj/PYPROJ_USER_GUIDE.txt

@@ -0,0 +1,75 @@
+================================================================================
+  PYPROJ - USER GUIDE (Android Python STB) - Generated by RIMI
+================================================================================
+
+WHAT THIS IS
+------------
+pyproj 3.8.0 - Python interface to PROJ (cartographic projections and
+coordinate transformations library). This package ships the pyproj Python
+code, ten compiled Cython extension modules, the PROJ 9.8.1 shared library
+(libproj.so, built from source for Android) and the PROJ datum database
+(proj.db, 10 MB) plus support files, all inside ONE wheel per architecture:
+
+  pyproj-3.8.0-cp312-cp312-android_24_arm64_v8a.whl   (real ARM64 phones)
+  pyproj-3.8.0-cp312-cp312-android_24_x86_64.whl      (x86_64 emulators)
+
+INSTALL
+-------
+1. Install the wheel matching your device architecture via PipManager.
+2. Install `certifi` (pyproj's only runtime dependency) from its own
+   package - it is NOT bundled in this wheel (house rule: pure-Python
+   deps live in their own packages).
+3. No PROJ_DATA / PROJ_LIB setup needed: the wheel carries
+   pyproj/proj_dir/share/proj/proj.db and pyproj finds it automatically
+   (internal proj directory is preferred over env vars).
+
+QUICK START
+-----------
+  from pyproj import CRS, Transformer, Geod
+
+  # CRS objects (needs proj.db - vendored, works offline)
+  wgs84 = CRS.from_epsg(4326)
+
+  # coordinate transform: lon/lat -> Web-Mercator
+  t = Transformer.from_crs("EPSG:4326", "EPSG:3857", always_xy=True)
+  x, y = t.transform(12.0, 55.0)   # -> (1335833.89, 7361866.11)
+
+  # geodesic on WGS84 ellipsoid (no DB needed, pure math in PROJ)
+  g = Geod(ellps="WGS84")
+  az12, az21, dist = g.inv(0.0, 0.0, 1.0, 0.0)  # 1 deg on equator
+  print(dist)   # 111319.49079327357 metres
+
+  # where the datum files live
+  from pyproj import datadir
+  print(datadir.get_data_dir())   # .../pyproj/proj_dir/share/proj
+
+ANDROID NOTES / GOTCHAS
+-----------------------
+- The bundled libproj.so is preloaded automatically at
+  `import pyproj` (ctypes.CDLL of the wheel sibling). Never move or
+  rename pyproj/libproj.so inside site-packages.
+- Network features (TransformerGroup downloads, projsync, grid CDN) need
+  internet AND are built WITHOUT curl support in this wheel: remote grid
+  download is unavailable. Everything that works from the vendored
+  proj.db + embedded math works fully offline.
+- GeoTIFF grid support is disabled (TIFF off): transformations listed in
+  proj.db that require an external .tif grid raise a ProjError naming the
+  missing grid instead of silently mis-transforming. Standard
+  CRS-to-CRS work (incl. Copenhagen 4326->3857 above) needs no grids.
+- Full 700 MB+ proj-data grid packs are NOT shipped (same as upstream
+  wheels). If you need a specific grid, push the .tif/.gsb next to
+  proj.db and call pyproj.datadir.append_data_dir(), or set PROJ_DATA.
+- SQLite is statically linked INSIDE libproj.so: no extra .so to install.
+- Tested API surface (see Test_Pyproj.py, 10 checks): import, version
+  strings, certifi presence, PROJ 9.8.1 linkage, proj.db vendoring, CRS
+  lookup, 4326->3857 known answer + roundtrip, geodesic inv/fwd known
+  answers, ellipsoid map listing.
+
+VERSIONS INSIDE
+---------------
+  pyproj 3.8.0 (latest stable, 2026) | PROJ 9.8.1 (exact version upstream
+  3.8.0 wheels bundle) | SQLite 3.53.4 (static) | Python 3.12 | API 24+.
+
+================================================================================
+  Generated by RIMI
+================================================================================