forked from ikarustechnologies/stellarmatewebmanual
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Capture.html
489 lines (426 loc) · 47.1 KB
/
Capture.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
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
<!DOCTYPE html>
<link href="https://fonts.googleapis.com/css2?family=Inter" rel="stylesheet">
<html lang="en">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="generator" content="HelpNDoc Professional Edition 6.9.0.577">
<meta name="viewport" content="width=device-width, initial-scale=1" />
<link rel="icon" href="favicon.ico"/>
<title>Capture</title>
<meta name="description" content="" />
<meta name="keywords" content="">
<!-- Twitter Card data -->
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="Capture">
<meta name="twitter:description" content="">
<!-- Open Graph data -->
<meta property="og:title" content="Capture" />
<meta property="og:type" content="article" />
<meta property="og:description" content="" />
<meta property="og:site_name" content="The StellarMate Plus Manual" />
<!-- Bootstrap core CSS -->
<link href="vendors/bootstrap-3.4.1/css/bootstrap.min.css" rel="stylesheet"/>
<!-- IE10 viewport hack for Surface/desktop Windows 8 bug -->
<link href="vendors/bootstrap-3.4.1/css/ie10-viewport-bug-workaround.css" rel="stylesheet"/>
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="vendors/html5shiv-3.7.3/html5shiv.min.js"></script>
<script src="vendors/respond-1.4.2/respond.min.js"></script>
<![endif]-->
<!-- JsTree styles -->
<link href="vendors/jstree-3.3.7/themes/default/style.min.css" rel="stylesheet"/>
<!-- Hnd styles -->
<link href="css/layout.min.css" rel="stylesheet" />
<link href="css/effects.min.css" rel="stylesheet" />
<link href="css/theme-light-blue.min.css" rel="stylesheet" />
<link href="css/print.min.css" rel="stylesheet" media="print" />
<style type="text/css">nav { width: 350px} @media screen and (min-width:769px) { body.md-nav-expanded div#main { margin-left: 350px} body.md-nav-expanded header { padding-left: 364px} }</style>
<!-- Content style -->
<link href="css/hnd.content.css" rel="stylesheet" />
</head>
<body class="md-nav-expanded">
<div id="skip-link">
<a href="#main-content" class="element-invisible">Skip to main content</a>
</div>
<header class="headroom">
<button class="hnd-toggle btn btn-default">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
</button>
<h1>The StellarMate Plus Manual</h1>
<a href="https://www.stellarmate.com"><img src="StellarMate_Logo_Text_Black.png" alt="logo" class="logo"/></a>
</header>
<nav class="md-nav-expanded">
<!-- Nav tabs -->
<ul class="tab-tabs nav nav-tabs" role="tablist">
<li id="nav-close">
<button class="hnd-toggle btn btn-default">
<span class="glyphicon glyphicon-remove" aria-hidden="true"></span>
</button>
</li>
<li role="presentation" class="tab active">
<a href="#contents" id="tab-contents" aria-controls="contents" role="tab" data-toggle="tab">
<i class="glyphicon glyphicon-list"></i>
Contents
</a>
</li>
<li role="presentation" class="tab">
<a href="#search" id="tab-search" aria-controls="search" role="tab" data-toggle="tab">
<i class="glyphicon glyphicon-search"></i>
Search
</a>
</li>
</ul> <!-- /Nav tabs -->
<!-- Tab panes -->
<div class="tab-content">
<div role="tabpanel" class="tab-pane active" id="contents">
<div id="toc" class="tree-container unselectable"
data-url="_toc.json"
data-openlvl="1"
>
</div>
</div> <!-- /contents-->
<div role="tabpanel" class="tab-pane" id="search">
<div class="search-content">
<div class="search-input">
<form id="search-form">
<div class="form-group">
<div class="input-group">
<input type="text" class="form-control" id="input-search" name="input-search" placeholder="Search..." />
<span class="input-group-btn">
<button class="btn btn-default" type="submit">
<span class="glyphicon glyphicon-search" aria-hidden="true"></span>
</button>
</span>
</div>
</div>
</form>
</div> <!-- /search-input -->
<div class="search-result">
<div id="search-info"></div>
<div class="tree-container unselectable" id="search-tree"></div>
</div> <!-- /search-result -->
</div> <!-- /search-content -->
</div> <!-- /search-->
</div> <!-- /Tab panes -->
</nav>
<div id="main">
<article>
<div id="topic-content" class="container-fluid"
data-hnd-id="Capture"
data-hnd-context="125"
data-hnd-title="Capture"
>
<div class="navigation">
<ol class="breadcrumb">
<li><a href="TheKStarsHandbook.html">The KStars Handbook</a></li><li><a href="KStarsTools.html">KStars Tools</a></li><li><a href="Ekos2.html">Ekos</a></li>
</ol>
<div class="nav-arrows">
<div class="btn-group btn-group-xs" role="group"><a class="btn btn-default" href="Ekos2.html" title="Ekos" role="button"><span class="glyphicon glyphicon-menu-up" aria-hidden="true"></span></a><a class="btn btn-default" href="Scheduler.html" title="Scheduler" role="button"><span class="glyphicon glyphicon-menu-left" aria-hidden="true"></span></a><a class="btn btn-default" href="Focus.html" title="Focus" role="button"><span class="glyphicon glyphicon-menu-right" aria-hidden="true"></span></a></div>
</div>
</div>
<a id="main-content"></a>
<h2>Capture</h2>
<div class="main-content">
<p></p>
<h4 class="rvps34"><img alt="" style="padding : 1px;" src="lib/ekos_capture.png"></h4>
<p class="rvps10"><span class="rvts20">The CCD Module is your primary image and video acquisition module in Ekos. It enables you to capture single (Preview), multiple images (Sequence Queue), or record </span><a class="rvts23" href="https://sites.google.com/site/astropipp/ser-player">SER</a><span class="rvts20"> videos along with a selection of filter wheel and rotator, if available.</span></p>
<h5 class="rvps35"><a name="CAPTURE-CCD-FILTER-WHEEL"></a><span class="rvts0"><span class="rvts22">CCD & Filter Wheel Group</span></span></h5>
<p class="rvps10"><span class="rvts20">Select the desired CCD/DSLR and Filter Wheel (if available) for capture. Set CCD temperature and filter settings.</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Camera: Select the active CCD camera. If your camera has a guide head, you can select it from here as well.</span></li>
<li class="rvps10"><span class="rvts20">Restart Camera Driver: Restarts the INDI driver for the active camera.</span></li>
<li class="rvps10"><span class="rvts20">Clear Camera Configuration: Resets the INDI driver camera configuration back to default.</span></li>
<li class="rvps10"><span class="rvts20">FW: Select the active Filter Wheel device. If your camera has a built-in filter wheel, the device would be the same as the camera.</span></li>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: circle;">
<li class="rvps2"><span class="rvts20">Filter Settings: Use the Filter Manager to specify various settings for each filter including exposure, offset, autofocus, and locking policy.</span></li>
</ul>
<li class="rvps10"><span class="rvts20">Cooler: Toggle Cooler On/Off. Set the desired temperature, if your camera is equipped with a cooler. Check the option to force temperature setting before any capture. Capture process is only started after the measured temperature is within requested temperature tolerance. The </span><span class="rvts21">default</span><span class="rvts20"> tolerance is 0.1 degrees Celsius but can be adjusted in Capture options under Ekos configuration.</span></li>
</ul>
<p class="rvps2"><span class="rvts6"><br/></span></p>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<div class="rvps5"><table width="100%" border="1" cellpadding="1" cellspacing="2" style="border-color: #000000; border-style: solid; border-spacing: 2px; border-top: none; border-right: none; border-bottom: none; border-left: none;">
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><img width="16" height="16" alt="" style="padding : 1px;" src="lib/exclamation-circle-svg.png"></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps2"><span class="rvts18">IMPORTANT</span></p>
</td>
</tr>
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><span class="rvts17"><br/></span></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps37"><span class="rvts16">Only use driver restart if the camera driver becomes completely unresponsive. This feature is still experimental and might lead to instability so only use as a last resort.</span></p>
</td>
</tr>
</table>
</div>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<p class="rvps2"><span class="rvts16"><br/></span></p>
<h5 class="rvps35"><a name="CAPTURE-SETTINGS"></a><span class="rvts0"><span class="rvts22">Capture Settings</span></span></h5>
<p class="rvps3"><img alt="" style="padding : 1px;" src="lib/capture_settings.png"></p>
<p class="rvps10"><span class="rvts20">Set all capture parameters as detailed below. Once set, you can capture a preview by click on Preview or add a job to the sequence queue.</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Exposure: Specify exposure duration in seconds.</span></li>
<li class="rvps10"><span class="rvts20">Filter: Specify the desired filter.</span></li>
<li class="rvps10"><span class="rvts20">Count: Number of images to capture</span></li>
<li class="rvps10"><span class="rvts20">Delay: Delay in seconds between image captures.</span></li>
<li class="rvps10"><span class="rvts20">Format: Specify capture save format. For all CCDs, only FITS option is available. For DSLR cameras, you can an additional option to save in Native format (example: RAW or JPEG).</span></li>
<li class="rvps10"><span class="rvts20">ISO: For DSLR cameras, specify the ISO value.</span></li>
<li class="rvps10"><span class="rvts20">Type: Specify the type of desired CCD frame. Options are Light, Dark, Bias, and Flat frames.</span></li>
<li class="rvps10"><span class="rvts20">Gain: Specify the value of gain between 0% to 100%. This will increase the signal to noise level of your image.</span></li>
<li class="rvps10"><span class="rvts20">Offset: Specify the value added to avoid the reads to clip at value "zero"</span></li>
<li class="rvps10"><span class="rvts20">Custom Properties: Set extended properties available in the camera to the job settings.</span></li>
<li class="rvps10"><span class="rvts20">Calibration: For Dark &s; Flat frames, you can set additional options explained in the </span><a class="rvts23" href="Capture.html#CAPTURE-CALIBRATION-FRAMES">Calibration Frames section below</a><span class="rvts20">.</span></li>
<li class="rvps10"><span class="rvts20">Frame: Specify the left (X), top (Y), width (W), and height (H) of the desired CCD frame. If you changed the frame dimensions, you can reset it to default values by clicking on the reset button.</span></li>
<li class="rvps10"><span class="rvts20">Binning: Specify horizontal (X) and vertical (Y) binning.</span></li>
</ul>
<h6 class="rvps36"><a name="CAPTURE-CUSTOM-PROPERTIES"></a><span class="rvts0"><span class="rvts22">Custom Properties</span></span></h6>
<p class="rvps10"><span class="rvts20">Many cameras offer additional properties that cannot be directly set in the capture settings using the common control. The capture controls described above represent the most common settings shared among different cameras, but each camera is unique and may offer its own extended properties. While you can use INDI Control Panel to set any property in the driver; it is important to be able to set such property for each job in the sequence. When you click Custom Properties, a dialog is shown divided into Available Properties and Job Properties. When you move an Available Properties to the Job Property list, its current value can be recorded once you click Apply. When you add a job to the Sequence Queue, the properties values selected in the Job Properties list shall be recorded and saved.</span></p>
<p class="rvps10"><span class="rvts20">The following video explains this concept is more detail with a live example:</span></p>
<p class="rvps3"><a class="rvts23" href="https://www.stellarmate.com/images/fss/videos/custom_properties.mp4">https://www.stellarmate.com/images/fss/videos/custom_properties.mp4</a></p>
<h5 class="rvps35"><a name="CAPTURE-FILE-SETTINGS"></a><span class="rvts0"><span class="rvts22">File Settings</span></span></h5>
<p class="rvps3"><img alt="" style="padding : 1px;" src="lib/file_settings.png"></p>
<p class="rvps10"><span class="rvts20">Settings for specifying where captured images are saved to, and how to generate unique file names in addition to upload mode settings.</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Prefix: Specify the prefix to append to the generated filename. You may also append the frame type, filter, expose duration, and ISO 8601 timestamp. For example, if you specify Prefix as </span><span class="rvts22">M45</span><span class="rvts20"> and checked the Type and Filter checkboxes, and assuming your filter was set to Red and your frame type is Light, the generated file names will be as follows:</span></li>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: circle;">
<li style="margin-left: 0px" class="rvps31"><span class="rvts20">M45_Light_Red_001.fits</span></li>
<li style="margin-left: 0px" class="rvps31"><span class="rvts20">M45_Light_Red_002.fits</span></li>
</ul></ul>
<p class="rvps31"><span class="rvts20">If TS was checked, a timestamp will be appended to the filename, example:</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;"><ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: circle;">
<li style="margin-left: 0px" class="rvps31"><span class="rvts20">M45_Light_Red_001_2016-11-09T23-47-46.fits</span></li>
<li style="margin-left: 0px" class="rvps31"><span class="rvts20">M45_Light_Red_002_2016-11-09T23-48-34.fits</span></li>
</ul>
<li class="rvps10"><span class="rvts20">Script: Specify an </span><span class="rvts21">optional</span><span class="rvts20"> script to be executed after each capture is complete. The full path of the script must be specified and it must executable. To denote success, the script must return zero as this would allow the sequence to continue. If a non-zero value is returned by the script, the sequence is aborted.</span></li>
<li class="rvps10"><span class="rvts20">Directory: Local directory to save the sequence images to.</span></li>
<li class="rvps10"><span class="rvts20">Save: Select how captured images are uploaded:</span></li>
</ul>
<ol style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: decimal;"><ol style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: decimal;">
<li value="1" style="margin-left: 0px" class="rvps31"><span class="rvts20">Locally: Captured images are saved locally on disk in the directory specified in the Directory field.</span></li>
<li value="2" style="margin-left: 0px" class="rvps31"><span class="rvts20">Remotely: When connecting to a remote device, select this option to save images on the remote device only. No images are uploaded to Ekos.</span></li>
<li value="3" style="margin-left: 0px" class="rvps31"><span class="rvts20">Both: Captured images are saved on both the remote computer and on the local disk as well. When selecting Remotely or Both, you must specify the remote directory where the remote images are saved to. By default, all captured images are uploaded to Ekos.</span></li>
</ol></ol>
<p class="rvps31"><span class="rvts20">When selecting Remotely or Both, you must specify the remote directory where the remote images are saved to. By default, all captured images are uploaded to Ekos.</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Remote: When selecting either Remotely or Both modes above, you must specify the remote directory where remote images are saved to.</span></li>
</ul>
<h5 class="rvps35"><a name="CAPTURE-LIMIT-SETTINGS"></a><span class="rvts0"><span class="rvts22">Limit Settings</span></span></h5>
<p class="rvps3"><img alt="" style="padding : 1px;" src="lib/limit_settings.png"></p>
<p class="rvps10"><span class="rvts20">Limit settings are applicable to all the images in the sequence queue. When a limit is exceeded, Ekos shall command the appropriate action to remedy the situation as explained below.</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Guiding Deviation: If checked, it enforces a limit of maximum allowable guiding deviation for the exposure, if autoguiding is used. If the guiding deviation exceeds this limit in arcseconds, it aborts the exposure sequence. It will automatically resume the exposure sequence again once the guiding deviation goes below this limit.</span></li>
<li class="rvps10"><span class="rvts20">Autofocus if HFR exceeds a value: If autofocus is enabled in the </span><a class="rvts23" href="Focus.html">focus module</a><span class="rvts20"> and at least one autofocus operation was completed successfully, you can set the maximum acceptable HFR value. If this option is enabled then between consecutive exposures, the HFR value is recalculated, and if found to exceed the maximum acceptable HFR value, then an autofocus operation is automatically triggered. If the autofocus operation is completed successfully, the sequence queue resumes, otherwise, the job is aborted.</span></li>
<li class="rvps10"><span class="rvts20">Autofocus if change in temperature exceeds a value: If autofocus is enabled in the focus module and at least one autofocus operation was completed successfully, you can set the maximum acceptable change in temperature value. If this option is enabled then between consecutive exposures, the change in temperature value is recalculated, and if found to exceed the maximum acceptable change in temperature value, then an autofocus operation is automatically triggered. If the autofocus operation is completed successfully, the sequence queue resumes, otherwise the job is aborted.</span></li>
<li class="rvps10"><span class="rvts20">Meridian Flip: If supported by the mount, set the hour angle limit (in hours) before a </span><a class="rvts23" href="http://astronomy.mdodd.com/gem_movement.html">meridian flip</a><span class="rvts20"> is commanded. For example, if you set the meridian flip duration to 0.1 hours, Ekos shall wait until the mount passes the meridian by 0.1 hours (6 minutes), then it commands the mount to perform a meridian flip. After the meridian flip is complete, Ekos re-aligns using astrometry.net (if </span><a class="rvts23" href="Align.html">the alignment</a><span class="rvts20"> was used) and resumes guiding (if it was started before) and then resumes the capture process automatically.</span></li>
</ul>
<h5 class="rvps35"><a name="CAPTURE-SEQUENCE-QUEUE"></a><span class="rvts0"><span class="rvts22">Sequence Queue</span></span></h5>
<p class="rvps10"><span class="rvts20">Sequence Queue is the primary hub of the Ekos Capture Module. This is where you can plan and execute jobs using the sequence queue built-in powerful editor. To add a job, simply select all the parameters from the capture and file settings as indicated above. Once you selected your desired parameters, click on the add button </span><img alt="" style="padding : 1px;" src="lib/list-add.png"><span class="rvts20"> in the sequence queue to add it to the queue.</span></p>
<p class="rvps3"><img alt="" style="padding : 1px;" src="lib/sequence_settings.png"></p>
<p class="rvps10"><span class="rvts20">You can add as many jobs as desired. While it is not strictly necessary, it is preferable to add the dark and flat jobs after the light frames. Once you are done adding jobs, simply click Start Sequence </span><img alt="" style="padding : 1px;" src="lib/media-playback-start.png"><span class="rvts20"> to begin executing the jobs. A job state changes from Idle to In Progress and finally to Complete once it is done. The Sequence Queue automatically starts the next job. If a job is aborted, it may be resumed again. To pause a sequence, click the pause button </span><img alt="" style="padding : 1px;" src="lib/media-playback-pause.png"><span class="rvts20"> and the sequence will be stopped after the current capture is complete. To reset the status of all the jobs, simply click the reset button </span><img alt="" style="padding : 1px;" src="lib/view-refresh.png"><span class="rvts20">. Please beware that all image progress counts are reset as well. To preview an image in KStars FITS Viewer, click the Preview button.</span></p>
<p class="rvps10"><span class="rvts20">Sequence queues can be saved as an XML file with extension .esq (Ekos Sequence Queue). To load a sequence queue, click the open document button </span><img alt="" style="padding : 1px;" src="lib/document-open.png"><span class="rvts20">. Please note that it will replace any current sequence queues in Ekos.</span></p>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<div class="rvps5"><table width="100%" border="1" cellpadding="1" cellspacing="2" style="border-color: #000000; border-style: solid; border-spacing: 2px; border-top: none; border-right: none; border-bottom: none; border-left: none;">
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><img width="16" height="16" alt="" style="padding : 1px;" src="lib/exclamation-circle-svg.png"></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps2"><span class="rvts18">IMPORTANT</span></p>
</td>
</tr>
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><span class="rvts17"><br/></span></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps29"><span class="rvts18">Job Progress</span><span class="rvts16">: Ekos is designed to execute and resume the sequence over multiple nights if required. Therefore, if Remember Job Progress option is enabled in </span><a class="rvts23" href="Ekos.html">Ekos Options</a><span class="rvts16">, Ekos shall scan the file system to count how many images are already completed and will resume the sequence from where it was left off. If this default behavior is not desired, simply turn off Remember Job Progress under options.</span></p>
</td>
</tr>
</table>
</div>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<p class="rvps10"><span class="rvts20">To edit a job, double click it. You will notice the add button </span><img alt="" style="padding : 1px;" src="lib/list-add.png"><span class="rvts20"> now changed to check mark button </span><img alt="" style="padding : 1px;" src="lib/dialog-ok-apply.png"><span class="rvts20">. Make your changes on the left-hand side of the CCD module and once done, click on the check mark button. To cancel a job edit, click anywhere on the empty space within the sequence queue table.</span></p>
<p class="rvps10"><span class="rvts20">To capture a preview image with the settings you have set in the Camera & Filter Wheel Panel, click the Capture a Preview button. If your camera doesn't support live video feed, click on the Start framing (looping) button. If your camera supports live video feed, then you can click the Live Video camera photo button to start streaming. The video stream window enables recording and subframing of the video stream. For more information, check the video below:</span></p>
<p class="rvps17"><a class="rvts23" href="https://www.youtube.com/watch?v=qRsAqTL4ZZI">https://www.youtube.com/watch?v=qRsAqTL4ZZI</a></p>
<h5 class="rvps35"><a name="CAPTURE-LIVE-VIDEO"></a><span class="rvts0"><span class="rvts22">Live Video</span></span></h5>
<p class="rvps10"><span class="rvts20">The Live Video window allows live streaming of your camera in order to check if your camera is working fine. You can also record a video, change FPS and zoom in.</span></p>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<div class="rvps5"><table width="100%" border="1" cellpadding="1" cellspacing="2" style="border-color: #000000; border-style: solid; border-spacing: 2px; border-top: none; border-right: none; border-bottom: none; border-left: none;">
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><img width="16" height="16" alt="" style="padding : 1px;" src="lib/exclamation-circle-svg.png"></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps2"><span class="rvts18">IMPORTANT</span></p>
</td>
</tr>
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><span class="rvts17"><br/></span></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps37"><span class="rvts16">Please note that while recording, the streaming frame rate will drop to increase the efficiency of the video recording process.</span></p>
</td>
</tr>
</table>
</div>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<p class="rvps2"><span class="rvts20"><br/></span></p>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<div class="rvps5"><table width="100%" border="1" cellpadding="1" cellspacing="2" style="border-color: #000000; border-style: solid; border-spacing: 2px; border-top: none; border-right: none; border-bottom: none; border-left: none;">
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><img width="16" height="16" alt="" style="padding : 1px;" src="lib/exclamation-circle-svg.png"></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps2"><span class="rvts18">IMPORTANT</span></p>
</td>
</tr>
<tr valign="top">
<td width="5" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps6"><span class="rvts17"><br/></span></p>
</td>
<td width="426" style="border-color: #000000; border-style: solid; padding: 1px; border-top: none; border-right: none; border-bottom: none; border-left: none;"><p class="rvps37"><span class="rvts16">If Ekos is connected to remote device (eg. StellarMate), please specify the remote directory (eg. /home/stellarmate/Pictures) instead of a local directory. Specifying a local directory could result in errors (as that directory might not exist in the remote device).</span></p>
</td>
</tr>
</table>
</div>
<hr style="height: 1px; color : #000000; background-color : #000000; border-width : 0px;">
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Start Recording: Starts recording everything in the live video frame. Governed by the record options (Until stopped, duration, or frames).</span></li>
<li class="rvps10"><span class="rvts20">Stop Recording: Stops recording and saves a video file.</span></li>
<li class="rvps10"><span class="rvts20">Recording Options: Opens the recording options dialog where you can set the following options:</span></li>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: circle;">
<li class="rvps10"><span class="rvts20">File name: Set SER video file name. Record files may contain some patterns to make them dynamic:</span></li>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: square;">
<li class="rvps10"><span class="rvts20">_D_ for the date in YYYY-MM-DD.</span></li>
<li class="rvps10"><span class="rvts20">_H_ for time in HH:MM:SS.</span></li>
<li class="rvps10"><span class="rvts20">_T_ for ISO8601 time stamp.</span></li>
<li class="rvps10"><span class="rvts20">_F_ for filter name, if any.</span></li>
</ul>
<li class="rvps10"><span class="rvts20">Directory: Set SER video remote directory name. If INDI server is running locally, then a local directory can be selected. However, if you are capture live video recording optionsconnected to a remote INDI server, then the directory must be a valid directory on the remote file system where it is saved. Record directories may contain some patterns to make them dynamic:</span></li>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: square;">
<li class="rvps10"><span class="rvts20">_D_ for the date in YYYY-MM-DD.</span></li>
<li class="rvps10"><span class="rvts20">_H_ for time in HH:MM:SS.</span></li>
<li class="rvps10"><span class="rvts20">_T_ for ISO8601 time stamp.</span></li>
<li class="rvps10"><span class="rvts20">_F_ for filter name, if any.</span></li>
</ul>
<li class="rvps10"><span class="rvts20">Record:</span></li>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: square;">
<li class="rvps10"><span class="rvts20">Until Stopped: Record stream until manually stopped.</span></li>
<li class="rvps10"><span class="rvts20">Duration: Record stream for specified duration in seconds.</span></li>
<li class="rvps10"><span class="rvts20">Frames: Record stream until this many frames are captured.</span></li>
</ul></ul>
<li class="rvps10"><span class="rvts20">Zooming in: You can zoom in to different parts of your live video frame by clicking and holding, then dragging to another position to create a blue selection, when you release the mouse, the frame will be zoomed in to the selected area.</span></li>
<li class="rvps10"><span class="rvts20">Reset frame: Unzooms and resets the frame back to default.</span></li>
<li class="rvps10"><span class="rvts20">Toggle debayer: Turns on or off Debayering, which is a demosaicing algorithm, it is a digital image process used to reconstruct a full color image from the incomplete color samples output from an image sensor overlaid with a color filter array. It is also known as CFA interpolation or color reconstruction.</span></li>
<li class="rvps10"><span class="rvts20">Frame (s): Specifies the amount of frames per second for the video stream. Click on Apply FPS and restart stream when you set a new value for this field.</span></li>
<li class="rvps10"><span class="rvts20">Apply FPS and restart stream: Applies the FPS set in the Frame (s) field and restarts the stream with the new FPS setting.</span></li>
<li class="rvps10"><span class="rvts20">FPS: Displays the average FPS of the live video being streamed.</span></li>
</ul>
<h5 class="rvps35"><a name="CAPTURE-FILTER-SETTINGS"></a><span class="rvts0"><span class="rvts22">Filter Settings</span></span></h5>
<p class="rvps3"><img alt="" style="padding : 1px;" src="lib/filter_settings.png"></p>
<p class="rvps10"><span class="rvts20">Click the filter icon </span><img alt="" style="padding : 1px;" src="lib/view-filter.png"><span class="rvts20"> next to the filter wheel selection box to open the filter settings dialog. If you are using filters that are not parafocal with each other and require a specific amount of focus offsets in order to get them into proper then set all the relative focus offsets in the dialog.</span></p>
<p class="rvps10"><span class="rvts20">Configure settings for each filter individually:</span></p>
<ol style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: decimal;"><ol style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: decimal;">
<li value="1" style="margin-left: 0px" class="rvps31"><span class="rvts20">Filter: Filter Name</span></li>
<li value="2" style="margin-left: 0px" class="rvps31"><span class="rvts20">Exposure: Set exposure time used when performing focus under this filter. By default, it is set to 1 second.</span></li>
<li value="3" style="margin-left: 0px" class="rvps31"><span class="rvts20">Offset: Set relative offsets. Ekos will command a focus offset change if there is a difference between the current and target filter offsets. For example, given the values in the example image, if the current filter is set to </span><span class="rvts21">Red</span><span class="rvts20"> and next filter is </span><span class="rvts21">Green</span><span class="rvts20">, then Ekos shall command the focuser to Focus In by +300 ticks. Relative positive focus offsets denote Focus Out while negative values denote Focus In.</span></li>
<li value="4" style="margin-left: 0px" class="rvps31"><span class="rvts20">Auto Focus: Check this option to initial AutoFocus process whenever the filter is changed to this filter.</span></li>
<li value="5" style="margin-left: 0px" class="rvps31"><span class="rvts20">Lock Filter: Set which filter should be set and </span><span class="rvts21">locked</span><span class="rvts20"> when performing autofocus for this filter.</span></li>
<li value="6" style="margin-left: 0px" class="rvps31"><span class="rvts20">Flat Focus Position: this value is set automatically once you finish autofocus for some filter. If the sequence queue contains flat images, then Ekos would first move the focuser to the filter absolute focus position before capturing the flat images. This to ensure both your light and flat frames are exactly captured using the same per-filter offset.</span></li>
</ol></ol>
<p class="rvps10"><span class="rvts20">Let's take an example. Suppose the capture sequence is running and the current filter is Green, so the relative offset is already set to +300. The next image in the sequence uses Hydrogen Alpha (H_Alpha) so before Ekos captures the next frame, the following actions take place:</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Since Luminosity is specified as the locked filter and auto-focus is checked, the filter is changed to Luminosity</span></li>
<li class="rvps10"><span class="rvts20">A focus offset is -300 is applied since the prior filter Green was moved +300 previously.</span></li>
<li class="rvps10"><span class="rvts20">Auto Focus process is initiated.</span></li>
<li class="rvps10"><span class="rvts20">Once Auto Focus is complete, the filter is changed to H_Alpha.</span></li>
<li class="rvps10"><span class="rvts20">A focus offset of -1200 is applied.</span></li>
<li class="rvps10"><span class="rvts20">Capture sequence is resumed.</span></li>
</ul>
<h5 class="rvps35"><a name="CAPTURE-FITS-VIEWER"></a><span class="rvts0"><span class="rvts22">FITS Viewer</span></span></h5>
<p class="rvps10"><span class="rvts20">Captured images are displayed in KStars FITS Viewer tool, and also in the summary screen. Set options related to how the images are displayed in the viewer.</span></p>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;">
<li class="rvps10"><span class="rvts20">Auto Dark: You can capture an image and auto dark subtract it by checking this option. Note that this option is only applicable when using Preview, you cannot use it in batch mode sequence queue.</span></li>
<li class="rvps10"><span class="rvts20">Effects: Image enhancement filter to be applied to the image after capture.</span></li>
</ul>
<h5 class="rvps35"><a name="CAPTURE-ROTATION-SETTINGS"></a><span class="rvts0"><span class="rvts22">Rotator Settings</span></span></h5>
<p class="rvps3"><img alt="" style="padding : 1px;" src="lib/ekos_rotator_settings.png"></p>
<p class="rvps10"><span class="rvts20">Field Rotators are supported in INDI & Ekos. The rotator angle is the raw angle reported by the rotator and is not necessary the </span><a class="rvts23" href="https://en.wikipedia.org/wiki/Position_angle">Position Angle</a><span class="rvts20">. A Position Angle of </span><span class="rvts21">zero</span><span class="rvts20"> indicates that the frame top (indicated by small arrow) is pointing </span><span class="rvts21">directly</span><span class="rvts20"> at the pole. The position angle is expressed as E of N (East of North), so 90 degrees PA indicates the frame </span><span class="rvts21">top</span><span class="rvts20"> points 90 degrees away (counter-clockwise) from the pole. Check </span><a class="rvts23" href="http://www.srl.caltech.edu/NuSTAR_Public/NuSTAROperationSite/file/NuSTAR-PA.pdf">examples</a><span class="rvts20"> for various PAs.</span></p>
<p class="rvps10"><span class="rvts20">To calibrate the Position Angle (PA), capture and solve an image in the </span><a class="rvts23" href="Align.html">Ekos Align module</a><span class="rvts20">. An </span><span class="rvts21">offset</span><span class="rvts20"> and a </span><span class="rvts21">multiplier</span><span class="rvts20"> are applied to the raw angle to produce the position angle. The Ekos Rotator dialog permits direct control of the raw angle and also the PA. The offset and multiplier can be changed manually to synchronize the rotator's raw angle with the actual PA. Check Sync FOV to PA to rotate the current Field of View (FOV) indicator on the Sky Map with the PA value as you change it in the dialog.</span></p>
<p class="rvps17"><a class="rvts23" href="https://www.youtube.com/watch?v=V_hRPMlPjmA">https://www.youtube.com/watch?v=V_hRPMlPjmA</a></p>
<p class="rvps10"><span class="rvts20">Each capture job may be assigned different rotator angles, but be aware that this would cause guiding to abort as it would lose track of the guide star when rotating. Therefore, for most sequences, the rotator angle is kept the same for all capture jobs.</span></p>
<h5 class="rvps35"><a name="CAPTURE-CALIBRATION-FRAMES"></a><span class="rvts0"><span class="rvts22">Calibration Frames</span></span></h5>
<p class="rvps3"><img alt="" style="padding : 1px;" src="lib/calibration_settings.png"></p>
<p class="rvps10"><span class="rvts20">For Flat Field frames, you can set calibration options in order to automate the process. The calibration options are designed to facilitate automatic unattended flat field frame capture. It can also be used for dark and bias frames if desired. If your camera is equipped with a mechanical shutter, then it is not necessary to set calibration settings unless you want to close the dust cover to ensure no light at all passes through the optical tube. For flat fields, you must specify the flat field light source, and then specify the duration of the flat field frame. The duration can be either manual or based on ADU calculations.</span></p>
<ol style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: decimal;">
<li value="1" class="rvps10"><span class="rvts20">Flat Field Source</span></li>
</ol>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;"><ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: circle;">
<li class="rvps10"><span class="rvts20">Manual: The flat light source is manual.</span></li>
<li class="rvps10"><span class="rvts20">Dust Cover with Built-In Flat Light: If using a dust cover with builtin light source (e.g. FlipFlat). For dark and bias frames, close the dust cap before proceeding. For flat frames, close the dust cap and turn on the light source.</span></li>
<li class="rvps10"><span class="rvts20">Dust Cover with External Flat Light: If using a dust cover with an external flat light source. For dark and bias frames, close the dust cap before proceeding. For flat frames, open the dust cap and turn on the light source. The external flat light source location is presumed to be the parking location.</span></li>
<li class="rvps10"><span class="rvts20">Wall: Light source is a panel on the observatory wall. Specify the Azimuth and Altitude coordinates of the panel and the mount shall slew there before capturing the flat field frames. If the light panel is controllable from INDI, Ekos shall turn it on/off as required.</span></li>
<li class="rvps10"><span class="rvts20">Dawn/Dusk: Currently unsupported.</span></li>
</ul></ul>
<ol style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: decimal;">
<li value="2" class="rvps10"><span class="rvts20">Flat Field Duration</span></li>
</ol>
<ul style="text-indent: 0px; padding: 0; margin: 0 0 0 24px; list-style-position: outside; list-style-type: disc;"><ul style="text-indent: 0px; padding: 0; margin: 0 0 0 48px; list-style-position: outside; list-style-type: circle;">
<li class="rvps10"><span class="rvts20">Manual: Duration is as specified in the Sequence Queue.</span></li>
<li class="rvps10"><span class="rvts20">ADU: Duration is variable until specified ADU is met.</span></li>
</ul></ul>
<p class="rvps10"><span class="rvts20">Before the calibration capture process is started, you can request Ekos to park the mount and/or dome. Depending on your flat source selection above, Ekos will use the appropriate flat light source before starting flat frames capture. If ADU is specified, Ekos begins by capturing a couple of preview images to establish the curve required to achieve the desired ADU count. Once an appropriate value is calculated, another capture is taken and ADU is recounted until a satisfactory value is achieved.</span></p>
<h5 class="rvps35"><a name="CAPTURE-VIDEO-TUTORIALS"></a><span class="rvts0"><span class="rvts22">Video Tutorials</span></span></h5>
<p class="rvps10"><a class="rvts23" href="https://www.youtube.com/watch?v=Gz07j7VPnpc">Capture</a></p>
<p class="rvps10"><a class="rvts23" href="https://www.youtube.com/watch?v=yfz9_UJIvLY">Filter Wheels</a></p>
<p></p>
</div>
<div id="topic_footer"><div id="topic_footer_content">Copyright © 2020 by Ikarus Technologies. All Rights Reserved.</div></div>
</div> <!-- /#topic-content -->
</article>
<footer></footer>
</div> <!-- /#main -->
<div class="mask" data-toggle="sm-nav-expanded"></div>
<!-- Modal -->
<div class="modal fade" id="hndModal" tabindex="-1" role="dialog" aria-labelledby="hndModalLabel">
<div class="modal-dialog" role="document">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">×</span></button>
<h4 class="modal-title" id="hndModalLabel"></h4>
</div>
<div class="modal-body">
</div>
<div class="modal-footer">
<button type="button" class="btn btn-primary modal-btn-close" data-dismiss="modal">Close</button>
</div>
</div>
</div>
</div>
<!-- Scripts -->
<script src="vendors/jquery-3.4.1/jquery.min.js"></script>
<script src="vendors/bootstrap-3.4.1/js/bootstrap.min.js"></script>
<script src="vendors/markjs-8.11.1/jquery.mark.min.js"></script>
<script src="vendors/uri-1.19.1/uri.min.js"></script>
<script src="vendors/imageMapResizer-1.0.7/imageMapResizer.min.js"></script>
<!-- IE10 viewport hack for Surface/desktop Windows 8 bug -->
<script src="vendors/bootstrap-3.4.1/js/ie10-viewport-bug-workaround.js"></script>
<!-- Headroom -->
<script src="vendors/headroom-0.9.4/headroom.min.js"></script>
<script src="vendors/headroom-0.9.4/jquery.headroom.min.js"></script>
<!-- JsTree -->
<script src="vendors/jstree-3.3.7/jstree.min.js"></script>
<!-- HelpNDoc scripts -->
<script src="_translations.js"></script>
<script src="js/hndsd.min.js"></script>
<script src="js/hndse.min.js"></script>
<script src="js/app.min.js"></script>
<!-- Scripts -->
<script>
$(function() {
// Create the app
var app = new Hnd.App();
// Update translations
hnd_ut(app);
// Instanciate imageMapResizer
imageMapResize();
// Custom JS
// Boot the app
app.Boot();
});
</script>
</body>
</html>