Litmaps

Add articles to a saved Litmap. Call show_litmap afterwards to show the updated Litmap in the conversation.

add_articles_to_litmap

Add articles to a collection.

add_articles_to_collection

Annotate a Litmap that already exists, the way a user can in the Litmaps app: give papers a short label, a coloured outline or an icon, and put papers into named, coloured groups. Fields left unset are unchanged. It can replace or remove labels, outlines and icons the user made, and recolour their tags, so the user is asked to confirm. Groups are Litmaps tags (collections): a group reuses the workspace's tag of the same name or creates one, adds the papers to it, and shows it on this Litmap. To annotate a Litmap you're creating, pass the annotations to create_litmap instead.

annotate_litmap

Check whether a DOI has been retracted. Worth running before relying on a paper.

check_retraction

Create a new Litmap (a saved citation map) in the user's workspace, optionally with articles on it, labelled and grouped as it's created: pass `articles` (a short label, coloured outline or icon per paper) and `groups` (named, coloured groups of papers, stored as Litmaps tags). Annotating here only adds to the user's account, so prefer it to a separate annotate_litmap call. Use it when the user wants to keep a Litmap; to just show papers, use show_litmap with their article IDs, which saves nothing.

create_litmap

Create a new collection (shown as a Tag in the Litmaps app) in a workspace. Leave colour unset to get a brand colour the workspace uses least.

create_collection

Find papers similar or related to one or more seed articles. The core discovery tool. For 'similar papers', 'related work' or expanding a literature search, use the default strategy, citation_connected: Litmaps' citation-connected ranking of papers sharing citations and references with the seeds. Other strategies return reference lists, citing papers, shared authors, or text similarity. Show the papers you pick as a Litmap with show_litmap; if a Litmap is already in the conversation, add them to it with add_articles_to_litmap and call show_litmap again, rather than only listing them.

find_related_articles

Fetch a Litmap's details and the articles on it.

get_litmap_articles

The papers, citations, annotations and groups of a Litmap, for the Litmap view to draw. Only the view calls it.

get_litmap_graph

Fetch an article's authors in order, with their position on the paper.

get_article_authors