gdsdiff 0.1.0__py3-none-any.whl

gdsdiff-0.1.0.dist-info/METADATA

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: gdsdiff
+Version: 0.1.0
+Summary: Exact, evidence-oriented comparison of GDSII layout geometry
+Author-email: Sandbo Chang <sandbochang@outlook.com>
+License-Expression: GPL-3.0-only
+Project-URL: Homepage, https://github.com/SandboChang/gdsdiff
+Project-URL: Issues, https://github.com/SandboChang/gdsdiff/issues
+Project-URL: Repository, https://github.com/SandboChang/gdsdiff
+Keywords: GDSII,CAD,layout,geometry,verification
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gdstk>=1.0.0
+Requires-Dist: numpy>=1.26
+Provides-Extra: test
+Requires-Dist: jsonschema>=4.23; extra == "test"
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: tomli; python_version < "3.11" and extra == "test"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: jsonschema>=4.23; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: tomli; python_version < "3.11" and extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Provides-Extra: native-dev
+Requires-Dist: cmake>=3.24; extra == "native-dev"
+Requires-Dist: pybind11>=2.12; extra == "native-dev"
+Dynamic: license-file
+
+# gdsdiff
+
+`gdsdiff` compares the geometry and hierarchy of two GDSII layouts and emits
+neutral, machine-readable evidence. It supports exact CPU verification by
+default and can use optional CUDA or Apple Metal acceleration when a compatible
+system toolchain and device are available.
+
+The package is usable on CPU-only machines. CUDA, Metal, CMake, and compiler
+toolchains are runtime capabilities, not mandatory Python dependencies.
+
+## Install
+
+```bash
+python -m pip install gdsdiff
+```
+
+For local development from this checkout:
+
+```bash
+UV_PROJECT_ENVIRONMENT=.venv_wsl UV_LINK_MODE=copy uv sync --locked --extra dev
+TMPDIR=/tmp .venv_wsl/bin/python -m pytest
+```
+
+Use a repository-local virtual environment: `.venv_wsl` on Windows 11 through
+WSL, `.venv_mac` on macOS, and `.venv` on native Linux.
+
+## Command line
+
+```bash
+python -m gdsdiff before.gds after.gds --output-dir comparison
+```
+
+Exit codes are stable: `0` means the selected failure policy passed, `1` means
+differences failed the policy, and `2` means the comparison could not produce
+valid evidence. Reports use factual directions such as `coverage_before_only`
+and `coverage_after_only`.
+
+## Python API
+
+```python
+from gdsdiff import CompareConfig, compare_gds_files
+
+result = compare_gds_files(
+    CompareConfig("before.gds", "after.gds", backend="cpu")
+)
+print(result.status, result.exit_code)
+```
+
+Polygon extraction is public so downstream tools such as `ebeamtime` can share
+the same zero-copy `PolygonBuffer` representation:
+
+```python
+from gdsdiff import extract_gds_polygons
+
+extraction = extract_gds_polygons("layout.gds", layers="1:0,2:0")
+print(extraction.buffer.polygon_count)
+```
+
+See `docs/` for comparison semantics, report format, engine details, and
+debugging guidance.
+
+## Optional acceleration
+
+- CUDA requires an NVIDIA GPU, a compatible driver, and the CUDA toolkit with
+  `nvcc` available. On WSL, install the Windows NVIDIA display driver and the
+  WSL CUDA toolkit, never a Linux display driver. `nvcc` is discovered from
+  `PATH`, `CUDA_HOME`, `/usr/local/cuda`, or `/opt/cuda`.
+- On-demand builds default to NVIDIA's `-arch=native`: `nvcc` detects visible
+  GPUs and emits native SASS without PTX. For cross-machine builds, set
+  `GDSDIFF_CUDA_ARCHITECTURES` to comma-separated compute capabilities without
+  decimals (for example, `89,120`). Targets and standard `NVCC_*_FLAGS` are
+  included in the content-addressed cache key.
+- Metal requires Apple Silicon/macOS with the Xcode command-line tools.
+- Missing or unusable accelerators fall back to CPU unless `require_gpu=True`
+  is explicitly requested.
+
+Installation and import never compile GPU code. Inspect the CUDA toolchain with
+`gdsdiff.inspect_cuda_toolchain()`, then build and verify the optional backend
+with `gdsdiff.prepare_cuda()` or `gdsdiff-prepare-cuda --json`. Explicit
+`backend="cuda"` use retains lazy preparation. Passive diagnostics and
+`discover_native_capabilities()` report only already-prepared backends.
+
+Native artifacts are stored in a private, content-addressed user cache keyed by
+source, compiler/toolkit identity, build flags, and native GPU identity. The
+optional geometry cache uses JSON plus non-executable NumPy arrays; legacy
+pickle cache entries are ignored and rebuilt.
+
+## License
+
+GPL-3.0-only. See `LICENSE`.

gdsdiff-0.1.0.dist-info/RECORD

@@ -0,0 +1,85 @@
+gdsdiff/__init__.py,sha256=gvUKGnGAWosW7JJ1jJLB0CcrvmtWC-LjSQc66jHhXgY,5686
+gdsdiff/__main__.py,sha256=nbdP6zFlOqcCirgxoIQ6HiWVhdh7URm5GOWr5_EwmBk,116
+gdsdiff/_environment.py,sha256=sCuHqAMiXmV5t8Jhg-wsWTvBexmEAnMMhpIVwhD6GW0,340
+gdsdiff/_version.py,sha256=Ej7IsJUZBOqchwPRcQqON5BR0Q7tWXV6uiwiB0VcGMk,1378
+gdsdiff/acceptance_evidence.py,sha256=1I1fvBXudplbB35bAl50YAS_2ypY9KOCOIRIDOL745o,21349
+gdsdiff/api.py,sha256=lUYXdIvc2jAxGuGHT0t5W9VT7N2U_HnfqNCMEsWVusY,135723
+gdsdiff/boundary_loops.py,sha256=dGsQQHu3xWGI62pd3LZdVv_bPV8KagaYteOFgQs_VgQ,24147
+gdsdiff/cache.py,sha256=DM27pLAEI6fYEaOvWUUE8PINND7VeXU-DLhr0AbqURQ,20355
+gdsdiff/canonicalize.py,sha256=69vqgBCFqx8Ft3VpNjxCkNFsZg1UEslRBkY7HG32SbE,6371
+gdsdiff/cli.py,sha256=L6e3tQ_qFgsnGLRY-tsM_v9MARHUD5Q6o32y-H7N-aE,14839
+gdsdiff/config.py,sha256=7sDB_XbTbEEeVz1acf9JlZT1l5DOPdNvSdJKagqeedw,11242
+gdsdiff/cuda_setup.py,sha256=O2MROFSzOygNm6_Se0CMMux-XYJjcd4vHn5yiS3lhF4,5651
+gdsdiff/design_history.py,sha256=0ZbADW2qd8H-jEaZER7mwDgmfxaFLlsiqLHiT2EEDQA,2332
+gdsdiff/diagnostics.py,sha256=BFFLtw_wfoL0laP71o3e2OyHZHw9DNVTwUp_iu-S9zc,1215
+gdsdiff/diff_gds.py,sha256=F1RUwaKOYLQXKFrFGcScLqjGoMX2peNohyM0prrTAI8,2142
+gdsdiff/exact_diff_markdown.py,sha256=hSZTUjl9awoNG8DUskidARzO2CS2592VFFSVdKVvms0,43027
+gdsdiff/exact_oracle.py,sha256=9U16eIsM0oK8eFNLXfYOsvy9dFulFPWZIsbxu08stv0,26004
+gdsdiff/extract.py,sha256=CghP8RUqSwMFKGwieNpZlCyP7FSV4oahx0b4tWyjsbo,13406
+gdsdiff/gds_metadata.py,sha256=0NB5AysN1TdukLqMvCAyDzMfak54iNwE2kF6I7MVuig,1112
+gdsdiff/geometry.py,sha256=3SOkcOhrWp-cR2NNMVtgMwibIJt2J1PTVW6cI6nwBUc,4341
+gdsdiff/grid.py,sha256=MNYvfygP9z-lCjebzvoAPor61QsOAKCQ5TsElAPXQgM,4981
+gdsdiff/hierarchy.py,sha256=lTBdagGv2vhxF8jG30YYBEhHLlXY85Myv56OFGMksKU,7954
+gdsdiff/hierarchy_extract.py,sha256=szMTXHgc1RqyGo1_QEDVbNoHHvcjMbTQNWwPf0CTvI0,10912
+gdsdiff/inventory.py,sha256=XpRvh4j7DuCnuDAX6CjogAZ4uVXyHN-D__KlkCZhs1Q,5072
+gdsdiff/multiprocessing_support.py,sha256=M261AwNkts3O4eyprfPiz2W1MtwqX_6tkN82vupYQus,1111
+gdsdiff/native.py,sha256=0XjU3Tuq4OiZJFOJyN29AGVyfEg5PF3E5YOtRoLEc6I,4870
+gdsdiff/native_cache.py,sha256=u4-pIVUIy_Qu1ZLIUv3_qrY3I9dzkFwBx20ZMYE1cAc,10111
+gdsdiff/policy.py,sha256=zMm_IfSbr_HGKje9YOt0VH9HJjONcmvrtYGS5tjpaZk,11042
+gdsdiff/polygon_components.py,sha256=65g98m940XqyKrGkLuUBksJt0pRwo00541q8q-InFFE,35989
+gdsdiff/profiles.py,sha256=nSuoWEfIauaZFigKEWbWyf77i6Mp9eDtaJqYlqz361I,5893
+gdsdiff/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+gdsdiff/rect_coverage.py,sha256=BfusMBb-gSReDEpTuwhN6DmpZ2essFAVrZcQ-mTRFzs,15710
+gdsdiff/report.py,sha256=W_U5KCwLaMsONOUcQxkdlu3soSl3sBJ5Eucbvjz7_SA,13880
+gdsdiff/semantics.py,sha256=BOA68B22CrXfJUdgyeQIvbHgb8RxaCuJ2FYBRIg2UiM,2157
+gdsdiff/source_edge_diff.py,sha256=JD2i4eBzsojPEd9vRtdRwr-AlltpQTPdEgO0pZeRS4Q,50636
+gdsdiff/spatial.py,sha256=MXmNVDVtTeQ7Dqc-IJp-QcKsKW38zTQr7mjnP-kJsa4,2942
+gdsdiff/structural_guard.py,sha256=2BVkmECjRD1ue25VHIW8jsLV6J55Ap65yjuUxiz_b_U,5624
+gdsdiff/surplus_coverage.py,sha256=aopJBnzE4eIAp5uincamvoBJbNP1rEySbu5I2LCBrds,11209
+gdsdiff/synthetic_suite.py,sha256=d6-K-rbakbXgeEhfukpor790UePyQjxHcfl1Jq7LZGI,72547
+gdsdiff/templates.py,sha256=Emqtog8yW3r5nDqE9x6JXiCpuUaE6oC4VQJpokixtPs,26089
+gdsdiff/tiling.py,sha256=q-V8XpNCiKcSw9hT7MnAKNUArJMKQc-nvC_TmR6xjcM,5236
+gdsdiff/windowed_exact.py,sha256=bRkFAg3ZCYtlEe2XOo3sODcaPss-0iisX6k6eI5tIvw,10599
+gdsdiff/windows.py,sha256=ktqQgVmbt8mAX8NRkdNz0AbC7a5tqtgCIHO5GlSBwxU,6126
+gdsdiff/backends/__init__.py,sha256=xqKEhbc0L-eRV2PIgkPlCbKIP36rVdykgFTsteaZTDY,835
+gdsdiff/backends/base.py,sha256=mPiN0s77Ra9nCGD9fx5OKo0GJpe0sWTvEdLx6hYRQE0,2052
+gdsdiff/backends/boundary_loop_ctypes.py,sha256=nYzY2H3_oPm1qBdZwPgjs8EIAorpj-QmKb2XmemYJHg,6953
+gdsdiff/backends/cpu.py,sha256=bEGVoDP0ZWqxhqygDVipI6NpQEtjEqGFX8S02_tJltg,696
+gdsdiff/backends/cpu_ctypes.py,sha256=5r9W3LGdPvDxvpx18s5aqtiuS-TbiDzpL47FS3uCtZw,9372
+gdsdiff/backends/cuda.py,sha256=EJv1pc1d4sorW6eGfkqAvyX91_9jAga9hEBcdIpRhOA,1262
+gdsdiff/backends/cuda_ctypes.py,sha256=vGezV0ZtJxeqpcfSl9o1tvSTFzACXf1-TDSoPiedJkI,55367
+gdsdiff/backends/exact.py,sha256=6dbcy4CFl6iq88E_8clu1vuNpM7Ev4Pe5lrfb0Codcc,18957
+gdsdiff/backends/geometry_ctypes.py,sha256=xRstJABHr9xCs2wvkKiwDpqtuQgK9KY7rIfHKn-0fj8,8691
+gdsdiff/backends/identity.py,sha256=cW-C2TJUMeCiKAtlIBZ5UqZgD6L-gdZbycXbB33fdIA,1651
+gdsdiff/backends/metal.py,sha256=8gt1JKwOHickJzK6rWkITdDtR6_I13sALdEkIQoo7jA,9268
+gdsdiff/backends/metal_ctypes.py,sha256=1LLA6mxy987Mc2a54QBNS5AbzvyeoeNJ2tUrIeonxfs,34916
+gdsdiff/backends/polygon_extract_ctypes.py,sha256=AiqNoZFoqymCT02LzgMy7cmysTFaLG5pFnW1Y761lpQ,8576
+gdsdiff/backends/structural_ctypes.py,sha256=QYZ6leMIeuXQ9QWE34ltC_ujyUcbKzPb7D7mUOSJikQ,3898
+gdsdiff/native_src/cpu_prefilter.cpp,sha256=HmvtGdIIg21W190pdws1x6xHnM9nv5FNZMwmDEFpBbo,12229
+gdsdiff/native_src/gds_boundary_loops.cpp,sha256=-cmaT-eUS1o68sp1m3UHmJtTDgrUu60OJZ0wgeIHGbk,17786
+gdsdiff/native_src/gds_geometry_scan.cpp,sha256=GNwK2q5rOq_8HAvvJk6Jja0umFFpUHjOpZm00tPGJoQ,22511
+gdsdiff/native_src/gds_polygon_extract.cpp,sha256=gmnStsvI050ygmP1Ot7p45Q6eQYqWoRYfGBk3h13eUI,22433
+gdsdiff/native_src/gds_structural_scan.cpp,sha256=qTlgdkzViTexxn5nF2ZKayDJrHb4s0T5IWfrUCifjeM,11600
+gdsdiff/native_src/gdsdiff/CMakeLists.txt,sha256=jUJM00eiVN3LX1oK8xXATPnZ6HBavrP8hTYqpmcwnlI,3871
+gdsdiff/native_src/gdsdiff/core.cpp,sha256=ixuJiWRaSba0awE9td8ogWYJ65rzrV1K96X-u2Be4m8,7391
+gdsdiff/native_src/gdsdiff/core.hpp,sha256=E3l5e7EcKCZGb-9RSPMAjrXBCYN-dZrFCTUXejntJjM,2761
+gdsdiff/native_src/gdsdiff/cuda_assignment.cu,sha256=Up0k0uH4YCM-gHNjDxVGgQxEuQpuNKWR8sqDfyqsXiA,9869
+gdsdiff/native_src/gdsdiff/cuda_assignment.cuh,sha256=Mg7cfhituqJGypf_Td5zKf4nlMoVs443WhHnmsYOd1Y,818
+gdsdiff/native_src/gdsdiff/cuda_candidates.cu,sha256=x6CzR8tUF8YE8bE5OYpXoCmV3HA9WygtXm7FB2YhXaE,5108
+gdsdiff/native_src/gdsdiff/cuda_candidates.cuh,sha256=BwsVG6XUyMKa1tWnYyH0c7gw-h4TX3N9wv97HGIg7w4,419
+gdsdiff/native_src/gdsdiff/cuda_ctypes.cu,sha256=FEdB-G4Ik7jcnhtfZXJLQ61dqehkCQ3s4B0TFYszU_k,202048
+gdsdiff/native_src/gdsdiff/cuda_memory.cu,sha256=kmXx3w66-KCloxnjT7MBtedls3kq8_6xucWD5uGcRpY,7698
+gdsdiff/native_src/gdsdiff/cuda_memory.cuh,sha256=4medYNEGWbLrJrx4hMJgFd6TZ-zzq00lU7j8EMuBI0o,865
+gdsdiff/native_src/gdsdiff/metal_ctypes.mm,sha256=TEXhgDGbcK4HrdBez2LH5ypDupIGW4LmfhawQ8iCKlE,123445
+gdsdiff/native_src/gdsdiff/python_bindings.cpp,sha256=6Zx_AbHgW9bDoMmT9qe0BbqpOi4suhB5S4wEGtdIf0k,708
+gdsdiff/native_src/gdsdiff/test_core.cpp,sha256=nzyUBclpm4Q91qkbSNQKGvBGrMK1--IfnB5Doe8SIE0,3123
+gdsdiff/native_src/gdsdiff/test_cuda_assignment.cu,sha256=EEUR6tAZbmgtrCisQuiWR0p4Flc8bqJNerPRprZQNp4,3864
+gdsdiff/native_src/gdsdiff/test_cuda_candidates.cu,sha256=yPvPfmM8Ec8vEi6ec5tJExWZGKyX-c0BIPVvk_zDVAg,3134
+gdsdiff/native_src/gdsdiff/test_cuda_memory.cu,sha256=f484zaETdMq_tFHYKJ117JK2AxBGun5ZE6IVPZGfsBY,3474
+gdsdiff/schemas/gdsdiff_report-v1.schema.json,sha256=8V6WVOicQsghIcMy-L7rBsBkmVe5PLpf_SamIoG74kE,4147
+gdsdiff-0.1.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+gdsdiff-0.1.0.dist-info/METADATA,sha256=Gs54o6JZBzpSDU6HquNLIR9OHeT-ao50XfMbw31DQ1E,5231
+gdsdiff-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+gdsdiff-0.1.0.dist-info/entry_points.txt,sha256=pbR70Qpnk370AOuptM_yTqE7f1LhMKm4TU1j7DCU5b4,139
+gdsdiff-0.1.0.dist-info/top_level.txt,sha256=6SuSy2Tssdx7463FmBbtaOyxtz1Mr85VarBwldi_k0w,8
+gdsdiff-0.1.0.dist-info/RECORD,,

gdsdiff-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gdsdiff-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+gdsdiff = gdsdiff.cli:main
+gdsdiff-diagnostics = gdsdiff.diagnostics:main
+gdsdiff-prepare-cuda = gdsdiff.cuda_setup:main