scitex_scholar.migration

Connected Papers migration for scitex_scholar.

Import: Fetch a Connected Papers graph and convert to CitationGraph or Papers. Export: Convert CitationGraph to BibTeX/JSON importable by CP web UI.

Usage:

from scitex_scholar.migration import from_connected_papers, to_connected_papers

result = from_connected_papers("649def34f8be52c8b66281af98ae884c09aef38b")
result = to_connected_papers(graph, output="./export")
scitex_scholar.migration.from_connected_papers(paper_id, *, cp_api_key=None, s2_api_key=None, output_format='citation_graph', dry_run=False)[source]

Import a Connected Papers graph into scitex.

Parameters:

  • paper_id (str) – Semantic Scholar paper ID (40-char SHA) for the seed paper.

  • cp_api_key (Optional[str]) – Connected Papers API key.

  • s2_api_key (Optional[str]) – Semantic Scholar API key for DOI resolution.

  • output_format (str) – “citation_graph” returns CitationGraph, “papers” returns Papers.

  • dry_run (bool) – If True, fetch and report stats without creating objects.

Returns:

{success: True, graph/papers, stats, warnings} or {success: False, error: str}.

Return type:

Dict[str, Any]

scitex_scholar.migration.to_connected_papers(graph, *, output=None)[source]

Export a CitationGraph as BibTeX/JSON for Connected Papers.

Parameters:

  • graph (CitationGraph) – Citation graph to export.

  • output (Union[Path, str, None]) – Output directory. Defaults to current directory.

Returns:

{success, bibtex_path, json_path, paper_count} or {success: False, error}.

Return type:

Dict[str, Any]