diff --git a/gmtxy-image2.sh b/gmtxy-image2.sh index 5202433..bddfe71 100755 --- a/gmtxy-image2.sh +++ b/gmtxy-image2.sh @@ -58,42 +58,48 @@ while getopts "hi:o:L:r:u:c:l:G:t:v:f:a:p:X:x:gnKOS" arg do case $arg in h) - dispTitle "${0##*/}" "simple grid file mapping using GMT script under x-y plane. \ - The template accepts a grid (.nc or .grd) file as input and outputs a .png and a .eps file. \ - For further explanations, please look for GMT's manuscripts." - dispAuthorInfo "Dr. Yi Zhang (yizhang-geo@zju.edu.cn)" + dispTitle "${0##*/}" "Image mapping of grid file(s) using the GMT software under the x-y plane. \ + This script accepts one or several grid (.nc or .grd) files as inputs and outputs \ + image files (.png and .eps files). The script could also output data specified shell scripts for \ + further modification. For detailed explanations of relevant arguments, please look for the GMT's manuscripts. \ + This software comes with ABSOLUTE NO WARRANTY. Use it at your own caution." + dispAuthorInfo "Dr. Yi Zhang (yizhang-geo@zju.edu.cn). Contact me if you have questions or suggestions." dispUsage "${0##*/} -i [-o] [-L] [-r///] [-u] \ [-c] [-t,] [-v] [-l;] [-g] [-G] \ - [-f] [-p] [-n] [-a,,] [-K] [-O] [-S] \ + [-f] [-p] [-n] [-a,,] [-K] [-O] [-S] \ [-X,] [-x,]" - dispOptionShort "-i" "Input grid file." - dispOptionShort "-o" "Output image file. File extension is not needed. the input filename will be \ - used if this option is not set." - dispOptionShort "-L" "Select layouts. enter a number to select the layout to use (0-3). \ - The default is zero." - dispOptionShort "-r" "Data range. The template will ditect the input data range automaticly, \ - the use of this option will overwrite the range." - dispOptionShort "-u" "Data unit. The default is meter." - dispOptionShort "-c" "Color cpt. The default is rainbow." + dispOptionShort "-i" "Input grid file. This is the only mandatory option that the script has. Just enter a filename \ + and you get a image." + dispOptionShort "-o" "Output image files. Name extension is not needed. the input filename will be \ + used if this option is not set. NOTE: set this option for plotting multiple images." + dispOptionShort "-L" "Select layout template that will be used for plotting. The script has four inbuilt templates \ + you can choose from (0 (default) - 3). Please try out to see their difference. You can also add more templates by \ + editing the script. Just make sure that you know what you are doing." + dispOptionShort "-r" "Range of the input data. The script will detect the full range of the data automatically and \ + the use of this option will overwrite the argument." + dispOptionShort "-u" "Data unit. The default is meter (m)." + dispOptionShort "-c" "Filename of the color scale. The default is rainbow.cpt." dispOptionShort "-t" "Intervals of axis's ticks. the script will set the intervals automatically \ - if -t option is not set." + if this option is not set." dispOptionShort "-v" "Intervals of color bar's labels. the script will set the intervals \ - automatically if -v option is not set." - dispOptionShort "-l" "Axis labels separated by semicolons. The deafults are x (m) and y (m)." - dispOptionShort "-g" "Use grdgradient. The default is false." - dispOptionShort "-G" "Provide a different input grid data for the use of grdgradient. \ + automatically if this option is not set." + dispOptionShort "-l" "Axis' labels separated by semicolons. The defaults are x (m) and y (m)." + dispOptionShort "-g" "Plot a over layer of directional illumination. The default is false." + dispOptionShort "-G" "Use a input grid data for applying directional illumination. \ This should be used with the '-g' option at the same time." - dispOptionShort "-f" "Set frames for mapping axises. The default is wEsNZ." + dispOptionShort "-f" "Set frames for plotting axises. The default is WesNZ for layout template 0." dispOptionShort "-n" "Don't plot color bar." dispOptionShort "-a" "Add an annotation on the map. you need to enter a string contains both \ - coordinates and text of the annotation, such as '10,10,(a)'." - dispOptionShort "-p" "Plot polygons via a file." - dispOptionShort "-K" "Keep the .ps file open." - dispOptionShort "-O" "Continue from a previous .ps file." - dispOptionShort "-X" "Move the starting point for mapping image." - dispOptionShort "-x" "Move the starting point for mapping color bar." - dispOptionShort "-S" "Instead of running the script, print a executable script on screen. \ - This option is designed to help building data specified scripts using the template." + coordinates and text of the annotation, such as '10,10,(a)'. For more than one annotations, \ + please output a data specified script using -S option, then edit the script accordingly." + dispOptionShort "-p" "Take inputs from a table file and plot polygons. Each line of the file \ + represents a 2D point's coordinates." + dispOptionShort "-K" "Keep the .ps file open. This option must be set for plotting multiple images to a single output file." + dispOptionShort "-O" "Continue from a previous .ps file. This option must be set for plotting multiple images to a single output file." + dispOptionShort "-X" "Move the starting point for mapping the image. Use this option for plotting sub-figures." + dispOptionShort "-x" "Move the starting point for mapping the color bar. Use this option for plotting sub-figures." + dispOptionShort "-S" "Instead of running the script for actually plotting, print a executable shell script on screen. \ + This option is designed to help building data specified shell scripts for further modification." exit 0;; i) data=$OPTARG;;