util/minorview.py

   1 #!/usr/bin/env python3
   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 # minorview.py: Minorview visuliser for MinorCPU model MinorTrace output
  39 #
  40
  41 import gtk
  42 import os
  43 import sys
  44 import argparse
  45
  46 # Find MinorView modules even if not called from minorview directory
  47 minorviewDir = os.path.dirname(os.path.realpath(__file__))
  48 sys.path.append(minorviewDir)
  49
  50 from minorview.model import BlobModel
  51 from minorview.view import BlobView, BlobController, BlobWindow
  52 from minorview.point import Point
  53
  54 if __name__ == '__main__':
  55     parser = argparse.ArgumentParser(description='Minor visualiser')
  56
  57     parser.add_argument('--picture', metavar='picture-file',
  58         default=minorviewDir + '/minorview/minor.pic',
  59         help='markup file containing blob information '
  60             + '(default: <minorview-path>/minor.pic)')
  61     parser.add_argument('--prefix', metavar='name', default='system.cpu',
  62         help='name prefix in trace for CPU to be visualised (default: '
  63             + 'system.cpu)')
  64     parser.add_argument('--start-time', metavar='time', type=int, default=0,
  65         help='time of first event to load from file')
  66     parser.add_argument('--end-time', metavar='time', type=int, default=None,
  67         help='time of last event to load from file')
  68     parser.add_argument('--mini-views', action='store_true', default=False,
  69         help='show tiny views of the next 10 time steps')
  70     parser.add_argument('eventFile', metavar='event-file', default='ev')
  71
  72     args = parser.parse_args(sys.argv[1:])
  73
  74     model = BlobModel(unitNamePrefix=args.prefix)
  75
  76     if args.picture and os.access(args.picture, os.O_RDONLY):
  77         model.load_picture(args.picture)
  78     else:
  79         parser.error('Can\'t read picture file: ' + args.picture)
  80
  81     # Make the key objects
  82     view = BlobView(model)
  83     controller = BlobController(model, view,
  84         defaultEventFile=args.eventFile,
  85         defaultPictureFile=args.picture)
  86     window = BlobWindow(model, view, controller)
  87     window.add_control_bar(controller.bar)
  88
  89     # Miniviews allow future timesteps to appear at the bottom of the
  90     #   display.
  91     if args.mini_views:
  92         window.miniViewCount = 10
  93
  94     window.show_window()
  95
  96     if args.eventFile and os.access(args.eventFile, os.O_RDONLY):
  97         controller.startTime = args.start_time
  98         controller.endTime = args.end_time
  99         model.load_events(args.eventFile, startTime=args.start_time,
 100             endTime=args.end_time)
 101         controller.set_time_index(0)
 102     else:
 103         parser.error('Can\'t read event file: ' + args.eventFile)
 104
 105     gtk.main()