gem5/util/minorview.py

#!/usr/bin/env python2
#
# Copyright (c) 2013 ARM Limited
# All rights reserved
#
# The license below extends only to copyright in the software and shall
# not be construed as granting a license to any other intellectual
# property including but not limited to intellectual property relating
# to a hardware implementation of the functionality of the software
# licensed hereunder.  You may use the software subject to the license
# terms below provided that you ensure that this notice is replicated
# unmodified and in its entirety in all distributions of the software,
# modified or unmodified, in source code or in binary form.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are
# met: redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer;
# redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution;
# neither the name of the copyright holders nor the names of its
# contributors may be used to endorse or promote products derived from
# this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
# Authors: Andrew Bardsley
#
# minorview.py: Minorview visuliser for MinorCPU model MinorTrace output
#

import gtk
import os
import sys
import argparse

# Find MinorView modules even if not called from minorview directory
minorviewDir = os.path.dirname(os.path.realpath(__file__))
sys.path.append(minorviewDir)

from minorview.model import BlobModel
from minorview.view import BlobView, BlobController, BlobWindow
from minorview.point import Point

if __name__ == '__main__':
    parser = argparse.ArgumentParser(description='Minor visualiser')

    parser.add_argument('--picture', metavar='picture-file',
        default=minorviewDir + '/minorview/minor.pic',
        help='markup file containing blob information '
            + '(default: <minorview-path>/minor.pic)')
    parser.add_argument('--prefix', metavar='name', default='system.cpu',
        help='name prefix in trace for CPU to be visualised (default: '
            + 'system.cpu)')
    parser.add_argument('--start-time', metavar='time', type=int, default=0,
        help='time of first event to load from file')
    parser.add_argument('--end-time', metavar='time', type=int, default=None,
        help='time of last event to load from file')
    parser.add_argument('--mini-views', action='store_true', default=False,
        help='show tiny views of the next 10 time steps')
    parser.add_argument('eventFile', metavar='event-file', default='ev')

    args = parser.parse_args(sys.argv[1:])

    model = BlobModel(unitNamePrefix=args.prefix)

    if args.picture and os.access(args.picture, os.O_RDONLY):
        model.load_picture(args.picture)
    else:
        parser.error('Can\'t read picture file: ' + args.picture)

    # Make the key objects
    view = BlobView(model)
    controller = BlobController(model, view,
        defaultEventFile=args.eventFile,
        defaultPictureFile=args.picture)
    window = BlobWindow(model, view, controller)
    window.add_control_bar(controller.bar)

    # Miniviews allow future timesteps to appear at the bottom of the
    #   display.
    if args.mini_views:
        window.miniViewCount = 10

    window.show_window()

    if args.eventFile and os.access(args.eventFile, os.O_RDONLY):
        controller.startTime = args.start_time
        controller.endTime = args.end_time
        model.load_events(args.eventFile, startTime=args.start_time,
            endTime=args.end_time)
        controller.set_time_index(0)
    else:
        parser.error('Can\'t read event file: ' + args.eventFile)

    gtk.main()