## page was renamed from surface_imager.e

= surface_imager =

||Category ?||Version ?||

 . (!) This code was developed for the Mercator Project (LASER Program). The code uses Gaskell's basic infrastructure and data files.

== Description ==
'''surface_imager''' takes a [[bigmap]] and generates a surface image as if you are standing on (or near) the surface.  It is designed to have a 100mm focal length lens and generate a 1024x1024 image.


== Input Files ==
 * none

== Input stdin ==
 * Bigmap name
 * Location of the point of view (x, y, z).  X and Y are pixel positions within the map.  Z is in meters above the surface.
 * Direction that you are looking (azimuth and elevation - in degrees).  Zero azimuth is looking due north.  Zero elevation is looking at the horizon.
 * Sun position (azimuth and elevation - in degrees).  Zero azimuth has the Sun due north.  90 elevation is the Sun straight up.

Here's a sample input:

 {{{
123456
1733 1393 10
90, 0
60, 30            <- low sun angle

 }}}

== Output ==
 * IMAGE.pgm - The output image.  Normally, it is 1024x1024 of the field of view (about 24 degrees square).

{{attachment:surf_example.jpg}}

----------
CategoryPrograms CategoryMercator