alterlab-mixed-methods

$npx mdskill add AlterLab-IEU/AlterLab-Academic-Skills/alterlab-mixed-methods

Designs and integrates mixed methods research combining qualitative and quantitative approaches.

  • Plan convergent, sequential, embedded, or multiphase mixed methods designs.
  • Uses WebFetch, WebSearch, and Python helpers for guidance and examples.
  • Selects design based on research questions and integration strategies.
  • Provides frameworks, notation systems, and quality criteria for mixed methods.

SKILL.md

.github/skills/alterlab-mixed-methodsView on GitHub ↗
---
name: alterlab-mixed-methods
description: "Mixed methods research design and integration strategies for combining qualitative and quantitative approaches. Use when planning convergent, explanatory sequential, exploratory sequential, embedded, transformative, or multiphase designs; when integrating diverse data sources through merging, connecting, or embedding; when constructing joint displays or meta-inferences; or when evaluating quality criteria specific to mixed methods research. Covers Creswell & Plano Clark frameworks, notation systems, and software tools for integration. For single-strand qualitative coding (thematic analysis, grounded theory, saturation, inter-coder reliability) use alterlab-qualitative-methods; for questionnaire/Likert/instrument-validation mechanics use alterlab-survey-design. Part of the AlterLab Academic Skills suite."
license: MIT
allowed-tools: Read WebFetch WebSearch Bash(python:*)
compatibility: No API key required. Guidance-focused skill; uses WebFetch/WebSearch and optional Python helpers via `uv run python`.
metadata:
  skill-author: AlterLab
  version: "1.0.0"
  last_updated: "2026-03-18"
---

# Mixed Methods Research Design

## Overview

Mixed methods research is a methodology that combines quantitative and qualitative research approaches within a single study or program of inquiry. It goes beyond simply collecting both types of data — it requires intentional integration at one or more stages of the research process (design, methods, interpretation, reporting) to generate insights that neither approach could produce alone. This skill provides comprehensive guidance on designing, executing, and reporting mixed methods studies according to established frameworks, with particular emphasis on the Creswell & Plano Clark typology and the integration strategies that distinguish rigorous mixed methods from mere parallel data collection.

Mixed methods emerged as a recognized "third methodological movement" in the early 2000s, though researchers had been combining approaches for decades. Its legitimacy rests on the philosophical position of pragmatism — selecting methods based on what works best to answer the research questions rather than adhering to a single paradigm. Today, mixed methods is a requirement or strong recommendation in many funding agencies (NIH, NSF, ESRC) and is increasingly expected in fields such as health sciences, education, evaluation research, and social policy.

## When to Use This Skill

Use this skill when:
- Designing a study that requires both statistical generalizability and contextual depth
- Planning how to combine qualitative and quantitative strands in a coherent design
- Choosing between convergent, explanatory sequential, exploratory sequential, embedded, transformative, or multiphase designs
- Developing integration strategies (merging, connecting, embedding) for multi-strand studies
- Constructing joint displays to visualize integrated findings
- Formulating meta-inferences that go beyond what either strand alone could produce
- Writing the methods section of a mixed methods manuscript or proposal
- Evaluating the quality, legitimacy, or rigor of a mixed methods study
- Using the Creswell & Plano Clark notation system to diagram a design
- Selecting software tools for managing mixed methods data integration
- Preparing a mixed methods study for IRB review with multiple data collection phases
- Responding to reviewer critiques about the rationale for mixing methods

## Core Capabilities

### 1. Mixed Methods Design Typology

The following designs represent the major archetypes. In practice, many studies adapt or combine these.

#### Convergent Parallel Design (QUAL + QUAN)

Both strands are collected and analyzed concurrently, then merged for interpretation.

```
Notation: QUAL + QUAN → Merge → Interpretation

Timeline:
  Phase 1 (concurrent):
    ├── Quantitative data collection & analysis
    └── Qualitative data collection & analysis
  Phase 2:
    └── Merge results → Compare, contrast, synthesize

Purpose: Triangulation, complementarity, or obtaining a more complete understanding

Example research question:
  "How do survey measures of teacher self-efficacy converge with or diverge
   from teachers' narrative accounts of their classroom confidence?"
```

**Key decisions in convergent design:**
- Sample: Same participants (identical samples), overlapping samples, or parallel samples?
- Timing: Truly concurrent or within the same broad phase?
- Merging point: At the results level (side-by-side comparison) or at the data transformation level (qualitizing or quantitizing)?
- Handling discrepancy: What if findings conflict? Plan for this a priori.

A worked convergent-design joint display (survey statistics vs. interview themes with per-row convergence assessment and meta-inference) is in `references/joint_display_templates.md`.

#### Explanatory Sequential Design (QUAN → qual)

Quantitative data is collected and analyzed first; qualitative data is then collected to explain or elaborate on quantitative results.

```
Notation: QUAN → qual → Interpretation

Timeline:
  Phase 1: Quantitative data collection & analysis
  Phase 2: Identify results needing explanation
           (outliers, unexpected findings, significant predictors)
  Phase 3: Qualitative data collection targeting those results
  Phase 4: Qualitative analysis
  Phase 5: Integration and interpretation

Connection point: Quantitative results inform qualitative sampling and protocols

Example research question:
  "What factors explain why some departments showed significant improvement
   in research output while others with similar resources did not?"
```

**Participant selection strategies for the qualitative phase:**
```python
# Conceptual selection logic for explanatory sequential design
def select_qualitative_participants(quant_results):
    """
    Common strategies for selecting participants
    for the qualitative follow-up phase.
    """
    strategies = {
        "extreme_cases": "Select participants at the extremes of the distribution",
        "outlier_cases": "Select participants whose outcomes deviate from predictions",
        "typical_cases": "Select participants near the mean for each subgroup",
        "maximal_variation": "Select across the full range of the key variable",
        "confirming_disconfirming": "Select cases that support and challenge quant findings",
        "subgroup_follow_up": "Select from each statistically identified subgroup"
    }

    # Example: Follow up on regression residuals
    high_residual = quant_results[quant_results['residual'].abs() > 2.0]
    typical = quant_results[quant_results['residual'].abs() < 0.5].sample(n=5)

    return {
        "outliers": high_residual,
        "typical": typical,
        "rationale": "Comparing outlier and typical cases to explain model misfit"
    }
```

#### Exploratory Sequential Design (qual → QUAN)

Qualitative data is collected first to explore a phenomenon; findings inform the development of a quantitative instrument or phase.

```
Notation: qual → QUAN → Interpretation

Timeline:
  Phase 1: Qualitative data collection & analysis
  Phase 2: Develop quantitative instrument/variables from qual findings
           (e.g., survey items derived from interview themes)
  Phase 3: Quantitative data collection & analysis
  Phase 4: Integration and interpretation

Connection point: Qualitative findings generate hypotheses, variables, or instruments
                  for the quantitative phase

Common applications:
  - Instrument development (qual themes → survey items → psychometric validation)
  - Taxonomy development (qual categories → quantitative classification testing)
  - Theory generation (qual grounded theory → quantitative hypothesis testing)
```

**Instrument development workflow:**
```
Qualitative Phase:
  Interviews (n=20-30) → Thematic analysis → Identify constructs and language

Connecting Bridge:
  Themes → Item pool → Expert review → Cognitive interviews → Pilot items

Quantitative Phase:
  Survey (n=300+) → Exploratory factor analysis → Confirmatory factor analysis
  → Reliability testing → Validity evidence (convergent, discriminant, criterion)
```

#### Embedded Design (QUAN[qual] or QUAL[quan])

One strand is primary; the other is embedded within it to enhance the primary design.

```
Notation: QUAN(qual) — Quantitative primary with embedded qualitative

Example: Randomized controlled trial with embedded qualitative process evaluation

  ┌─────────────────────────────────────────────┐
  │  RCT (Primary Quantitative Design)          │
  │                                              │
  │  Treatment group ──→ Outcome measures        │
  │       │                                      │
  │       └──→ [Qualitative interviews at        │
  │             midpoint to understand            │
  │             implementation fidelity           │
  │             and participant experience]       │
  │                                              │
  │  Control group ──→ Outcome measures          │
  └─────────────────────────────────────────────┘

Purpose: The qualitative strand answers a secondary question
         within the larger quantitative framework
```

#### Transformative Design

Any mixed methods design organized within a transformative theoretical framework (feminist, critical race theory, disability studies, postcolonial, etc.) that centers equity, justice, and the perspectives of marginalized communities.

```
Key principles:
  1. Research questions address power, oppression, or social justice
  2. Marginalized community members participate in design decisions
  3. Methods are selected to amplify silenced voices
  4. Integration explicitly examines how findings relate to structural inequity
  5. Results include action agendas and recommendations for change

Notation adds a framework wrapper:
  Transformative Framework [QUAL → QUAN]
  or
  Transformative Framework [QUAL + QUAN]
```

#### Multiphase Design

A programmatic approach where multiple mixed methods projects build on each other over time, common in large-scale program evaluation and longitudinal research.

```
Notation: Study 1 (QUAN) → Study 2 (qual) → Study 3 (QUAL + QUAN) → ...

Example: Multi-year curriculum evaluation program
  Year 1: Needs assessment (QUAL → QUAN)
  Year 2: Pilot intervention (QUAN with embedded qual)
  Year 3: Full-scale RCT (QUAN → qual for process evaluation)
  Year 4: Sustainability study (QUAL + QUAN convergent)
```

### 2. The Notation System

The Creswell & Plano Clark notation system communicates design decisions concisely:

```
Symbol Reference:
  UPPERCASE   = Priority/emphasis strand (e.g., QUAN = quantitative is primary)
  lowercase   = Secondary/supplementary strand (e.g., qual = qualitative is secondary)
  +           = Concurrent/simultaneous collection
  →           = Sequential collection (left happens before right)
  ( )         = Embedded strand within a larger design
  [ ]         = Framework wrapper (e.g., transformative, pragmatic)
  { }         = Sometimes used for the integration/merging phase

Common patterns:
  QUAN + QUAL      Convergent, equal weight
  QUAN → qual      Explanatory sequential, quantitative dominant
  qual → QUAN      Exploratory sequential, quantitative dominant
  QUAN(qual)       Embedded qualitative within quantitative
  Trans[QUAL + QUAN]  Transformative convergent design

Expanded notation (Morse, 2003):
  Uses + for simultaneous, → for sequential
  All caps for driving component, lowercase for supplementary
  Example: QUAL + quan  (qualitative-dominant concurrent)
```

### 3. Integration Strategies

Integration is the hallmark of mixed methods research. Without intentional integration, you have a multi-method study, not a mixed methods study.

#### Merging (for convergent designs)

```
Merging Techniques:

1. Side-by-side comparison
   - Present quantitative and qualitative findings in parallel
   - Use a joint display to compare directly
   - Assess convergence, complementarity, or divergence

2. Data transformation
   a. Quantitizing: Converting qualitative data to numeric form
      - Frequency counts of themes across participants
      - Binary coding of theme presence/absence
      - Rating scales applied to qualitative categories

   b. Qualitizing: Converting quantitative data to qualitative form
      - Creating narrative profiles from cluster analysis results
      - Developing case descriptions from survey response patterns

3. Joint displays (see templates below)
```

#### Connecting (for sequential designs)

```
Connecting Techniques:

1. Building (qual → QUAN)
   - Qualitative findings directly inform quantitative design
   - Example: Interview themes → survey items → factor analysis

2. Explaining (QUAN → qual)
   - Quantitative results identify what to explore qualitatively
   - Example: Regression outliers → purposeful sampling → interviews

3. Participant selection
   - One strand identifies participants for the other
   - Example: Survey screening → interview sample selection
```

#### Embedding

```
Embedding Techniques:

1. Within-design embedding
   - Secondary strand operates within the primary design structure
   - Example: Process evaluation interviews within an RCT

2. Framework embedding
   - Both strands serve a larger theoretical or programmatic purpose
   - Data integration occurs at the framework level
```

### 4. Joint Displays

Joint displays are visual representations that bring quantitative and qualitative findings together in a single display for integrated analysis. Four ready-to-use layouts — side-by-side comparison, statistics-by-themes matrix, case-oriented display, and process/timeline display — plus a worked convergent-design example are in `references/joint_display_templates.md`. Copy a template, populate both strands, then add the integration/meta-inference column.

### 5. Meta-Inferences

Meta-inferences are the overarching conclusions drawn from integrating quantitative inferences and qualitative inferences. They represent the "value added" of mixed methods.

```
Meta-Inference Development Process:

Step 1: State quantitative inferences
  "Survey data indicate that 73% of participants improved on outcome X,
   with intervention dosage as the strongest predictor (β = .45, p < .001)."

Step 2: State qualitative inferences
  "Interview data reveal three pathways to improvement: peer support,
   self-directed practice, and facilitator scaffolding. Participants
   described dosage as necessary but insufficient without peer support."

Step 3: Develop meta-inferences
  "Integrating both strands, dosage operates as a quantitative proxy for
   engagement intensity, but the qualitative mechanism is relational —
   higher dosage provides more opportunity for peer support, which is
   the active ingredient. This suggests interventions should optimize
   for peer interaction quality, not merely contact hours."

Quality criteria for meta-inferences:
  - Integrative efficacy: Does the meta-inference go beyond either strand alone?
  - Interpretive consistency: Is it supported by both strands of evidence?
  - Interpretive distinctness: Does it offer a unique insight?
  - Integrative correspondence: Does it address the mixed methods research question?
```

### 6. Quality Criteria for Mixed Methods Research

Rigor is judged against Onwuegbuzie & Johnson's (2006) nine legitimation types — sample integration, inside-outside, weakness minimization, sequential, conversion, paradigmatic mixing, commensurability, multiple validities, and political legitimation — plus Creswell & Plano Clark's additional standards (clear mixed methods question, justified rationale, rigorous individual strands, explicit integration, coherent worldview, feasibility). The full annotated legitimation framework and standards, alongside GRAMMS and MMAT checklists, are in `references/mixed-methods-frameworks.md`.

### 7. Software Tools for Mixed Methods Integration

Dedicated platforms (NVivo, MAXQDA, Dedoose) support integrated projects and joint displays; quantitative work runs in R, SPSS, Stata, or Python, qualitative work in the CAQDAS tools above, and integration/visualization in R, Python, or Tableau. The full annotated catalog — including data-management (OSF, REDCap, Qualtrics) and diagramming (Lucidchart, draw.io, TikZ) tools — is in `references/software_and_reporting.md`.

### 8. Writing a Mixed Methods Methods Section

A methods section names and diagrams the design, describes sampling and data collection per strand, and — critically — makes the integration procedures explicit, then reports strand-specific and mixed methods quality criteria. The full section-by-section template (Research Design, Participants and Sampling, Data Collection, Data Analysis, Quality and Rigor) is in `references/software_and_reporting.md`.

### 9. Common Mixed Methods Research Questions

Mixed methods questions take three structures: a single hybrid question, separate strand questions plus an integration question, or phased questions for sequential designs. Worked examples of each are in `references/software_and_reporting.md`.

## Best Practices

1. **Start with the research question** — Let the question dictate the design, not the other way around. If a single method can answer your question, do not use mixed methods just to appear rigorous.

2. **Name and diagram your design** — Use the Creswell & Plano Clark notation and include a visual procedural diagram in every proposal and manuscript.

3. **Plan integration from the start** — Integration is not an afterthought. Specify integration points, strategies, and expected products (joint displays, meta-inferences) in your proposal.

4. **Build a team with diverse expertise** — Few researchers are expert in both advanced quantitative and qualitative methods. Collaborate with specialists in each tradition.

5. **Budget time and resources realistically** — Mixed methods takes longer and costs more. A convergent design requires running two full studies simultaneously. Sequential designs require waiting for Phase 1 results before designing Phase 2.

6. **Use the notation system consistently** — Uppercase for priority strand, lowercase for supplementary, arrows for sequence, plus signs for concurrent collection.

7. **Address philosophical foundations** — Reviewers will ask. Pragmatism is the most common worldview, but transformative, critical realist, and dialectical positions are also legitimate. State your position and its implications.

8. **Report integration explicitly** — The most common reviewer critique of mixed methods papers is "these are two separate studies stapled together." Prevent this by dedicating a results section to integration findings, using joint displays, and articulating meta-inferences.

9. **Pilot both strands** — Pilot your quantitative instruments AND qualitative protocols. For sequential designs, pilot the connection between phases.

10. **Follow reporting guidelines** — Use the GRAMMS (Good Reporting of A Mixed Methods Study) guidelines or the Mixed Methods Appraisal Tool (MMAT) as a checklist.

## Common Pitfalls

1. **No actual integration** — Collecting both types of data but analyzing and reporting them separately without integration. This is multi-method research, not mixed methods.

2. **Superficial qualitative strand** — Adding a few open-ended survey questions and calling it mixed methods. True qualitative strands require purposeful sampling, rich data, and systematic analysis.

3. **Mismatch between design and execution** — Claiming an explanatory sequential design but collecting qualitative data concurrently because of time pressure. Name the design you actually used.

4. **Ignoring discrepant findings** — When quantitative and qualitative findings conflict, this is often the most interesting result. Do not suppress discrepancies; analyze and discuss them.

5. **Inadequate sampling justification** — Not explaining why the quantitative sample is 500 but the qualitative sample is 15. Different strands have different sampling logics and different adequacy criteria.

6. **Missing philosophical discussion** — Failing to articulate why combining paradigms is defensible in your study. Reviewers in methods-focused journals will flag this.

7. **Overcomplicating the design** — Using multiphase or complex embedded designs when a simple convergent or sequential design would suffice. Match complexity to the research question.

8. **Insufficient expertise** — Attempting advanced mixed methods without training or collaboration in both traditions. Each strand must meet the quality standards of its own tradition.

9. **Timing failures in sequential designs** — Not leaving enough time between phases to analyze Phase 1 results and design Phase 2. This is a project management issue that undermines methodological rigor.

10. **Vague integration language** — Saying findings were "combined" or "synthesized" without specifying how. Use precise integration vocabulary: merged via joint display, connected through participant selection, embedded within experimental design.

## References

- Creswell, J. W., & Plano Clark, V. L. (2018). *Designing and Conducting Mixed Methods Research* (3rd ed.). Sage.
- Teddlie, C., & Tashakkori, A. (2009). *Foundations of Mixed Methods Research*. Sage.
- Morse, J. M. (2003). Principles of mixed methods and multimethod research design. In A. Tashakkori & C. Teddlie (Eds.), *Handbook of Mixed Methods in Social and Behavioral Research* (pp. 189-208). Sage.
- Onwuegbuzie, A. J., & Johnson, R. B. (2006). The validity issue in mixed research. *Research in the Schools*, 13(1), 48-63.
- Fetters, M. D., Curry, L. A., & Creswell, J. W. (2013). Achieving integration in mixed methods designs—principles and practices. *Health Services Research*, 48(6pt2), 2134-2156.
- Guetterman, T. C., Fetters, M. D., & Creswell, J. W. (2015). Integrating quantitative and qualitative results in health science mixed methods research through joint displays. *Annals of Family Medicine*, 13(6), 554-561.
- O'Cathain, A., Murphy, E., & Nicholl, J. (2008). The quality of mixed methods studies in health services research. *Journal of Health Services Research & Policy*, 13(2), 92-98.
- Schoonenboom, J., & Johnson, R. B. (2017). How to construct a mixed methods research design. *Kolner Zeitschrift fur Soziologie und Sozialpsychologie*, 69(Suppl 2), 107-131.

See also:
- `references/mixed-methods-frameworks.md` — design typology comparisons, detailed integration techniques, legitimation framework, GRAMMS/MMAT checklists, philosophical worldviews, and reading lists.
- `references/joint_display_templates.md` — four joint display layouts plus a worked convergent-design example.
- `references/software_and_reporting.md` — software catalog, methods-section template, and research-question structures.

Part of the AlterLab Academic Skills suite.

More from AlterLab-IEU/AlterLab-Academic-Skills

SkillDescription
alterlab-abm-mesaBuilds agent-based models of social systems with Mesa 3 — the current AgentSet API (model.agents.shuffle_do('step'), auto-assigned unique_id, mandatory super().__init__(seed=...)), cell spaces (mesa.discrete_space OrthogonalMooreGrid / classic mesa.space grids), the DataCollector, batch_run parameter sweeps, and SolaraViz — for emergence, segregation, diffusion, opinion dynamics, and cooperation models. It uses the Mesa 3.x API (the old mesa.time schedulers like RandomActivation are removed) and treats the model as a generative theory to be validated, not just run. Use when the request mentions an agent-based model, Mesa, simulating interacting agents, or emergent macro behavior from micro rules. For discrete-event (queueing/process) simulation prefer alterlab-simpy; for reinforcement learning prefer alterlab-stable-baselines3. Part of the AlterLab Academic Skills suite.
alterlab-academic-careerPrepares academic career documents and professional-development materials for faculty and researchers. Use when drafting academic CVs, research statements, teaching philosophies, diversity statements, faculty-position cover letters, tenure dossiers, promotion narratives, academic portfolios, or mentorship statements, and when planning conference-networking strategy, building academic web presence, setting up ORCID profiles, or understanding impact metrics. Part of the AlterLab Academic Skills suite.
alterlab-accreditation-aolScaffolds program-level Assurance-of-Learning (AoL) documentation for AACSB (2020 Standard 5) and ABET (Criterion 3 Student Outcomes, Criterion 4 Continuous Improvement) accreditation — program learning outcomes / competency goals, curriculum-to-outcome mapping matrices, direct- and indirect-assessment plans, rubric design, and closing-the-loop continuous-improvement narratives — and validates the structure of an outcome-mapping matrix with scripts/aol_matrix.py. Use when the user needs AACSB or ABET assurance-of-learning material, a program-learning-outcomes set, a curriculum/outcome map or coverage matrix, a direct/indirect assessment plan, a closing-the-loop report, or accreditation self-study text. For single-course design or course rubrics prefer alterlab-teaching-design; for post-award grant reports prefer alterlab-grant-reporting. Part of the AlterLab Academic Skills suite.
alterlab-adaptyvSubmits and tracks protein-testing experiments on the Adaptyv Bio Foundry cloud lab (wet-lab validation), and optimizes protein sequences before submission with computational tools (NetSolP, SoluProt, SolubleMPNN, ESM). Use when designing proteins that need wet-lab validation - binding/affinity screening, expression testing, thermostability, or fluorescence assays - or when submitting experiments to the Foundry API, browsing the target catalog, tracking experiment status, retrieving results, or pre-screening sequences for solubility/expression. Triggers on "Adaptyv", "Foundry API", "cloud lab", "biolayer interferometry / BLI", "wet-lab validation". Part of the AlterLab Academic Skills suite.
alterlab-aeonRuns time series machine learning with the aeon library — classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search via scikit-learn compatible APIs. Use when working with temporal data, sequential patterns, or time-indexed observations (univariate or multivariate) that need specialized algorithms beyond standard ML approaches. Part of the AlterLab Academic Skills suite.
alterlab-akademik-tesvikComputes the annual Turkish academic-incentive (akademik teşvik) score for Devlet (state) university öğretim elemanı (academic staff) from a classified activity list, applying the verified Akademik Teşvik Ödeneği Yönetmeliği (2018/11834) Faaliyet Hesaplama Tablosu headline puanları (Proje 20, Araştırma 15, Yayın 30, Patent 30, Atıf 30, Tebliğ 20, Ödül 20) with the k (author-count), p (Q1 1/Q2 0.8/Q3 0.5/Q4 0.25), and r (project-role) coefficients via türü puanı = Σ(faaliyet oranları) × headline (MADDE 8/2), then enforcing the per-type headline ceilings, the 100 cap (MADDE 8/3), and the net-30 payment gate (MADDE 10/3) in a deterministic scripts/tesvik_score.py. Use when the user wants to calculate akademik teşvik puanı, check the en az 30 (net-30) threshold, apply TABLO 4 ceilings, or estimate teşvik eligibility; keeps its coefficients separate from doçentlik scoring. For doçentlik point eligibility prefer alterlab-docentlik-eligibility. Part of the AlterLab Academic Skills suite.
alterlab-alpha-vantageAccesses real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API (requires a free API key from alphavantage.co). Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Part of the AlterLab Academic Skills suite.
alterlab-alphafoldPredict protein 3D structures with AlphaFold2 via ColabFold — MMseqs2-accelerated MSAs, monomer and AlphaFold2-Multimer complex folding, and confidence-based validation (pLDDT, pTM/ipTM, PAE). Use when folding a protein sequence or complex from FASTA, generating a predicted structure with confidence metrics, ranking models, or checking self-consistency of a design. For co-folding a protein WITH a small-molecule ligand or predicting binding affinity prefer alterlab-boltz; for antibody–antigen or one-FASTA multi-entity complexes prefer alterlab-chai; to LOOK UP an already-computed structure prefer alterlab-alphafold-db; for ESM embeddings or inverse folding prefer alterlab-esm. Part of the AlterLab Academic Skills suite.
alterlab-alphafold-dbAccess the AlphaFold DB of 200M+ AI-PREDICTED protein structures — retrieve models by UniProt accession, download PDB/mmCIF files, and analyze prediction confidence metrics (pLDDT, PAE). Use when a UniProt ID needs a computationally predicted 3D structure or when no experimental structure exists, for homology modeling, protein engineering, or structure-based drug discovery; for EXPERIMENTALLY determined structures (X-ray, cryo-EM, NMR) prefer alterlab-pdb, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Skills suite.
alterlab-anndataBuild, slice, concatenate, read, and write AnnData annotated data matrices (obs, var, X, layers, obsm, uns) — the scverse data STRUCTURE, not an analysis pipeline. Use when creating or wrangling .h5ad/zarr files, managing cell and gene annotations, concatenating batches, or handling layers/obsm/backed-mode; for the QC, normalization, clustering, UMAP, and differential-expression analysis pipeline prefer alterlab-scanpy instead, and for RNA velocity from spliced/unspliced layers prefer alterlab-scvelo instead. Part of the AlterLab Academic Skills suite.