pyobs-allsky-cloudcover/example.yaml at main · pyobs/pyobs-allsky-cloudcover · GitHub

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
class: pyobs_cloudcover.application.Application

# Camera which images are used for cloud detection
image_sender: "allskycam"

# Web Service
server:
  # Host Name
  url: "localhost"
  # Port
  port: 8080

# Influx DB
measurement_log:
  logger:
    type: "influx"
    url: ""
    bucket: ""
    org: ""
    token: ""

  measurements:
    cloud_zenith:
      - type: "zenith"
        name: "cloudcover"
        # Altitude which is considered to be the lower boundary of the zenith to average for the zenith cloud fraction measurement (in degree)
        altitude: 80.0
    cloud_total:
      - type: "total"
        name: "cloudcover"
    coverage:
      - type: "change"
        name: "coverage-change"
      - type: "sun"
        name: "sun-coverage"
        radius: 20.0
      - type: "moon"
        name: "moon-coverage"
        radius: 20.0


# Different image analysis pipelines can be used for different solar altitude intervals
# Currently only the "night" pipeline is available, which works best after the astronomical dawn
pipelines:
  day:
    alt_interval:
      start: 18
      end:

    options:
      # Astronomical solution
      # Possible models:
      #   Simple Model
      #     class: pyobs_cloudcover.world_model.SimpleModel
      #     parameters: (a0, F, R, c_x, c_y) see https://ui.adsabs.harvard.edu/abs/2019A&A...626A.105B
      #   WCS Model
      #     class: pyobs_cloudcover.world_model.WCSModel
      #     parameters:
      #       file_path: Path to FITS file containing WCS
      world_model:
        class: pyobs_cloudcover.world_model.SimpleModel
        a0: 4.81426598e-03
        F: 2.00000000e+00
        R: 1.06352627e+03
        c_x: 7.57115607e+02
        c_y: 5.11194838e+02

      # Filepath to the image mask
      mask_filepath: "data/mask.npy"

      cloud_map:
        # Under which color ratio a pixel is considered cloudy (blue/red + blue/green)
        threshold: 3.5

      # Apparent size of the sun in the allsky image in degree
      sun_apparent_size: 0.54

      coverage_info:
        # Altitude which is considered to be the lower boundary of the zenith to average for the zenith cloud fraction measurement (in degree)
        zenith_altitude: 80
  night:
    # Solar altitude interval (in degree), in which this pipeline should be used
    alt_interval:
      start:
      end: -18

    options:
      # Astronomical solution
      # Possible models:
      #   Simple Model
      #     class: pyobs_cloudcover.world_model.SimpleModel
      #     parameters: (a0, F, R, c_x, c_y) see https://ui.adsabs.harvard.edu/abs/2019A&A...626A.105B
      #   WCS Model
      #     class: pyobs_cloudcover.world_model.WCSModel
      #     parameters:
      #       file_path: Path to FITS file containing WCS
      world_model:
        class: pyobs_cloudcover.world_model.SimpleModel
        a0: 4.81426598e-03
        F: 2.00000000e+00
        R: 1.06352627e+03
        c_x: 7.57115607e+02
        c_y: 5.11194838e+02

      preprocessor:
        # Filepath to the image mask
        mask_filepath: "tests/integration/mask.npy"
        # Which image binning should be applied
        bin_size: 2

      catalog:
        # Filepath to the star catalog
        filepath: "data/catalog_v50.csv"
        filter:
          # Lower altitude boundary (in degree)
          alt: 30.0
          # Upper magnitude boundary (in mag)
          v_mag: 7.0
          # Minimum allowed distance between stars (in px after binning)
          distance: 0.0

      # Determines the visibility of a star
      reverse_matcher:
        # How many standard deviations a signal has to be over the average brightness to count as a star detection
        sigma_threshold: 3.0
        # Maximum allowed distance between a signal and the calculated position of the star (in px)
        distance: 4.0
        # Maximum allowed median brightness of the window
        median_limit: 8e3
        # Rectangle around the calculated star position with 2 * window_size + 1 length, in which the star searched for (in px)
        window_size: 6.0

      # Determines at which celestial positions the limiting magnitude is evaluated
      altaz_grid:
        # Number of equidistant points on the hole celestial sphere
        point_number: 100000
        # Lower boundary for altitude
        limiting_altitude: 30

      lim_mag_map:
        # Radius in which to use stars for estimating the limiting magnitude (in degree)
        radius: 7.0
        # Number of consecutive images in which a star has to be visible to be considered visible for the limiting magnitude estimation
        integration_length: 1

      cloud_map:
        # Under which limiting magnitude a pixel is considered cloudy (in mag)
        threshold: 5.5

      # Apparent size of the moon in the allsky image in degree
      moon_apparent_size: 0.5