thresholdfloor 0.3.0__tar.gz → 0.3.2__tar.gz

{thresholdfloor-0.3.0 → thresholdfloor-0.3.2}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Heather Nightfall
-
-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.
+MIT License
+
+Copyright (c) 2026 Heather Nightfall
+
+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.

{thresholdfloor-0.3.0/src/thresholdfloor.egg-info → thresholdfloor-0.3.2}/PKG-INFO

@@ -1,296 +1,296 @@
-Metadata-Version: 2.4
-Name: thresholdfloor
-Version: 0.3.0
-Summary: A floor below for tuning to what's above
-Author: WitchMithras
-License: Proprietary (staging)
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aetherfield>=0.5.1
-Requires-Dist: moontime>=0.4.9
-Requires-Dist: rasterio>=1.4.4
-Requires-Dist: python-dateutil>=2.8.0
-Requires-Dist: pytz>=2021.0
-Requires-Dist: numpy>=1.21.0
-Requires-Dist: Pillow>=9.0.0
-Requires-Dist: cryptography>=40.0.0
-Requires-Dist: scipy>=1.9.0
-Requires-Dist: python-dotenv>=0.19.0
-Dynamic: license-file
-
-# ThresholdFloor
-
-*ThresholdFloor* is a geolocated simulation of light, shadow, and sky.
-
-It answers a very old question:
-
-> *If I stand here, what is the sky doing right now?*
-
-Where *MoonTime* tracks cycles, and *AetherField* tracks positions,
-ThresholdFloor brings those movements down to Earth — into light, into shadow, into place.
-
----
-
-## 🌍 What It Does
-
-ThresholdFloor creates a virtual “floor” at a real location on Earth and lets you observe:
-
-* ☀️ The Sun’s angle across the sky
-* 🌗 The shifting length and direction of shadows
-* 🌅 Sunrise and sunset behavior
-* 🌞 Seasonal turning points (equinoxes, solstices)
-* 🌌 Zodiac regions above and below the horizon
-
-It turns celestial motion into something physical:
-
-> light touching ground
-
----
-
-## 🧭 Core Idea
-
-In many ancient systems, knowledge of time and season did not come from clocks.
-
-It came from:
-
-* shadows on the ground
-* the angle of light
-* where the sun rose and set
-
-ThresholdFloor recreates that perspective computationally.
-
-Instead of asking:
-
-> *What time is it?*
-
-You can ask:
-
-> *Where is the light?*
-
----
-
-## 🚀 Quick Example
-
-```python
-from thresholdfloor import ThresholdFloor as tf
-
-def test_one():
-
-    tfloor = tf(
-        name="meow meow tehran",
-        latitude=35.6892,
-        longitude=51.3890,
-        tz="Asia/Tehran"
-    )
-
-    print(tfloor.get_phase())  # Shadow-based phase
-
-    tfloor.sigil()  # Visual representation of current state
-
-    hkfloor = tf(
-        "meow meow hongkong",
-        22.3027,
-        114.1772,
-        "Asia/Hong_Kong",
-        elevation_m=958
-    )
-
-    sigil = hkfloor.sigil(show=False)
-
-    print(hkfloor.get_sunrise())  # Sunrise angle
-
-    bfloor = tf(
-        "meow meow beijing",
-        39.9075,
-        116.3972,
-        "Asia/Shanghai",
-        elevation_m=50
-    )
-
-    print(bfloor.as_above())  # Zodiac above horizon
-    print(bfloor.so_below())  # Zodiac below horizon
-
-    tofloor = tf(
-        "meow meow tokyo",
-        35.68972,
-        139.69222,
-        "Asia/Tokyo"
-    )
-
-    print(tofloor.now())      # Local MoonTime
-    print(tofloor.observe())  # Current solar geometry
-```
-
----
-
-## 🌞 Solar Cycle Example
-
-```python
-def test_two():
-
-    jfloor = tf(
-        "Jericho",
-        latitude=31.871,
-        longitude=35.443,
-        tz="Asia/Jerusalem"
-    )
-
-    # Configure observation point
-    jfloor.configure_gatehouse(31.8720, 35.4440, -245.0, bearing_deg=90.7)
-
-    # Compute solstice anchors
-    summer, winter = jfloor.compute_solstice_anchors()
-
-    # Lay out solar markers across the year
-    jfloor.auto_layout_gate_posts_across_solar_range(
-        start_date=winter,
-        days=366,
-        num_pegs=7,
-    )
-
-    # Scan solar cycle into months
-    result = jfloor.scan_solar_cycle_for_months(winter, days=366)
-
-    for m in range(1, 13):
-        print(f"Month {m}: first hit on {result['first_hits'][m]}")
-```
-
----
-
-## 🧩 Core Concepts
-
-### Floor
-
-A *Floor* is a fixed location defined by:
-
-* latitude
-* longitude
-* timezone
-* optional elevation
-
-It represents a real place on Earth.
-
----
-
-### Observation
-
-```python
-tfloor.observe()
-```
-
-Returns the current solar position relative to the floor:
-
-* altitude
-* azimuth
-* light direction
-
----
-
-### Phase
-
-```python
-tfloor.get_phase()
-```
-
-A shadow-based phase derived from solar geometry.
-
----
-
-### Sigil
-
-<p align="center">
-  <img src="docs/images/sigil_example.png" width="400"/>
-</p>
-
-```python
-tfloor.sigil()
-```
-
-Generates a visual encoding of the current state of the floor.
-
-This is an evolving feature and may expand in future releases.
-
----
-
-### Horizon Mapping
-
-```python
-tfloor.as_above()
-tfloor.as_below()
-```
-
-Maps zodiac regions relative to the local horizon.
-
----
-
-### Local Time
-
-```python
-tfloor.now()
-```
-
-Returns the current moment expressed relative to the floor.
-
----
-
-## 🌌 Design Philosophy
-
-ThresholdFloor is built around a simple inversion:
-
-Modern systems:
-
-* abstract time
-* global reference
-* detached observation
-
-ThresholdFloor:
-
-* grounded time
-* local reference
-* embodied observation
-
-It does not ask you to synchronize with a global clock.
-
-It lets you observe what is happening *where you are*.
-
----
-
-## 🧬 Ecosystem
-
-ThresholdFloor builds on:
-
-* `moontime` → temporal cycles
-* `aetherfield` → celestial positions
-
-Together they form:
-
-* **Time** → MoonTime
-* **Sky** → AetherField
-* **Ground** → ThresholdFloor
-
----
-
-## 🧪 Status
-
-Alpha release.
-
-Core functionality is in place, but APIs and visual systems (such as sigils) are still evolving.
-
----
-
-## 🕯️ Closing Note
-
-There was a time when people did not need instruments to understand the day.
-
-They could look at a shadow and know:
-
-* how far the sun had traveled
-* what season they were in
-* where they stood in the cycle
-
-ThresholdFloor is an attempt to rebuild that intuition.
-
-Not by replacing modern systems —
-
-but by letting light and shadow speak again.
+Metadata-Version: 2.4
+Name: thresholdfloor
+Version: 0.3.2
+Summary: A floor below for tuning to what's above
+Author: WitchMithras
+License: Proprietary (staging)
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aetherfield>=0.5.1
+Requires-Dist: moontime>=0.4.9
+Requires-Dist: rasterio>=1.4.4
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: pytz>=2021.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: Pillow>=9.0.0
+Requires-Dist: cryptography>=40.0.0
+Requires-Dist: scipy>=1.9.0
+Requires-Dist: python-dotenv>=0.19.0
+Dynamic: license-file
+
+# ThresholdFloor
+
+*ThresholdFloor* is a geolocated simulation of light, shadow, and sky.
+
+It answers a very old question:
+
+> *If I stand here, what is the sky doing right now?*
+
+Where *MoonTime* tracks cycles, and *AetherField* tracks positions,
+ThresholdFloor brings those movements down to Earth — into light, into shadow, into place.
+
+---
+
+## 🌍 What It Does
+
+ThresholdFloor creates a virtual “floor” at a real location on Earth and lets you observe:
+
+* ☀️ The Sun’s angle across the sky
+* 🌗 The shifting length and direction of shadows
+* 🌅 Sunrise and sunset behavior
+* 🌞 Seasonal turning points (equinoxes, solstices)
+* 🌌 Zodiac regions above and below the horizon
+
+It turns celestial motion into something physical:
+
+> light touching ground
+
+---
+
+## 🧭 Core Idea
+
+In many ancient systems, knowledge of time and season did not come from clocks.
+
+It came from:
+
+* shadows on the ground
+* the angle of light
+* where the sun rose and set
+
+ThresholdFloor recreates that perspective computationally.
+
+Instead of asking:
+
+> *What time is it?*
+
+You can ask:
+
+> *Where is the light?*
+
+---
+
+## 🚀 Quick Example
+
+```python
+from thresholdfloor import ThresholdFloor as tf
+
+def test_one():
+
+    tfloor = tf(
+        name="meow meow tehran",
+        latitude=35.6892,
+        longitude=51.3890,
+        tz="Asia/Tehran"
+    )
+
+    print(tfloor.get_phase())  # Shadow-based phase
+
+    tfloor.sigil()  # Visual representation of current state
+
+    hkfloor = tf(
+        "meow meow hongkong",
+        22.3027,
+        114.1772,
+        "Asia/Hong_Kong",
+        elevation_m=958
+    )
+
+    sigil = hkfloor.sigil(show=False)
+
+    print(hkfloor.get_sunrise())  # Sunrise angle
+
+    bfloor = tf(
+        "meow meow beijing",
+        39.9075,
+        116.3972,
+        "Asia/Shanghai",
+        elevation_m=50
+    )
+
+    print(bfloor.as_above())  # Zodiac above horizon
+    print(bfloor.so_below())  # Zodiac below horizon
+
+    tofloor = tf(
+        "meow meow tokyo",
+        35.68972,
+        139.69222,
+        "Asia/Tokyo"
+    )
+
+    print(tofloor.now())      # Local MoonTime
+    print(tofloor.observe())  # Current solar geometry
+```
+
+---
+
+## 🌞 Solar Cycle Example
+
+```python
+def test_two():
+
+    jfloor = tf(
+        "Jericho",
+        latitude=31.871,
+        longitude=35.443,
+        tz="Asia/Jerusalem"
+    )
+
+    # Configure observation point
+    jfloor.configure_gatehouse(31.8720, 35.4440, -245.0, bearing_deg=90.7)
+
+    # Compute solstice anchors
+    summer, winter = jfloor.compute_solstice_anchors()
+
+    # Lay out solar markers across the year
+    jfloor.auto_layout_gate_posts_across_solar_range(
+        start_date=winter,
+        days=366,
+        num_pegs=7,
+    )
+
+    # Scan solar cycle into months
+    result = jfloor.scan_solar_cycle_for_months(winter, days=366)
+
+    for m in range(1, 13):
+        print(f"Month {m}: first hit on {result['first_hits'][m]}")
+```
+
+---
+
+## 🧩 Core Concepts
+
+### Floor
+
+A *Floor* is a fixed location defined by:
+
+* latitude
+* longitude
+* timezone
+* optional elevation
+
+It represents a real place on Earth.
+
+---
+
+### Observation
+
+```python
+tfloor.observe()
+```
+
+Returns the current solar position relative to the floor:
+
+* altitude
+* azimuth
+* light direction
+
+---
+
+### Phase
+
+```python
+tfloor.get_phase()
+```
+
+A shadow-based phase derived from solar geometry.
+
+---
+
+### Sigil
+
+<p align="center">
+  <img src="docs/images/sigil_example.png" width="400"/>
+</p>
+
+```python
+tfloor.sigil()
+```
+
+Generates a visual encoding of the current state of the floor.
+
+This is an evolving feature and may expand in future releases.
+
+---
+
+### Horizon Mapping
+
+```python
+tfloor.as_above()
+tfloor.so_below()
+```
+
+Maps zodiac regions relative to the local horizon.
+
+---
+
+### Local Time
+
+```python
+tfloor.now()
+```
+
+Returns the current moment expressed relative to the floor.
+
+---
+
+## 🌌 Design Philosophy
+
+ThresholdFloor is built around a simple inversion:
+
+Modern systems:
+
+* abstract time
+* global reference
+* detached observation
+
+ThresholdFloor:
+
+* grounded time
+* local reference
+* embodied observation
+
+It does not ask you to synchronize with a global clock.
+
+It lets you observe what is happening *where you are*.
+
+---
+
+## 🧬 Ecosystem
+
+ThresholdFloor builds on:
+
+* `moontime` → temporal cycles
+* `aetherfield` → celestial positions
+
+Together they form:
+
+* **Time** → MoonTime
+* **Sky** → AetherField
+* **Ground** → ThresholdFloor
+
+---
+
+## 🧪 Status
+
+Alpha release.
+
+Core functionality is in place, but APIs and visual systems (such as sigils) are still evolving.
+
+---
+
+## 🕯️ Closing Note
+
+There was a time when people did not need instruments to understand the day.
+
+They could look at a shadow and know:
+
+* how far the sun had traveled
+* what season they were in
+* where they stood in the cycle
+
+ThresholdFloor is an attempt to rebuild that intuition.
+
+Not by replacing modern systems —
+
+but by letting light and shadow speak again.