[STORY] Capture and output list of relevant citations associated with each pipeline

[tclose]

Description

As a pipelines user, I would like to be able to access a lit of citations corresponding to the methods used in a pipeline and a short description of how they fit together (e.g. dot-points), so that I can write my methods section.

As a pipeline developer, I would like users to be prompted to acknowledge the work put into designing the pipeline as well as all the methods it builds upon, so that my work and that of the methods developers is appropriately recognised.

Acceptance Criteria

• 1. Citations are recorded alongside pipeline implementation
• 2. Compiled lists of citations are saved next to generated derivatives
• 3. Links to the compiled list are prominent in the XNAT UI

Thoughts

• A Zenodo reference to the pipeline software itself, including versioning (will have to think about the best way to do this)
• Any paper that describes the synthesised workflow
• Papers that describe the component parts of the workflow (we may need to be clever about how we do this to avoid generating a huge list)
• Software used (e.g. FSL, MRtrix, Pydra, Arcana, ...)
• Acknowledgements of AIS, NIF node, etc...

The idea would be to also capture how the reference was used so we can kind of generate a dot-point methods markdown document that gets saved alongside the generated derivatives.

Probably it makes sense to define this in the pipeline decorator, e.g.

@analysis(Clinical)
class Bold():

    fmri: NiftiXGz
    preprocessed: NiftiXGz

    @pipeline(preprocessed,
              citations=[
                  Citation(doi='https://doi.org/10.1038/s41592-018-0235-4',
                           desc="draws upon the methods and default parameters used in fMRIPrep")])
    def preprocess(self, wf, fmri):
        ...

[tclose]

Epic: Australian-Imaging-Service/pipelines#17