Project

General

Profile

Old LArSoftWiki » History » Version 65

« Previous - Version 65/136 (diff) - Next » - Current version
Erica Snider, 12/11/2013 03:48 AM


If you are looking for the legacy cvs-based LArSoft site that was previously hosted on this site, note that all content has been moved to LArSoft cvs (legacy site).
If you are looking for the legacy svn-based LArSoft site, go here.
---------------------------------------------------------------

This is the beta LArSoft redmine project and the future home of the LArSoft redmine project.

LArSoftWiki (beta)

This page is in beta and content is still under construction. Will go live when the migration to git/cmake is completed.

The LArSoft software is designed to work for all planned and running liquid argon experiments at Fermilab. It is written in C++ and built on the ROOT data analysis software, and the art analysis framework supported by the Fermilab Scientific Computing Division for intensity frontier experiments.

To join the LArSoft mailing list, please follow these instructions using the list name LARSOFT.

Preliminaries

  • Beta testers: read this first
  • Fermilab computing accounts: see the instructions on the [[larsoftsvn:Fermilab Computing Access]] page if you need an account.
  • See [[larsoftsvn:Load Balanced Access to General Purpose VMs]] for information on accessing experiment VMs at Fermilab (e.g., lbnegpvm0X, uboonegpvm0X, etc., collectively known as GPCF.).
  • See the documentation section for information on working with/developing LArSoft code, and using git, git flow, mrb and other tools you will need.
  • The procedures and tools for building and developing software with this system are completely different from those of the previous system based on svn repositories and the SoftRelTools build system. See the documentation section for details.

Where to find the software

In a standard LArSoft installation, the software is accessed via a set of re-locatable ups products, each of which corresponds to the code within a git repository. Each product and the associated repository contain LArSoft software components (i.e., SoftRelTool "packages") that are within the same layer of functionality. The products and repository read-write urls are the following (read-only access is available via http://cdcvs.fnal.gov/projects/<repo_name>):

Product
repository
name
repository url (all in Redmine) lxr link
(not yet avail)
Redmine browser
larcore ssh:///cvs/projects/larcore -- redmine
lardata ssh:///cvs/projects/lardata -- redmine
larevt ssh:///cvs/projects/larevt -- redmine
larsim ssh:///cvs/projects/larsim -- redmine
larreco ssh:///cvs/projects/larreco -- redmine
larana ssh:///cvs/projects/larana -- redmine
lareventdisplay ssh:///cvs/projects/lareventdisplay -- redmine
larexamples ssh:///cvs/projects/larexamples -- redmine
larpandora ssh:///cvs/projects/larpandora -- "redmine:https://cdcvs.fnal.gov/redmine/projects/larpandora/repository
larsoft ssh:///cvs/projects/larsoft
(A product used to set up the others with a single command. Contains the "setup" package.)
--
redmine

(The SoftRelTools-based packages in each product/repository can be found here along with the approximate order of dependency.)

Although you can use git clone <repository url> to download a copy of each repository to your local area, additional steps are needed to use, build or develop the software. See the documentation section below for details.

Re-factoring of experiment-specific software

Most experiment-specific code, fcl and gdml files have been removed from the larcore, lardata, larevt and larsim repositories and moved into beta versions of experiment-specific git repositories. (One exception to this statement is that the DetId_t enum type, which effectively maps detector name strings to integers, remains in core LArSoft, pending migration to a new, string-based mechanism for storing and using this information. Other exceptions include fcl files that were not identified during the initial migration.) The beta versions of experiment-specific repositories are the following:

Product
repository
name
repository url (all in Redmine) lxr link
(not yet avail)
Redmine browser
lbnecode ssh:///cvs/projects/lbnecode -- redmine
uboonecode ssh:///cvs/projects/lardata -- redmine

Release notes

Release Date Purpose Changes / notes Full release notes
v1.00.00 Jan 2014 First production
release
Replica of final svn-based release. Future LArSoft development
proceeds from this release.
xxx
v0.0x.yy 12/10/2013 "beta" public release Beta suitable for general user testing N/A
v0.01.01 12/02/2013 "beta" limited release Beta suitable for expert testing N/A
v0.00.09 11/25/2013 "beta" pre-release Second full release under new system. First full re-factoring
of experiment-specific and core LArSoft code in the larcore,
lardata, larevt, and larsim products. Preparation for expert
user testing of beta release.
N/A
v0.00.04 9/15/2013 "alpha" release First release of git/cmake/ups-based LArSoft products
Used for mrb, configuration and re-factoring
development and testing
N/A

Documentation

Working with LArSoft

Overview of the user and developer environment

Links to the tools used in working with the software

  • git
  • git flow
  • mrb : the multi-repository build tool
  • Re-locatable ups
  • cmake

How-to's

Advanced technical how-to's

Release procedures

Walk-through exercises

LArSoft code management and distribution procedures

Working areas

Beta re-factoring