Project

General

Profile

Old LArSoftWiki » History » Version 90

Erica Snider, 01/16/2014 02:15 PM

1 87 Lynn Garren
{{>toc}}
2 87 Lynn Garren
3 87 Lynn Garren
---------------------------------------------------------------
4 1 Brian Rebel
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) ":https://cdcvs.fnal.gov/redmine/projects/larsoft-cvs/wiki.*
5 1 Brian Rebel
If you are looking for the legacy svn-based LArSoft site, "go here":https://cdcvs.fnal.gov/redmine/projects/larsoftsvn/wiki. 
6 54 Erica Snider
---------------------------------------------------------------
7 1 Brian Rebel
8 89 Erica Snider
This is the beta LArSoft redmine project. It will become the home home of the LArSoft redmine project on Jan 21.
9 29 Erica Snider
10 54 Erica Snider
h1. LArSoftWiki (beta)
11 1 Brian Rebel
12 89 Erica Snider
*This page is in beta and content is still under construction.*  Will go live on Jan 21, 2014 at the start of the production migration to git / mrb / ups.
13 31 Erica Snider
14 1 Brian Rebel
15 54 Erica Snider
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 "art":https://cdcvs.fnal.gov/projects/art/wiki analysis framework supported by the Fermilab Scientific Computing Division for intensity frontier experiments.
16 1 Brian Rebel
17 1 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.
18 1 Brian Rebel
19 1 Brian Rebel
20 54 Erica Snider
h1. Preliminaries
21 35 Erica Snider
22 64 Erica Snider
* *Beta testers:  [[ Special instructions for beta testers | read this first ]]*
23 73 Erica Snider
* Fermilab computing accounts:  see the [[larsoftsvn:Fermilab Computing Access]] page if you need an account.
24 54 Erica Snider
* 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.).
25 73 Erica Snider
* See the [[LArSoftWiki#documentation|documentation section below]] for information on working with LArSoft, and using git, git flow, mrb and other tools you will need.
26 82 Erica Snider
* *[[ Supported platforms ]]*
27 1 Brian Rebel
28 35 Erica Snider
h2. Where to find the software
29 65 Erica Snider
30 65 Erica Snider
* [[ The Fermilab core LArSoft installation ]]
31 65 Erica Snider
* [[ Experiment-specific code and re-factoring ]]
32 85 Erica Snider
* [[ LArSoft repositories, packages and dependencies | What are the repository names and what is in them?]]
33 86 Erica Snider
* [[ Sub-package locations ]] (e.g., in which repository can I find the @HitFinder@ sub-package?)
34 81 Erica Snider
* [[ Download instructions ]]
35 65 Erica Snider
36 50 Erica Snider
37 50 Erica Snider
38 77 Erica Snider
h1. Releases
39 1 Brian Rebel
40 1 Brian Rebel
| *Release* | *Date* | *Purpose* | *Changes / notes* | *Full release notes* |
41 90 Erica Snider
| v1.00.00| 01/24/2014 | First production 
42 1 Brian Rebel
                       release | Replica of final svn-based release. Future LArSoft development 
43 90 Erica Snider
                                 proceeds from this release. | [[Release Notes 1.00.00]] |
44 90 Erica Snider
| v0.02.02| 01/15/2014| "beta" public release | Beta suitable for general user testing. Includes 
45 90 Erica Snider
                                                all improvements and fixes since v0.02.01 was
46 90 Erica Snider
                                                released.
47 90 Erica Snider
                                                Based on 11/25/2013 snapshot | [[Release Notes 0.02.02]] |
48 79 Erica Snider
| v0.02.01| 12/17/2013| "beta" public release | Beta suitable for general user testing.
49 78 Erica Snider
                                                Based on 11/25/2013 snapshot | [[Release Notes 0.02.01]] |
50 75 Erica Snider
| v0.02.00| 12/10/2013| "beta" public release | Beta suitable for general user testing.
51 75 Erica Snider
                                                Problems found in initial testing require
52 75 Erica Snider
                                                a new release. Based on 11/25/2013 snapshot. | N/A |
53 52 Erica Snider
| v0.01.01| 12/02/2013| "beta" limited release | Beta suitable for expert testing | N/A |
54 35 Erica Snider
| v0.00.09| 11/25/2013| "beta" pre-release | Second full release under new system. First full re-factoring
55 35 Erica Snider
                                       of experiment-specific and core LArSoft code in the larcore,
56 35 Erica Snider
                                       lardata, larevt, and larsim products. Preparation for expert
57 35 Erica Snider
                                       user testing of beta release.| N/A|
58 42 Erica Snider
| v0.00.04| 9/15/2013| "alpha" release | First release of git/cmake/ups-based LArSoft products
59 42 Erica Snider
                                       Used for mrb, configuration and re-factoring
60 1 Brian Rebel
                                       development and testing | N/A |
61 79 Erica Snider
62 79 Erica Snider
Beta version of lbnecode (not installed -- version number is the value in product_deps)
63 79 Erica Snider
| *Version* | *Date* | *Purpose* |
64 79 Erica Snider
| v0.01.00  | 12/17/2013 | Beta for larsoft v0.02.01 |
65 79 Erica Snider
| v0.00.02  | 12/10/2013 | Beta for larsoft v0.02.00 |
66 79 Erica Snider
67 79 Erica Snider
Beta version of uboonecode (not installed -- version number is the value in product_deps)
68 79 Erica Snider
| *Version* | *Date* | *Purpose* |
69 79 Erica Snider
| v0.01.00  | 12/17/2013 | Beta for larsoft v0.02.01 |
70 79 Erica Snider
| v0.00.02  | 12/10/2013 | Beta for larsoft v0.02.00 |
71 33 Erica Snider
72 1 Brian Rebel
h1. Documentation
73 32 Erica Snider
74 69 Erica Snider
h2. Overview of the user and developer environment
75 69 Erica Snider
76 69 Erica Snider
* [[ The user environment ]] 
77 83 Erica Snider
* [[ The developer environment ]]
78 69 Erica Snider
79 69 Erica Snider
80 69 Erica Snider
81 60 Erica Snider
h2. Working with LArSoft
82 60 Erica Snider
83 80 Erica Snider
  * *[[ Quick-start guide to using and developing LArSoft code ]]*
84 71 Erica Snider
  * [[ LArSoft repositories, packages and dependencies ]]
85 1 Brian Rebel
  * *[[ Special instructions for beta testers ]]*
86 1 Brian Rebel
87 1 Brian Rebel
  * [[larsoftsvn:Using the Framework]]
88 68 Erica Snider
  * "ART Tutorial":http://oink.fnal.gov/
89 68 Erica Snider
  * [[larsoftsvn:NuSoft and LArSoft|nutools and LArSoft]]
90 68 Erica Snider
  * [[Using LArSoft on the GPVM nodes]]
91 1 Brian Rebel
92 1 Brian Rebel
93 1 Brian Rebel
94 68 Erica Snider
95 75 Erica Snider
h2. Links to the tools used to work with the software
96 1 Brian Rebel
97 71 Erica Snider
git and git flow:
98 67 Erica Snider
* [[cet-is-public:git flow quick start]] (edited 2/4/2013).
99 67 Erica Snider
* [[cet-is-public:Marc's suggested git workflow]]
100 1 Brian Rebel
* [[cet-is-public:GitTipsAndTricks|Git Tips and Tricks]]
101 1 Brian Rebel
102 72 Erica Snider
Understanding CMakeLists.txt and product_deps files
103 71 Erica Snider
* [[cet-is-public:Cetbuildtools cmake modules]]:  such as @cet_make@ and @cet_add_compiler_flags@. Used in @CMakeLists.txt@ files throughout LArSoft
104 71 Erica Snider
* [[cet-is-public:Art cmake modules]]: such as @art_make@ and @simple_plugin@. Used in @CMakeLists.txt@ files throughout LArSoft
105 71 Erica Snider
* [[cet-is-public:Defining products in the CET build environment]]: explains the @product_deps@ file
106 71 Erica Snider
* [[cet-is-public:AddingProductDependencies|Adding Product Dependencies]]: how to edit the @product_deps@ and @CMakeLists.txt@ files to add dependencies
107 71 Erica Snider
* [[cet-is-public:CodeTips|Various helpful tips for coding in the CET C++ environment]]: things you hope you never need to know
108 71 Erica Snider
* [[cet-is-public:Building your own code with cmake]]:  pointer to a _really_ simple example
109 67 Erica Snider
110 71 Erica Snider
mrb and ups:
111 32 Erica Snider
*  mrb : the multi-repository build tool
112 1 Brian Rebel
*  Re-locatable ups
113 72 Erica Snider
* [[cet-is-public:AboutQualifiers|About qualifiers]]:  the things after "-q" in setup <prod> <ver> -q <qual>
114 33 Erica Snider
115 33 Erica Snider
116 45 Erica Snider
h1. How-to's
117 33 Erica Snider
118 33 Erica Snider
119 33 Erica Snider
h2. Advanced technical how-to's
120 33 Erica Snider
121 33 Erica Snider
h2. Release procedures
122 1 Brian Rebel
123 1 Brian Rebel
h1. Walk-through exercises
124 1 Brian Rebel
125 75 Erica Snider
h1. LArSoft code management and distribution
126 75 Erica Snider
127 75 Erica Snider
* [[Admin scripts]]
128 75 Erica Snider
* [[Procedure to create a new version of larsoft_data]]
129 76 Erica Snider
* [[Installation procedures]]
130 76 Erica Snider
* [[Release notes template]]
131 33 Erica Snider
132 51 Erica Snider
h1. Working areas
133 34 Erica Snider
134 34 Erica Snider
[[Beta re-factoring]]
135 71 Erica Snider
136 1 Brian Rebel
[[ Detailed documentation on using and developing LArSoft code ]] : not a resource
137 88 Erica Snider
138 88 Erica Snider
[[ Production transition checklist ]]