Skip to content

Installing the Software

Emanuele Leonardi edited this page May 16, 2019 · 22 revisions

If you only want to download and use the PADME software, you can obtain the lastest release from the main repository hosted on GitHub.

From any machine where git is installed give the following command:

git clone https://github.com/PADME-Experiment/padme-fw <localdir>

If \<localdir\> is omitted, a directory named padme-fw is created inside the current directory.

If you want to be able to commit your changes to the software, you must first register to GitHub, create and register a ssh key (see below), and then apply to join the PADME-Experiment developers team by sending a "request for access" e-mail to emanuele.leonardi@roma1.infn.it specifying the GitHub user name you created.

A ssh key can be created on any Linux node with the command

ssh-keygen -t rsa -b 4096 -C "your_email@your_site"

Inside the .ssh directory in your home directory you will find the files id_rsa (private key) and id_rsa.pub (public key). To register this key into GitHub you have to copy the content of id_rsa.pub to the page reachable from your GitHub home page with Settings -> SSH and GPG keys -> New SSH key (choose any title you like).

After the registration is completed, you can get a copy of the PADME software with the command:

git clone ssh://git@github.com/PADME-Experiment/padme-fw.git <localdir>

A lot of useful information about git can be found in the NA62 Git HowTo Guide, which explains most standard use cases and procedures also adopted by the PADME collaboration.

In general, you will want to use the develop branch which contains all up-to-date software. The master branch is used for production specific tasks and is usually quite old, while otherr branches are used for incomplete development tasks and should not be used unless you know what you are doing.

To use the develop branch do

cd padme-fw
git checkout develop

As stated in the HowTo Guide, before doing any modification to the code, make sure to create a new branch based on develop and switch to it. As an example:

git checkout develop
git branch feature/mynewbranch
git checkout feature/mynewbranch
Clone this wiki locally