Trace DataCite relations
datacite_trace_relationsMap the relation graph around one DOI — versions, parts, supplements, derivations, documentation, citations, references, and every other DataCite relation type — as nodes and directed edges that keep the relationType exactly as asserted and name each edge's source: the DOI's own metadata, other DataCite records that point at it, or DataCite Event Data (citation links harvested from Crossref and other sources). Accepts any DOI, including a journal article's DOI, to find the datasets and software it cites and those that cite, supplement, or derive from it. DataCite DOIs are hydrated with title, type, year, repository, and citation count; other identifiers stay leaf nodes. Depth 1 by default, at most 2, with a node cap (default 50, max 100) disclosed when it binds. An absent edge is not evidence that no relationship exists.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | Yes | The root DOI — any agency's, e.g. a DataCite dataset 10.5061/dryad.234 or a journal article's DOI. Bare, doi:, or a doi.org URL; case-insensitive. | |
| depth | No | Hops from the root: 1 (default) or 2. Depth 2 expands at most 10 DataCite neighbours through their own and reverse metadata, and runs only while max_nodes has room after the first hop. | |
| max_nodes | No | Node cap including the root, 1–100 (default 50). Filled in order: own-metadata targets, records pointing at the root, Event Data endpoints, then the second hop. | |
| relation_types | No | Only these relation types (IsVersionOf, HasPart, IsSupplementTo, IsDerivedFrom, Cites, IsCitedBy, …), any case, read from the traced DOI's side: HasPart keeps the DOI's own HasPart assertions and the records asserting IsPartOf it, each edge shown as asserted. IsPublishedIn and Other have no inverse and match on either side. A second hop reads them from each expanded neighbour's side. Omitted: all. Groups: datacite_list_reference topic relation_types. | |
| include_event_data | No | Add Event Data citation links (mostly harvested from Crossref). Citation relation types only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The max_nodes applied. | |
| root | No | The root DOI. For another agency's DOI, title, type, and year come from DataCite's linking copy when it holds one. | |
| edges | No | Edges between returned nodes, at most 1,000, the first found; identical edges from several sources are merged. | |
| error | No | Present when the call failed. Absent on success. | |
| nodes | No | Nodes, root first. | |
| shown | No | Nodes returned, root included. | |
| notice | No | Coverage caveats: non-DataCite root, no relations found, Event Data unavailable, records pointing at a DOI too large to read 100 of, Event Data objects left out and nodes left unhydrated because DataCite did not answer in time, node cap, unexpanded second hop, neighbours past the second-hop limit, edge cap, uncounted citations. | |
| coverage | No | What each source contributed and how much of it was read. | |
| truncated | No | True when max_nodes or the 1,000-edge cap bound. | |
| edgesFound | No | Edges between the returned nodes before the 1,000-edge cap; present only when the cap bound. | |
| rootCounts | No | DataCite's own counts for the root (DataCite roots only), to compare with the edges shown. |