util/minorview.py

   1 #!/usr/bin/env python
   2 #
   3 # Copyright (c) 2013 ARM Limited
   4 # All rights reserved
   5 #
   6 # The license below extends only to copyright in the software and shall
   7 # not be construed as granting a license to any other intellectual
   8 # property including but not limited to intellectual property relating
   9 # to a hardware implementation of the functionality of the software
  10 # licensed hereunder.  You may use the software subject to the license
  11 # terms below provided that you ensure that this notice is replicated
  12 # unmodified and in its entirety in all distributions of the software,
  13 # modified or unmodified, in source code or in binary form.
  14 #
  15 # Redistribution and use in source and binary forms, with or without
  16 # modification, are permitted provided that the following conditions are
  17 # met: redistributions of source code must retain the above copyright
  18 # notice, this list of conditions and the following disclaimer;
  19 # redistributions in binary form must reproduce the above copyright
  20 # notice, this list of conditions and the following disclaimer in the
  21 # documentation and/or other materials provided with the distribution;
  22 # neither the name of the copyright holders nor the names of its
  23 # contributors may be used to endorse or promote products derived from
  24 # this software without specific prior written permission.
  25 #
  26 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  27 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  28 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  29 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  30 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  31 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  32 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  33 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  34 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  35 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  36 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  37 #
  38 # Authors: Andrew Bardsley
  39 #
  40 # minorview.py: Minorview visuliser for MinorCPU model MinorTrace output
  41 #
  42
  43 import gtk
  44 import os
  45 import sys
  46 import argparse
  47
  48 # Find MinorView modules even if not called from minorview directory
  49 minorviewDir = os.path.dirname(os.path.realpath(__file__))
  50 sys.path.append(minorviewDir)
  51
  52 from minorview.model import BlobModel
  53 from minorview.view import BlobView, BlobController, BlobWindow
  54 from minorview.point import Point
  55
  56 if __name__ == '__main__':
  57     parser = argparse.ArgumentParser(description='Minor visualiser')
  58
  59     parser.add_argument('--picture', metavar='picture-file',
  60         default=minorviewDir + '/minorview/minor.pic',
  61         help='markup file containing blob information '
  62             + '(default: <minorview-path>/minor.pic)')
  63     parser.add_argument('--prefix', metavar='name', default='system.cpu',
  64         help='name prefix in trace for CPU to be visualised (default: '
  65             + 'system.cpu)')
  66     parser.add_argument('--start-time', metavar='time', type=int, default=0,
  67         help='time of first event to load from file')
  68     parser.add_argument('--end-time', metavar='time', type=int, default=None,
  69         help='time of last event to load from file')
  70     parser.add_argument('--mini-views', action='store_true', default=False,
  71         help='show tiny views of the next 10 time steps')
  72     parser.add_argument('eventFile', metavar='event-file', default='ev')
  73
  74     args = parser.parse_args(sys.argv[1:])
  75
  76     model = BlobModel(unitNamePrefix=args.prefix)
  77
  78     if args.picture and os.access(args.picture, os.O_RDONLY):
  79         model.load_picture(args.picture)
  80     else:
  81         parser.error('Can\'t read picture file: ' + args.picture)
  82
  83     # Make the key objects
  84     view = BlobView(model)
  85     controller = BlobController(model, view,
  86         defaultEventFile=args.eventFile,
  87         defaultPictureFile=args.picture)
  88     window = BlobWindow(model, view, controller)
  89     window.add_control_bar(controller.bar)
  90
  91     # Miniviews allow future timesteps to appear at the bottom of the
  92     #   display.
  93     if args.mini_views:
  94         window.miniViewCount = 10
  95
  96     window.show_window()
  97
  98     if args.eventFile and os.access(args.eventFile, os.O_RDONLY):
  99         controller.startTime = args.start_time
 100         controller.endTime = args.end_time
 101         model.load_events(args.eventFile, startTime=args.start_time,
 102             endTime=args.end_time)
 103         controller.set_time_index(0)
 104     else:
 105         parser.error('Can\'t read event file: ' + args.eventFile)
 106
 107     gtk.main()