ANYgeometry 0.2.1__py3-none-any.whl

anygeometry/__init__.py

@@ -0,0 +1,324 @@
+"""Lightweight structural-surface geometry shared by the ANY ecosystem."""
+
+from .curves import Arc, ArcFrame, CurveShape, DegenerateArcError, Spline, Straight
+from .closure import ModelClosure, extract_model_closure
+from .entities import Edge, EntityKind, EntityRef, Face, OrientedEdge, Vertex, VertexRole
+from .editing import (
+    InsertResult,
+    Measurement,
+    PatternResult,
+    circular_pattern,
+    copy_entities,
+    insert_model,
+    linear_pattern,
+    measure,
+    mirror_entities,
+    reverse_edge,
+    reverse_face,
+)
+from .errors import GeometryError, GeometryTopologyError
+from .evaluation import (
+    edge_tangent_many,
+    evaluate_edge_many,
+    evaluate_face_many,
+    face_derivatives_many,
+    face_normal_many,
+    project_to_face_many,
+)
+from .features import (
+    FeatureExecution,
+    FeatureExecutor,
+    FeatureHistory,
+    FeatureInputRef,
+    FeatureOutputRef,
+    FeatureRecord,
+    FeatureRegistry,
+    FeatureResult,
+    FeatureStatus,
+    RegenerationReport,
+    builtin_feature_registry,
+)
+from .intersections import (
+    ExpectedImprintChange,
+    FaceIntersection,
+    ImprintApplication,
+    ImprintOperation,
+    ImprintPlan,
+    apply_imprint,
+    clip_line_to_face,
+    intersect_faces,
+    intersect_surfaces,
+    line_cylinder,
+    line_line,
+    line_plane,
+    numerical_surface_intersection,
+    plane_cylinder,
+    plane_plane,
+    plan_imprint,
+    query_intersection,
+)
+from .model import GeometryModel
+from .identity import EntityHandle, Resolution, ResolutionStatus
+from .transactions import AABBChange, ChangeSet, TopologyTransaction
+from .tolerance import DEFAULT_TOLERANCE_POLICY, TolerancePolicy, feature_extent
+from .predicates import (
+    IntersectionComponent,
+    IntersectionDimension,
+    IntersectionKind,
+    IntersectionQuality,
+    IntersectionResult,
+    ParameterRange as IntersectionParameterRange,
+    qualified_line_line,
+    qualified_line_cylinder,
+    qualified_line_plane,
+    qualified_plane_plane,
+    qualified_segment_segment,
+)
+from .policies import MutationPolicy
+from .spatial import (
+    AABB,
+    AABBTree,
+    IndexDiagnostics,
+    IndexUpdate,
+    IndexUpdateKind,
+    NearestQueryResult,
+)
+from .audit import (
+    AuditEvidenceQuality,
+    AuditEntity,
+    AuditCode,
+    AuditIssue,
+    AuditMetrics,
+    AuditPolicy,
+    AuditReport,
+    AuditScope,
+    AuditSeverity,
+    AuditWitness,
+    BroadPhaseDiagnostics,
+)
+from .strict_audit import audit_changed_region, strict_audit
+from .structural import (
+    Attachment,
+    AttachmentEvidence,
+    AttachmentKind,
+    AttachmentTargetKind,
+    BoundaryPolicy,
+    Coedge,
+    ConnectivityPolicy,
+    ConnectionIntent,
+    FaceUse,
+    FrozenMetadata,
+    Junction,
+    JunctionKind,
+    JunctionMemberUse,
+    Member,
+    MemberEdgeUse,
+    NonManifoldPolicy,
+    Orientation,
+    ParameterRange,
+    Part,
+    Sheet,
+    SheetTopologyPolicy,
+)
+from .overlaps import (
+    FaceOverlap,
+    OverlapFragmentation,
+    find_coplanar_overlaps,
+    fragment_coplanar_overlaps,
+)
+from .operations import (
+    closest_point,
+    fragment_face,
+    project,
+    punch_hole,
+    split_face,
+    split_face_at,
+    split_face_between,
+    strip_face,
+    surface_point,
+    transform,
+    trim_face,
+)
+from .serialization import from_dict, read_geometry, to_dict, write_geometry
+from .sketch import (
+    SketchConstraint,
+    SketchDefinition,
+    SketchPlane,
+    face_sketch_plane,
+    materialize_sketch,
+    solve_sketch,
+)
+from .surfaces import (
+    CoonsSurface,
+    Cone,
+    Cylinder,
+    Plane,
+    RuledSurface,
+    Surface,
+    SurfaceProtocol,
+    closest_uv,
+    surface_normal,
+)
+
+__all__ = [
+    "AABB",
+    "AABBChange",
+    "AABBTree",
+    "Arc",
+    "ArcFrame",
+    "Attachment",
+    "AttachmentEvidence",
+    "AttachmentKind",
+    "AttachmentTargetKind",
+    "AuditCode",
+    "AuditEntity",
+    "AuditEvidenceQuality",
+    "AuditIssue",
+    "AuditMetrics",
+    "AuditPolicy",
+    "AuditReport",
+    "AuditScope",
+    "AuditSeverity",
+    "AuditWitness",
+    "BoundaryPolicy",
+    "BroadPhaseDiagnostics",
+    "ChangeSet",
+    "Coedge",
+    "ConnectivityPolicy",
+    "ConnectionIntent",
+    "CoonsSurface",
+    "Cone",
+    "CurveShape",
+    "Cylinder",
+    "DegenerateArcError",
+    "Edge",
+    "EntityKind",
+    "EntityHandle",
+    "EntityRef",
+    "ExpectedImprintChange",
+    "Face",
+    "FaceIntersection",
+    "FaceOverlap",
+    "FaceUse",
+    "FeatureExecution",
+    "FeatureExecutor",
+    "FeatureHistory",
+    "FeatureInputRef",
+    "FeatureOutputRef",
+    "FeatureRecord",
+    "FeatureRegistry",
+    "FeatureResult",
+    "FeatureStatus",
+    "GeometryError",
+    "GeometryModel",
+    "GeometryTopologyError",
+    "FrozenMetadata",
+    "IndexDiagnostics",
+    "IndexUpdate",
+    "IndexUpdateKind",
+    "ImprintApplication",
+    "ImprintOperation",
+    "ImprintPlan",
+    "IntersectionComponent",
+    "IntersectionDimension",
+    "IntersectionKind",
+    "IntersectionParameterRange",
+    "IntersectionQuality",
+    "IntersectionResult",
+    "InsertResult",
+    "Measurement",
+    "Member",
+    "MemberEdgeUse",
+    "ModelClosure",
+    "MutationPolicy",
+    "NearestQueryResult",
+    "NonManifoldPolicy",
+    "Orientation",
+    "OrientedEdge",
+    "OverlapFragmentation",
+    "Plane",
+    "PatternResult",
+    "ParameterRange",
+    "Part",
+    "RegenerationReport",
+    "Resolution",
+    "ResolutionStatus",
+    "RuledSurface",
+    "SketchConstraint",
+    "SketchDefinition",
+    "SketchPlane",
+    "Sheet",
+    "SheetTopologyPolicy",
+    "Spline",
+    "Straight",
+    "Surface",
+    "SurfaceProtocol",
+    "TolerancePolicy",
+    "TopologyTransaction",
+    "Vertex",
+    "VertexRole",
+    "apply_imprint",
+    "audit_changed_region",
+    "closest_point",
+    "clip_line_to_face",
+    "closest_uv",
+    "copy_entities",
+    "circular_pattern",
+    "edge_tangent_many",
+    "evaluate_edge_many",
+    "evaluate_face_many",
+    "extract_model_closure",
+    "face_derivatives_many",
+    "face_normal_many",
+    "fragment_face",
+    "fragment_coplanar_overlaps",
+    "face_sketch_plane",
+    "from_dict",
+    "find_coplanar_overlaps",
+    "feature_extent",
+    "intersect_faces",
+    "intersect_surfaces",
+    "insert_model",
+    "line_cylinder",
+    "line_line",
+    "line_plane",
+    "qualified_line_line",
+    "qualified_line_cylinder",
+    "qualified_line_plane",
+    "qualified_plane_plane",
+    "qualified_segment_segment",
+    "linear_pattern",
+    "measure",
+    "materialize_sketch",
+    "mirror_entities",
+    "numerical_surface_intersection",
+    "plane_cylinder",
+    "plane_plane",
+    "plan_imprint",
+    "query_intersection",
+    "project",
+    "project_to_face_many",
+    "punch_hole",
+    "read_geometry",
+    "reverse_edge",
+    "reverse_face",
+    "split_face",
+    "split_face_at",
+    "split_face_between",
+    "strip_face",
+    "strict_audit",
+    "solve_sketch",
+    "surface_normal",
+    "surface_point",
+    "to_dict",
+    "transform",
+    "trim_face",
+    "write_geometry",
+    "builtin_feature_registry",
+    "DEFAULT_TOLERANCE_POLICY",
+    "Junction",
+    "JunctionKind",
+    "JunctionMemberUse",
+]
+
+__version__ = "0.2.1"

anygeometry/__main__.py

@@ -0,0 +1,92 @@
+"""Command-line inspection and example generation for ANYgeometry."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+from typing import Sequence
+
+from . import __version__
+from .generators import stiffened_panel
+from .serialization import read_geometry, write_geometry
+
+
+def _parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="anygeometry",
+        description="Inspect or create a neutral ANYgeometry document.",
+    )
+    parser.add_argument("geometry_file", nargs="?", type=Path)
+    parser.add_argument(
+        "--write-example",
+        metavar="PATH",
+        type=Path,
+        help="write a small stiffened-panel geometry document",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="emit the inspection summary as JSON",
+    )
+    parser.add_argument("--version", action="version", version=__version__)
+    return parser
+
+
+def _summary(path: Path) -> dict[str, object]:
+    geometry = read_geometry(path)
+    return {
+        "path": str(path),
+        "vertices": len(geometry.vertices),
+        "edges": len(geometry.edges),
+        "faces": len(geometry.faces),
+        "groups": {
+            name: len(geometry.group(name)) for name in sorted(geometry.groups)
+        },
+        "replacement_history": len(geometry.replacement_history()),
+        "topology": "valid",
+    }
+
+
+def main(args: Sequence[str] | None = None) -> int:
+    """Run the lightweight CLI and return a process exit status."""
+
+    parser = _parser()
+    options = parser.parse_args(args)
+    if options.write_example is not None and options.geometry_file is not None:
+        parser.error("geometry_file and --write-example are mutually exclusive")
+    if options.write_example is not None:
+        geometry = stiffened_panel(
+            4.0,
+            3.0,
+            longitudinal_spacing=1.0,
+            transverse_spacing=2.0,
+        )
+        write_geometry(options.write_example, geometry)
+        print(f"Wrote {options.write_example}")
+        return 0
+    if options.geometry_file is None:
+        parser.print_help()
+        return 0
+
+    summary = _summary(options.geometry_file)
+    if options.json:
+        print(json.dumps(summary, indent=2, sort_keys=True))
+    else:
+        print(
+            f"{summary['path']}: {summary['vertices']} vertices, "
+            f"{summary['edges']} edges, {summary['faces']} faces; topology valid"
+        )
+        groups = summary["groups"]
+        if groups:
+            print(
+                "Groups: "
+                + ", ".join(
+                    f"{name}={count}" for name, count in groups.items()
+                )
+            )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())