Getting Started

This page will help you quickly get started with the Solidipes package. The steps are the following:

Installation and Setup of the package,
Initializing a Solidipes project,
Launching the web interface.

For a more in-depth overview of the capabilities of Solidipes, take a look at the Tutorials.

Installation and Setup

Solidipes is currently only tested on Linux. Installation is possible on other platforms, but not all features have been fully tested. For Windows users, we recommend using WSL. The installation instructions below are only for Linux.

You need to have Python installed on your system to install and uses Solidipes (minimum Python 3.9).

Creating a Virtual Environment

To avoid conflicts with Python packages already present on your system, we strongly recommend creating a virtual environment.

Using venv (all Python installations)
With Anaconda

Once you have created and activated your environment, you can proceed to install your Solidipes package.

Installing Solidipes

Run the following command:

pip install solidipes

Enabling command auto-completion (Optional)

If you plan on using the Solidipes command in a terminal, we recommend enabling auto-completion. If you are using bash or zsh as your shell, you can enable TAB completion for the solidipes command by running:

activate-global-python-argcomplete

You may need to run this command as sudo or with the --user flag.

sudo activate-global-python-argcomplete
# or
activate-global-python-argcomplete --user

Initializing a Solidipes project

To prepare a new Solidipes project, run the following command in the root of your project directory:

solidipes init

This will create some files and directories in the root of your project directory:

a .solidipes directory, which contains metadata about your project and files
a DESCRIPTION.md file, which contains a description of your project
an automatically generated README.md file, filled with the metadata and description of your project

The easiest way to edit your project’s metadata and curate your data is to use the web interface. If you wish to do so manually using the command line, refer to the User reference.

Launching the web interface

Run the command:

solidipes report web-report .

and click on the displayed link to open a web interface in your Browser. There, you can edit your project’s metadata, curate your data, and publish your project to Zenodo.