@platforma-open/milaboratories.repertoire-mutation-heatmap.block 1.0.0

package/block-pack/description.md

@@ -0,0 +1,13 @@
+# Overview
+
+Visualizes the per-variant repertoire produced by the **Amplicon Repertoire Profiling** block as mutation-enrichment heat maps. It is built for deep mutational scanning (DMS), phage or yeast display selections, and affinity-maturation campaigns — wherever you need to see *which mutations are enriched* across a designed antibody/TCR library.
+
+The headline view is a position × residue heat map: for every position in a parent (reference) sequence, each cell summarizes the variants carrying a given residue at that position. Cells are coloured by aggregated abundance, or — by default — by per-position **state frequency**, the canonical enrichment readout in which each position column sums to one. The map is faceted by parent, since positions are only comparable within the same reference frame.
+
+A live filter selects the variant subset before aggregation and shows it **side by side with the unfiltered baseline**. Restrict the subset by sample or selection round, or by a per-variant property range — for example a Tite-Seq dissociation constant (Kd) — to ask "which mutations are enriched among the high-affinity binders?". Changing the filter re-runs the aggregation. Cells can instead be coloured by the **mean of a per-variant property** (such as binding affinity) across the variants carrying each residue, turning the same map into a property landscape.
+
+A second heat map shows known-variant × sample abundance, rendered directly from the profiler's pre-aggregated counts — useful for tracking designed variants across samples or selection rounds.
+
+This block consumes the outputs of the Amplicon Repertoire Profiling block directly; pair the two to go from raw amplicon reads to interpretable enrichment maps. Filtering or colouring by a measured property additionally uses a per-variant property column (e.g. a Kd) supplied by an upstream assay block.
+
+This block is built on the Platforma SDK and its GraphMaker visualization engine, developed by MiLaboratories Inc. For more information, please see the [MiLaboratories website](https://milaboratories.com/).

package/block-pack/manifest.json

@@ -0,0 +1 @@
+{"schema":"v2","description":{"id":{"organization":"milaboratories","name":"repertoire-mutation-heatmap","version":"1.0.0"},"components":{"workflow":{"type":"workflow-v1","main":{"type":"relative","path":"main.plj.gz"}},"model":{"type":"relative","path":"model.json"},"ui":{"type":"relative","path":"ui.tgz"}},"meta":{"title":"Deep Mutational Scanning","description":"Visualizes deep mutational scanning libraries as position × residue mutation-enrichment heatmaps over a live-filtered variant subset, plus a known-variant × sample abundance heatmap.","longDescription":{"type":"relative","path":"description.md"},"logo":{"type":"relative","path":"block-logo.png"},"url":"https://github.com/platforma-open/repertoire-mutation-heatmap","support":"mailto:support@milaboratories.com","tags":["downstream","dms","antibody"],"organization":{"name":"MiLaboratories Inc","url":"https://milaboratories.com/","logo":{"type":"relative","path":"organization-logo.png"}}},"featureFlags":{"supportsLazyState":true,"supportsPframeQueryRanking":true,"requiresUIAPIVersion":3,"requiresModelAPIVersion":2,"requiresCreatePTable":2,"requiresPFramesVersion":1001031,"requiresPFrameSpec":true,"requiresPFrame":true,"requiresDialog":true}},"timestamp":1782846461501,"files":[{"name":"main.plj.gz","size":477544,"sha256":"78F91AF78B92FE6A20A907E31E3645D99B9E69CA6C784F89224920C1E037BA1F"},{"name":"model.json","size":355231,"sha256":"8151BB3A702AC50ACB180F08E0053C829EB18260E7E70AFBA475AA1E66EC5B63"},{"name":"ui.tgz","size":6167759,"sha256":"E216BB35D8B89BEE859BD1508F2F72F3E2709015037AD705E2EF8C463D5B4D2C"},{"name":"organization-logo.png","size":24439,"sha256":"FA71390C77C91E4B7FAAE5640D00F92F1E3F2869296F68B6040DD7CC549A50B5"},{"name":"description.md","size":2102,"sha256":"BD3FDC5BDABC99A900BB9B012B04B226598A8FCABF20ED0597552CE4605A7D89"},{"name":"block-logo.png","size":21527,"sha256":"6BB33BAF0CD039549661B51AE490373BE60D1811EC71F5023400928293BC2427"}]}