View source: R/calc_zenith_raster_coord.R

calc_zenith_raster_coord | R Documentation |

Calculate zenith raster coordinates from points digitized with the open-source software package ‘ImageJ’. The zenith is the point on the image that represents the zenith when upward-looking photographs are taken with the optical axis parallel to the vertical line.

calc_zenith_raster_coord(path_to_csv) calc_zenith_raster_coordinates(path_to_csv)

`path_to_csv` |
Character vector of length one. Path to a CSV file created with the point selection tool of ‘ImageJ’ software. |

The technique described under the headline ‘Optical center characterization’
of the
user
manual of the software Can-Eye can be used to acquire the data for
determining the zenith coordinates. This technique was used by
\insertCitePekin2009;textualrcaiman, among others. Briefly, it consists
in drilling a small hole in the cap of the fisheye lens (it must be away from
the center of the cap), and taking about ten photographs without removing the
cap. The cap must be rotated about 30º before taking each photograph.
**The method implemented here does not support multiple holes**.

The point selection tool of ‘ImageJ’ software should be used to manually digitize the white dots and create a CSV file to feed this function. After digitizing the points on the image, use the dropdown menu Analyze>Measure to open the window Results. To obtain the CSV, use File>Save As...

Another method–only valid when enough of the circle perimeter is depicted in the image– is taking a very bright picture (for example, a picture of a room with walls painted in light colors) with the lens completely free (do not use any mount). Then, digitize points over the circle perimeter. This was the method used for producing the example file (see Examples). It is worth noting that the perimeter of the circle depicted in a circular hemispherical photograph is not necessarily the horizon.

Numeric vector of length two. Raster coordinates of the zenith, assuming a lens facing up with its optical axis parallel to the vertical line. It is important to note the difference between the raster coordinates and the Cartesian coordinates. In the latter, the vertical axis value decreases downward, but the opposite is true for the raster coordinates, which works like a spreadsheet.

Other Lens Functions:
`azimuth_image()`

,
`calc_diameter()`

,
`calibrate_lens()`

,
`expand_noncircular()`

,
`fisheye_to_equidistant()`

,
`fisheye_to_pano()`

,
`lens()`

,
`test_lens_coef()`

,
`zenith_image()`

## Not run: path <- system.file("external/points_over_perimeter.csv", package = "rcaiman") calc_zenith_raster_coord(path) ## End(Not run)

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.