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
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620 | # Copyright (c) 2024 MBARI
# MBARI Proprietary Information. Confidential. All Rights Reserved
# Unauthorized copying or distribution of this file via any medium is strictly
# prohibited.
#
# WARNING - This file contains information whose export is restricted by the
# Export Administration Act of 1979 (Title 50, U.S.C., App. 2401 et seq.), as
# amended. Violations of these export laws are subject to severe civil and/or
# criminal penalties.
mission lineCaptureHoming {
"""
Home to transponder while maintaining altitude or depth. Altitude gets
priority if non nan. The mission sequence: (*) Start (1) Midcourse
guidance: nav to target WP while querying transponder (2) Terminal
guidance: home to target using USBL tracking data (4) Dock: final
approach using fixed heading.
"""
# Define mission arguments
arguments {
MissionTimeout = 4 hour
"""
Maximum length of mission
"""
NeedCommsTime = 240 minute
"""
How often to surface for commumications
"""
MicromodemCommsInterval = 5 minute
"""
How often to trigger Umodem communications
"""
Repeat = 1 count
"""
Number of times the vehicle should try to cycle through the homing
sequence.
"""
WaitOnDockTimeout = 5 minute
"""
Time duration to wait on the dock after a successful line capture.
"""
StayOnDock = false
"""
If true, mission terminates after WaitOnDockTimeout following a successful
catpture, without executing the undock sequence.
"""
TrySlide = false
"""
If true, once docked, try to slide down the docking rod until charging and
comms are acheived
"""
SlideRetries = 2 count
"""
If using slide mode, max number of times to try the slide sequence before
giving up
"""
SlideSinkDuration = 5 minute
"""
Time duration to slide down by sinking during each slide mode iteration
"""
SlideCloseDuration = 5 minute
"""
Time duration to close arm to check for power/comms during each slide mode
iteration
"""
SlideDriveDuration = 2 minute
"""
Time duration for actions that involve the prop (either bumping or continuous
driving) during each slide mode iteration
"""
TryWiggle = false
"""
If true, uses mass shifter to try to wiggle down the rod after sinking in
slide mode
"""
SlideWiggleCount = 2 count
"""
Number of mass shifter wiggles to try during each slide mode iteration
"""
TryJog = false
"""
If true, bumps prop repeatedly in forward and reverse after sinking in
slide mode
"""
JogLength = 3 second
"""
Length of time to run the prop in each direction while jogging in slide mode
"""
TryWhirl = false
"""
If true, sets elevators to dive, rudders to turn, and drives continuously
after sinking in slide mode
"""
WhirlSpeed = 1 meter_per_second
"""
Speed at which to drive while whirling in slide mode
"""
TransponderCode = Dock:Dock.transponderCode
"""
Transponder Address.
"""
TrackingUpdatePeriodMidcourse = 60 second
"""
How long to wait between acoustic queries.
"""
TrackingUpdatePeriodTerminal = 2.5 second
"""
How long to wait between acoustic queries.
"""
TrackingUpdatePeriodDocked = 2 minute
"""
How long to wait between acoustic queries.
"""
TrackingNumFixesLowPassFilter = 5 count
"""
Median filter bin size. Filters the contact estimated lat/lon position.
Prefer odd number, set to 1 to disable filter.
"""
NumberOfPings = 1 count
"""
Number of pings requested each time.
"""
NumPingsUSBL = 1 count
"""
Number of pings requested while in USBL mode range.
"""
RangeUSBL = 40 meter
"""
USBL mode range.
"""
TrackingNumFixesLowPassFilterUSBL = 5 count
"""
Median filter bin size. Filters the contact estimated lat/lon position.
Prefer odd number, set to 1 to disable filter.
"""
DockingAltitude = NaN meter
"""
Docking altitude. Ignored when NaN and used over depth when a valid
altitude is set.
"""
InvalidAltitudeTimeout = NaN minute
"""
The mission will use the last good depth command if no valid altitude
readings are received within this specified time duration.
"""
AltitudeDepthLimit = NaN meter
"""
Vehicle will not be commanded deeper than this regardless of altitude
command.
"""
MinAltitude = 5 meter
"""
Minimum height above the sea floor for the entire mission.
"""
MaxDepth = 205 meter
"""
Maximum depth for the entire mission.
"""
MinOffshore = 2 kilometer
"""
Minimum offshore distance for the entire mission.
"""
ApproachDepthTimeout = 20 minute
"""
Maximum wait time for the vehicle to reach the target depth on initial
dive.
"""
ApproachDepthRate = 0.05 meter_per_second
"""
Descent depth rate (positive depth is down). Used only as a smoothing
parameter.
"""
Lat1 = NaN degree
"""
Latitude of rollout waypoint. If nan, waypoint is skipped.
"""
Lon1 = NaN degree
"""
Longitude of rollout waypoint. If nan, waypoint is skipped.
"""
CaptureRadius = NaN meter
"""
How close to call the waypiont behavior satisfied. Nan uses default
value.
"""
# Mission Variables (don't change)
MidcourseDepth = Dock:LineCapture.midcourseDepth
"""
Desired vehicle depth when navigating to dock WP (during midcourse
phase).
"""
MidcourseSpeed = Dock:LineCapture.midcourseSpeed
"""
Speed during initial dive and waypoint.
"""
TrackingPeriod = 60 second
"""
Mission variable (don't change). The mission sets this variable to
update the how long to wait between acoustic queries.
"""
}
output {
Mode = -1 count
"""
Mission variable (don't change). The mission sets this variable to
reflect the termination status of the LineCapture insert.
"""
NumPings = 1 count
"""
Mission variable (don't change). The mission sets this variable to
update the requested ping number and enter usbl mode.
"""
LowPassFilterWinSize = 1 count
"""
Mission variable (don't change). The mission sets this variable to
update the requested ping number and enter usbl mode.
"""
LowPassFilterWinOverlap = true
"""
Mission variable (don't change). The mission sets this variable to
update the requested ping number and enter usbl mode.
"""
}
# Mission timeout
timeout duration=MissionTimeout
insert Insert/Science.tl {
"""
Most missions will run the science sensors. If you don't place this
aggregate above NeedComms, science instruments get turned off on the
last upcast and while floating on the surface.
"""
}
# Safety nets and surfacing behaviors
insert Insert/StandardEnvelopes.tl
assign in sequence StandardEnvelopes:MinAltitude = MinAltitude
assign in sequence StandardEnvelopes:MaxDepth = MaxDepth
assign in sequence StandardEnvelopes:MinOffshore = MinOffshore
insert id="NeedComms" Insert/NeedComms.tl
assign in sequence NeedComms:DiveInterval = NeedCommsTime
assign in sequence NeedComms:WaitForPitchUp = 0 minute
# Micromodem comms
insert id="MicromodemComms" Insert/MicromodemComms.tl {
redefineArg CommsInterval = MicromodemCommsInterval
}
readData {
while (
Mode > 0 count
and Sensor:DataOverHttps.connectionStatus == true
)
Universal:platform_communications
}
# Add LineCapture directives.
insert Insert/LineCapture.tl
assign in sequence LineCapture:MaxDepth = MaxDepth
assign in sequence LineCapture:MinOffshore = MinOffshore
assign in sequence LineCapture:MinAltitude = MinAltitude
assign in sequence LineCapture:DockingAltitude = DockingAltitude
assign in sequence LineCapture:InvalidAltitudeTimeout = InvalidAltitudeTimeout
assign in sequence LineCapture:AltitudeDepthLimit = AltitudeDepthLimit
# Add track acoustic contact directive.
assign in sequence NumPings = NumberOfPings
behavior Estimation:TrackAcousticContact id="TrackAC" {
run in parallel
set contactLabelSetting = TransponderCode
set numberOfSamplesSetting = NumPings
set updatePeriodSetting = TrackingPeriod
set numFixesLowPassSetting = LowPassFilterWinSize
set lowPassOverlapSetting = LowPassFilterWinOverlap
}
# Add USBL mode directives.
aggregate UpdateNumPings_NotTerminal {
run while (
not ( LineCapture:GuidanceMode == LineCapture:Terminal )
and not ( NumPings == NumberOfPings )
)
syslog info "No longer in Terminal. Resuming normal ranging with " + NumberOfPings~count
+ "pings."
assign in sequence NumPings = NumberOfPings
assign in sequence LowPassFilterWinSize = TrackingNumFixesLowPassFilter
assign in sequence LowPassFilterWinOverlap = true
}
aggregate UpdateNumPings_Terminal {
run while (
LineCapture:GuidanceMode == LineCapture:Terminal
)
aggregate UpdateNumPingsUSBL {
run when (
not ( NumPings == NumPingsUSBL )
and (
( LineCapture:Range < RangeUSBL ) # don't enter USBL mode during rollout
and not ( Dock:LineCapture.guidanceMode == 5 count )
)
)
syslog info "Entering USBL mode with " + NumPingsUSBL~count + "pings at "
+ LineCapture:Range~meter + "(mode " + Dock:LineCapture.guidanceMode~count + ")."
assign in sequence NumPings = NumPingsUSBL
assign in sequence LowPassFilterWinSize = TrackingNumFixesLowPassFilterUSBL
assign in sequence LowPassFilterWinOverlap = true
}
aggregate UpdateNumPingsATR {
run when (
not ( NumPings == NumberOfPings )
and (
( LineCapture:Range >= RangeUSBL ) # do ATR mode during rollout
or Dock:LineCapture.guidanceMode == 5 count
)
)
syslog info "Resuming normal ranging with " + NumberOfPings~count + "pings "
+ LineCapture:Range~meter + "(mode " + Dock:LineCapture.guidanceMode~count + ")."
assign in sequence NumPings = NumberOfPings
assign in sequence LowPassFilterWinSize = TrackingNumFixesLowPassFilter
assign in sequence LowPassFilterWinOverlap = true
}
}
aggregate UpdatePingUpdateRate_Midcourse {
run when (
not ( TrackingPeriod == TrackingUpdatePeriodMidcourse )
and (
( LineCapture:Range > LineCapture:TerminalRange ) # do slow ping mode during rollout
or Dock:LineCapture.guidanceMode == 5 count
)
)
syslog info "Entering Midcourse tracking update period " + TrackingUpdatePeriodMidcourse~second
+ "sec at" + LineCapture:Range~meter + "(mode " + Dock:LineCapture.guidanceMode~count + ")."
assign in sequence TrackingPeriod = TrackingUpdatePeriodMidcourse
assign in sequence LowPassFilterWinSize = TrackingNumFixesLowPassFilter
assign in sequence LowPassFilterWinOverlap = true
}
aggregate UpdatePingUpdateRate_Terminal {
run when (
not ( TrackingPeriod == TrackingUpdatePeriodTerminal )
and (
( LineCapture:Range <= LineCapture:TerminalRange )
and not ( Dock:LineCapture.guidanceMode == 5 count )
and not ( LineCapture:GuidanceMode == 0 count )
) # don't enter fast ping mode during rollout or on dock
)
syslog info "Entering Terminal tracking update period " + TrackingUpdatePeriodTerminal~second
+ "sec at" + LineCapture:Range~meter + "(mode " + Dock:LineCapture.guidanceMode~count + ")."
assign in sequence TrackingPeriod = TrackingUpdatePeriodTerminal
assign in sequence LowPassFilterWinSize = TrackingNumFixesLowPassFilter
assign in sequence LowPassFilterWinOverlap = true
}
aggregate restartDHCP {
run when ( called )
syslog important "Restarting DHCP..."
behavior Guidance:Execute {
run in sequence
set command = "! /mnt/mmc/LRAUV/Tools/dhcp.sh"
}
}
# Start mission sequence.
call id="StartingMission" refId="NeedComms"
syslog important "Restarting logs"
behavior Guidance:Execute {
run in sequence
set command = "restart logs"
}
aggregate InitialDive {
run in sequence
behavior Guidance:SetSpeed {
run in parallel
set speed = MidcourseSpeed
}
behavior Guidance:Pitch {
run in sequence
timeout duration=ApproachDepthTimeout {
syslog important "Timed out trying to reach the target depth. Stopping mission at current depth of "
+ Universal:depth~meter
behavior Guidance:Execute {
run in sequence
set command = "stop"
}
}
set depth = MidcourseDepth
set depthRate = ApproachDepthRate
}
}
aggregate Lap {
run in sequence repeat=Repeat
assign in sequence Mode = -99 count
# Execute the LineCapture sequence.
call refId="LineCapture"
assign in sequence Mode = LineCapture:GuidanceMode
syslog info "Mode" + Mode~count
call refId="restartDHCP"
aggregate Docked {
run in sequence
break if ( Mode < 0 count )
syslog info "Waiting on dock for " + WaitOnDockTimeout~minute
# Add SetNav directives.
insert Insert/SetNavAcoustic.tl
assign in sequence TrackingPeriod = TrackingUpdatePeriodDocked
behavior Dock:Docked id="Docked" {
run in sequence
timeout duration=WaitOnDockTimeout
set slideSinkTime = SlideSinkDuration
set slideCloseTime = SlideCloseDuration
set slideDriveTime = SlideDriveDuration
set jogLength = JogLength
set whirlSpeed = WhirlSpeed
set slideRetries = SlideRetries
set wiggleCount = SlideWiggleCount
set slideAllowed = TrySlide
set massWiggle = TryWiggle
set propJog = TryJog
set driveWhirl = TryWhirl
}
aggregate Detach {
run in sequence
break if ( StayOnDock == true )
syslog important "Breaking off. Range: " + Universal:acoustic_contact_range~meter + "."
behavior Dock:Undock id="Undock" {
run in sequence
}
call refId="restartDHCP"
}
aggregate Wpt1 {
run in sequence
break if (
isNaN ( Lat1 )
or isNaN ( Lon1 )
or ( StayOnDock == true )
)
syslog important "Driving to post-undock waypoint " + Lat1~degree + "," + Lon1~degree
behavior Guidance:Pitch {
run in parallel
set depth = MidcourseDepth
}
behavior Guidance:SetSpeed {
run in parallel
set speed = MidcourseSpeed
}
behavior Guidance:Waypoint {
run in sequence
set latitude = Lat1
set longitude = Lon1
set captureRadius = CaptureRadius
}
}
aggregate Drift {
"""
Drift before next docking attempt
"""
run in sequence
break if (
not isNaN ( Lat1 )
and not isNaN ( Lon1 )
or ( StayOnDock == true )
)
syslog important "No post-undock waypoint, drifting for "
+ Dock:LineCapture.rolloutTimeout~minute + " minutes"
behavior Guidance:Buoyancy {
run in parallel
set position = Control:VerticalControl.buoyancyNeutral
}
behavior Guidance:Pitch {
run in parallel
set massPosition = Control:VerticalControl.massDefault
set elevatorAngle = 0 degree
}
behavior Guidance:Point {
run in parallel
set rudderAngle = 0 degree
}
behavior Guidance:SetSpeed {
run in parallel
set speed = 0 meter_per_second
}
behavior Guidance:Wait {
run in sequence
set duration = Dock:LineCapture.rolloutTimeout
}
}
}
}
}
|