flet-gpumap 0.1.0__tar.gz

flet_gpumap-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yasuhiro / AIseed
+
+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.

flet_gpumap-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: flet-gpumap
+Version: 0.1.0
+Summary: GPU で格子データ(気象の予報など)を地図に描く Flet の拡張
+Author: aiseed-dev
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aiseed-dev/flet-tools/tree/main/flet-gpumap
+Project-URL: Repository, https://github.com/aiseed-dev/flet-tools
+Project-URL: Issues, https://github.com/aiseed-dev/flet-tools/issues
+Keywords: flet,flutter,gpu,shader,map,weather,grid
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flet>=1.0.4
+Dynamic: license-file
+
+# flet-gpumap
+
+気象の格子データ（等緯度経度の格子）を GPU で描く [Flet](https://flet.dev) の拡張。
+AIseed Weather(weather.time-j.net)の地図画面の「動く地図」で使っている。
+
+- 色の場: シェーダー（`shaders/field.frag`）が画面の画素ごとに投影を逆にたどって
+  経緯度を求め、格子を双一次補間して配色する。配色表は透明度も持ち、透ける所には陸海の地色が出る
+- 風の粒子: Dart で動かし、直近 12 コマの位置を細い三角形の列にして 1 回で描く
+- 等値線と数値、海岸線: 経緯度の線を受け取り、表示に合わせて描く
+- 投影: `plate_carree`（全球なら経度方向につながる）、`polar_north`・`polar_south`（正距方位）
+- 拡大（ホイール・ピンチ）・移動（ドラッグ）・読み取りは部品の中で完結する
+
+## Python から
+
+```python
+from flet_gpumap import GpuField, GpuFrame
+
+GpuField(
+    nx=361, ny=281, lon0=95.0, lat0=65.0, dlon=0.25, dlat=0.25,
+    projection="plate_carree", center_lon=140, center_lat=30, px_per_deg=14,
+    vmin=-20, vmax=40, lut=lut_256_rgba, base=land_mask_bytes, coast=coast_bytes,
+    label="2m気温", unit="°C",
+    frames=[GpuFrame(index=i, scalar=..., wind=..., contours=..., contours_bold=..., labels=...)
+            for i in ...],
+    step=0,
+    attribution="Data: ECMWF Open Data (CC-BY-4.0)",
+    on_ready=..., on_stats=...,
+)
+```
+
+データの形は `src/flet_gpumap/gpufield.py` の説明のとおり（値は 16 bit を RGBA の RG に、
+風は int16 の 0.01 m/s、線は float32 の (経度, 緯度) で切れ目は NaN）。
+時刻は `GpuFrame` を足していき、`step` を変えるだけで切り替える。
+
+値が階級（レーダーの降水強度など）のときは `sampling="nearest"` で補間せずに塗り、
+`classes=["", "〜1", "1〜5", …]` で読み取りに階級の名前を出す。細かい格子の階級は
+`GpuFrame(scalar8=…)`（1 格子点 1 バイト）で送ると RGBA の 4 分の 1 で済む。風の無い量は
+`show_particles=False, particles=0`。
+
+## 実行環境
+
+自作の部品は Flet の出来合いの実行環境では表示されない。部品入りの実行環境を `flet build` で
+`build/linux` に作り、プロジェクトのフォルダーで `flet run` する（Linux の Flet は `build/linux` を
+先に使う）。
+部品（Dart・シェーダー）を変えたら作り直す。
+
+Linux（Intel 内蔵 GPU）で 57〜59 fps（粒子 10,000、等値線・海岸線あり）。Web でも描ける。
+
+## ライセンス
+
+MIT（[LICENSE](LICENSE)）。aiai-tools のほかのコードは AGPL-3.0-or-later だが、この部品は
+ほかのアプリでも使えるように MIT にした（2026-10-14）。AIseed Weather の flet-gpufield を元にし、
+地図とグラフを描ける部品に広げる（[DESIGN.md](DESIGN.md)）。
+
+## 公開
+
+`flet-gpumap-v0.1.0` のようなタグを push すると、GitHub Actions(`.github/workflows/publish-flet-gpumap.yml`)
+が PyPI に出す。

flet_gpumap-0.1.0/README.md

@@ -0,0 +1,58 @@
+# flet-gpumap
+
+気象の格子データ（等緯度経度の格子）を GPU で描く [Flet](https://flet.dev) の拡張。
+AIseed Weather(weather.time-j.net)の地図画面の「動く地図」で使っている。
+
+- 色の場: シェーダー（`shaders/field.frag`）が画面の画素ごとに投影を逆にたどって
+  経緯度を求め、格子を双一次補間して配色する。配色表は透明度も持ち、透ける所には陸海の地色が出る
+- 風の粒子: Dart で動かし、直近 12 コマの位置を細い三角形の列にして 1 回で描く
+- 等値線と数値、海岸線: 経緯度の線を受け取り、表示に合わせて描く
+- 投影: `plate_carree`（全球なら経度方向につながる）、`polar_north`・`polar_south`（正距方位）
+- 拡大（ホイール・ピンチ）・移動（ドラッグ）・読み取りは部品の中で完結する
+
+## Python から
+
+```python
+from flet_gpumap import GpuField, GpuFrame
+
+GpuField(
+    nx=361, ny=281, lon0=95.0, lat0=65.0, dlon=0.25, dlat=0.25,
+    projection="plate_carree", center_lon=140, center_lat=30, px_per_deg=14,
+    vmin=-20, vmax=40, lut=lut_256_rgba, base=land_mask_bytes, coast=coast_bytes,
+    label="2m気温", unit="°C",
+    frames=[GpuFrame(index=i, scalar=..., wind=..., contours=..., contours_bold=..., labels=...)
+            for i in ...],
+    step=0,
+    attribution="Data: ECMWF Open Data (CC-BY-4.0)",
+    on_ready=..., on_stats=...,
+)
+```
+
+データの形は `src/flet_gpumap/gpufield.py` の説明のとおり（値は 16 bit を RGBA の RG に、
+風は int16 の 0.01 m/s、線は float32 の (経度, 緯度) で切れ目は NaN）。
+時刻は `GpuFrame` を足していき、`step` を変えるだけで切り替える。
+
+値が階級（レーダーの降水強度など）のときは `sampling="nearest"` で補間せずに塗り、
+`classes=["", "〜1", "1〜5", …]` で読み取りに階級の名前を出す。細かい格子の階級は
+`GpuFrame(scalar8=…)`（1 格子点 1 バイト）で送ると RGBA の 4 分の 1 で済む。風の無い量は
+`show_particles=False, particles=0`。
+
+## 実行環境
+
+自作の部品は Flet の出来合いの実行環境では表示されない。部品入りの実行環境を `flet build` で
+`build/linux` に作り、プロジェクトのフォルダーで `flet run` する（Linux の Flet は `build/linux` を
+先に使う）。
+部品（Dart・シェーダー）を変えたら作り直す。
+
+Linux（Intel 内蔵 GPU）で 57〜59 fps（粒子 10,000、等値線・海岸線あり）。Web でも描ける。
+
+## ライセンス
+
+MIT（[LICENSE](LICENSE)）。aiai-tools のほかのコードは AGPL-3.0-or-later だが、この部品は
+ほかのアプリでも使えるように MIT にした（2026-10-14）。AIseed Weather の flet-gpufield を元にし、
+地図とグラフを描ける部品に広げる（[DESIGN.md](DESIGN.md)）。
+
+## 公開
+
+`flet-gpumap-v0.1.0` のようなタグを push すると、GitHub Actions(`.github/workflows/publish-flet-gpumap.yml`)
+が PyPI に出す。

flet_gpumap-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "flet-gpumap"
+version = "0.1.0"
+description = "GPU で格子データ(気象の予報など)を地図に描く Flet の拡張"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "aiseed-dev" }]
+keywords = ["flet", "flutter", "gpu", "shader", "map", "weather", "grid"]
+license = "MIT"
+dependencies = [
+    "flet>=1.0.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/aiseed-dev/flet-tools/tree/main/flet-gpumap"
+Repository = "https://github.com/aiseed-dev/flet-tools"
+Issues = "https://github.com/aiseed-dev/flet-tools/issues"
+
+[dependency-groups]
+dev = [
+    "mkdocs",
+    "mkdocs-material",
+    "mkdocstrings[python]"
+]
+
+[tool.setuptools.package-data]
+"flutter.flet_gpumap" = ["**/*"]
+
+[tool.setuptools]
+license-files = ["LICENSE"]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

flet_gpumap-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flet_gpumap-0.1.0/src/flet_gpumap/__init__.py

@@ -0,0 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Yasuhiro / AIseed
+
+from flet_gpumap.gpufield import GpuField, GpuFieldStatsEvent, GpuFrame
+
+__all__ = ["GpuField", "GpuFieldStatsEvent", "GpuFrame"]

flet_gpumap-0.1.0/src/flet_gpumap/gpufield.py

@@ -0,0 +1,139 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 Yasuhiro / AIseed
+
+"""気象の格子データを GPU で描く Flet の部品。
+
+Python は格子データと表示の決まり（投影・配色・範囲）を渡すだけで、拡大・移動・風の粒子の
+動きは Flutter 側（GPU のシェーダーと Dart）が 1 コマごとに描く。
+
+時刻ごとのデータは子の `GpuFrame` で渡し、`step`（番号）を変えるだけで切り替える。
+Flet は足された子だけを送るので、全時刻を順に足していけば、切り替えのたびに
+データを送り直すことはない。
+"""
+from dataclasses import dataclass, field
+from typing import Optional
+
+import flet as ft
+
+__all__ = ["GpuField", "GpuFrame", "GpuFieldStatsEvent"]
+
+
+@dataclass
+class GpuFieldStatsEvent(ft.Event["GpuField"]):
+    """描画の速さの報告（約 2 秒ごと）。"""
+
+    fps: float
+    """1 秒あたりのコマ数。"""
+
+    frame_ms: float
+    """粒子の移動の計算にかかった時間の平均（ミリ秒）。"""
+
+    particles: int
+    """動かしている粒子の数。"""
+
+    upload_ms: float
+    """最後に時刻のデータを GPU 用の画像にするのにかかった時間（ミリ秒）。"""
+
+    build_ms: float = 0.0
+    """Flutter が測った 1 コマの組み立て（build）の時間の平均（ミリ秒）。"""
+
+    raster_ms: float = 0.0
+    """Flutter が測った 1 コマの描画（raster）の時間の平均（ミリ秒）。"""
+
+    frames: int = 0
+    """受け取っている時刻の数。"""
+
+
+@ft.control("GpuFrame")
+class GpuFrame(ft.BaseControl):
+    """1 時刻分のデータ。
+
+    - `scalar`: 色で描く量。格子点ごとに RGBA 4 バイト。RG が `vmin`〜`vmax` を 0〜65535 に
+      詰めた値（R が上位）、A が 255 なら値あり・0 なら欠測。
+    - `scalar8`: `scalar` の代わりに 1 格子点 1 バイト（0〜255 が `vmin`〜`vmax`、欠測なし）。
+      階級のような粗い値を細かい格子で送るとき（送る量が 4 分の 1）。
+    - `wind`: 風の粒子用の u・v。int16 little-endian（0.01 m/s 単位）で u を ny × nx、続けて v。
+    - `contours` / `contours_bold`: 等値線。float32 LE の (経度, 緯度) の並び、線の切れ目は NaN。
+    - `labels`: 等値線の数値。float32 LE の (経度, 緯度, 値) の並び。
+    """
+
+    index: int = 0
+    scalar: Optional[bytes] = None
+    scalar8: Optional[bytes] = None
+    wind: Optional[bytes] = None
+    contours: Optional[bytes] = None
+    contours_bold: Optional[bytes] = None
+    labels: Optional[bytes] = None
+
+
+@ft.control("GpuField")
+class GpuField(ft.LayoutControl):
+    """等緯度経度の格子（北から南の行順）を GPU で描く。"""
+
+    nx: int = 0
+    ny: int = 0
+    lon0: ft.Number = 0.0
+    """最初の列（西端）の格子点の経度。"""
+    lat0: ft.Number = 0.0
+    """最初の行（北端）の格子点の緯度。"""
+    dlon: ft.Number = 0.25
+    dlat: ft.Number = 0.25
+    periodic: bool = False
+    """経度方向に一周つながる格子か（全球）。"""
+
+    projection: str = "plate_carree"
+    """"plate_carree"（正距円筒）、"polar_north"・"polar_south"（極の正距方位）。"""
+
+    center_lon: ft.Number = 137.0
+    """最初の表示の中心の経度。極の投影では画面の真下に来る経度。"""
+    center_lat: ft.Number = 36.0
+    px_per_deg: ft.Number = 14.0
+    """最初の表示の縮尺（1 度あたりの論理画素。極では余緯度 1 度あたり）。"""
+
+    vmin: ft.Number = 0.0
+    vmax: ft.Number = 1.0
+    """配色の両端に対応する値（読み取りの値の換算にも使う）。"""
+
+    lut: Optional[bytes] = None
+    """配色。256 段 × RGBA8（vmin から vmax まで）。A が透明度。"""
+
+    base: Optional[bytes] = None
+    """陸海。格子点ごとに 1 バイト（1 が陸）。配色が透ける所に地色として出る。"""
+
+    coast: Optional[bytes] = None
+    """海岸線。float32 LE の (経度, 緯度) の並び、線の切れ目は NaN。"""
+
+    label: str = ""
+    unit: str = ""
+    """読み取りに出す量の名前と単位。"""
+
+    sampling: str = "bilinear"
+    """"bilinear"（双一次補間）か "nearest"（最寄りの格子点）。階級のような値は "nearest" に
+    する（階級の間を補間すると、観測されていない値の縁ができる）。"""
+
+    classes: list[str] = field(default_factory=list)
+    """値が階級の番号（0, 1, 2, …）のときの、番号ごとの名前。読み取りに数値の代わりに出す
+    （空の名前は出さない。label・unit が空なら名前だけを出す）。"""
+
+    frames: list[GpuFrame] = field(default_factory=list)
+    """時刻ごとのデータ。"""
+
+    step: int = 0
+    """描く時刻（GpuFrame.index）。まだ届いていなければ、届くまで前の時刻を描く。"""
+
+    particles: int = 10000
+    """風の粒子の数（Intel 内蔵 GPU で 12,000 まで 60 fps）。"""
+
+    show_particles: bool = True
+
+    attribution: str = ""
+    """右下に出す出典（図には必ず出典を付ける）。"""
+
+    status_text: str = ""
+    """左上に出す状態の知らせ（読み込み中、この時刻のデータが無い、など）。空なら出さない。"""
+
+    on_ready: Optional[ft.ControlEventHandler["GpuField"]] = None
+    """部品が画面に出たとき（実行環境に部品が入っている印）。"""
+
+    on_stats: Optional[ft.EventHandler[GpuFieldStatsEvent]] = None
+    """描画の速さの報告を受け取る。"""

flet_gpumap-0.1.0/src/flet_gpumap.egg-info/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: flet-gpumap
+Version: 0.1.0
+Summary: GPU で格子データ(気象の予報など)を地図に描く Flet の拡張
+Author: aiseed-dev
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aiseed-dev/flet-tools/tree/main/flet-gpumap
+Project-URL: Repository, https://github.com/aiseed-dev/flet-tools
+Project-URL: Issues, https://github.com/aiseed-dev/flet-tools/issues
+Keywords: flet,flutter,gpu,shader,map,weather,grid
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flet>=1.0.4
+Dynamic: license-file
+
+# flet-gpumap
+
+気象の格子データ（等緯度経度の格子）を GPU で描く [Flet](https://flet.dev) の拡張。
+AIseed Weather(weather.time-j.net)の地図画面の「動く地図」で使っている。
+
+- 色の場: シェーダー（`shaders/field.frag`）が画面の画素ごとに投影を逆にたどって
+  経緯度を求め、格子を双一次補間して配色する。配色表は透明度も持ち、透ける所には陸海の地色が出る
+- 風の粒子: Dart で動かし、直近 12 コマの位置を細い三角形の列にして 1 回で描く
+- 等値線と数値、海岸線: 経緯度の線を受け取り、表示に合わせて描く
+- 投影: `plate_carree`（全球なら経度方向につながる）、`polar_north`・`polar_south`（正距方位）
+- 拡大（ホイール・ピンチ）・移動（ドラッグ）・読み取りは部品の中で完結する
+
+## Python から
+
+```python
+from flet_gpumap import GpuField, GpuFrame
+
+GpuField(
+    nx=361, ny=281, lon0=95.0, lat0=65.0, dlon=0.25, dlat=0.25,
+    projection="plate_carree", center_lon=140, center_lat=30, px_per_deg=14,
+    vmin=-20, vmax=40, lut=lut_256_rgba, base=land_mask_bytes, coast=coast_bytes,
+    label="2m気温", unit="°C",
+    frames=[GpuFrame(index=i, scalar=..., wind=..., contours=..., contours_bold=..., labels=...)
+            for i in ...],
+    step=0,
+    attribution="Data: ECMWF Open Data (CC-BY-4.0)",
+    on_ready=..., on_stats=...,
+)
+```
+
+データの形は `src/flet_gpumap/gpufield.py` の説明のとおり（値は 16 bit を RGBA の RG に、
+風は int16 の 0.01 m/s、線は float32 の (経度, 緯度) で切れ目は NaN）。
+時刻は `GpuFrame` を足していき、`step` を変えるだけで切り替える。
+
+値が階級（レーダーの降水強度など）のときは `sampling="nearest"` で補間せずに塗り、
+`classes=["", "〜1", "1〜5", …]` で読み取りに階級の名前を出す。細かい格子の階級は
+`GpuFrame(scalar8=…)`（1 格子点 1 バイト）で送ると RGBA の 4 分の 1 で済む。風の無い量は
+`show_particles=False, particles=0`。
+
+## 実行環境
+
+自作の部品は Flet の出来合いの実行環境では表示されない。部品入りの実行環境を `flet build` で
+`build/linux` に作り、プロジェクトのフォルダーで `flet run` する（Linux の Flet は `build/linux` を
+先に使う）。
+部品（Dart・シェーダー）を変えたら作り直す。
+
+Linux（Intel 内蔵 GPU）で 57〜59 fps（粒子 10,000、等値線・海岸線あり）。Web でも描ける。
+
+## ライセンス
+
+MIT（[LICENSE](LICENSE)）。aiai-tools のほかのコードは AGPL-3.0-or-later だが、この部品は
+ほかのアプリでも使えるように MIT にした（2026-10-14）。AIseed Weather の flet-gpufield を元にし、
+地図とグラフを描ける部品に広げる（[DESIGN.md](DESIGN.md)）。
+
+## 公開
+
+`flet-gpumap-v0.1.0` のようなタグを push すると、GitHub Actions(`.github/workflows/publish-flet-gpumap.yml`)
+が PyPI に出す。

flet_gpumap-0.1.0/src/flet_gpumap.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+src/flet_gpumap/__init__.py
+src/flet_gpumap/gpufield.py
+src/flet_gpumap.egg-info/PKG-INFO
+src/flet_gpumap.egg-info/SOURCES.txt
+src/flet_gpumap.egg-info/dependency_links.txt
+src/flet_gpumap.egg-info/requires.txt
+src/flet_gpumap.egg-info/top_level.txt
+src/flutter/flet_gpumap/pubspec.yaml
+src/flutter/flet_gpumap/lib/flet_gpumap.dart
+src/flutter/flet_gpumap/lib/src/extension.dart
+src/flutter/flet_gpumap/lib/src/gpufield.dart
+src/flutter/flet_gpumap/shaders/field.frag

flet_gpumap-0.1.0/src/flet_gpumap.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flet_gpumap-0.1.0/src/flet_gpumap.egg-info/requires.txt

@@ -0,0 +1 @@
+flet>=1.0.4

flet_gpumap-0.1.0/src/flet_gpumap.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+flet_gpumap
+flutter

flet_gpumap-0.1.0/src/flutter/flet_gpumap/lib/flet_gpumap.dart

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026 Yasuhiro / AIseed
+
+library flet_gpumap;
+
+export "src/extension.dart" show Extension;

flet_gpumap-0.1.0/src/flutter/flet_gpumap/lib/src/extension.dart

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026 Yasuhiro / AIseed
+
+import 'package:flet/flet.dart';
+import 'package:flutter/widgets.dart';
+
+import 'gpufield.dart';
+
+class Extension extends FletExtension {
+  @override
+  Widget? createWidget(Key? key, Control control) {
+    switch (control.type) {
+      case "GpuField":
+        return GpuFieldControl(key: key, control: control);
+      default:
+        return null;
+    }
+  }
+}