Project

General

Profile

Old LArSoftWiki » History » Version 35

Erica Snider, 11/30/2013 07:39 PM

1 29 Erica Snider
If you are looking for the legacy cvs LArSoft site, *all content has been moved to "LArSoft cvs (legacy site) ":https://cdcvs.fnal.gov/redmine/projects/larsoft-cvs/wiki.*
2 25 Erica Snider
---------------------------------------------------------------
3 1 Brian Rebel
4 32 Erica Snider
{{toc}}
5 1 Brian Rebel
6 29 Erica Snider
This will be the new home of the LArSoft redmine project. For the current version of this page, please visit the "current wiki":https://cdcvs.fnal.gov/redmine/projects/larsoftsvn/wiki.
7 29 Erica Snider
8 1 Brian Rebel
h1. LArSoftWiki
9 1 Brian Rebel
10 31 Erica Snider
*Under construction...*  Will go live when the migration to git/cmake is completed.
11 31 Erica Snider
12 1 Brian Rebel
13 19 Brian Rebel
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":http://root.cern.ch data analysis software and the "FMWK":https://cdcvs.fnal.gov/redmine/wiki/nusoft/FMWK framework for HEP experiments. The releases of the software are managed using an "SRT":http://runiicomputing.fnal.gov/cmgt/SoftRelTools-Manual/SoftRelTools-Manual-chunks/index.html distribution.
14 1 Brian Rebel
15 17 Brian Rebel
To join the LArSoft mailing list, please follow these "instructions":http://listserv.fnal.gov/users.asp#subscribe%20to%20list using the list name LARSOFT.
16 32 Erica Snider
17 32 Erica Snider
18 35 Erica Snider
h1. Getting started
19 1 Brian Rebel
20 35 Erica Snider
h2. Access to Fermilab computing
21 1 Brian Rebel
22 35 Erica Snider
h3. Load balanced access to GPCF VMs
23 1 Brian Rebel
24 35 Erica Snider
h2. Where to find the software
25 1 Brian Rebel
26 35 Erica Snider
At Fermilab, the software lives in a set of re-locatable ups products, each of which corresponds to the code within a git repository. Each product and associated repository contain LArSoft software components (i.e., SoftRelTool "packages") that are at a similar layer of functionality. The reference products and repository urls are the following:
27 35 Erica Snider
28 35 Erica Snider
|*Product 
29 35 Erica Snider
repository
30 35 Erica Snider
name* | *repository url (all in Redmine)* | lxr link 
31 35 Erica Snider
                                            (not yet avail) | Redmine browser |
32 35 Erica Snider
|larcore| ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/larcore | -- | 
33 35 Erica Snider
|lardata| ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/lardata | -- |
34 35 Erica Snider
|larevt | ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/larevt  | -- |
35 35 Erica Snider
|larsim | ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/larsim  | -- |
36 35 Erica Snider
|larreco| ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/larreco | -- |
37 35 Erica Snider
|larana | ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/larana  | -- |
38 35 Erica Snider
|lareventdisplay| ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/lareventdisplay | -- |
39 35 Erica Snider
|larexamples|     ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/larexamples     | -- |
40 35 Erica Snider
41 35 Erica Snider
(The SoftRelTools-based packages in each product/repository can be found "here":https://cdcvs.fnal.gov/redmine/projects/larsoft-alpha/wiki/LarSoft_Product_List .)
42 35 Erica Snider
43 35 Erica Snider
44 35 Erica Snider
git repositories, each of which contains software components that are at a similar layer of functionality. The repositories are:
45 35 Erica Snider
* 
46 35 Erica Snider
47 33 Erica Snider
h2. Accessing LArSoft
48 32 Erica Snider
49 33 Erica Snider
* Repositories
50 1 Brian Rebel
* Browsing the software
51 1 Brian Rebel
52 1 Brian Rebel
h2. Release notes
53 1 Brian Rebel
54 1 Brian Rebel
| *Release* | *Date* | *Purpose* | *Changes / notes* | *Full release notes* |
55 1 Brian Rebel
| v0.00.04| 9/15/2013| "alpha" release | First release of git/cmake/ups-based LArSoft products
56 33 Erica Snider
                                       Used for mrb, configuration and re-factoring
57 33 Erica Snider
                                       development and testing | N/A |
58 35 Erica Snider
| v0.00.09| 11/25/2013| "beta" pre-release | Second full release under new system. First full re-factoring
59 35 Erica Snider
                                       of experiment-specific and core LArSoft code in the larcore,
60 35 Erica Snider
                                       lardata, larevt, and larsim products. Preparation for expert
61 35 Erica Snider
                                       user testing of beta release.| N/A|
62 35 Erica Snider
| v0.0x.0y| 12/02/2013| "beta" limited release | Beta suitable for expert testing | N/A |
63 35 Erica Snider
| v1.00.00| Jan 2014 | First production 
64 33 Erica Snider
                       release | Replica of final svn-based release. Future LArSoft development 
65 33 Erica Snider
                                 proceeds from this release. | xxx |
66 33 Erica Snider
67 32 Erica Snider
h1. Documentation
68 32 Erica Snider
69 32 Erica Snider
h2. LArSoft
70 32 Erica Snider
71 32 Erica Snider
h2. Development workflow
72 32 Erica Snider
73 32 Erica Snider
74 32 Erica Snider
75 32 Erica Snider
h2. General user workflow
76 32 Erica Snider
77 32 Erica Snider
h2. Tools for working with the software
78 32 Erica Snider
79 32 Erica Snider
*  git
80 32 Erica Snider
*  git flow
81 32 Erica Snider
*  mrb : the multi-repository build tool
82 32 Erica Snider
*  
83 32 Erica Snider
84 32 Erica Snider
85 32 Erica Snider
86 32 Erica Snider
* Basic workflow
87 32 Erica Snider
* Using git
88 32 Erica Snider
* Multi-repository build
89 33 Erica Snider
90 33 Erica Snider
91 33 Erica Snider
h1. How to
92 33 Erica Snider
93 33 Erica Snider
94 33 Erica Snider
h2. Advanced technical how-to's
95 33 Erica Snider
96 33 Erica Snider
h2. Release procedures
97 33 Erica Snider
98 33 Erica Snider
h1. Walk-through exercises
99 34 Erica Snider
100 34 Erica Snider
101 34 Erica Snider
h1. Working areas
102 34 Erica Snider
103 34 Erica Snider
[[Beta re-factoring]]