Fundamentals

Introduction

Research Data Management

FAIR Data Principles

Metadata

Data Sharing

Data Publications

Data Management Plan

Version Control & Git

Public Data Repositories

Persistent Identifiers

Implementation within DataPLANT

Annotated Research Context

ARC Commander

Swate - a workflow annotation tool for Excel

DataHUB

Training & Tutorials

QuickStart on ARCs

ARC Commander QuickStart

Swate QuickStart

Best practices for data annotation

ARC Commander

last updated at 2022-08-10 A tool to make FAIR RDM easy

The ARC Commander is one of two central DataPLANT tools designed for convenient interaction with your ARC (the other one being SWATE). It supports you in many actions on files within your ARC enabling you to sort, associate and keep track of your files.

The major function of the ARC Commander is to set up the ARC directory and put it under version-control for you. The ARC Commander creates the directory structure with the root directories "studies", "assays", "runs", and "workflows" (see ARC for details). According to the design of your project, you can use the ARC Commander to create study and assay sub-directories and add the associated details and data files. While setting up the root directory structure, the ARC Commander initializes your ARC as a git repository, allowing you to track changes of your ARC and easily back-up and synchronize it with the DataHUB. This includes an efficient mechanism to keep track of your large data files. The ARC Commander makes it straight-forward to download shared ARCs from the DataHUB for collaboration.

Apart from managing the ARC as a whole in terms of file handling, the ARC Commander supervises the integrity and connections between files of your ARC. It ensures that the ARC is intact following the ARC specifications as well as the ISA model to provide machine-readability of metadata. By (automatically) registering your studies and assays including their associated meta(data) files in the isa.investigation.xlsx registry file, the ARC Commander makes the resources in your ARC identifiable and findable. It would also warn you about possible inconsistencies, such as duplicate ISA metadata files (e.g. every ARC stores only one isa.investigation.xlsx) or studies and assays that may have been added manually and not registered, yet.

What the ARC Commander does not do

Unless you actively request it to, the ARC Commander does not delete, modify or move files within your ARC. While it may help with suggestions, the ARC Commander will not guess your intentions or override your decisions. For instance, the ARC Commander will not search any (ISA) metadata or other data files in your ARC and move them into the intended folders. If such files exist somewhere in your ARC, they will simply be ignored as "additional payload" (see ARC specifications). The ARC Commander does not operate / manage your ARC automatically. You have the full control over all actions. Whenever you decide to add or link new (meta)data in your ARC or synchronize it with the DataHUB, you can do so with a few commands.

Do I have to use the ARC Commander?

No. As with most tools and services developed in DataPLANT, you are not obliged to use the ARC Commander to benefit from DataPLANT's support in FAIR RDM. However, we'd highly recommend to check it following the ARC Commander Quickstart.

The alternative would be to

How does it work?

The ARC Commander runs on current Windows, Mac and Linux operating systems. At the moment, the tool is solely designed as a CLI-based software. For the future, the DataPLANT developers work on a GUI version, making it even more intuitive for all users.

For details, please

DataPLANT Support

Besides these technical solutions, DataPLANT supports you with community-engaged data stewardship. For further assistance, feel free to reach out via our helpdesk or by contacting us directly .
✏️ Edit this page