Skip to content

Latest commit

 

History

History
423 lines (310 loc) · 19.3 KB

resources.md

File metadata and controls

423 lines (310 loc) · 19.3 KB
layout title
experiment
For Collaborators

For collaborators

This page is mainly for collaboration members, and provides useful resources and instructions for people working on the experiment. Some of the tools and applications listed below may require a username and password.

Newsletters

{% assign letters_by_date = site.newsletters | sort:"date" | reverse %} {% for letter in letters_by_date %} {% assign index = forloop.index0 %} {% if index == 0 %}
## Current newsletter: {{letter.title}} _(added on {{letter.date | date_to_long_string }})_ {{letter.text}}
{% endif %}

{% if index == 1 %}

## Previous newsletters
{% endif %} {% if index > 0 %}

{{letter.title}}

{% endif %}
## {{letter.title}}

(added on {{letter.date | date_to_long_string }})

{{letter.text}}

{% endfor %}

Internal documentation

DocDB

For technical notes etc, see DocDB. To set up an account:

  • To sign up, click here
  • Go to the main database link
  • Select link private NEMO documents
  • Use your name and password (created in step 1) to log in
  • Add yourself as an author

Next time you log in you can upload documents! Just follow the active options. For security reasons, in about a week, we will certify all new user requests ~24 hrs to be able to upload docs. If you have problems, send an email message to the administrator.

SuperNEMO wiki

The SuperNEMO wiki is hosted at LPC Caen and holds up-to-date information about the status of integration, committees, and analyses. You can get a login from Yves or Francois.

Software and computing

Working with the SuperNEMO software

All software is available under {% include icon-github.html username=site.github_username %}

The main software package for offline work is Falaise. A guide to installing Falaise on Linux and macOS platforms is available through the dedicated Homebrew package manager and repo A starter guide to the core simulation, reconstruction and analysis tools available in Falaise can be found here.

Please note that the documentation is always under development, so feature requests or contributions are welcome. For installation related issues when using brew, use the SuperNEMO Brew Issue Tracker. For all issues relating to using Falaise, or installing/developing it locally, raise an issue on the Falaise tracker

Getting an account on the CCLyon computing cluster -------------------------------------------------- The CCLyon computing cluster is where our data and large simulation samples are stored. There are installations of the SuperNEMO software available on CCLyon. You'll need to get an account to use it.

To create your CC-IN2P3 user account, please follow the procedure below:

  • read the Charters for the use of resources (the account creation or submission of a creation request implies acceptance of the charters),
  • go to the Identity Management Portal and select the “Sign up” button,
  • fill in the required information (using eduGAIN will make this task easier) and follow the instructions you’ll receive by e-mail.

Once the account has been created, an access with the same identifier is provisioned on our Helpdesk.

If your CCLyon account is expiring ----------------------------------

Periodically, you will receive a notification inviting you to confirm the information associated to your profile. To extend your account activity, please follow the steps below:

  • click on the link provided on the red banner in your Identity Management Portal profile,
  • follow the procedure to verify your e-mail address and click on the link you will receive by e-mail,
  • verify that the information associated with your account (if necessary, update it) and confirm that you have read the Charters concerning the use of resources.
CCLyon support --------------

For any support, contact our computing tsar, Yves.

Useful links :

Using CCLyon -------------

Here are some instructions for logging onto CCLyon and getting started with the batch system that enables you to submit large jobs to the distributed computing cluster.

Website development -------------------------------------------------- This site uses [GitHub Pages](https://pages.github.com) to create a static website. It uses the following tools and techniques:

Building locally

The website generated by Jekyll can be built and served locally to test changes without making commits upstream. Note that GitHub Pages has a soft limit of 10 rebuilds per hour. Provided you have an install of Ruby 2 or better, including the development headers and library, the workflow is:

$ git clone https://github.com/supernemo-dbd/supernemo-dbd.github.io
$ cd supernemo-dbd.github.io
$ ./snjekyll serve

The last command will download and setup the local Jekyll instance, and start a local isolated webserver at http://127.0.0.1:4000. Simply point your favoured browser to this address to view the generated site.

The server runs in the foreground and watches the site sources for changes (for example, index.md). When a file changes, the server will rebuild the site automatically, so simply refresh your browser to see the resultant regenerated site. For example, try making some changes to index.md. The server may be shutdown at any point using Ctrl-C.

Further information on tasks available from snjekyll can be seen by running

$ ./snjekyll help

Alternately, if you already have a custom Ruby install, e.g. with Home/Linuxbrew you can do

$ git clone {{ site.github.repository_url }}
$ cd {{ site.github.repository_name }}
$ gem install bundler
$ bundle install
$ bundle exec jekyll serve

In both workflows, the xz package installed by Home/Linuxbrew is not compatible with the nokogiri gem required by Jekyll, and will cause compiliation of the gem to fail. snjekyll will issue a warning about this, but will not take further action. To work around this issue, either do brew unlink xz or remove Home/Linuxbrew settings from your environment. The latter may not be possible if you have Homebrew installed in /usr/local

Can we use MathJax and $$\LaTeX$$?

MathJax can support inline math, e.g. $$ 1/x^2 $$, and block equations:

$$ e^{i\pi} + 1 = 0 $$

like the above. Numbered equations, using the AMS math environment:

$$ \begin{equation} E = mc^2 \label{einstein} \end{equation} $$

This should allow a reference (see Equation $$\eqref{einstein}$$) to be inserted.

Can we use code blocks?

Here's C++:

#include <iostream>
  
int main() {
std::cout << "Hello World\n";
}

and some Python:

import os
print('Hello World')

Support or Contact

Having trouble with Pages? Check out our documentation or contact support and we’ll help you sort it out.

Operations

Working at LSM -------------

![The view from LSM]({{"assets/modane.jpg"| relative_url }})

As we prepare to take data, everyone is welcome and needed at LSM. You'll also all need to come here for your first shift! Here are some hints to ensure your trip is drama-free. If you have questions travel to LSM, contact Manu or Andrea.

Before you travel

  • Read the LSM user guide in English or French. This includes details of the documents that any non-CNRS users need to send to LSM admin, including a scan of an ID document and a stamped and signed employer declaration.
  • Read, sign and date the Code of conduct and send it to Silvia Scorza
  • Make sure Manu and Andrea know when you are coming and which days you will be able to go underground at least 1 week in advance, so that they can add you to the LSM calendar and arrange for a driver. If you would like to eat lunch underground, let them know - but it can't be guaranteed, as it depends on driver schedules.

Going underground

The cars going to the underground lab leave at 8:30am each day, so be sure to arrive at the surface lab on time. If you plan to stay all day, bring your own lunch - there's a fridge, microwave, kettle and espresso machine underground, as well as clean drinking water (in bottles). You'll need an approved driver to stay with you, so if no SuperNEMO driver will stay underground, you will need to negotiate with LSM.

If you are not eating lunch underground, you will leave for lunch on the surface by 11:30am. If returning to the tunnel for the afternoon, departure will be 1:30pm from the surface lab.

If you're staying late, you'll need to get permission from the lab management - your driver should be able to help you. The LSM drivers normally leave the underground lab for the evening at around 4:30 or 5pm, but if you have a SuperNEMO driver, you might be able to stay later.

Training

Before you go underground for the first time, you will need to do some basic safety training, in case there is an emergency in the tunnel. Jean-Lou of LSM leads this training, and you will be able to do it very quickly in the morning before you go underground. You will also need to receive some security paperwork. To get all of this set up, let Valerie Favre know that you will be going underground for the first time.

Staying in Modane

You have a few options for accommodation in Modane. The cheapest option is to stay in the LSM dorms. There are 4 rooms in the basement of the surface lab. Each one has its own shower and toilet, and there is a shared kitchen which is stocked with basic cooking equipment. The dorm rooms cost EUR19 per night. To find out about availability and book a room, contact LSM.

Alternatively, people choose to stay in Modane itself (walking distance to the lab) or in the nearby ski resort of Aussois, a 10-15 minute drive from the lab. Some hotels we have tried:

If a few people are travelling together outside peak vacation season, it may be possible to rent a chalet in Aussois - speak to Manu if you are interested.

Modane and Aussois both have restaurants, although some of them will be closed in the non-tourist season. Modane's gastronomic district (such as it is) is the street by the railway station. A few we like:

  • Il Peppuccio Pizzeria in Modane. No trip to LSM is complete without a Peppuccio pizza. Veggie options available. Gluten-free possible but limited.
  • L'Echappee A little more expensive, with French food including Alpine specialities. Go there when you want to celebrate.
  • Pulcinella A pizzeria that is not Peppuccio. Sometimes open when Peppuccio is closed.
  • Le Perce Neige Traditional food of the Savoie region. Lots of cheese. Feels like somebody's living room.
  • L'international Turkish food. Exotic by Modane standards!
  • Hotel de la Gare Sells crepes and galettes, among other things.

Getting to Modane

The easiest way to get to Modane is probably to fly to either Geneva or Lyon St-Exupery, and rent a car. It's around a 2.5-hour drive to the lab from either of these, mostly on motorways, although the travel time can vary significantly with traffic. There is parking at the lab and street parking near the hotels, though finding spaces in downtown Modane can be annoying.

The TGV from Paris Gare-de-Lyon to Turin stops in Modane, but the trains are not frequent. It's about a 4-hour ride from Paris. For more flexibility in timing, you can consider changing at Chambery and using a local train for the Alpine part of the trip. There is also a TGV from the Lyon airport - again, infrequent - if you don't want to drive. To get to Geneva airport by public transit, take the train to Chambery and then either a Flixbus direct to the airport, or train changing in Geneva central. You can book the trains on the SNCF website or app.

Things to consider

It is warm in the tunnel! Choose comfortable and cool clothing. Be sure to stay hydrated. (There is drinking water available underground.)

When you are underground, you must wear closed-toed shoes. No sandals!

There is no wi-fi underground, but you can connect to the internet using an ethernet cable (in the break room). You should turn off your phone or put it in airplane mode when you are underground, to protect other experiments in the lab.

        <div id="analysis" style="display:none">
            <header class="post-header">
                <h1 class="post-title text-center">Data and analysis</h1>
            </header>
Analysis code ------------- A work-in-progress collection of SuperNEMO and NEMO-3 analysis code is available in the [AllAnalyses](https://github.com/SuperNEMO-DBD/AllAnalyses) repository under {% include icon-github.html username=site.github_username %}.

SuperNEMO Analysis wiki

The SuperNEMO Analysis wiki page is hosted at LPC Caen and holds up-to-date information about the status of analyses, as well as links to helpful tools and documents to get you started analysing SuperNEMO data. It also has links to the minutes of all our internal analysis meetings. You can get a login from Yves or Francois.

Future meetings

All the information you need about the upcoming collaboration meetings

{% assign meetings_by_date = site.meetings | sort:"startdate" | reverse %}
{% for meeting in meetings_by_date %}
{% if meeting.remoteurl %}{% endif%} {% if meeting.remoteurl %} {% endif%}

{% if meeting.startdate %} {% if meeting.enddate %}{{ meeting.startdate | date: "%A %-d %B " }} to {{ meeting.enddate | date: "%A %-d %B, %Y" }} {% else %} Week of {{ meeting.startdate | date: "%A %-d %B, %Y" }} {% endif%} (Week {{ meeting.startdate | date: "%U" }})

{% endif%} 
  <i>{{meeting.abstract}}</i>
  </p>
</div>
<div class='col-xs-5'>
  {% if meeting.remoteurl %}<a href="{{ meeting.remoteurl }}" target="_blank">{% endif%}  
  <img src="{{meeting.thumbnail}}" class="img-thumbnail" alt="{{ meeting.location}} ">
  {% if meeting.remoteurl %}</a> {% endif%} 
</div>
{% endfor %}
Internal Documentation
Software and computing
Operations
Data and analysis
Future meetings