> ## Documentation Index
> Fetch the complete documentation index at: https://proto.evodesign.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AF3 Chain-Pair Protein-DNA ipTM

> Score protein-DNA interface confidence using the chain-pair ipTM matrix, returning the max (or mean) ipTM across all protein-DNA chain pairs.

<div class="page-hero">
  <img class="page-hero-banner" src="https://proto-bio.github.io/proto-assets/images/constraint/af3-chain-pair-prot-dna-iptm/hero.png" alt="AF3 Chain-Pair Protein-DNA ipTM" />
</div>

<Note>
  **License:** This constraint can use multiple tools, each under its own license. See the **Tools Used** tab and each tool's page for license details.
</Note>

<p class="entity-disclaimer">This constraint is open source. Any third-party models, product names, or trademarks referenced are the property of their respective owners, and Proto is not affiliated with them.</p>

<hr class="entity-rule" />

<input type="radio" name="tab-constraint-af3-chain-pair-prot-dna-iptm" id="none-constraint-af3-chain-pair-prot-dna-iptm" class="tab-radio-input" />

<input type="radio" name="tab-constraint-af3-chain-pair-prot-dna-iptm" id="tools-constraint-af3-chain-pair-prot-dna-iptm" class="tab-radio-input" defaultChecked />

<input type="radio" name="tab-constraint-af3-chain-pair-prot-dna-iptm" id="source-constraint-af3-chain-pair-prot-dna-iptm" class="tab-radio-input" />

<div class="tool-tab-bar"><span class="tool-tab-wrap"><label for="tools-constraint-af3-chain-pair-prot-dna-iptm" class="tool-tab tab-open badge-tools"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="7" height="7" x="3" y="3" rx="1" /><rect width="7" height="7" x="14" y="3" rx="1" /><rect width="7" height="7" x="14" y="14" rx="1" /><rect width="7" height="7" x="3" y="14" rx="1" /></svg> Tools Used</label><label for="none-constraint-af3-chain-pair-prot-dna-iptm" class="tool-tab tab-close badge-tools"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="7" height="7" x="3" y="3" rx="1" /><rect width="7" height="7" x="14" y="3" rx="1" /><rect width="7" height="7" x="14" y="14" rx="1" /><rect width="7" height="7" x="3" y="14" rx="1" /></svg> Tools Used</label></span> <span class="tool-tab-wrap"><label for="source-constraint-af3-chain-pair-prot-dna-iptm" class="tool-tab tab-open badge-source"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6" /><polyline points="8 6 2 12 8 18" /></svg> Source</label><label for="none-constraint-af3-chain-pair-prot-dna-iptm" class="tool-tab tab-close badge-source"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6" /><polyline points="8 6 2 12 8 18" /></svg> Source</label></span></div>

<div class="tab-panel tools-panel" data-tab="tools-constraint-af3-chain-pair-prot-dna-iptm">
  <div class="tools-used-grid">
    <a href="/docs/tools/structure-prediction/alphafold3" class="tools-used-tile">
      <img noZoom src="https://proto-bio.github.io/proto-assets/images/tool/alphafold3/social.png" alt="" loading="lazy" />
    </a>

    <a href="/docs/tools/structure-prediction/boltz2" class="tools-used-tile">
      <img noZoom src="https://proto-bio.github.io/proto-assets/images/tool/boltz2/social.png" alt="" loading="lazy" />
    </a>

    <a href="/docs/tools/structure-prediction/protenix" class="tools-used-tile">
      <img noZoom src="https://proto-bio.github.io/proto-assets/images/tool/protenix/social.png" alt="" loading="lazy" />
    </a>
  </div>
</div>

<a href="https://github.com/evo-design/proto-language/blob/d3b7822f74ea64747cc751a3b2ab1aa6b799ac47/proto_language/constraint/protein_structure/af3_chain_pair_prot_dna_iptm_constraint.py#L261" target="_blank" class="tab-panel source-panel" data-tab="source-constraint-af3-chain-pair-prot-dna-iptm">
  <div class="source-info">
    <img noZoom src="https://github.com/evo-design.png?size=40" class="source-avatar" width="36" height="36" />

    <span class="source-path">evo-design/proto-language<span class="source-subpath">/proto\_language/constraint/protein\_structure/af3\_chain\_pair\_prot\_dna\_iptm\_constraint.py</span></span>
  </div>

  <span class="panel-goto-btn source-goto-btn"><span><svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" /></svg> View source</span></span>
</a>

<div class="entity-contributors"><span class="entity-contributors-label">Constraint contributors</span><span class="entity-contributors-people"><a class="entity-contributor" href="https://github.com/adititm" target="_blank" rel="noopener" title="adititm: 1 commit"><img noZoom class="entity-contributor-avatar" src="https://avatars.githubusercontent.com/u/61667248?v=4&s=64" alt="" loading="lazy" /><span class="entity-contributor-login">adititm</span></a><a class="entity-contributor" href="https://github.com/dguo8412" target="_blank" rel="noopener" title="dguo8412: 1 commit"><img noZoom class="entity-contributor-avatar" src="https://avatars.githubusercontent.com/u/46211285?v=4&s=64" alt="" loading="lazy" /><span class="entity-contributor-login">dguo8412</span></a></span></div>
Score protein-DNA ipTM from a per-chain-pair ipTM matrix.

For each candidate complex:

1. Separate protein and DNA sequences from the input tuple.
2. Build a complex with `num_protein_copies` protein chains and all DNA
   chains (optionally adding the reverse complement).
3. Run the configured structure predictor and read `chain_pair_iptm`.
4. Pick out the protein-to-DNA entries and aggregate (max or mean).
5. Score: 0.0 (best) when aggregated ipTM >= `desired_iptm`, 1.0 (worst)
   when ipTM is 0.

When the predictor does not expose the per-chain-pair ipTM matrix this
raises `RuntimeError`: overall ipTM is not a valid substitute.

**Supported tools**: any DNA-capable `StructureBasedConstraintConfig`
predictor; AlphaFold3 and Protenix emit the per-chain-pair ipTM matrix under
`chain_pair_iptm`, and Boltz-2 emits the same matrix under
`pair_chains_iptm`.

## API Reference

<div class="api-model-section api-model-static api-config-section">
  <div class="api-model-header"><span class="api-model-badge api-config-badge">Config</span><span class="api-model-name">AF3ChainPairProtDNAIPTMConfig</span><a href="https://github.com/evo-design/proto-language/blob/d3b7822f74ea64747cc751a3b2ab1aa6b799ac47/proto_language/constraint/protein_structure/af3_chain_pair_prot_dna_iptm_constraint.py#L55" target="_blank" class="func-table-btn func-source-btn api-model-source"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6" /><polyline points="8 6 2 12 8 18" /></svg> Source</a></div>

  Config for the AF3 chain-pair protein-DNA ipTM constraint.

  Runs a structure prediction for the protein-DNA complex and extracts the
  pairwise chain ipTM matrix. Only the protein-to-DNA entries are kept; the
  result is aggregated via `aggregation` (default: max over all protein-DNA
  chain pairs — both dimer halves, and both DNA strands when
  `include_reverse_complement` is set), then scored against `desired_iptm`.

  <Note>
    The per-chain-pair ipTM matrix (`chain_pair_iptm`) is exposed by both
    AlphaFold3 and Protenix. Boltz-2 exposes the same matrix under
    `pair_chains_iptm`. A tool that does not surface the matrix raises a
    `RuntimeError` — overall ipTM is not a valid substitute.
  </Note>

  <ParamField path="num_protein_copies" type="integer" default="2">
    Protein monomer copies in the complex (2=homodimer, 1=monomer); reuses input chains first.
  </ParamField>

  <ParamField path="pair_type" type="enum" default="protein-dna">
    Interface scored: 'protein-dna' (protein-DNA ipTM) or 'protein-protein' (homodimer ipTM).

    Options: `protein-dna`, `protein-protein`
  </ParamField>

  <ParamField path="desired_iptm" type="number" default="0.7">
    Target protein-DNA chain-pair ipTM. Score is 0 when achieved.
  </ParamField>

  <ParamField path="aggregation" type="enum" default="max">
    Aggregate protein-DNA chain-pair ipTM: 'max' (best pair) or 'mean' (average of pairs).

    Options: `max`, `mean`
  </ParamField>

  <ParamField path="include_reverse_complement" type="boolean" default="False">
    Add the reverse-complement DNA strand when the input has only one DNA sequence.
  </ParamField>

  <ParamField path="structure_tool" type="enum" default="alphafold3">
    Predictor for the protein-DNA complex; must be DNA-capable (alphafold3/boltz2/protenix).

    Options: `esmfold`, `esmfold2`, `alphafold3`, `boltz2`, `chai1`, `protenix`, `alphafold2`, `alphafold2_binder`
  </ParamField>

  <ParamField path="esmfold_config" type="ESMFoldConfig">
    Configuration for ESMFold structure prediction.
  </ParamField>

  <ParamField path="esmfold2_config" type="ESMFold2Config">
    Configuration for ESMFold2 structure prediction.
  </ParamField>

  <ParamField path="alphafold3_config" type="AlphaFold3Config">
    Configuration for AlphaFold3 structure prediction.
  </ParamField>

  <ParamField path="boltz2_config" type="Boltz2Config">
    Configuration for Boltz2 structure prediction.
  </ParamField>

  <ParamField path="chai1_config" type="Chai1Config">
    Configuration for Chai1 structure prediction.
  </ParamField>

  <ParamField path="protenix_config" type="ProtenixConfig">
    Configuration for Protenix structure prediction.
  </ParamField>

  <ParamField path="alphafold2_config" type="AlphaFold2Config">
    Configuration for the general AlphaFold2 multimer structure predictor.
  </ParamField>

  <ParamField path="alphafold2_binder_config" type="AlphaFold2BinderStructureConfig">
    Configuration for the AF2 binder-design backend.
  </ParamField>
</div>

<div class="api-model-section api-model-static api-output-section">
  <div class="api-model-header"><span class="api-model-badge api-output-badge">Returns</span><span class="api-model-name">ConstraintOutput</span></div>

  Per-proposal score in `[0, 1]` (lower is
  better) with `prot_dna_iptm` / `prot_prot_iptm` / `overall_iptm`
  metadata and the predicted Structure on slot 0.
</div>

## Usage

Programming a protein-DNA operator complex with Protenix:

```python python icon="python" theme={null}
>>> from proto_language.core import Segment
>>> protomer = Segment(length=120, sequence_type="protein")
>>> operator = Segment(length=20, sequence_type="dna")
>>> chain_pair_iptm = Constraint(
...     inputs=[protomer, operator],
...     function=af3_chain_pair_prot_dna_iptm_constraint,
...     function_config={"structure_tool": "protenix", "num_protein_copies": 2},
... )
```

## Metadata

| Property        | Value                                     |
| --------------- | ----------------------------------------- |
| Key             | `af3-chain-pair-prot-dna-iptm`            |
| Function        | `af3_chain_pair_prot_dna_iptm_constraint` |
| Category        | `protein_structure`                       |
| Mode            | `discrete`                                |
| Uses GPU        | `True`                                    |
| Supported Types | `protein`, `dna`                          |
