-
Notifications
You must be signed in to change notification settings - Fork 0
/
support.html
255 lines (221 loc) · 14.8 KB
/
support.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
<title>Support and FAQ | ROBAST</title>
<meta name="description" content="Support and FAQ page for the ROBAST library. Users who need support by the ROBAST developer (Akira Okumura) or who have a basic question should read this page thoroughly before contacting the deveoper.">
<meta name="keywords" content="Non-Sequential Ray Tracing,ROOT,Telescopes,Cosmic Rays,Gamma Rays,Geant4,sim_telarray,Davies-Cotton,Schwarzschild-Couder,ROOT,C++,Python">
<meta name="author" content="Akira Okumura">
<!-- Bootstrap -->
<link href="./bootstrap/css/bootstrap.min.css" rel="stylesheet">
<!-- Custom styles and JS -->
<link href="./ROBAST.css" rel="stylesheet">
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
<!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->
<!-- Global site tag (gtag.js) - Google Analytics 4 -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-01KYCK3PHK"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-01KYCK3PHK');
</script>
<script type="text/javascript">
<!--
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-317349-9', 'robast.github.io');
ga('send', 'pageview');
//-->
</script>
</head>
<body style="padding-top:40px;padding-bottom:40px">
<div class="container">
<nav class="navbar navbar-inverse">
<div class="container-fluid">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="index.html">ROBAST</a>
</div>
<div id="navbar" class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li><a href="index.html">Home</a></li>
<li><a href="download.html">Download</a></li>
<li class="active"><a href="#">Support & FAQ</a></li>
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Documentation <span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="user_guide.html">User Guide</a></li>
<li><a href="htmldoc/ClassIndex.html" target="_blank">Class Reference</a></li>
</ul>
</li>
<li><a href="publications.html">Publications</a></li>
</ul>
</div>
</div>
</nav>
<div class="row">
<div class="col-md-offset-1 col-md-11 col-sm-12 col-xs-12">
<h1 class="h3">Support and Help</h1>
<p>ROBAST is currently developed by <a href="http://www.isee.nagoya-u.ac.jp/~okumura/profile.html" target="_blank">Akira Okumura</a> (Institute for Space-Earth Environmental Research, Nagoya University) as an open-source project on GitHub.</p>
<p>If you have any question or need help, please feel free to contact me by <a href="mailto:[email protected]">e-mail</a>. If you have a GitHub account, using <a href="https://github.com/ROBAST/ROBAST/issues">the GitHub issue tracker</a> is more preferred because other users can see your trobleshooting.</p>
<div class="alert alert-danger" role="alert">
<span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
<span class="sr-only">Error:</span>
Please note that ROBAST is not commercial software but a free open-souce project, meaning that the user support by the developer is voluntary base.<br>
When you send a question to the developer, please describe the following information. Otherwise you will make him angry, and any prompt reply cannot be expected.
<ul>
<li>ROOT version</li>
<li>ROBAST version</li>
<li>OS version</li>
<li>GCC or Clang version</li>
<li>How you installed ROOT (binary install, CMake, configure, etc)</li>
<li>How you installed ROBAST</li>
<li>All environmental variables added for ROOT and ROBAST</li>
<li>A <strong>minimum</strong> script to reproduce your problem. Do not send hundreds of lines.</li>
<li>Screen shot or ROOT plot if your problem appears on your display</li>
<li>All the error messages you got. Copy and paste everything.</li>
<li>Steps to reproduce the problem</li>
</ul>
</div>
<p>In addition to the tutorial programs provided with ROBAST, you can get some more complex (= dirty) simulation examples upon request.</p>
<h1 class="h3">Bug Reports and Feature Requests</h1>
<p>Pleas go to the ROBAST issue page <a target="_blank">https://github.com/ROBAST/ROBAST/issues</a> to post your bug report or feature request. If you do not have a GitHub account, please make it and log in. You can also contact me by e-mail.</p>
<h1 class="h3">ROOT Help</h1>
<p>ROBAST requires you very basic knowledge of ROOT and C++. We do not answer your basic ROOT questions such as how to use TH2D or what <code>new</code> and <code>delete</code> are. Please refer to <a href="https://root.cern.ch/root/htmldoc/guides/users-guide/ROOTUsersGuide.html" target="_blank">the ROOT User's Guide</a>, that is quite well written for ROOT beginners. You can also use <a href="https://root.cern.ch/mailing-list" target="_blank">the ROOT mailing list</a> or <a href="https://root.cern.ch/phpBB3/" target="_blank">the ROOT forum</a> to get an answer for your question.</p>
<h1 class="h3">Future Development</h1>
<p>ROBAST is a volunteer-based open-source project, and it is currently developed and maintained by only Akira Okumura. Thus, we cannot guarantee the future development or support at the moment. In my personal prospect, however, ROBAST will be maintained for the next 10 years, because it will be used during the initial phase (–2025) of the Cherenkov Telescope Array observatory.</p>
<h1 class="h3">FAQ</h1>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Which paper and URL should I cite?</h2>
</div>
<div class="panel-body">
<p>If you used ROBAST in your research, we would appreciate it if you could cite the following paper.</p>
<pre>A. Okumura, K. Noda, C. Rulten (2016)
“ROBAST: Development of a ROOT-Based Ray-Tracing Library for Cosmic-Ray Telescopes and its Applications in the Cherenkov Telescope Array”
<i>Astroparticle Physics</i> <b>76</b> 38–47 arXiv:1512.04369</pre>
Please use <a>http://robast.github.io/</a> for the ROBAST URL.
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Is ROBAST actively developed and maintained?</h2>
</div>
<div class="panel-body">
Yes. ROBAST will be used by the developer for his projects until at least ~2030.
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Which repository is the origin?</h2>
</div>
<div class="panel-body">
<p>We used SourceForge for several years, but we are currently using GitHub for some reasons. Please do not use the old ROBAST repository on SourceForge. <a>https://github.com/ROBAST/ROBAST</a> is the repository origin.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. What operating systems are supported?</h2>
</div>
<div class="panel-body">
<p>macOS and Linux. In principle any POSIX systems that are supported in ROOT are compatible with ROBAST. We have been using ROBAST on several versions of OS X (up to Catalina) and Linux distributions (CentOS 6 and 7). We do not know if ROBAST runs on Windows machines, because we have never seen researchers who use ROOT on Windows.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Can ROBAST simulate diffraction or interference?</h2>
</div>
<div class="panel-body">
<p>No. ROBAST simulates photon tracks with a geometrical optics approach, because it relies on the particle tracking engine of the ROOT geometry library. We do not have a plan to support diffraction or interference.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Can ROBAST simulate polarization?</h2>
</div>
<div class="panel-body">
<p>Currently ROBAST cannot simulate photon polarization, however, we have a plan to support it in a future ROBAST release. Fresnel reflection and refraction in ROBAST assume random polarization. If it is really important in your simulation, please send us your request.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. How do I model a Fresnel lens?</h2>
</div>
<div class="panel-body">
<p>Please make a composite shape from a number of <code>AGeoAsphericDisk</code> objects. ROBAST does not have a dedicated class for simulation of Fresnel lenses. However, you can model a Fresnel lens geometry by using a number of <code>AGeoAsphericDisk</code> volumes aligned like an onion slice. The simulation speed will be very slow if the pitch of the concentric circles is very small.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Who is the owner of <code>TGeo</code> objects?</h2>
</div>
<div class="panel-body">
<p><code>TGeoManager</code>, the base class of <code>AOpticsManager</code>, takes care of heap objects. <code>TGeo</code> objects are automatically deleted when the destructor of <code>TGeoManager</code> or <code>AOpticsManager</code> is called. Some ROBAST classes are derived from <code>TGeo</code> classes, and you do not need to delete them yourself. Classes starting with <code>AGeo</code> are derived from the <code>TGeoBBox</code> class. <code>AOpticalComponent</code>, <code>AMirror</code>, <code>ALens</code>, <code>AFocalSurface</code>, and <code>AObscuration</code> are derived from <code>TGeoVolume</code>. <code>ARay</code> inherits <code>TGeoTrack</code>.</p>
<p>Other <code>TGeo</code> classes such as <code>TGeoCompositeShape</code> and <code>TGeoRotation</code> are also deleted by <code>TGeoManager</code> or <code>AOpticsManager</code>.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. What functionality will be added in future?</h2>
</div>
<div class="panel-body">
<p>I have a plan to support photon polarization. Polarization is supported only in <code>AMultilayer</code> at the moment.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. What projects use ROBAST?</h2>
</div>
<div class="panel-body">
<p>There are more than 15 researchers and students who use ROBAST in the Cherenkov Telescope Array. As far as I know there are several persons who use ROBAST for their other projects, but I do not know what these projects are.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Can I use ROBAST in Python?</h2>
</div>
<div class="panel-body">
<p>Yes. You can use it via PyROOT. Please try <code>tutorial/SimpleParabolicTelescope.py</code>.</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h2 class="panel-title">Q. Can I import a CAD file?</h2>
</div>
<div class="panel-body">
<p>It is not currently possible because the ROOT geometry library does not support tessellated solids. If it supports tessellated objects in future, you will be able to import a CAD file using an intermediate format converter such as <a href="http://www.fastrad.net" target="_blank">FASTRAD</a> to generate a <a href="http://gdml.web.cern.ch/GDML/" target="_blank">GDML</a> file.</p>
</div>
</div>
</div>
</div>
<div class="row">
<div class="col-md-12 col-sm-12 col-xs-12">
<hr>
<footer>
<p style="text-align:right;">© Copyright 2007–2020 <a href="http://www.isee.nagoya-u.ac.jp/~okumura/profile.html" target="_blank">Akira Okumura</a></p>
</footer>
</div>
</div>
</div>
<!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<!-- Include all compiled plugins (below), or include individual files as needed -->
<script src="./bootstrap/js/bootstrap.min.js"></script>
<script src="./retina/retina.js"></script>
</body>
</html>