Publications model

Table of contents

  1. Introduction
  2. Fields
  3. Lookup DOI
  4. Submission process
  5. Permissions
  6. API access

Introduction

A publication is one paper, article or preprint. Linking it to a project connects the paper to the records behind it, so a reader can move from the citation to the subjects, sessions and procedures the results came from. Publications are attached from the project side. In BrainSTEM, publications are a shared model across users.

This model with its direct connections only: drag to pan, Ctrl + scroll to zoom, click a model to select it, use the chevron to see its fields.

Fields

FieldDescription
TitleThe title of the publication as published, including subtitle (required; string; maximum length: 200 characters; must be unique across BrainSTEM).
AuthorsThe author list in published order (required; string; maximum length: 500 characters). Free text, since most co-authors will not have accounts. Example: “Smith J, Johnson A, Brown B”
JournalThe journal in which the publication appears (required). Must reference an existing journal; submit a missing journal first.
AbstractThe published abstract (required). It makes the entry searchable.
Publication dateDate when the publication was released (required; date). Example: “2024-03-15”
DOIDigital Object Identifier (string; maximum length: 200 characters). Optional, but the field that settles whether a paper is already in BrainSTEM; record it whenever one exists. Example: “10.1038/s41593-024-01567-2”
VolumeThe journal volume (string; maximum length: 100 characters).
Publication URLDirect link to the publication (URL; maximum length: 300 characters).
PDF URLDirect link to a publicly accessible PDF, such as an open-access or repository copy (URL; maximum length: 300 characters).
Adding/editing commentsComments for the submission/approval process.

Lookup DOI

The publication form has a Lookup DOI button beside the DOI field. It fetches the paper from Crossref and fills in the title, authors, abstract, volume, publication URL and publication date. When Crossref has no abstract it falls back to Semantic Scholar for that field. If the journal already exists in BrainSTEM it is matched by name and selected; otherwise the fetched journal name is shown so you can submit it. Everything it fills stays editable. The lookup exists only in the web form; through the API, submit the fields directly.

Submission process

Any user can submit new publication entries or propose changes to existing ones. A submission enters the approval queue and is usable in your own records immediately; it is visible only to you until accepted. Search by DOI before submitting: a duplicate under a slightly different title is the usual reason a submission is rejected. For the approval statuses see the Resources page.

Permissions

Everyone can read the accepted list. Editing an accepted publication is restricted, since it is a record of something already published; an edit creates a change request that is reviewed before it takes effect. Your own pending submissions remain yours to edit or cancel.

API access

The API provides programmable access to publication data, returning the accepted list plus your own pending submissions. For more information about the fields and data structure, please consult the Publications API page.