Scientific Citation Network and Knowledge Mapper

When to Use This Skill

• identifying seminal papers in a research field
• mapping research lineage and intellectual heritage
• discovering related work through reference tracking
• finding potential collaborators through co-citation analysis
• tracking citation patterns to identify research trends
• building literature reviews with comprehensive coverage

Quick Start

from scripts.main import CitationChasingMapping

# Initialize the tool
tool = CitationChasingMapping()

from scripts.citation_mapper import CitationNetworkMapper

mapper = CitationNetworkMapper(data_source="PubMed")

# Build citation network from seed paper
network = mapper.build_network(
    seed_paper={
        "pmid": "12345678",
        "title": "Breakthrough Discovery in Immunotherapy"
    },
    backward_depth=2,  # references of references
    forward_depth=2,   # citing papers of citing papers
    max_papers=500
)

# Identify seminal papers
seminal_papers = mapper.identify_seminal_works(
    network=network,
    min_citations=100,
    centrality_threshold=0.8
)

print(f"Found {len(seminal_papers)} highly influential papers:")
for paper in seminal_papers[:5]:
    print(f"  - {paper.title} (cited {paper.citation_count} times)")

# Find research clusters
clusters = mapper.identify_research_clusters(
    network=network,
    algorithm="louvain",
    min_cluster_size=10
)

# Generate collaboration map
collaboration_map = mapper.generate_collaboration_network(
    network=network,
    institution_field="affiliation"
)

# Create visualization
mapper.visualize_network(
    network=network,
    layout="force_directed",
    color_by="publication_year",
    size_by="citation_count",
    output_file="citation_network.pdf"
)

Core Capabilities

1. Build Comprehensive Citation Networks

Construct bidirectional citation graphs from seed papers with configurable depth.

# Build network from multiple seed papers
network = mapper.build_network(
    seed_papers=[
        {"pmid": "12345678", "title": "Original Discovery"},
        {"pmid": "87654321", "title": "Follow-up Study"}
    ],
    backward_depth=3,  # References
    forward_depth=2,   # Citing papers
    max_papers=1000,
    include_citations=True
)

# Export network for Gephi
mapper.export_network(network, format="gexf", file="network.gexf")

2. Identify Seminal Works

Use centrality metrics to find field-defining papers.

# Calculate centrality metrics
centrality = mapper.calculate_centrality(
    network=network,
    metrics=["betweenness", "eigenvector", "pagerank"]
)

# Identify seminal papers
seminal = mapper.identify_seminal_works(
    centrality=centrality,
    min_citations=100,
    top_n=20
)

for paper in seminal:
    print(f"{paper.title}: {paper.centrality_score}")

3. Discover Research Clusters

Detect communities and emerging research topics.