Source code for tuiview.viewerapplication

Module contains the ViewerApplication class
# This file is part of 'TuiView' - a simple Raster viewer
# Copyright (C) 2012  Sam Gillingham
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

import sys
import argparse
from PyQt5.QtWidgets import QApplication, QMessageBox

from . import archivereader
from . import geolinkedviewers
from . import viewerstretch
from .viewerstrings import MESSAGE_TITLE

[docs]def getCmdargs(): """ Get commandline arguments """ p = argparse.ArgumentParser() p.add_argument('-b', '--bands', help="comma seperated list of bands to display") p.add_argument('-c', '--colortable', action="store_true", default=False, help="Apply color table to image") p.add_argument('-g', '--greyscale', action="store_true", default=False, help="Display image in greyscale") p.add_argument('-r', '--rgb', action="store_true", default=False, help="use 3 bands to create RGB image") p.add_argument('-n', '--nostretch', action="store_true", default=False, help="do no stretch on data") p.add_argument('-l', '--linear', nargs=2, metavar=('minVal', 'maxVal'), help="do a linear stretch between two values " + "(eg '-l 0 10'). Pass 'stats' for statistics") p.add_argument('-s', '--stddev', action="store_true", default=False, help="do a 2 standard deviation stretch") p.add_argument('--hist', action="store_true", default=False, help="do a histogram stretch") p.add_argument('--stretchfromtext', help="Load stretch and lookup table from text file") p.add_argument('--stretchfromgdal', help="Load stretch and lookup table from GDAL file" + " that contains saved stretch and lookup table") p.add_argument('--noplugins', action="store_false", default=True, dest='loadplugins', help="Don't load plugins") p.add_argument('--separate', action="store_true", default=False, help="load multiple files into separate windows") p.add_argument('--goto', help="Zoom to a location. Format is:"+ " 'easting,northing,factor' where factor is meters"+ " per window pixel.") p.add_argument('-v', '--vector', action='append', dest="vectors", help="overlay vector file on top of rasters." + " Can be specified multple times") p.add_argument('-t', '--savedstate', help="path to a .tuiview file with saved viewers state") p.add_argument('filenames', nargs='*') cmdargs = p.parse_args() # default values for these 'fake' parameters that we # then set depending on the flags. cmdargs.stretch = viewerstretch.ViewerStretch() cmdargs.modeSet = False cmdargs.stretchModeSet = False cmdargs.bandsSet = False if cmdargs.colortable: cmdargs.stretch.setColorTable() cmdargs.modeSet = True if cmdargs.greyscale: cmdargs.stretch.setGreyScale() cmdargs.modeSet = True if cmdargs.rgb: cmdargs.stretch.setRGB() cmdargs.modeSet = True if cmdargs.nostretch: cmdargs.stretch.setNoStretch() cmdargs.stretchModeSet = True if cmdargs.linear is not None: (minVal, maxVal) = cmdargs.linear if minVal == 'stats': minVal = None else: minVal = float(minVal) if maxVal == 'stats': maxVal = None else: maxVal = float(maxVal) cmdargs.stretch.setLinearStretch(minVal, maxVal) cmdargs.stretchModeSet = True if cmdargs.stddev: cmdargs.stretch.setStdDevStretch() cmdargs.stretchModeSet = True if cmdargs.hist: cmdargs.stretch.setHistStretch() cmdargs.stretchModeSet = True if cmdargs.bands is not None: bandlist = [int(x) for x in cmdargs.bands.split(',')] cmdargs.stretch.setBands(bandlist) cmdargs.bandsSet = True if cmdargs.stretchfromtext is not None: try: cmdargs.stretch = viewerstretch.ViewerStretch.fromTextFileWithLUT( cmdargs.stretchfromtext) cmdargs.modeSet = True cmdargs.stretchModeSet = True cmdargs.bandsSet = True except Exception as e: QMessageBox.critical(None, MESSAGE_TITLE, str(e)) if cmdargs.stretchfromgdal is not None: cmdargs.stretch = viewerstretch.ViewerStretch.fromGDALFileWithLUT( cmdargs.stretchfromgdal) cmdargs.modeSet = True cmdargs.stretchModeSet = True cmdargs.bandsSet = True return cmdargs
[docs]class ViewerApplication(QApplication): """ Main class for application """ def __init__(self): QApplication.__init__(self, sys.argv) self.pluginHandlers = [] # for settings self.setApplicationName('tuiview') self.setOrganizationName('TuiView') cmdargs = getCmdargs() loadplugins = cmdargs.loadplugins self.viewers = geolinkedviewers.GeolinkedViewers(loadplugins) stretch = None if (cmdargs.modeSet and cmdargs.stretchModeSet and cmdargs.bandsSet): # use the stretch they have constructed stretch = cmdargs.stretch elif (cmdargs.modeSet or cmdargs.stretchModeSet or cmdargs.bandsSet): msg = ('Stretch incomplete. Must specify one of [-c|-g|-r] and' + ' one of [-n|-l|-s|--hist] and -b, or none to use defaults.') raise SystemExit(msg) if len(cmdargs.filenames) == 0 and cmdargs.savedstate is None: self.viewers.newViewer() else: if cmdargs.separate: # need to be in separate windows for filename in cmdargs.filenames: self.viewers.newViewer(filename, stretch) else: # load into one viewer viewer = None for filename in archivereader.file_list_to_archive_strings( cmdargs.filenames): if viewer is None: viewer = self.viewers.newViewer(filename, stretch) else: viewer.addRasterInternal(filename, stretch) # saved state if cmdargs.savedstate is not None: try: fileobj = open(cmdargs.savedstate) self.viewers.readViewersState(fileobj) fileobj.close() except Exception as e: QMessageBox.critical(None, MESSAGE_TITLE, str(e)) self.viewers.newViewer() # open vectors in all viewer windows if cmdargs.vectors is not None: for viewer in self.viewers.viewers: for vector in cmdargs.vectors: viewer.addVectorInternal(vector) # goto a location if cmdargs.goto is not None: from tuiview.viewerwidget import GeolinkInfo arr = cmdargs.goto.split(',') if len(arr) != 3: msg = "goto usage: 'easting,northing,factor'" raise SystemExit(msg) (easting, northing, metresperimgpix) = arr easting = float(easting) northing = float(northing) metresperimgpix = float(metresperimgpix) obj = GeolinkInfo(0, easting, northing, metresperimgpix) self.viewers.onMove(obj)
[docs] def savePluginHandler(self, handler): """ Plugins need to be able to save an instance of their signal handling object so it doesn't get cleaned up by Python's garbage collection. There are a number of ways to address this, but this seems the cleanest. Get an instance of this ViewerApplication class in the plugin by using the: app = QApplication.instance() Call. """ self.pluginHandlers.append(handler)
[docs]def run(): """ Call this function to instantiate an instance of ViewerApplication and have the command line parameters inspected etc and app run """ app = ViewerApplication() app.exec_()