metafold 0.12.dev10__tar.gz → 0.12.1__tar.gz

{metafold-0.12.dev10 → metafold-0.12.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metafold
-Version: 0.12.dev10
+Version: 0.12.1
 Summary: Metafold SDK for Python
 Author-email: Metafold 3D <info@metafold3d.com>
 License: Copyright 2024 Metafold 3D
@@ -25,7 +25,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.12
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: attrs~=23.2
@@ -38,7 +38,7 @@ Requires-Dist: dotenv>=0.9.9; extra == "simulation"
 Requires-Dist: pandas>=2.3.3; extra == "simulation"
 Requires-Dist: plyfile>=1.1.3; extra == "simulation"
 Requires-Dist: pyyaml>=6.0.3; extra == "simulation"
-Requires-Dist: simulation-configurator==0.1.2; extra == "simulation"
+Requires-Dist: simulation-configurator==0.2.*; extra == "simulation"
 Requires-Dist: tables>=3.11.1; extra == "simulation"
 Dynamic: license-file
 

{metafold-0.12.dev10 → metafold-0.12.1}/metafold/simulation/compression_simulation.py

@@ -8,7 +8,7 @@ import uuid
 
 from requests import HTTPError
 import yaml
-from dotenv import load_dotenv
+from dotenv import load_dotenv  # type: ignore
 from metafold import MetafoldClient
 from pathlib import Path
 from numpy.typing import DTypeLike
@@ -353,6 +353,8 @@ class CompressionSimulation:
         bvh_filename: Optional[str] = None
         # Sampling resolution (longest axis) assigned for the pass-2 sample job.
         sample_resolution: Optional[int] = None
+        # From the prep metrics job; None until prep completes.
+        interior_volume: Optional[float] = None
         patch: dict = field(default_factory=dict)
         jobs: dict[str, Any] = field(default_factory=lambda: {})
         part_unique_name = ""
@@ -374,6 +376,7 @@ class CompressionSimulation:
                 "is_piston": isinstance(self.part, ExperimentPistonBase),
                 "part_name": self.part.name,
                 "disabled": self.disabled,
+                "interior_volume": self.interior_volume,
             }
 
         def restore_from_state_dict(self, saved: dict):
@@ -382,6 +385,7 @@ class CompressionSimulation:
             self.material_name = saved["material_name"]
             self.jobs = saved["jobs"]
             self.disabled = saved.get("disabled", False)
+            self.interior_volume = saved.get("interior_volume")
 
     client: MetafoldClient
     project_id: str = ""
@@ -425,7 +429,7 @@ class CompressionSimulation:
         simulation_name: str,
         project_id: str = "",
         stl_folder_path: str = "PLY",
-        env_source: str = ".env.dev",
+        env_source: str | None = ".env.dev",
         output_path: str = "",
         client: Optional[MetafoldClient] = None,
         simulation_parameters: SimulationParameters = SimulationParameters(),
@@ -437,7 +441,7 @@ class CompressionSimulation:
             WorkflowStep(WorkflowStepType.VON_MISES_STRESS),
             WorkflowStep(WorkflowStepType.EFFECTIVE_STRAIN),
             WorkflowStep(WorkflowStepType.FORCE_DISPLACEMENT),
-            WorkflowStep(WorkflowStepType.STRESS_STRAIN),
+            # stress_strain is opt-in (not default): callers add it via workflow_steps.
             WorkflowStep(WorkflowStepType.PARTICLE_DISPLACEMENT),
             WorkflowStep(WorkflowStepType.ENERGY_METRICS),
         ],
@@ -642,7 +646,8 @@ class CompressionSimulation:
         return created.id
 
     def setup_client(self, env_source, project_id) -> MetafoldClient:
-        load_dotenv(env_source)
+        if env_source is not None:
+            load_dotenv(env_source)
 
         if not project_id:
             self.project_id = os.environ.get("METAFOLD_PROJECT_ID", "")
@@ -824,6 +829,24 @@ class CompressionSimulation:
             params[f"{sample_mesh_job}.resolution"] = f"{resolution}"
             part_info.jobs["sample-mesh"] = sample_mesh_job
 
+            # Metrics run in prep (not the main workflow) so interior volume
+            # is known before dispatch, when the server manifest is uploaded.
+            if self._is_analysis_target(part_info.part) and self._get_step(
+                WorkflowStepType.METRICS, part_info.part.name
+            ):
+                metrics_job = f"metrics-{unique_name}"
+                jobs[metrics_job] = {
+                    "type": "implicit/metrics",
+                    "needs": [sample_mesh_job],
+                    "assets": {"volume": sample_mesh_job},
+                    "parameters": {
+                        "volume_size": {"job": sample_mesh_job, "parameter": "patch_size"},
+                        "volume_offset": {"job": sample_mesh_job, "parameter": "patch_offset"},
+                        "volume_resolution": {"job": sample_mesh_job, "parameter": "patch_resolution"},
+                    },
+                }
+                part_info.jobs["metrics"] = metrics_job
+
         workflow_yaml = yaml.dump({"jobs": jobs}, default_flow_style=False)
         return workflow_yaml, params, assets
 
@@ -1025,6 +1048,30 @@ class CompressionSimulation:
             if volume_asset is not None:
                 info.volume_filename = volume_asset.filename
 
+            metrics_job = prep_workflow_jobs.get(info.jobs.get("metrics", ""))
+            if metrics_job is not None:
+                raw = metrics_job.outputs.params.get("interior_volume")
+                if raw is not None:
+                    info.interior_volume = float(raw)
+
+    def _total_interior_volume(self, workflow: Optional[Workflow] = None) -> float:
+        """Sum interior volumes across analysis-target parts. Falls back to
+        the main-workflow metrics readback for experiments dispatched before
+        metrics moved to the prep workflow."""
+        total = 0.0
+        for part_info in self.part_infos:
+            if not self._is_analysis_target(part_info.part) or part_info.disabled:
+                continue
+            if part_info.interior_volume is not None:
+                total += part_info.interior_volume
+                continue
+            metrics_job = part_info.jobs.get("metrics", "")
+            if workflow is not None and metrics_job:
+                raw = workflow.get_parameter(f"{metrics_job}.interior_volume")
+                if raw is not None:
+                    total += float(raw)
+        return total
+
     def get_part_info(self, name):
         for info in self.part_infos:
             if info.part.name == name:
@@ -1218,6 +1265,9 @@ class CompressionSimulation:
         ElementTree.indent(self.ups)
 
     def _add_to_workflow_metrics(self, part_infos: list[PartInfo]):
+        # Duplicates the prep metrics jobs (which feed the server manifest):
+        # removing these changed main-workflow scheduling and left it pending,
+        # so they stay until that's understood.
         for part_info in part_infos:
             part = part_info.part
             if not self._is_analysis_target(part):
@@ -1241,7 +1291,6 @@ class CompressionSimulation:
             self.workflow_params[f"{metrics_job_name}.volume_resolution"] = json.dumps(
                 part_info.patch["resolution"]
             )
-            part_info.jobs["metrics"] = metrics_job_name
 
     def _add_to_workflow_compress(self, part_infos: list[PartInfo]):
         compress_job_name = "compress"
@@ -2046,16 +2095,7 @@ class CompressionSimulation:
                     data["ply"] = f"{name}/ply/part.####.ply"
 
                     # Sum interior volumes from all parts
-                    total_volume = 0.0
-                    for part_info in self.part_infos:
-                        if self._is_analysis_target(part_info.part):
-                            if part_info.disabled:
-                                continue
-                            metrics_job = part_info.jobs.get("metrics", "")
-                            if metrics_job:
-                                raw = w.get_parameter(f"{metrics_job}.interior_volume")
-                                if raw is not None:
-                                    total_volume += float(raw)
+                    total_volume = self._total_interior_volume(w)
 
                     result.update(
                         {
@@ -2279,18 +2319,7 @@ class CompressionSimulation:
                             }
 
             # Sum interior volumes across analysis-target parts.
-            total_volume = 0.0
-            for part_info in self.part_infos:
-                if not self._is_analysis_target(part_info.part):
-                    continue
-                if part_info.disabled:
-                    continue
-                metrics_job = part_info.jobs.get("metrics", "")
-                if not metrics_job:
-                    continue
-                raw = w.get_parameter(f"{metrics_job}.interior_volume")
-                if raw is not None:
-                    total_volume += float(raw)
+            total_volume = self._total_interior_volume(w)
 
             result.update(
                 {
@@ -2445,19 +2474,7 @@ class CompressionSimulation:
         Volume is inlined (from prep workflow parameters); energy values are
         refs that the server resolves from the energy-metrics job output."""
         scalars: dict[str, Any] = {}
-
-        total_volume = 0.0
-        for part_info in self.part_infos:
-            if not self._is_analysis_target(part_info.part):
-                continue
-            if part_info.disabled:
-                continue
-            metrics_job = part_info.jobs.get("metrics", "")
-            if metrics_job:
-                raw = workflow.get_parameter(f"{metrics_job}.interior_volume")
-                if raw is not None:
-                    total_volume += float(raw)
-        scalars["volume"] = total_volume
+        scalars["volume"] = self._total_interior_volume(workflow)
 
         if self._contains_step(WorkflowStepType.ENERGY_METRICS):
             em_job_id = job_id_lookup.get("energy-metrics", "")
@@ -2717,7 +2734,7 @@ class CompressionSimulation:
                     "heading": "Absorbed Energy (J)",
                     "filtering": False,
                 }
-            )    
+            )
             self.manifest["resultsListConfig"].append(
                             {
                     "key": "loadingEnergy",

{metafold-0.12.dev10 → metafold-0.12.1}/metafold/simulation/run_experiment.py

@@ -98,12 +98,15 @@ Available material presets
                 "material_pla", "material_stainless_steel",
                 "material_ti64", "material_tpu"
 
-Available workflow steps (default: all)
-----------------------------------------
+Available workflow steps (default: all except stress_strain)
+------------------------------------------------------------
     "compute_bvh", "metrics", "compress", "von_mises_stress",
-    "effective_strain", "force_displacement", "stress_strain",
+    "effective_strain", "force_displacement",
     "particle_displacement", "energy_metrics"
 
+    Opt-in (not run by default; add explicitly to workflow_steps):
+    "stress_strain"
+
 Zip format (for run_experiment_from_zip)
 -----------------------------------------
 A zip containing:

{metafold-0.12.dev10 → metafold-0.12.1}/metafold.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metafold
-Version: 0.12.dev10
+Version: 0.12.1
 Summary: Metafold SDK for Python
 Author-email: Metafold 3D <info@metafold3d.com>
 License: Copyright 2024 Metafold 3D
@@ -25,7 +25,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.12
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: attrs~=23.2
@@ -38,7 +38,7 @@ Requires-Dist: dotenv>=0.9.9; extra == "simulation"
 Requires-Dist: pandas>=2.3.3; extra == "simulation"
 Requires-Dist: plyfile>=1.1.3; extra == "simulation"
 Requires-Dist: pyyaml>=6.0.3; extra == "simulation"
-Requires-Dist: simulation-configurator==0.1.2; extra == "simulation"
+Requires-Dist: simulation-configurator==0.2.*; extra == "simulation"
 Requires-Dist: tables>=3.11.1; extra == "simulation"
 Dynamic: license-file
 

{metafold-0.12.dev10 → metafold-0.12.1}/metafold.egg-info/requires.txt

@@ -9,5 +9,5 @@ dotenv>=0.9.9
 pandas>=2.3.3
 plyfile>=1.1.3
 pyyaml>=6.0.3
-simulation-configurator==0.1.2
+simulation-configurator==0.2.*
 tables>=3.11.1

{metafold-0.12.dev10 → metafold-0.12.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "metafold"
-version = "0.12.dev10"
+version = "0.12.1"
 authors = [
     {name = "Metafold 3D", email = "info@metafold3d.com"},
 ]
@@ -18,7 +18,7 @@ dependencies = [
 readme = "README.md"
 license = {file = "LICENSE"}
 description = "Metafold SDK for Python"
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 keywords = ["metafold", "api", "sdk", "implicit geometry"]
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -38,7 +38,7 @@ simulation = [
     "pandas>=2.3.3",
     "plyfile>=1.1.3",
     "pyyaml>=6.0.3",
-    "simulation-configurator==0.1.2",
+    "simulation-configurator==0.2.*",
     "tables>=3.11.1",
 ]
 
@@ -68,7 +68,7 @@ packages = ["metafold", "metafold.simulation"]
 environments = ["sys_platform == 'linux'"]
 
 [tool.uv.sources]
-simulation-configurator = { index = "sim-config-idx" }
+simulation-configurator = { index = "gitlab" }
 
 [[tool.mypy.overrides]]
 module = [
@@ -79,7 +79,7 @@ module = [
 ignore_missing_imports = true
 
 [[tool.uv.index]]
-name = "sim-config-idx"
+name = "gitlab"
 url = "https://gitlab.com/api/v4/projects/75460563/packages/pypi/simple"
 explicit = true
 authenticate = "always"

{metafold-0.12.dev10 → metafold-0.12.1}/tests/test_compression_simulation.py

@@ -167,13 +167,15 @@ class TestBuildWorkflow:
         assert isinstance(piston.part, ExperimentPistonBase)
         assert piston.material_index == 0
 
-    def test_build_workflow_has_per_part_metrics_jobs(self, prepared_sim):
-        yaml_str, _ = prepared_sim.build_workflow()
+    def test_prep_workflow_has_per_part_metrics_jobs(self, prepared_sim):
+        mesh_parts = [p for p in prepared_sim.part_infos if hasattr(p.part, "filename")]
+        yaml_str, _, _ = prepared_sim._build_sample_workflow_for_batch(mesh_parts)
         loaded = yaml.safe_load(yaml_str)
-        # one metrics job per non-piston mesh part
+        # one metrics job per non-piston mesh part, chained to its sample job
         for info in prepared_sim.part_infos:
             if not isinstance(info.part, ExperimentPistonBase) and hasattr(info.part, "filename"):
-                assert f"metrics-{info.part_unique_name}" in loaded["jobs"]
+                job = loaded["jobs"][f"metrics-{info.part_unique_name}"]
+                assert job["needs"] == [f"sample-mesh-{info.part_unique_name}"]
 
     def test_build_workflow_compress_has_velocity(self, prepared_sim):
         _, params = prepared_sim.build_workflow()
@@ -565,24 +567,6 @@ jobs:
     - compress
     assets:
       data: compress
-  stress-strain-upper_foam:
-    type: sim/postprocess/stress-strain
-    needs:
-    - force-displacement
-    assets:
-      data: force-displacement
-  stress-strain-midsole:
-    type: sim/postprocess/stress-strain
-    needs:
-    - force-displacement
-    assets:
-      data: force-displacement
-  stress-strain-outsole:
-    type: sim/postprocess/stress-strain
-    needs:
-    - force-displacement
-    assets:
-      data: force-displacement
   particle-displacement:
     type: sim/postprocess/particle-displacement
     needs:
@@ -638,12 +622,6 @@ jobs:
         "metrics-upper_foam.volume_resolution": "[32, 32, 16]",
         "metrics-upper_foam.volume_size": "[0.1, 0.1, 0.05]",
         "particle-displacement.keys": "[\"/material0/position\", \"/material1/position\", \"/material2/position\", \"/material3/position\"]",
-        "stress-strain-midsole.initial_length": "0.05",
-        "stress-strain-midsole.keys": "[\"/force_displacement\"]",
-        "stress-strain-outsole.initial_length": "0.05",
-        "stress-strain-outsole.keys": "[\"/force_displacement\"]",
-        "stress-strain-upper_foam.initial_length": "0.05",
-        "stress-strain-upper_foam.keys": "[\"/force_displacement\"]",
         "von-mises-stress.keys": "[\"/material0/cauchy_stress\", \"/material1/cauchy_stress\", \"/material2/cauchy_stress\", \"/material3/cauchy_stress\"]"
         }
         """)
@@ -653,7 +631,8 @@ jobs:
 
 
 class TestStressStrainPerPart:
-    """stress-strain runs once per deformable part (not one representative)."""
+    """stress-strain runs once per deformable part (not one representative).
+    It is opt-in: callers must add the step to workflow_steps."""
 
     def _built_sim(self, ply_folder, basic_parts, tmp_path):
         sim = CompressionSimulation(
@@ -662,6 +641,12 @@ class TestStressStrainPerPart:
             stl_folder_path=str(ply_folder),
             output_path=str(tmp_path / "out"),
             client=MagicMock(),
+            # stress_strain is not default; opt in (needs compress + force-displacement).
+            workflow_steps=[
+                WorkflowStep(WorkflowStepType.COMPRESS),
+                WorkflowStep(WorkflowStepType.FORCE_DISPLACEMENT),
+                WorkflowStep(WorkflowStepType.STRESS_STRAIN),
+            ],
         )
         # Distinct X/Y so compression_area = X*Y is unambiguous.
         fake_patch = {"size": [0.1, 0.2, 0.05], "offset": [0.0, 0.0, 0.0], "resolution": [32, 32, 16]}
@@ -673,6 +658,16 @@ class TestStressStrainPerPart:
         sim.build_workflow()
         return sim
 
+    def test_not_run_by_default(self, ply_folder, basic_parts, tmp_path):
+        sim = CompressionSimulation(
+            parts=basic_parts,
+            simulation_name="t",
+            stl_folder_path=str(ply_folder),
+            output_path=str(tmp_path / "out"),
+            client=MagicMock(),
+        )
+        assert not sim._contains_step(WorkflowStepType.STRESS_STRAIN)
+
     def test_one_job_per_deformable_part(self, ply_folder, basic_parts, tmp_path):
         sim = self._built_sim(ply_folder, basic_parts, tmp_path)
         for name in ("upper_foam", "midsole", "outsole"):
@@ -721,6 +716,18 @@ class TestMakeManifestV2:
             stl_folder_path=str(ply_folder),
             output_path=str(tmp_path / "out"),
             client=MagicMock(),
+            # Every step, including opt-in stress_strain, so all cards render.
+            workflow_steps=[
+                WorkflowStep(WorkflowStepType.COMPUTE_BVH),
+                WorkflowStep(WorkflowStepType.METRICS),
+                WorkflowStep(WorkflowStepType.COMPRESS),
+                WorkflowStep(WorkflowStepType.VON_MISES_STRESS),
+                WorkflowStep(WorkflowStepType.EFFECTIVE_STRAIN),
+                WorkflowStep(WorkflowStepType.FORCE_DISPLACEMENT),
+                WorkflowStep(WorkflowStepType.STRESS_STRAIN),
+                WorkflowStep(WorkflowStepType.PARTICLE_DISPLACEMENT),
+                WorkflowStep(WorkflowStepType.ENERGY_METRICS),
+            ],
         )
         # In the real flow create_sim_config() assigns material indices before
         # make_manifest_v2() runs; mirror that so per-part cards key correctly.
@@ -1125,6 +1132,7 @@ class TestSetupClient:
             simulation_name="t",
             stl_folder_path=str(ply_folder),
             output_path=str(tmp_path / "out"),
+            env_source=None,  # Ensure local .env files do not pollute test environment
             **kwargs,
         )