= make_tilefile =

||Category B||Version 3.0||

== Description ==

This program generates the pixel/line maplet-center locations required to complete the tiling of a bigmap at a user-specified resolution.

'''make_tilefile''' analyzes a coverage_m.pgm file, which is the output of [[map_coverage]], for areas that still need to be tiled. The output of this program is then put in the [[make_scriptT.in]] file. 

=== Required Files  ===
 * coverage_m.pgm - a Portable Graymap Format image of the bigmap-tiling in the user-specified maplet resolution range, generated using [[map_coverage]]

=== Output Files ===
 * std-out - list of bigmap pixel/line coordinates for new maplet center locations

== Using make_tilefile ==

29 March 2021 - For DART, in the Blessed master version of the code (updated 3.0.5), the -d option was added to increase the density of the tilefiles.  It creates a 2nd set that is offset by 25 pixels.  It provides more control points (and maplets) with much increased overlaps.


=== 1. Enter either Y or N in response to 'Upwards? (y/n)'. ===

 . '''Upwards? - Y''' - Pixel/line coordinates for tiling starting at the Southern-most line, West-to-East and South-to-North.
 . '''Upwards? - N''' - Pixel/line coordinates for tiling starting at the Northern-most line, West-to-East and North-to-South.

Here are two samples showing each of these responses:


{{{
 Upwards? (y/n)
y
      50  200
     100  200
     150  200
     200  200
      50  150
     100  150
#    150  150
     200  150
      50  100
     100  100
     150  100
     200  100
      50   50
#    100   50
#    150   50
     200   50
END
}}}

{{{
 Upwards? (y/n)
n
      50   50
#    100   50
#    150   50
     200   50
      50  100
     100  100
     150  100
     200  100
      50  150
     100  150
#    150  150
     200  150
      50  200
     100  200
     150  200
     200  200
END
}}}


The output columns are the pixel and line coordinates respectively for bare points in the bigmap. Locations that already contain a maplet in the required resolution-range are marked with '''#''' and will be ignored by [[make_scriptT]]. See [[make_scriptT]] for additional details. 


=== 2. Enter input and capture output using a single command line like this sample: ===

{{{
echo "N" | make_tilefile > out
}}}

 /!\ Use a text editor to discard the first line of output before you append it to the [[make_scriptT.in]]. See [[make_scriptT.in]] for additional details.

 (!) '''make_tilefile''' is set to make the pixel and line coordinates in intervals of 50 because maplets have a 99 by 99 pixel dimension. This means that the center will always be at the (50,50) coordinate with respect to a maplet. Thus, when a maplet is made at the same resolution as the bigmap, the maplet center coordinates will be multiples of 50.
---------
''(Compiled by DL)''

CategoryPrograms

Based on [[http://sbib.psi.edu/wiki_ext/refman.pdf|SPOC v3.02A PDF/UTILITIES/make_tilefile.f File Reference]]