Skip to content

Commit e3b1e6c

Browse files
Markus WaldmannMarkus Waldmann
authored andcommitted
Changed naming in CloudLayer, added Sky Obscured
Renamed ENUMS to LEVEL0-8, added LEVEL_SKY_OBSCURED for situations where the sky is not perceivable, Visual Reference in the comments added Signed-off-by: Markus Waldmann <Markus.Waldmann@stud.hs-kempten.de>
1 parent 686bbdb commit e3b1e6c

File tree

1 file changed

+24
-17
lines changed

1 file changed

+24
-17
lines changed

osi_environment.proto

Lines changed: 24 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -346,10 +346,12 @@ message EnvironmentalConditions
346346
{
347347
// Definition of the cloud state level, i.e. cloud state and sky visualization settings.
348348
//
349-
optional CloudStateLevel cloud_state_level = 1;
349+
optional CloudLayerLevel cloud_layer_level = 1;
350350

351351
// Defines the cloud state levels given by observation of total cloud amount in oktas.
352352
//
353+
// For visual alignment please call the reference[1]
354+
//
353355
// The total degree of coverage indicates how large the part of the sky vault is which is covered
354356
// with clouds altogether. It is given in eighths, because this division is easier to estimate
355357
// for the observer. 0 eighths means that there are no traces of clouds in the sky,
@@ -364,58 +366,63 @@ message EnvironmentalConditions
364366
// With a little practice, the observer can easily determine the total amount of cloud cover.
365367
// Problems occur only with scattered clouds or many single clouds (cumulus).
366368
// Their cloud cover is often overestimated. On the other hand,
367-
// the coverage of thin ice clouds (cirrus) is often underestimated [3].
369+
// the coverage of thin ice clouds (cirrus) is often underestimated [2].
368370
//
369371
// \par References:
370-
// [1] ISO 15469:2004(E) / CIE S 011/E:2003 : Spatial distribution of skylight
371-
// [2] https://en.wikipedia.org/wiki/Cloud_cover
372-
// [3] https://www.dwd.de/DE/service/lexikon/Functions/glossar.html?lv2=100932&lv3=101016
372+
// ISO 15469:2004(E) / CIE S 011/E:2003 : Spatial distribution of skylight
373+
// https://en.wikipedia.org/wiki/Cloud_cover
374+
// [1] https://www.eoas.ubc.ca/courses/atsc113/flying/met_concepts/01-met_concepts/01c-cloud_coverage/index.html
375+
// [2] https://www.dwd.de/DE/service/lexikon/Functions/glossar.html?lv2=100932&lv3=101016
373376
//
374-
enum CloudStateLevel
377+
enum CloudLayerLevel
375378
{
376379
// Cloud State is unknown (must not be used in ground truth).
377380
//
378-
CLOUD_STATE_LEVEL_UNKNOWN = 0;
381+
CLOUD_LAYER_LEVEL_UNKNOWN = 0;
379382

380383
// Other (unspecified but known) CloudState.
381384
//
382-
CLOUD_STATE_LEVEL_OTHER = 1;
385+
CLOUD_LAYER_LEVEL_OTHER = 1;
383386

384387
// Cloudless (0/8)
385388
//
386-
CLOUD_STATE_LEVEL_CLOUDLESS = 2;
389+
CLOUD_LAYER_LEVEL_0 = 2;
387390

388391
// Sunny (1/8)
389392
//
390-
CLOUD_STATE_LEVEL_SUNNY = 3;
393+
CLOUD_LAYER_LEVEL_1 = 3;
391394

392395
// Serene (2/8))
393396
//
394-
CLOUD_STATE_LEVEL_SERENE = 4;
397+
CLOUD_LAYER_LEVEL_2 = 4;
395398

396399
// Slightly Cloudy (3/8)
397400
//
398-
CLOUD_STATE_LEVEL_SLIGHTLY_CLOUDY = 5;
401+
CLOUD_LAYER_LEVEL_3 = 5;
399402

400403
// Light Cloudy (4/8)
401404
//
402-
CLOUD_STATE_LEVEL_LIGHT_CLOUDY = 6;
405+
CLOUD_LAYER_LEVEL_4 = 6;
403406

404407
// Cloudy (5/8)
405408
//
406-
CLOUD_STATE_LEVEL_CLOUDY = 7;
409+
CLOUD_LAYER_LEVEL_5 = 7;
407410

408411
// Heavy Cloudy (6/8)
409412
//
410-
CLOUD_STATE_LEVEL_HEAVY_CLOUDY = 8;
413+
CLOUD_LAYER_LEVEL_6 = 8;
411414

412415
// Almost Covered (7/8)
413416
//
414-
CLOUD_STATE_LEVEL_ALMOST_COVERED = 9;
417+
CLOUD_LAYER_LEVEL_7 = 9;
415418

416419
// Covered (8/8)
417420
//
418-
CLOUD_STATE_LEVEL_COVERED = 10;
421+
CLOUD_LAYER_LEVEL_8 = 10;
422+
423+
// Sky obscured, describes situations where the sky is not perceivable.
424+
//
425+
CLOUD_LAYER_LEVEL_SKY_OBSCURED = 11;
419426
}
420427
}
421428

0 commit comments

Comments
 (0)