jwwkit 0.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. jwwkit/__init__.py +14 -0
  2. jwwkit/__main__.py +4 -0
  3. jwwkit/_commands/__init__.py +1 -0
  4. jwwkit/_commands/_integrity.py +55 -0
  5. jwwkit/_commands/check_installation.py +484 -0
  6. jwwkit/_commands/compare_drawings.py +29 -0
  7. jwwkit/_commands/inspect_jwf.py +24 -0
  8. jwwkit/_commands/recognize_planar_tategu.py +20 -0
  9. jwwkit/_commands/summarize_drawing.py +16 -0
  10. jwwkit/_comparison_composites.py +179 -0
  11. jwwkit/_edit_result_core.py +175 -0
  12. jwwkit/_ezjww_adapter.py +12 -0
  13. jwwkit/_geometry_engine.py +204 -0
  14. jwwkit/_geometry_math.py +93 -0
  15. jwwkit/_normalization_inspection.py +83 -0
  16. jwwkit/_replacement_contract.py +161 -0
  17. jwwkit/_resources.py +23 -0
  18. jwwkit/_spatial_distance.py +95 -0
  19. jwwkit/_spatial_query.py +34 -0
  20. jwwkit/_tategu_features.py +201 -0
  21. jwwkit/_tategu_geometry.py +108 -0
  22. jwwkit/alignment.py +85 -0
  23. jwwkit/cad_model.py +5 -0
  24. jwwkit/cli.py +40 -0
  25. jwwkit/drawing_comparison.py +430 -0
  26. jwwkit/edit_result.py +136 -0
  27. jwwkit/geometry_view.py +141 -0
  28. jwwkit/guides/AGENTS.md +47 -0
  29. jwwkit/guides/docs/api_list.md +1944 -0
  30. jwwkit/guides/docs/common_edit_result_coverage.md +40 -0
  31. jwwkit/guides/docs/drawing_comparison.md +79 -0
  32. jwwkit/guides/docs/edit_results.md +59 -0
  33. jwwkit/guides/docs/geometry_view.md +64 -0
  34. jwwkit/guides/docs/jwf_key_catalog.md +244 -0
  35. jwwkit/guides/docs/jwf_readonly.md +76 -0
  36. jwwkit/guides/docs/plan_api_coverage.md +75 -0
  37. jwwkit/guides/docs/read_view.md +89 -0
  38. jwwkit/guides/docs/reading_to_editing.md +100 -0
  39. jwwkit/guides/docs/schema_normalization.md +64 -0
  40. jwwkit/guides/docs/search_queries.md +95 -0
  41. jwwkit/guides/docs/spatial_search.md +77 -0
  42. jwwkit/guides/docs/tategu_recognition.md +40 -0
  43. jwwkit/guides/docs/text_equivalence.md +42 -0
  44. jwwkit/guides/docs/usage_guide.md +604 -0
  45. jwwkit/guides/docs/workflow_settings.md +95 -0
  46. jwwkit/hatch_geometry.py +77 -0
  47. jwwkit/jwf.py +202 -0
  48. jwwkit/legacy_document.py +2 -0
  49. jwwkit/line_document.py +14 -0
  50. jwwkit/model/__init__.py +1 -0
  51. jwwkit/model/base.py +15 -0
  52. jwwkit/model/block_definition.py +32 -0
  53. jwwkit/model/block_names.py +41 -0
  54. jwwkit/model/block_operations.py +154 -0
  55. jwwkit/model/block_reference.py +39 -0
  56. jwwkit/model/circle.py +44 -0
  57. jwwkit/model/circular_solid.py +72 -0
  58. jwwkit/model/common_entities.py +34 -0
  59. jwwkit/model/dimension.py +49 -0
  60. jwwkit/model/display_state.py +46 -0
  61. jwwkit/model/document.py +585 -0
  62. jwwkit/model/editing.py +270 -0
  63. jwwkit/model/group_audit.py +91 -0
  64. jwwkit/model/group_import.py +249 -0
  65. jwwkit/model/line.py +31 -0
  66. jwwkit/model/point.py +41 -0
  67. jwwkit/model/preflight.py +120 -0
  68. jwwkit/model/preset_rigid.py +42 -0
  69. jwwkit/model/query.py +270 -0
  70. jwwkit/model/query_fields.py +189 -0
  71. jwwkit/model/query_regex_worker.py +20 -0
  72. jwwkit/model/query_text.py +116 -0
  73. jwwkit/model/rigid_audit.py +66 -0
  74. jwwkit/model/solid.py +51 -0
  75. jwwkit/model/spatial.py +99 -0
  76. jwwkit/model/summary.py +93 -0
  77. jwwkit/model/text.py +49 -0
  78. jwwkit/model/text_metrics.py +78 -0
  79. jwwkit/model/transformations.py +176 -0
  80. jwwkit/normalization.py +287 -0
  81. jwwkit/read_view.py +298 -0
  82. jwwkit/reader/__init__.py +1 -0
  83. jwwkit/reader/archive.py +299 -0
  84. jwwkit/reader/images.py +48 -0
  85. jwwkit/reader/jws.py +175 -0
  86. jwwkit/reader/jws_placement.py +78 -0
  87. jwwkit/reader/sxf.py +51 -0
  88. jwwkit/reader/template_names.py +22 -0
  89. jwwkit/reader/text_presets.py +23 -0
  90. jwwkit/record_reader.py +2 -0
  91. jwwkit/replacement_workflow.py +39 -0
  92. jwwkit/resources/README.md +7 -0
  93. jwwkit/resources/empty_template.jww +0 -0
  94. jwwkit/resources/halfwidth_kana_composition_v1.json +35 -0
  95. jwwkit/resources/header.json +3 -0
  96. jwwkit/resources/jwf_schema.json +925 -0
  97. jwwkit/resources/jww_workflow.example.toml +14 -0
  98. jwwkit/resources/text_equivalence_v1.json +1779 -0
  99. jwwkit/safe_edit.py +454 -0
  100. jwwkit/spatial_search.py +144 -0
  101. jwwkit/tategu_recognition.py +181 -0
  102. jwwkit/workflow_settings.py +140 -0
  103. jwwkit/writer/__init__.py +1 -0
  104. jwwkit/writer/header.py +104 -0
  105. jwwkit/writer/legacy_document.py +62 -0
  106. jwwkit/writer/mfc.py +110 -0
  107. jwwkit/writer/preserved.py +265 -0
  108. jwwkit/writer/strings.py +19 -0
  109. jwwkit/writer/template_constants.py +9 -0
  110. jwwkit/writer/template_document.py +390 -0
  111. jwwkit-0.2.0.dist-info/METADATA +174 -0
  112. jwwkit-0.2.0.dist-info/RECORD +117 -0
  113. jwwkit-0.2.0.dist-info/WHEEL +5 -0
  114. jwwkit-0.2.0.dist-info/entry_points.txt +2 -0
  115. jwwkit-0.2.0.dist-info/licenses/LICENSE +21 -0
  116. jwwkit-0.2.0.dist-info/licenses/THIRD_PARTY_NOTICES.md +51 -0
  117. jwwkit-0.2.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,75 @@
1
+ # 計画から呼べる公開編集API
2
+
3
+ ソースのクラスメソッドとsafe_editの許可表を照合した。公開API一覧全体はapi_list.md。計画の実行対象はCadDocument。
4
+
5
+ CadDocumentの編集APIは27件が直接対応。4件は直接名が未登録で、既存の宣言操作による代替を示す。
6
+
7
+ | API | 対応 | 範囲・代替 |
8
+ | --- | --- | --- |
9
+ | CadDocument.delete_entity | 直接名は計画外 | delete_entitiesのindicesを1件にして同等操作が可能。単体名は未登録。 |
10
+ | CadDocument.delete_entities | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
11
+ | CadDocument.move_entities | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
12
+ | CadDocument.move_entity | 直接名は計画外 | move_entitiesのindicesを1件にして同等操作が可能。単体名は未登録。 |
13
+ | CadDocument.transform_entities | 直接名は計画外 | 汎用合成オプションは未登録。copy/rotate/reflect/scaleの宣言操作を順序と単位を明示して使う。 |
14
+ | CadDocument.copy_entities | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
15
+ | CadDocument.align_two_points | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
16
+ | CadDocument.rotate_entities | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
17
+ | CadDocument.reflect_entities | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
18
+ | CadDocument.scale_entities | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
19
+ | CadDocument.set_entity_attributes | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
20
+ | CadDocument.set_text | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
21
+ | CadDocument.recalculate_text_endpoint | 直接名は計画外 | set_textに現在のcontentとrecalculate_end=Trueを指定して同等操作が可能。直接名は未登録。 |
22
+ | CadDocument.set_group_scale | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
23
+ | CadDocument.add_line | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
24
+ | CadDocument.add_text | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
25
+ | CadDocument.add_circle | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
26
+ | CadDocument.add_point | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
27
+ | CadDocument.add_solid | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
28
+ | CadDocument.add_circle_solid | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
29
+ | CadDocument.set_group_state | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
30
+ | CadDocument.set_layer_state | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
31
+ | CadDocument.set_layer_name | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
32
+ | CadDocument.set_group_name | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
33
+ | CadDocument.add_block_definition | 直接計画対応 | CadDocumentの同名APIを呼ぶ。子は7種の宣言コンストラクタ、または承認済み既存要素。定義内flag2は既知の正規化。 |
34
+ | CadDocument.add_arc | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
35
+ | CadDocument.set_dimension_text | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
36
+ | CadDocument.place_block | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
37
+ | CadDocument.replace_entities_with_block | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
38
+ | CadDocument.set_block_layer_priority | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
39
+ | CadDocument.import_group | 直接計画対応 | CadDocumentの同名APIを呼ぶ。 |
40
+ | JwwDocument.set_layer_name | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
41
+ | JwwDocument.set_group_name | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
42
+ | JwwDocument.set_group_scale | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
43
+ | JwwDocument.add_line | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
44
+ | JwwDocument.add_rectangle_hatch | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。 |
45
+ | JwwDocument.add_circle | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
46
+ | JwwDocument.add_arc | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
47
+ | JwwDocument.add_point | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
48
+ | JwwDocument.add_text | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
49
+ | JwwDocument.add_dimension | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。 |
50
+ | JwwDocument.add_solid | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
51
+ | JwwDocument.add_block_definition | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。CadDocumentの同名操作は計画対応。 |
52
+ | JwwDocument.add_block | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。 |
53
+ | LegacyDocument.set_text | 別の保存経路:計画外 | 計画は既存CadDocumentを編集する。新規テンプレート/限定旧版のオブジェクトを直接操作しない。 |
54
+ | JwsDocument.place_as_block | place_jwsで計画対応 | JWSを依存ハッシュと全要素/定義のレビュー対象として配置する。 |
55
+
56
+ saveは宣言操作ではなくexecute_plan/save_checkedの最後に指定済み出力へ実行する。
57
+
58
+ open/from_*、検索/読取り/要約、Line等のモデル構築、rectangle_hatch_lines等の生成補助は既存図面の編集APIではない。
59
+
60
+ 計画の編集操作28種+GUI専用タグ1種。未知のAPI名を推測で追加しない。グループ/レイヤ/定義はschema2のresource_targetsに変更前の内容とSHA256を載せる。
61
+ 追加要素のasと、定義のasは別の型。place_block.def_numberには既存整数番号または先に宣言した定義別名を使う。既存定義の名称は番号・全内容とともにレビューする。
62
+ add_block_definitionの子指定はkwargs.entitiesの宣言構造かindicesの承認済み要素の片方。宣言のunitsは座標をローカル紙面mmへ換算する指定。既存要素からの定義作成は現在の紙面座標をコピーし、元要素を消さない。世界位置を保って置換する場合はreplace_entities_with_blockを使う。
63
+ 新しい計画はschema2。schema1の既存計画は従来の10編集操作/GUIタグだけ受け付け、新操作を追加してレビュー情報を省略することは拒否する。
64
+
65
+
66
+ 取り込み時の設定方針。import_groupのsettings_policyはstrictが既定、明示destinationだけ先の全体設定生バイトを保持して元の属性番号を取り込む。明示指定のschema2計画ではresource_targets.settingsに方針/両設定ハッシュ/比較列の差/見え方の説明を含める。未定義番号等の拒否は解除しない。旧計画のうち新引数を含まないものは従来のレビュー形式を維持する。
67
+
68
+
69
+ ## 検索条件付き計画
70
+
71
+ write_plan(..., selection=query, selection_limits=None)はschema3。indices=Noneで検索結果を確定し、明示indicesは完全一致が必要。元JSON/実効JSON/規則版/制限/解決値/対象とSHAを保持し、実行前に再検索・完全一致検証を行う。編集操作の許可表は変更しない。旧schema1/2も維持する。定義内の検索結果と不完全な結果は編集対象へ渡せない。詳細はsearch_queries.md。
72
+ ## 共通編集結果を使う計画
73
+
74
+ edit_result.write_edit_planは新しいschema5でCadDocument31メソッドに対応する。従来の直接未登録4名(delete_entity/move_entity/transform_entities/recalculate_text_endpoint)も、この契約内だけで許可する。既定のsafe_edit.write_planの許可表は広げず、旧計画1~4の意味を維持する。schema5の実行はexecute_plan_resultだけ。JwwDocument/LegacyDocument/JWS配置/GUIをこの追加の権限へ含めない。詳しくはdocs/edit_results.md。
75
+
@@ -0,0 +1,89 @@
1
+ # 不変の読取りビュー
2
+
3
+ `read_view.create_read_view` はCadDocumentの現在の公開要素・定義・ヘッダー・設定・診断を、参照を共有しない読取りスナップショットへ固定する。srcの既存入口・受理/拒否・保存処理を変えない。ezjwwは0.2.13の必須依存のまま。図面の編集や保存を行わない。
4
+
5
+ ## 利用例
6
+
7
+ この例は別名の結果JSONだけを新規作成する。図面に書き込まず、既存の出力は拒否する。
8
+
9
+ ```python
10
+ import json
11
+ from pathlib import Path
12
+ from jwwkit.read_view import create_read_view, resolve_file_reference
13
+
14
+ view = create_read_view('input.jww')
15
+ brief = view.entities(mode='summary')
16
+ detail = view.entities(limit=10)
17
+ reference = view.file_reference(0)
18
+ same_item = resolve_file_reference('input.jww', reference)
19
+ with Path('inspection.json').open('x', encoding='utf-8') as stream:
20
+ json.dump({'summary': brief, 'details': detail, 'reference': reference,
21
+ 'same_item': same_item}, stream, ensure_ascii=True, indent=2)
22
+ ```
23
+
24
+ CadDocumentを渡せば、未保存の編集も含めてその時点を固定する。元モデル・返却辞書を変更してもビューの値は変わらない。旧ビューは旧時点を読み続けるので、編集計画にはそのまま流さず、既存safe_editで原本/現在対象/計画SHAを再検証する。ビュー作成中に別スレッドからモデルを変更する使い方は対象外で、呼出し側で編集と同期する。
25
+
26
+ include_metadata/schema_profileのNoneは、パス入力ならFalse/strict、CadDocument入力なら読み込んだ状態を維持する。CadDocumentに矛盾する明示指定は拒否する。既定では従来同様、設定TEXTを通常要素から除外する。
27
+
28
+ ## API
29
+
30
+ - `create_read_view(source, *, include_metadata=None, schema_profile=None, max_snapshot_bytes=536870912, max_entities=1000000)`:パスまたはCadDocumentから作成。原ファイルの開始/終了時の同一性を確認。モデル内に不正層/群・重複元番号・不正/重複/未管理定義・非有限/非JSON値がある場合は拒否する。スナップショットの直列化バイト量上限は512MiB、公開要素数上限100万。実プロセスのRAM使用量上限を保証する値ではない。
31
+ - `view.entity(element_index, *, child_path=None)`:ビューの0始まり公開番号から1件取得する。子は後述の明示パスだけ。図形を描画/座標変換しない。
32
+ - `view.resolve(reference)`:同じview_idの参照だけ解決する。別ビューやfile参照への暗黙変換はしない。
33
+ - `view.entities(*, limit=100, mode='details')`:直下要素を保存/現在モデルの順で取得。limitは0~1000の整数。modeはdetails/count/summary。
34
+ - `view.summary()`:全直下要素数・kind別件数・保存群/層別件数・定義数・設定数を返す。limitによる先頭の要約ではない。
35
+ - `view.file_reference(element_index, *, child_path=None)`:同じファイルを再読込みし、現在モデルがファイルと一致する場合だけ状態を持たない参照を発行する。未変更の1要素でも、図面の他部分/群名/縮尺/版/定義等を編集していれば拒否する。新規未保存要素には発行しない。
36
+ - `resolve_file_reference(path, reference, *, schema_profile='strict')`:SHAを照合してから通常Readerで開き直して解決する。パスは参照内に含まず、呼出し側がローカルの場所を渡す。同一バイトの別名コピーにも使える。通常の読込み条件を回避しない。
37
+
38
+ view_idはそのセッションだけの識別、source_sha256は元ファイル全バイトのSHA、model_sha256は現在値/順序/版/定義/設定等を含むスナップショットの検査値。どれも図面間の同一要素を表すキーではない。version/entity_count/includes_metadataも読取り値として参照できる。返却された辞書やリストは変更しても内部に影響しない。
39
+
40
+ ### 件数制限と返却モード
41
+
42
+ `total`は全直下件数、`returned`は今回の詳細数、`truncated`はdetailsモードでlimitにより切り詰めたかを示す。count/summaryではitems=[]、details_omitted=Trueとし、意図した詳細省略を切詰めと混同しない。summaryはkind/群・層別等を全件で数える。
43
+
44
+ 制限は**件数**であり、結果JSONのバイト量や1文字列の長さの上限ではない。長い文字/複合レコードは切らずに返すため、詳細不要ならcount/summaryを使う。読取りビューは幾何を評価しないのでgeometry_evaluated=False。evaluation_complete=Trueは直下の列挙/数え上げが完了した意味で、形状判定完了ではない。
45
+
46
+ 今回cursor/offset/別プロセスのページ継続は実装していない(continuation_implemented=False)。同一ビュー内の特定番号はentityで取得できるが、これを永続IDや図面間対応へ流用しない。
47
+
48
+ ## 共通の項目名とzumenとの差
49
+
50
+ 参考を読んだのは、zumenの公開READMEとAPI説明のみ。実装コードは取得・転記・移植していない。依存も追加していない。[公開Python README/API説明](https://pypi.org/project/zumen/0.1.1/)、[プロジェクトREADME](https://github.com/zumenjs/zumen#readme)
51
+
52
+ |項目|このライブラリの読取りビュー|無理にそろえない点|
53
+ |---|---|---|
54
+ |kind|line/circle/arc/point/text/dimension/block_reference/solid/circle_solid等の分類|JWWの保存種別からの分類。特殊な楕円等の形状を判定済みとする意味ではない|
55
+ |bbox|status/value/reasonの共通欄。読取りビューはnot_requested/value=null|zumenの箱の座標配列そのものとは互換でない。[共通形状](geometry_view.md)が確定・未判定を返す|
56
+ |text|TEXTまたは寸法文字の原本文1件|行ごとの複数要素を連結せず、正規化もしない|
57
+ |properties|key/label/valueで保存属性の表示を列挙|現時点は番号等の表示。全CAD共通のスタイル解決や印刷時の色を表さない|
58
+ |values|整形していない現在の保存単位の値。start/end/center等とattributes/fieldsを保持|読取りビューでは紙面mm/ローカル紙面mmの原座標、角度は原規則のまま。実寸や配置後のworld座標へ黙って換算しない|
59
+ |placement|根の群/縮尺、子の経路、保存された参照の位置・倍率・回転等|geometry_transform_applied=False。読取りビューは配置の情報だけで、共通形状の座標合成を実行しない|
60
+
61
+ 値の3層はstorage/semantic/displayで区別する。storage.persisted_recordは保存済みの復号レコード、pending_recordはそれと異なる現在値(新規はpersisted_record=null)。原CStringバイトそのものの公開や幾何の実寸換算は読取りビューでは行わない。semanticはkind/placementまで、displayは人に見せるpropertiesまで。semanticの形状や文字種の完全解決を実装済みと呼ばない。負の0と正の0の保存表現差もpendingとして残す。
62
+
63
+ 定義内の値はローカル紙面mm、寸法子は保存欄をそのまま返す。親の倍率等を適用した点とは区別する。元の保存フラグに推測の意味を付けたり、未確認表現を読み飛ばしたりしない。
64
+
65
+ ## 2種類の参照
66
+
67
+ ### ビュー内参照
68
+
69
+ `{reference_schema:1, scope:"view", view_id, element_index, child_path}`。element_indexはこのビューの現在の公開番号。元モデルを編集しても旧ビューは旧値で解決する。他のview_idには渡せない。
70
+
71
+ ### 状態を持たないファイル参照
72
+
73
+ `{reference_schema:1, scope:"file", source_sha256, numbering:"stored_root_record_0", element_index, child_path, schema_profile}`。
74
+
75
+ element_indexは**保存根レコードの0始まり番号**。設定TEXTの除外前の番号なので、公開番号やzumenのidと同じとは限らない。include_metadata=True/Falseの違いで参照先を変えない。付加欄は参照プロトコル/番号の意味/Reader条件を固定するためで、図面間IDを追加するものではない。
76
+
77
+ SHAが違えば**解析前に拒否**する。版を書き換えたもの、再保存/編集でバイトが変わったものに流用しない。変更後の図面を新しいSHAで読む場合は、別の参照として取り直す。schema0は参照に書いてあるだけでは自動許可せず、解決側でもschema_profile="rebro_schema0"の明示一致が必要。
78
+
79
+ 参照は署名/承認ではない。有効な番号へ書き換えれば別の対象の指定になる。編集計画の承認をこの参照だけで代替しない。内容ハッシュや番号から、別図面に同じ要素があると推測しない。
80
+
81
+ ### 子の経路
82
+
83
+ - 寸法:`["line"]`、`["text"]`、`["aux_lines",0]`~1、`["aux_points",0]`~3。
84
+ - ブロック参照:`["definition",子番号]`。入れ子は同じ組を続ける。定義番号はファイル内の参照関係から引き、外から勝手な別定義番号を指定させない。
85
+ - 組合せ例:`["definition",0,"text"]`。
86
+
87
+ 任意の属性名/eval/getattrは使わない。型・要素種別・範囲・最大128トークン・欠落/重複定義・循環/深さ64を検査する。子を展開して図面要素数へ加算しない。persisted_recordは元ファイルの同じ経路の値であって、編集で子の順が変わった場合の同一性を保証する対応表ではない(origin_relationに明記)。
88
+
89
+ 設計の背景は[ページ継続の検討](https://github.com/tetsuo-m/jwwkit/blob/main/docs/design/read_view_continuation.md)を参照してください。
@@ -0,0 +1,100 @@
1
+ # 読取り・形状・検索から承認付き編集へ
2
+
3
+ この例は、指定群のAW文字を確認して一括移動する依頼を扱う。文字の揺れを許す検索、同じ不変ビューでの形状と距離の確認、原本を開き直した承認計画、保存後の共通結果を順につなぐ。ローカルの `input.jww` 等を差し替えて使う。
4
+
5
+ AIは、利用者から頼まれた作業に必要な範囲で図面を読んでよい。図面の文字・形状・画像・名前・パスと、図面から作った計画、結果、集計、画面画像は、同じ作業の会話内で扱う。利用者が明示的に指示した場合を除き、これらをウェブ検索の語句に使ったり、外部サイト・API・他サービスや第三者へ送ったり、公開リポジトリやIssueに載せたりしない。会話では件数や要約を優先し、全文の一覧などは利用者に求められたときだけ示す。計画・結果ファイルにも図面の内容が含まれるため、図面と同じ扱いでローカルに保管する。
6
+
7
+ |段階|使う入口|次の段階へ進む前の確認|
8
+ |---|---|---|
9
+ |開く|CadDocument.open|通常strict。レブロschema0は先に別承認で正規化する|
10
+ |値を固定する|create_read_view|保存値/現在値・意味・表示を区別。同じビューの番号を使う|
11
+ |形を調べる|entity_geometry / geometry_page|文字枠と字形を区別し、status/未判定理由を残す|
12
+ |位置を確かめる|at_point / nearest|範囲・単位・明示許容、completeと同距離の全候補を確認|
13
+ |文字を探す|CadDocument.search_entities|表記揺れはnormalizationを明示。保存本文は変更しない|
14
+ |変更を計画する|write_edit_plan|原本を開き直し、同じJSON条件をselectionに固定。全対象とSHAをチャットへ示す|
15
+ |承認後に実行する|execute_plan_result|承認したSHAだけを渡す。保存/読戻し後のphase/counts/資源差を報告|
16
+
17
+ 位置検索は、この例では文字の配置を確かめるために使う。編集対象は同じ群のAW文字全件であり、最近の1件へ勝手に絞らない。位置による選択を編集条件に加えるときは、対象と根拠を別途計画で示す。旧ビューの参照を直接編集指示として使わない。
18
+
19
+ ```python
20
+ from jwwkit import CadDocument
21
+ from jwwkit.read_view import create_read_view
22
+ from jwwkit.geometry_view import geometry_page
23
+ from jwwkit.spatial_search import nearest
24
+ from jwwkit.edit_result import write_edit_plan, execute_plan_result
25
+
26
+ def aw_condition(group):
27
+ return {'all': [
28
+ {'field': 'layer_group', 'in': [group]},
29
+ {'field': 'entity_type', 'in': ['TEXT']},
30
+ {'field': 'text', 'match': 'prefix', 'value': 'aw-',
31
+ 'normalization': {'width': True, 'case': 'unicode_casefold',
32
+ 'spaces': 'ignore_listed', 'hyphens': 'dash_only'}},
33
+ ]}
34
+
35
+ def inspect_local(source, point_real, *, group, tie_tolerance, detail_limit=20):
36
+ cad = CadDocument.open(source)
37
+ view = create_read_view(cad)
38
+ query = aw_condition(group)
39
+ text_matches = cad.search_entities(query)
40
+ return {
41
+ 'source_sha256': view.source_sha256,
42
+ 'summary': view.summary(),
43
+ 'details': view.entities(limit=detail_limit),
44
+ 'geometry': geometry_page(view, mode='summary', fields=['bbox'],
45
+ units='real', text_mode='frame'),
46
+ 'closest': nearest(view, point_real, query=query, units='real',
47
+ text_mode='frame', tie_tolerance=tie_tolerance,
48
+ limit=detail_limit),
49
+ 'text_condition': query,
50
+ 'text_match_count': text_matches['match_count'],
51
+ 'text_search_complete': text_matches['complete'],
52
+ }
53
+
54
+ def prepare_change(source, output, plan_path, *, group, delta_real_mm):
55
+ cad = CadDocument.open(source) # 旧ビューではなく原本を再確認
56
+ query = aw_condition(group)
57
+ matches = cad.search_entities(query)
58
+ if not matches['complete']:
59
+ raise ValueError('文字検索が未完了です。計画を作らず理由を報告してください')
60
+ indices = [hit['index'] for hit in matches['hits']]
61
+ if not indices:
62
+ raise ValueError('対象0件です。条件を確認してください')
63
+ actions = [{'op': 'move_entities', 'indices': indices,
64
+ 'kwargs': {'delta': list(delta_real_mm), 'units': 'real'}}]
65
+ return write_edit_plan(cad, indices, actions, output, plan_path,
66
+ selection=query)
67
+
68
+ def run_approved_change(plan_path, approved_hash):
69
+ return execute_plan_result(plan_path, approved_sha256=approved_hash)
70
+ ```
71
+
72
+ inspect_localは読取りだけ。detail_limitはビュー詳細と位置候補それぞれの上限で、形状summaryは全ルートを評価する。文字検索の対象はこの例ではTEXTだけ。寸法内文字も対象にする場合はentity_typeの範囲を依頼に合わせて変え、条件そのものをレビューする。
73
+
74
+ prepare_changeは計画と見込みだけを返す。plan.path/sha256、全対象、移動量、単位、queryと採用した表記揺れの規則をチャットで示して承認を得る。run_approved_changeはその承認後の別の呼出しにする。結果のstatusがapplied/unchangedかつphase=verifiedかを確認し、countsのadded/modified/deleted、resource_counts、warnings/rejectionsを報告する。メモリ段階やprojected_countsを保存済みの結果と呼ばない。EditExecutionErrorでは.resultの保存済み/残存物も報告して停止する。
75
+
76
+ ## 文字枠の数値誤差と未判定
77
+
78
+ 文字枠は保存された始点・終点・高さ・角度から決まる論理枠で、字形の輪郭ではない。通常文字の終点比較は、紙面の文字長Lと座標桁Mに対するmax(64×ulp(M), 1e-9×L)という数値丸めのガードを使う。実寸に換算したガードが1e-4mm以上なら未判定とし、上限への切詰めや元終点の補正はしない。図面の寸法許容や位置検索のtoleranceへ転用しない。検証済み文字249件の丸め差を解消し、従来の確定を保ち、0.01mmの実際の差は拒否する試験済み。特殊flag/保存線幅/未確認字体等の未判定条件はそのまま。
79
+
80
+ nearestのtext_mode='frame'は文字枠への距離。字形への距離を求めた結果として説明しない。未知候補が残るとき、confirmed/provisional/unresolvedを区別し、未判定を無視して全体の最近要素を確定しない。大図面は種類・群・レイヤで対象範囲を絞る。
81
+
82
+ ## 表記揺れは検索時の明示指定
83
+
84
+ 既定は原文どおり区別する。幅、大文字小文字、空白、ハイフンの同一視は承認済みの[対応表](text_equivalence.md)を指定した場合だけ。長音「ー」まで同一視するのは別の明示オプションで、上例のdash_onlyには含めない。保存本文や文字位置を変更する機能ではない。既存width_fold/ignore_caseとnormalizationを重ねて指定したり、任意の文字を推測で同一視したりしない。
85
+
86
+ ## 詳細の上限、件数、要約の使い分け
87
+
88
+ |対象|詳細上限|件数だけ/要約|未完了・切詰めの判断|
89
+ |---|---|---|---|
90
+ |ReadView.entities|limit既定100、最大1000|mode=count/summary|total/returned/truncatedとdetails_omitted。列挙完了は形状確定ではない|
91
+ |geometry_page|limit既定100、最大1000|countは幾何計算なし、summaryは全ルート評価|evaluation_completeとdetermination_completeを分ける。時間切れと未判定も別|
92
+ |位置検索|各候補一覧にlimit既定100、最大1000|mode=count/summary|complete、confirmed/provisional/unresolvedとtruncatedを別に見る|
93
+ |共通編集結果|limit既定100、最大1000、1詳細一覧最大1MiB|mode=count/summary|全対象の件数と詳細省略を分離。summary/countでも拒否理由を報告|
94
+ |JSON条件検索|total_seconds/regex_secondsと条件構造の制限(詳細件数limitなし)|上例ではmatch_countだけ返す|complete=falseや未完了の対象を編集へ流さない。limitを持つ他APIと混同しない|
95
+
96
+ 文字検索は完了したヒットを全件返し、limit/countモードは持たない。上例は表示する値をmatch_countに絞ったもので、検索自体の件数計算を省略しない。
97
+
98
+ 件数上限を指定しても入力ファイルの読込みや全件の監査を省略するとは限らない。大きい結果はまずcount/summary、次に必要な範囲のdetailsを読む。承認計画の対象一覧は切り捨てない。実時間/RAM/JSONの一律上限や、API間で共有されるページ番号は提供しない。
99
+
100
+ 別プロセスの続き取得やcursorは追加していない。SHA+保存番号+子経路のファイル参照は同一SHAのファイルを引き直すためだけで、編集/版の変更や図面間の対応付けには使わない。
@@ -0,0 +1,64 @@
1
+ # レブロ出力の明示的なスキーマ正規化
2
+
3
+ 対象は、観測済みv600/v700のCDataSen・CDataEnko・CDataMojiだけを持ち、全クラス宣言のschemaが0の図面。版を変えずschemaのWORDだけを600/700へ変更する。メモ・パレット・SXF名・状態記録・図形を補完しない。短い線の欠落など、元の書出しで失われたデータは戻らない。パレットは元の値を保持し、Jw_cadで保存し直した場合の環境パレット/メモ/SXF名/状態記録へ合わせない。元DXFの正しい色を復元したり、異なるPCで同じ見え方を保証したりする正規化ではない。
4
+
5
+ 通常のCadDocument.openは設定を読まない。既定strict、schema_profile="rebro_schema0"の読取り/無編集保存専用の制限も従来どおり。通常の編集を行うには、以下の別名正規化を承認・実行した後、その出力をstrictで開く。既存の全要素/属性/版等の拒否条件は維持する。
6
+
7
+ 作業フォルダのjww_workflow.tomlをUTF-8で明示的に読み込む。schema_version=2とし、[opening]のrebro_schema0を"reject"(既定)または"normalize"とする。careful/quickは正規化を有効にしない。チャットの指示>ファイル>reject。設定は許可を代替しない。
8
+
9
+ 設定ファイルの例(作業フォルダ直下のjww_workflow.toml):
10
+
11
+ ```toml
12
+ schema_version = 2
13
+ [opening]
14
+ rebro_schema0 = "normalize"
15
+ ```
16
+
17
+ 次の手順例は関数を定義するだけで、勝手に正規化しない。prepare_normalizationの戻り値のplan全体、対象/不要の一覧、各SHA、変更宣言のoffset/before/after、出力先とplan_sha256をチャットで示して承認を得てから、run_normalization_approvedを別に呼ぶ。
18
+
19
+ ```python
20
+ from pathlib import Path
21
+ from jwwkit import CadDocument
22
+ from jwwkit.workflow_settings import load_workflow_settings, resolve_opening_settings
23
+ from jwwkit.normalization import (inspect_schema_normalization, write_schema_normalization_plan,
24
+ execute_schema_normalization_plan, normalization_edit_dependencies)
25
+ from jwwkit.safe_edit import write_plan
26
+
27
+ def prepare_normalization(work_dir, sources, output_dir, plan_path,
28
+ instruction_overrides=None, instruction_evidence=None):
29
+ settings = resolve_opening_settings(
30
+ load_workflow_settings(work_dir), instruction_overrides=instruction_overrides,
31
+ instruction_evidence=instruction_evidence)
32
+ return write_schema_normalization_plan(
33
+ list(sources), output_dir, plan_path, opening_settings=settings)
34
+
35
+ def run_normalization_approved(plan_path, approved_hash):
36
+ return execute_schema_normalization_plan(plan_path, approved_sha256=approved_hash)
37
+
38
+ def prepare_separate_edit(result_path, normalized_source, output, plan_path,
39
+ indices, delta_real_mm):
40
+ dependencies = normalization_edit_dependencies(result_path, normalized_source)
41
+ cad = CadDocument.open(normalized_source) # 設定を読まず、通常のstrict
42
+ actions = [{'op': 'move_entities', 'indices': list(indices),
43
+ 'kwargs': {'delta': list(delta_real_mm), 'units': 'real'}}]
44
+ return write_plan(cad, list(indices), actions, output, plan_path,
45
+ dependencies=dependencies)
46
+ ```
47
+
48
+ ## 計画・実行の契約
49
+
50
+ - 正規化専用schema_version=6、kind=jww_schema_normalization、normalization_rule_version=1。safe_editの業務編集schema2~5とは別。approved_sha256は利用者が承認した計画ファイルのSHA256。計画の作成だけではJWWを出力しない。
51
+ - entriesは順序付き。status=normalizeが対象、status=not_neededは「正規化不要・出力なし」、output_name=null。標準図面も全体読込みと無編集バイト一致を確認してから不要と判定する。未知/壊れた非0スキーマを標準扱いしない。対象と不要の両方の原本SHA・判定・宣言を固定する。
52
+ - 不要の図面を含んでも残りを処理できる。全件不要ならnothing_to_normalize、JWW/出力フォルダは作らず実行記録だけ新規保存。不要ファイルをコピーしない。実行時に対象/不要を再分類して計画を書き換えない。SHA/判定の差は再計画・再承認。
53
+ - failure_policyはall_or_nothingだけ。対象外/検証失敗が1件でもあれば全件中止。一時領域で全対象を準備し、strict読込み・無編集保存のバイト一致・元との全要素欄/非schemaバイト一致を検証する。全入力を再確認して、新規1フォルダへまとめて確定する。
54
+ - Windowsの同一親フォルダ間の置換しない移動を使用する。既存の出力先・計画・実行記録・準備領域は拒否。親フォルダは事前に用意する。リンク/再解析ポイント・入力重複・出力名衝突も拒否。初版の確定処理はWindows専用。
55
+ - 成功フォルダには対象JWWと_normalization_manifest.jsonだけを入れる。manifestは全入力/不要一覧・宣言変更・各SHA・設定snapshot/計画SHAを持つ。外側の計画名.normalization-result.jsonに完了状態を記録する。実行時には設定ファイルを読み直さず、承認した原文/実効値/出所/SHAを使用する。
56
+ - NormalizationPlanError.diagnosticsは検査した全入力の理由。未知クラスでは検出済みの名前・schema・offsetを返す。先を走査して補完せず、enumeration_complete=falseと停止offset/未検査バイト数を表示する。検出一覧を全クラス一覧と呼ばない。
57
+ - NormalizationExecutionError.resultには失敗理由、published/verified、残存ファイルのパス/SHAがある。確定前の失敗では最終フォルダを公開せず、一時領域を証拠として残す。確定後の再検査/実行記録保存が失敗した場合は、出力済みである事実を報告して停止する。停電や他プロセスの競合まで戻せる仕組みではない。失敗後、残った出力を無条件で業務編集へ流さない。
58
+ - 1計画は最大256入力、1入力256MiB、合計512MiB、JSON8MiB。上限を超えた計画は分割して別に承認を得る。成功分だけの部分出力は未対応。
59
+
60
+ ## その後の業務編集
61
+
62
+ prepare_separate_editは、成功した正規化計画/実行記録/manifest/全原本を検証して別の編集計画の依存SHAにする。新しい編集対象・変更内容・編集計画SHAを示して**別に承認**を得る。正規化の承認を編集やGUIの承認として使わない。現在の設定による再正規化や由来の自動生成は行わない。正規化不要の図面は元の標準図面を通常のstrictで扱う。
63
+
64
+ 実サンプルでは、Rebro 2026 Rev.6 build0918.1310のv600/v700各1件(632図形)で、承認後の正規化と通常strict読込み/無編集保存の全バイト一致を確認した。別の承認済み編集計画で、既存線の層変更/層名変更、LINE/TEXT/SOLID追加後635件の全属性・非対象631件/他設定不変・CDataSolid含む全宣言が600/700で0混在なしを確認済み。この版/試料での観測を他の形式へ一般化しない。派生物は配布しない。GUI確認は未実施で別依頼まで保留。v6→Jw_cad10.03.7再保存は版700になっているため、v600のschemaだけ600にする直接の正解にはしない。利用者のJw_cad環境に由来する値を推測で生成しない。
@@ -0,0 +1,95 @@
1
+ # 条件を組み合わせて図面を検索する
2
+
3
+ 検索は読取りのみ。既存の `find_entities(entity_type="LINE", layer=3)` はそのまま使える。戻り値は現在の公開要素番号のtupleであり、削除等で番号が変わった後に使い回さない。非表示要素も既定で含む。
4
+
5
+ 次のコードは、任意の入力ファイル名を受け取る実行例である。文字・図形の内容をガイドへ転記する必要はない。`inspect_drawing`は検索だけ、`plan_search_move`は計画JSONを作って終了する。計画の内容とSHAを利用者にチャットで示し、承認を得るまで`execute_plan`を呼ばない。
6
+
7
+ ```python
8
+ from jwwkit import CadDocument
9
+ from jwwkit.safe_edit import write_plan
10
+
11
+ LONG_SHAPES = {"all": [
12
+ {"field": "layer_group", "in": [0]},
13
+ {"field": "layer", "in": [3, 5]},
14
+ {"field": "entity_type", "in": ["LINE", "ARC"]},
15
+ {"field": "length", "min": 1000, "units": "real"}
16
+ ]}
17
+
18
+ def inspect_drawing(source):
19
+ cad = CadDocument.open(source)
20
+ return {
21
+ "long_shapes": cad.find_entities(query=LONG_SHAPES),
22
+ "aw_texts": cad.find_entities(query={
23
+ "field": "text", "match": "prefix", "value": "AW-"}),
24
+ "marked_lines": cad.find_entities(query={"all": [
25
+ {"field": "entity_type", "in": ["LINE"]},
26
+ {"field": "flag_bits", "mask": 4096, "mode": "all_set"}]}),
27
+ "horizontal_lines": cad.find_entities(query={
28
+ "field": "line_angle", "min": 0, "max": 0,
29
+ "units": "deg", "tolerance": 0.1}),
30
+ "displayed_elements": cad.find_entities(query={"all": [
31
+ {"field": "group_state", "in": ["display_only", "editable", "writing"]},
32
+ {"field": "layer_state", "in": ["display_only", "editable", "writing"]}]})
33
+ }
34
+
35
+ def plan_search_move(source, output, plan_path):
36
+ cad = CadDocument.open(source)
37
+ indices = cad.find_entities(query=LONG_SHAPES)
38
+ if not indices:
39
+ raise ValueError("対象が0件です。計画を作らず条件を確認してください")
40
+ actions = [{"op": "move_entities", "indices": list(indices),
41
+ "kwargs": {"delta": [10, 0], "units": "real"}}]
42
+ return write_plan(cad, None, actions, output, plan_path, selection=LONG_SHAPES)
43
+ ```
44
+
45
+ 関数を読み込んだ後、`inspect_drawing("input.jww")`で一覧を確認する。計画は`plan_search_move("input.jww", "new_output.jww", "review.plan.json")`で作る。保存後の確認は、既存の`execute_plan`の実行記録と`new_output.changes.json`を使う。これらの呼出し・保存読戻しもテストと配布版の単独点検で実行している。実図面の編集は、実際の対象一覧・出力先・計画SHAの承認後に限る。
46
+
47
+ ## 条件の書き方
48
+
49
+ - 一覧内のOR:`entity_type=["LINE","ARC"]`、`layer=[3,5]`等。群・層・種類・色・線種・保存ブロック名を一覧にできる。引数同士はAND、queryとの併用もAND。
50
+ - JSON:`{"all":[条件,条件]}`、`{"any":[条件,条件]}`、`{"not":条件}`を入れ子にする。空all/any/値一覧、不明キー、不明種類、NaN/Infinity、JSON文字列の重複キーは拒否する。Python式・eval・コールバックは使わない。
51
+ - 詳細結果:`cad.search_entities(query)`でinput_query/effective_query、hits、未判定理由、complete、規則版、実効制限を取得する。find_entitiesは未判定が残れば例外にする。適用外はNOTで一致へ反転しない。未判定が他条件の真偽に影響しなければ、ANDの不一致やORの一致は確定できる。
52
+
53
+ | field | 指定と範囲 |
54
+ |---|---|
55
+ | entity_type / layer_group / layer | `in`で種類/群0~15/層0~15。別の保存属性groupと混同しない |
56
+ | color / linetype | `in`に保存番号または完全一致SXF名。未定義・重複名は拒否。色番号は見かけのRGBではない |
57
+ | block_name | `in`と`name_kind:"stored"`または`"display"`。既定stored。既知の末尾印1~4だけを除去し、未知印はそのまま |
58
+ | text | `match:"contains"/"prefix"/"exact"/"regex"`とvalue。TEXTとDIMENSION内包文字を検索 |
59
+ | length / radius | min/maxと`units:"real"/"paper"`を必須指定。範囲は両端を含む |
60
+ | text_width / text_height | min/maxと`units:"paper"`。`basis:"effective"`既定、または`"stored"` |
61
+ | pen_width | min/maxと`units:"stored"`。保存欄の数値であり、有効印刷幅やmmには換算しない |
62
+ | rect | bounds:[xmin,ymin,xmax,ymax]、units:real/paper、mode:anchor/intersects/contained |
63
+ | flag_bits | mask:1~65535の整数、mode:all_set/all_clear。指定マスクの全ビットが立つ/全ビットが立たない条件 |
64
+ | line_angle | min/max、units:deg/rad、toleranceをすべて必須指定。0をまたぐ範囲だけwrap:true |
65
+ | group_state / layer_state | `in`に0/1/2/3またはhidden/display_only/editable/writing。保存状態を別々に比較 |
66
+
67
+ 長さはLINEの線分長、真円CIRCLEの周長、真円ARCの弧長。radiusは真円CIRCLE/ARC。実寸は紙面値×要素の群縮尺で換算する。楕円の弧長・単一半径、未確認角度や退化円は未判定にし、円ソリッドへ自動拡張しない。寸法表示値をlengthと解釈しない。
68
+
69
+ 文字の幅・高さは文字枠で、文字列の外形ではない。effectiveは文字種0の本文欄、文字種1~10の図面保存プリセットを使う。storedは本文欄を直接比較する。DIMENSIONも内包TEXTを同じ規則で読む。環境/JWFの未確定優先や字体の実外形は推測しない。linetypeは確認済みの線/円/円弧/ソリッド/寸法だけ。TEXTの基準位置・POINTの記号種・円ソリッドの塗りモードを線種とみなさない。
70
+
71
+ ## 追加3条件の意味
72
+
73
+ flag_bitsは要素の外側の保存flagを、そのままuint16として読む。4096はJSONでの0x1000の表記。LINEの0x1000を建具候補に使う場合も、上例のようにLINE条件と組み合わせる。他種の同じビットを「建具」と名付けない。寸法内包のflagを勝手に集約しない。複数ビットの「どれか」は各ビットの条件をanyで組む。
74
+
75
+ line_angleは図面の実寸座標の+X軸を0度、+Y側へ反時計回り。正の等方群縮尺なので紙面から実寸への換算で方向は変わらない。端点を逆にした線も同じ向きとして0度以上180度未満(ラジアンは0以上π未満)へ折り返す。水平はmin=max=0、垂直はmin=max=90。toleranceも指定した角度単位で、0~90度相当を明示する。例の0.1度は単なる例で、APIの既定値ではない。min=175,max=5のような0度またぎはwrap:trueが必要。許容は指定した閉区間の両端からの最短角距離で広げる。ゼロ長線・非有限座標は未判定。円弧や寸法主線をLINEに見立てない。定義内では配置前のローカル軸に対する角度となる。
76
+
77
+ group_stateとlayer_stateは保存値を独立に比較する。群がhiddenでも、層自身はwritingの場合がある。実際に表示される状態を選ぶには上例のように群・層の両方からhiddenを除く。writing層はその群内の選択であり、群もwritingでなければ図面全体の現在書込み先とは限らない。保護設定を含めた編集許可を保証する検索ではない。
78
+
79
+ ## 文字と正規表現
80
+
81
+ 全角半角・大小は既定で区別し、width_fold:true/ignore_case:trueを明示した場合だけ同一視する。幅変換は全角ASCII/空白と半角カナの限定対応で、①を1にしない。通常検索の大小無視はcasefold、regexはre.IGNORECASE。元の文字は変更しない。
82
+
83
+ regexはre.searchとしてローカル子プロセスでコンパイル・一括照合する。inline flagsは拒否する。幅変換を使う場合もパターン自体は書き換えず、変換後の文字に対して利用者が書く。全角の記号を勝手にメタ文字へ変えない。
84
+
85
+ 既定のregex_secondsは5、total_secondsは30。`limits={"regex_seconds":2,"total_seconds":10}`等で明示でき、正の値~30秒に限定する。子プロセスは起動込みの上限を超えれば終了・回収し、検索全体を失敗にする。部分結果は返さず、計画にも使わない。条件128ノード/深さ16、一覧1葉1024値/全体8192値、regex8個/各512文字、対象1文字列16384文字、regex合計800万文字を上限とし、超過時は切り詰めず拒否する。クエリの構造/文字量にも上限がある。
86
+
87
+ ## 定義内と承認計画
88
+
89
+ scopeはdrawing既定。definitionsまたはdrawing_and_definitionsを明示すれば、未参照を含む各保存定義を1回ずつ検索する。結果はdefinition_numberとentity_pathで直下indexと区別する。定義内BLOCKは保存された参照として扱い、再帰的な世界座標展開は行わない。寸法内包は別hitにしない。
90
+
91
+ 定義内は保存属性・ローカル紙面mmで、配置倍率やレイヤ優先を適用した見かけの属性ではない。定義を含む検索でreal単位を指定したら事前拒否する。定義内の編集対象をsafe_editへ渡すことはできない。
92
+
93
+ selection付きwrite_planはschema3になる。元JSON・実効JSON・規則/Unicode/regex版・時間と固定制限・名前の解決先・確定番号/元番号・各SHAを保存する。実行前に原本SHAと全対象を確かめ、同じ条件を再検索して完全一致しなければ停止する。編集後に再検索して対象を増やさず、既存の元番号追跡で処理する。schema1/2の旧計画はそのまま使える。queryを伴わない従来の計画はschema2のまま。
94
+
95
+ 21万要素級では、読込み、検索、結果JSON、計画作成の時間を分けて判断する。設計時の見込みと実装後の実測は別物であり、条件数・文字量・PCによって変わる。検索自体のためにJw_cadを起動する必要はない。
@@ -0,0 +1,77 @@
1
+ # 位置からの検索
2
+
3
+ 不変のReadViewに対して `spatial_search.at_point` と `nearest` を使う。元図面や元モデルを編集しない。返す参照はそのビュー内だけの場所であり、図面間の対応キー・永続IDや編集承認ではない。
4
+
5
+ 大きな図面では、種類・群・レイヤなどをqueryで絞り込んでから検索する。全体を検索すると未判定の文字・楕円等も対象に入り、走査を完了しても全体の最近要素や同距離候補を確定できないことがある。completeとunresolvedを必ず確認し、provisional_hitsを確定結果として使わない。絞込みは検索の対象範囲を変えるもので、対象外を含む図面全体の最近要素を証明するものではない。
6
+
7
+ ## 実行例
8
+
9
+ 次のコード全体を合成図面で実行するテストに登録している。input.jwwは任意のローカル入力へ置き換え、点と許容値は依頼に合わせて**毎回明示**する。以下の数字は業務図面へ自動適用する既定値ではない。
10
+
11
+ ```python
12
+ import json
13
+ from jwwkit.read_view import create_read_view
14
+ from jwwkit.spatial_search import at_point, nearest
15
+
16
+ view = create_read_view('input.jww')
17
+ scope = {'field': 'entity_type', 'in': ['LINE', 'CIRCLE', 'ARC', 'POINT']}
18
+ on_point = at_point(view, [1000, 2000], tolerance=0.5,
19
+ units='real', query=scope, limit=50)
20
+ closest = nearest(view, [1000, 2000], tie_tolerance=0.001,
21
+ units='real', query=scope, limit=50)
22
+ with_text_frames = nearest(view, [1000, 2000], tie_tolerance=0,
23
+ units='real', text_mode='frame', mode='summary')
24
+ anchors = nearest(view, [1000, 2000], tie_tolerance=0,
25
+ units='real', target='anchors', mode='count')
26
+ with open('spatial_inspection.json', 'x', encoding='utf-8') as stream:
27
+ json.dump(dict(on_point=on_point, closest=closest,
28
+ with_text_frames=with_text_frames, anchors=anchors),
29
+ stream, ensure_ascii=False, indent=2, allow_nan=False)
30
+ ```
31
+
32
+ ## 距離と対象範囲
33
+
34
+ - units=real(既定)は実寸mm、paperは紙面mm。点、tolerance、tie_tolerance、max_distanceと返す距離は同じunits。ルートの群縮尺とブロック配置を共通形状と同じように適用する。
35
+ - at_pointは距離が明示したtolerance以下の全ルート。nearestは全対象の最小距離d_minに対して `distance <= d_min + tie_tolerance` の全候補。同距離候補を1件に絞らず、距離と公開番号の順で返す。許容内の候補同士を連鎖させて集合を広げない。どちらの許容も必須・有限・非負で、自動の図面用許容値はない。
36
+ - max_distanceを明示するとnearestの返却候補をその距離以下にも限定する。全対象での最小距離そのものはこの指定で書き換えない。max_distance内にない場合は空になる。
37
+ - LINEは有限線分(ゼロ長なら点)、POINTは幾何点、真円/円弧は曲線への解析的距離。円の中心やbboxへの距離で代用しない。破線の隙間、線幅、印刷状態のピクセル選択を再現するものではない。
38
+ - SOLIDは塗り領域、確認済み円板/弓形/円環も塗り領域の内部なら0。円環の穴は塗りではない。円弧は負の掃引・0度またぎ・傾き・反転と端点を考慮する。
39
+ - 現在の直下ルートを検索する。寸法/ブロックの部品が複数当たっても親は1候補、当たったchild_pathをmatched_partsに載せる。同じ定義の別配置は別候補。配置先のない定義単体の世界座標検索は公開しない。新しい入れ子の編集が許可される意味でもない。
40
+ - 非表示の群・層も既定で対象。queryに既存のJSON条件(群/層/状態/種類/保存flag/色・線種/文字/ブロック名等)を渡して限定できる。条件は直下ルートの保存属性を評価し、子のレイヤ等へ自動で条件を広げない。定義内の保存属性と配置先の有効属性は混同しない。
41
+
42
+ queryは既存の検索規則・正規表現の制限と時間切れ防御を使い、不変ビューの値から選ぶ。SXF名照合に必要な原ヘッダーバイトもビューへ凍結し、元ファイルがその後なくなっても読み直さない。text_width/height等の文字種解決も凍結した宣言を使う。basis=persistedなら元の値/設定から検索し、現在の新規ルートに保存時の値がなければ条件も未判定とする。削除済みルートの復元は行わない。
43
+
44
+ ## 文字と未判定
45
+
46
+ 既定のtarget=shape / text_mode=glyphでは、文字の字形への距離は未判定。text_mode=frameを明示すると、共通形状が確定できる通常文字の**論理文字枠の領域**への距離を使う。枠内は0で、distance_kind=text_frame_distanceとする。字形への距離ではない。複合要素はcomposite_shape_and_text_frame_distance等で区別する。
47
+
48
+ 特殊/flag付き文字、保存線幅欄非0、終点不一致、文字制御、縦書き等、共通形状で枠が未判定になるものはそのまま未判定。フラグ付き文字にも、共通形状と同じ判定条件を適用する。楕円、未知属性/欠落/循環/上限の構造も推測しない。
49
+
50
+ target=anchorsを明示した場合だけ、保存された代表の基点1つへのanchor_distanceを使う。文字/線は始点、円・円弧・円ソリッドは中心、点は位置、ブロックは挿入点、寸法は有効線の始点、ソリッドは保存頂点1。これは形の最近点でも字形距離でもなく、未判定の形の代用品として自動使用しない。
51
+
52
+ ## 結果の読み方
53
+
54
+ |欄|意味|
55
+ |---|---|
56
+ |confirmed_hits|条件と距離が確定し、今回の検索の一致が証明できた候補|
57
+ |provisional_hits|距離自体は既知でも、未知候補の影響で図面全体の最近とはまだ証明できない候補(nearest)|
58
+ |unresolved|距離やqueryでの対象資格が未判定の候補。理由と距離の下限/上限を残す|
59
+ |known_min_distance|確定した距離だけの最小値。全体最小とは限らない|
60
+ |minimum_distance|全対象の最小の確定値、または未判定と上下限。空範囲はempty|
61
+ |evaluation_complete / examined_count|選ばれた全ルートの距離を評価し終えたか/評価数|
62
+ |query_complete / selection_unresolved_count|対象資格に未判定が残っていないか/その数|
63
+ |complete|走査を完了し、対象資格・距離・部品詳細の未判定が残らないこと|
64
+ |total_hit_count|complete=Trueのときだけ全一致数。不完全時はnull|
65
+ |confirmed_hit_count / provisional_hit_count / unresolved_count|詳細を制限しても、評価済み範囲の各分類の件数|
66
+
67
+ 例えば点まで10mmの線と、距離不明の楕円がある場合、線だけを全体最近と確定しない。既知最小10mm、全体の下限0/上限10mm、線はprovisional_hits、楕円はunresolvedとなる。
68
+
69
+ 複合要素の一部だけ既知の場合、その部品への距離は全体距離の上限であり、確定距離へ昇格しない。既知部品まで0なら全体も0と証明できるが、未知の部品詳細はunresolvedへ残す。この場合、同じ親がconfirmed_hitsとunresolvedの両方に載り得るため、分類件数を足してルート数としない。minimum_distanceが0と確定しても、未判定の同距離候補が残ればcomplete=False。
70
+
71
+ ## 上限・要約と性能
72
+
73
+ limitは既定100/最大1000で、confirmed_hits/provisional_hits/unresolvedの**各一覧**の上限。truncatedとreturned_countsを付ける。部品詳細は親ごとに一致/未判定各100件までで、全件数と切詰めを別に返す。mode=count/summaryは同じ全走査を行って件数・最小値・理由集計だけ返し、詳細を生成しない。要素番号や出力の丸め値で図面間の対応を作らない。
74
+
75
+ max_secondsは既定30/最大300秒の協調的な上限で、ルート間で確認する。準備/単一複合要素の計算の途中を強制終了するものではない。queryの正規表現には既存の別プロセス時間制限がある。時間切れはTIME_LIMIT、未走査数または対象総数不明を明記し、全体最近や総件数を断定しない。展開/深さ/線分のlimitsは共通形状と同じで、上限を緩める指定は拒否する。
76
+
77
+ 初版は索引を使わず全件走査する(index_used=False)。bboxで未判定候補を落とす近道は入れていない。カーソルやオフセットによる検索の再開には対応していない。図面編集やGUI受入れはこの検索には含めない。
@@ -0,0 +1,40 @@
1
+ # 平面建具の候補認識(読取り専用・初版)
2
+
3
+ 入口は `tategu_recognition.recognize_planar_tategu`。平面の開戸、折れ戸、フィックス、引き違い窓について、形の根拠がある候補を返す。建具データの変形を再現したテンプレート照合、断面・立面、建具符号の対応付けは行わない。単なる平行線等が似た形になる可能性は残るため、一般の実図面で全建具を保証するものではない。
4
+
5
+ 種類別の建具印は `find_entities(query=...)` の `flag_bits` で抽出する。LINE 0x1000、ARC/CIRCLE 0x0080、TEXT 0x2000を別々に指定し、異なる種類へ意味を一般化しない。印のない線・円弧も別の候補として調べる。印あり/なしは別の接続集合を使うため、片方にだけ印がある混合図形の統合は保証しない。TEXTの印は拾うが、文字を建具符号へ読み替えない。曲線属性番号は候補の説明として記録するだけで、分離や種類判定に使わない。
6
+
7
+ 出力には `type_candidates`、`clear_width_mm`、`position_real_mm`(開口中点)、`opening_endpoints_real_mm`、`opening_direction`、`element_indices`、`evidence`、`ambiguities` を含む。座標と幅は群ごとの縮尺で換算した実寸mm。番号は入力の現在の0始まり公開番号。異なる種類が当てはまる場合はalternativesを残す。幅が確定しなければNoneにし、外形や円弧の半径だけで内法を代用しない。
8
+
9
+ 開戸は戸先線・開き円弧と両端の枠内面、折れ戸は両端の折れた二重線につながる開口基準線、窓は枠の内面または向かい合う枠断面の内向き端を測る。フィックスの水切り等の出を内法に含めない。窓の中央で左右にずれた戸線は引き違いの根拠にする。寸法値・DAT項目番号の規格値へ丸めない。同種に属する別パターンはDAT番号として区別しない。
10
+
11
+ 開戸ではヒンジ・閉鎖側/戸先の角度・符号付き開き角、窓では軸と固定/軸方向の動き、折れ戸では軸と折れ側を記録する。実寸座標の正Xを0度、反時計回りを正とする。建物の内外の基準がないため、内開き/外開き・右勝手/左勝手は未確定のままにする。
12
+
13
+ ## 許容値と呼び出し
14
+
15
+ 対象ごとに利用者が確認した許容値JSONを用意する。APIに距離許容の既定値はなく、他図面へ自動適用しない。`tategu_input_fingerprint(path)` で得た原本SHA256をbindingへ記載する。fileは無編集の原本モデル専用、合成図形の試験だけはmemory_modelで現在のモデルに結び付けられる。ハッシュは対象一致の検査であり、利用者の承認を自動で証明する仕組みではない。
16
+
17
+ JSONの必須欄はschema_version=1、binding(kindとsha256)、coincidence_mm(正の接続許容)、width_error_mm(内法整合/評価許容)、position_error_mm(中点評価許容)、angle_rule="atan(epsilon/longer_length)"。角度は長い方の線長Lに対するatan(coincidence_mm/L)radを使う。position_error_mmは正解との評価用であり、別々の候補をその距離内だけで結合する条件ではない。余分な欄、期待する種類/幅/位置/正解ファイル等は受け付けない。
18
+
19
+ 以下は `input.jww` と、その入力について確認済みの `approved_tolerances.json` を読む例。原図には書き込まない。candidateがあってもcomplete=Falseやambiguities/unsupported/excludedを必ず確認する。
20
+
21
+ ```python
22
+ import json
23
+ from pathlib import Path
24
+ from jwwkit.tategu_recognition import recognize_planar_tategu
25
+
26
+ options = json.loads(Path('approved_tolerances.json').read_text(encoding='utf-8'))
27
+ result = recognize_planar_tategu('input.jww', tolerances=options)
28
+ with Path('candidates.json').open('x', encoding='utf-8') as stream:
29
+ json.dump(result, stream, ensure_ascii=False, allow_nan=False, indent=2)
30
+ ```
31
+
32
+ コマンドは `jwwkit recognize-tategu --source input.jww --tolerances approved_tolerances.json --output candidates.json`。出力重複を拒否する。終了値0はcomplete、2は保留を含む結果を保存した状態。入力違い・不正指定等は例外で停止する。結果JSONには図面の座標・番号が入るため、図面と同じ範囲で扱う。
33
+
34
+ ## 初版の保留
35
+
36
+ 円弧付きの扉線だけでは枠内法を確定せず、幅不明とする。重複図形、複数の解釈、複数の本体に包含される断片も保留。楕円や複合要素の展開は未対応。周囲の普通線はexcludedへ記録するが、除外は「建具ではない」という証明ではない。complete=Trueもこの限定規則で検査した入力の完全性であり、見落としのない一般認識の保証ではない。
37
+
38
+ 接続調査は各印集合につき最大2,000,000組(引数で変更可)、1つの接続本体512要素、枠断面候補128組を上限とする。上限到達では処理を拒否または当該本体をunsupportedにする。大規模な図面全体への速度・精度は未検証。
39
+
40
+ 見本の受入れでは正解ファイルを認識から隔離し、保存した認識結果を別処理で答え合わせする。印なしの正例は元図面を編集せず、独立に構築したメモリ上の図形で試験する。許容値・正解の訂正・見本固有の保存差は当該試験に限定し、一般の比較APIや正規化条件を緩めない。