= make_tilefile =
(compiled by DL)

'''Purpose:''' Program to generate the pixel/line maplet-center locations required to complete the tiling of a bigmap at a user-specified resolution.

The make_tilefile utility analyses 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. ''(Taken from [[http://sbib.psi.edu/wiki_ext/refman.pdf|SPOC v3.02A PDF]]/UTILITIES/make_tilefile.f File Reference.)'' 

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

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

== Using make_tilefile ==

The program requires a single user-input - Upwards? (y/n):

{{{
 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
}}}

{{{
 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
}}}

The output columns are the pixel and line coordinates respectively for bare points in the bigmap. Locations which already contain a maplet in the required resolution-range are marked with '#' and will be ignored by [[make_scriptT]] (refer to relevant page for further details). 

'''Upwards? - Y:''' Pixel/line coordinates for tiling from the Southern-most line, West-to-East and South-to-North.

'''Upwards? - N:''' Pixel/line coordinates for tiling from the Northern-most line, West-to-East and North-to-South.

The user may enter input and capture output in a single command line as follows:

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

however, the first line of output will need to be discarded using a text editor before appending to the [[make_scriptT.in]] file (refer to relevant page for further details).