Skip to content
HALOWERK

Datenvertragswerk

simplicial gradient matching family

From one complete abstract simplicial complex on labels 0..n-1 (n 0..4, dimension <=2, at most 8 nonempty faces), given as face_mask with bit (s-1) for vertex subset s, generates every acyclic partial matching of its nonempty face Hasse diagram (Forman Thm 6.2). Returns faces, covers (all codimension-one pairs [lowerFaceIndex, upperFaceIndex]), all ascending matching_masks, aligned critical_masks and the count. The empty matching is always included.

POST https://datenvertrag.halowerk.com/v1/simplicial-gradient-matching-family

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
nSee schemaYes
face_maskSee schemaYes
claimSee schemaYes
Show full input schema
{
  "type": "object",
  "properties": {
    "n": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 4
        },
        {
          "type": "null"
        }
      ]
    },
    "face_mask": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 32767
        },
        {
          "type": "null"
        }
      ]
    },
    "claim": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "matching_masks": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0,
                "maximum": 511
              },
              "minItems": 0,
              "maxItems": 512
            },
            "critical_masks": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0,
                "maximum": 255
              },
              "minItems": 0,
              "maxItems": 512
            },
            "count": {
              "type": "integer",
              "minimum": 0,
              "maximum": 512
            }
          },
          "required": [
            "matching_masks",
            "critical_masks",
            "count"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "n",
    "face_mask",
    "claim"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "n": 0,
  "face_mask": 0,
  "claim": {
    "matching_masks": [
      0
    ],
    "critical_masks": [
      0
    ],
    "count": 1
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’