Update paper.md

minor updates, fixed link.

Author: Corey-Abramson

documentation/paper.md

@@ -41,15 +41,21 @@ bibliography: paper_ref.bib
 
 
 # Summary
-The CMAP (cultural mapping and pattern analysis) visualization toolkit is an open-source suite for analyzing and visualizing qualitative text data—from fieldnotes and interview transcripts to historical documents and web pages—designed for scholars integrating pattern analysis, visualization, and alternative explanations within qualitative and/or computational social science (CSS). Despite off-the-shelf QDA software, there is little in the way of highly scalable or open source options, particularly those with transparent and adjustable statistics. The foundation of the toolkit is a pragmatic approach that aligns research tools with social science project goals—empirical explanation, theory-guided measurement, comparative design, or evidence-based recommendations—guided by the principle that research questions should determine methods.
+The CMAP (cultural mapping and pattern analysis) visualization toolkit is an open-source suite for analyzing and visualizing text data—from qualitative fieldnotes and in-depth interview transcripts to historical documents and web-scaped data like message board posts or blogs. The toolkit is designed for scholars integrating pattern analysis, data visualization, and explanation in qualitative and/or computational social science (CSS). 
+
+Despite the existence of off-the-shelf commercial qualitative data analysis software, there is a dearth of highly scalable  open source options that can work with large data sets, and allow advanced statistical and language modeling. 
+
+The foundation of the toolkit is a pragmatic approach that aligns research tools with social science project goals—empirical explanation, theory-guided measurement, comparative design, or evidence-based recommendations—guided by the principle that research paradigm and questions should determine methods. Consequently, the CMAP visualization toolkit offers a range of possibilities through the adjustment of relatively small number of parameters, and allows integration with other python tools.
 
 
 # Statement of need 
-This builds on sociological traditions of multi-method analysis, triangulation, and purposive computation to link levels of analysis and generate insights of scientific and practical importance [@dubois1899philadelphia; @lamont2009workshop; @small2011mixed]. Computational tools in this framework expand human inquiry, continuing a trajectory from statistical computing, qualitative data analysis software, CSS text analyses, and visualization to open science. The toolkit recognizes that computation is already embedded in research and daily life—from CAQDAS software to search algorithms—and can be used thoughtfully to advance sociological inquiry and ensure emergent technologies address pressing social issues [@abramson2025pragmatic; @grimmer2022text; @healy2014data; @nelson2020computational; @breiger2015scaling; @dohan1998using; @peponakis2023calculations; @fourcade2024ordinal].  
+This software builds on sociological traditions of multi-method analysis, triangulation, and purposive computation to link levels of analysis and generate insights of scientific and practical importance [@dubois1899philadelphia; @lamont2009workshop; @small2011mixed]. Computational tools in this framework expand human inquiry, continuing a trajectory from statistical computing, qualitative data analysis software, CSS text analyses, and visualization to open science. The toolkit proceeds from the premise that computation is already embedded in research and daily life—from CAQDAS software to search algorithms—and can be used thoughtfully to advance sociological inquiry and ensure emergent technologies address pressing social issues [@abramson2025pragmatic; @grimmer2022text; @healy2014data; @nelson2020computational; @breiger2015scaling; @dohan1998using; @peponakis2023calculations; @fourcade2024ordinal].  
+
+CMAP includes cutting-edge visualization options that are open source and accessible to those without extensive Python programming experience, making it adaptable as both a pedagogical and research tool—addressing core issues of training and accessibility important for expanding CSS proficiencies for qualitative researchers [@abramson2025pragmatic].  
 
-CMAP includes cutting-edge visualization options that are open source and accessible to those without extensive Python programming experience, making it adaptable as both a pedagogical and research tool—addressing core issues of training and accessibility important for expanding CSS proficiencies for qualitative researchers [@abramson2025pragmatic]. The toolkit supports advanced analytic methods appropriate for computational text analysis alongside in-depth readings—including co-occurrence, clustering and embedding approaches—with visuals such as heatmaps, t-SNE dimensional reduction plots (like a scatter plot, with words), semantic networks, word clouds, and more. Examples work with common qualitative data sources and allow granular analysis that mirrors qualitative practices (at the level of words, sentences, paragraphs), yet scale for large datasets produced by teams.  
+The toolkit supports advanced analytic methods appropriate for computational text analysis alongside in-depth readings—including co-occurrence, clustering and embedding approaches—with visuals such as heatmaps, t-SNE dimensional reduction plots (like a scatter plot, with words), semantic networks, word clouds, and more. Examples work with common qualitative data sources and allow granular analysis that mirrors qualitative practices (at the level of words, sentences, paragraphs), yet scale for large datasets produced by teams.  
 
-CMAP visualizations are designed for integration into research papers and pedagogical applications, addressing the dearth of open-source software accessible to qualitative researchers seeking scalable analytical tools with transparent statistical foundations. The toolkit runs efficiently on consumer grade hardware, without extensive setup.  
+CMAP visualizations are designed for integration into research papers and pedagogical applications, addressing the dearth of open-source software accessible to qualitative researchers seeking scalable analytical tools using established data visualizations with transparent statistical foundations. The toolkit runs efficiently on consumer grade hardware, without extensive setup, even when using advanced features like word embeddings.  
 
 The main paper charts organization and functions. Full mathematical details, related software resources, and representative scientific applications are provided in the Appendix.
 
@@ -131,7 +137,7 @@ Any data can be used as long as it includes the required fields from the schema
 
 ![Parameter schema for CMAP text segments. \label{schema}](figures/schema.png){width=70%}
 
-All parameters are configurable in labeled execution blocks (\autoref{config}), which set how the visuals are produced. For instance short text windows and few words for syntactic analyses, larger windows and more seeds to look at overlapping themes. Users can designate colored grouping to correspond to deeper readings of text [@abramson2024inequality].  
+All parameters are configurable in labeled execution blocks (\autoref{config}), which set how the visuals are produced. For instance short text windows and few words for syntactic analyses, larger windows and more seeds to look at overlapping themes. Users can designate colored grouping to correspond to deeper readings of text [@abramson2024inequality] or use lists to compress concepts earlier in the pipeline.  
 
 ![Configurable Execution Block. \label{config}](figures/config.png){width=70%}
 
@@ -369,10 +375,10 @@ Deliberately choosing not to automate analysis when ethical considerations. Docu
 - Abramson, Corey M., Tara Prendergast, Zhuofan Li, and Martín Sánchez-Jankowski. 2024. "Inequality in the Origins and Experiences of Pain: What 'Big (Qualitative) Data' Reveal About Social Suffering in the United States." *Russell Sage Foundation Journal of the Social Sciences* 10(5):34-65. [Link](https://www.rsfjournal.org/content/rsfjss/10/5/34.full.pdf)  
 - Arteaga, Ignacia, Alma Hernández de Jesús, Brandi Ginn, Corey M. Abramson, and Daniel Dohan. 2025. "Understanding How Social Context Shapes Decisions to Seek Institutional Care: A Qualitative Study of Experiences of Progressive Cognitive Decline Among Latinx Families." *The Gerontologist* gnaf207. [Link](https://doi.org/10.1093/geront/gnaf207)  
 - Li, Zhuofan and Corey M. Abramson. 2025. "Ethnography and Machine Learning: Synergies and Applications." In *Oxford Handbook of the Sociology of Machine Learning*, edited by [editors]. Oxford University Press. [Preprint](https://arxiv.org/abs/2412.06087)  
-- Abramson, Corey M., Zhuofan Li, and Tara Prendergast. Expected 2026. "Qualitative Research in an Era of AI: A Pragmatic Approach to Data Analysis, Workflow, and Computation." *Annual Review of Sociology*. [Preprint available]
+- Abramson, Corey M., Zhuofan Li, and Tara Prendergast. Expected 2026. "Qualitative Research in an Era of AI: A Pragmatic Approach to Data Analysis, Workflow, and Computation." *Annual Review of Sociology*. [Preprint available](https://arxiv.org/pdf/2509.12503)
 
 ### Conference Presentations (2024-2025)
 
-- Abramson, Corey M., Kieran Turner, Ignacia Arteaga, Alma Hernández de Jesús, Brandi Ginn, Yuhan Nian, and Daniel Dohan. 2025. "Pragmatic Sensemaking: Semantic Maps of Dementia Narratives." ARS'25: Tenth International Workshop on Social Network Analysis. Naples, Italy. [Preprint](https://arxiv.org/pdf/2509.12503)
+- Abramson, Corey M., Kieran Turner, Ignacia Arteaga, Alma Hernández de Jesús, Brandi Ginn, Yuhan Nian, and Daniel Dohan. 2025. "Pragmatic Sensemaking: Semantic Maps of Dementia Narratives." ARS'25: Tenth International Workshop on Social Network Analysis. Naples, Italy.
 - Abramson, Corey M., Kieran Turner,Ignacia Arteaga, Alma Hernández de Jesús, Brandi Ginn, Yuhan Nian, and Daniel Dohan. 2025. "Pragmatic Sensemaking: Mapping the Cultural Work of Living with Dementia." American Sociological Association Annual Meeting. Chicago, IL.  
 - Abramson, Corey M., Zhuofan Li, and Tara Prendergast. 2024. "Qualitative Sociology in a Computational Era: Classic Issues, Emerging Trends, and New Possibilities." American Sociological Association Annual Meeting. Montreal, Canada.