Included Scripts

HotSpot includes a variety of useful scripts in the scripts directory, written either in Perl or Python. Following is a description of what the scripts are for, although you can also get usage information from each script by running it with no command-line arguments.

3Dfig.pl

This script reads in a layer configuration file and creates a .fig file (a vector image file viewable using xfig) for each floorplan in the layer configuration file.

grid_thermal_map.*

There are two versions of this script: one written in Perl (.pl extension) and one written in Python (.py extension). The Perl script reads in a floorplan file and a steady-state grid temperature file and produces a heat map as a .svg (vector image) file. Alternatively, the Python script reads in the same information, but uses matplotlib to produce the heat map as a .png file. example3 in the examples directory demonstrates how to use both of these scripts, and also produces output images from both so that you can compare and see which you prefer.

hsconvert-*

These are two scripts which, when used together, can automatically convert floorplans that contain floorplan elements with high aspect ratios into floorplans in which the floorplan elements have been subdivided into smaller floorplan elements with smaller aspect ratios. The hsconvert-flp.pl script can be used to convert the floorplan itself, while the hsconvert-data.pl script can be used to migrate power or temperature traces from the original floorplan to a floorplan converted by hsconvert-flp.pl.

split_grid_steady.py

This script takes in an output file produced by the -grid_steady_file option to HotSpot and divides the single file, which includes temperature information for each layer, into separate files for each layer. This option is necessary before visualizing a layer as a heat map with one of the grid_thermal_map scripts. An example of how to use this script is shown in example3

split_grid_transient.py

This script does the same thing as split_grid_steady.py, except that it works with an output file produced by -grid_transient_file.

tofig.pl

This script takes a floorplan file and produces an image of the floorplan as a .fig file (a vector image file viewable by xfig).

visualize_floorplan.py

This script takes as input a floorplan file and produces an image of the floorplan as a .png file using matplotlib. This script and tofig.pl produce images that look slightly different, so we recommend trying both to see which output you prefer.