run_s3_analysis
Runs the S3 pipeline on a Scopus CSV/Excel export to detect research communities, best threshold, and outliers from title and abstract embeddings.
Instructions
Run the S3 pipeline on a Scopus CSV/Excel export (needs Title and Abstract; Year, Cited by, Authors, Author Keywords, References and EID are used if present).
Follows the published S3 method: embeds Title+Abstract (all-mpnet-base-v2), builds the time-ordered S3 graph, scans thresholds 0.75-0.85 and keeps the Leiden (directed modularity) partition with the highest SII (silhouette x retained papers). Set threshold (e.g. 0.78) to reproduce a published run, or community_method="louvain" to reproduce the S3 web app. embedding_model is a key from list_embedding_models or any sentence-transformers model name (ask the user first; default mpnet). Records without title and abstract are dropped and duplicates (same DOI/EID/text, or S3 >= 0.98) are removed unless remove_duplicates=False. map_relations chooses the map, and every answer and report follows it: "text" (default; S3 text similarity, the published method), "hybrid" when the user asks for a hybrid map (screens text plus each citation relation at 5-40% weight, as compare_maps does, and uses the best hybrid if it raises both silhouette and QI, else text), or a specific hybrid the user names: "text+coupling", "text+cocitation", "text+direct" (75%/25%) or weights such as "s3=0.8,coupling=0.2". strict_citations=True stops short titles such as "Introduction" from matching unrelated references. significant_ties_only=True keeps only coupling, co-citation and co-authorship ties that are significant under a degree-preserving null model (in the map and Q35-Q37). Can take several minutes for thousands of papers the first time; embeddings are cached afterwards.
Returns a run_id plus a summary: best threshold, communities, outlier count.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"csv_path": "<csv_path>"
},
"name": "run_s3_analysis"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | ||
| rerun | No | ||
| csv_path | Yes | ||
| end_year | No | ||
| threshold | No | ||
| start_year | No | ||
| map_relations | No | text | |
| embedding_model | No | mpnet | |
| community_method | No | leiden | |
| strict_citations | No | ||
| remove_duplicates | No | ||
| significant_ties_only | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |