IDE version Panorama

Below are steps to run Panorama (IDE version) to analyze and improve your own Rails application.

Download and install RubyMine.
Download Panorama IDE plugin.
Open RubyMine and go to preference->plugin, then click Install plugin from disk, and select the panorama jar file just downloaded.
Open your project with RubyMine.

Since Panorama changes the webpage layout and monitors then code change, you need to modify your app to enable such functionality.

Add the following to your Gemfile

gem 'will_paginate'
gem 'bootstrap-sass'
gem 'sass-rails'
gem 'render_async'
gem 'react-rails-hot-loader'
gem 'active_record_query_trace'

You can also do this by

cd panorama-static-analyzer
ruby add_gems.rb path-to-app/

Create a folder interact/:

$ mkdir app/assets/javascripts/interact

Add the following to app/assets/stylesheets/application.scss (create this file if not exists):
```
@import "bootstrap-sprockets";
@import "bootstrap";
```

Create new active_query_trace.rb:

$ touch config/initializer/active_query_trace.rb

and add the following to this file:

ActiveRecordQueryTrace.enabled = true
ActiveRecordQueryTrace.lines = 0
ActiveRecordQueryTrace.level = :rails

Add the following to the body of your view file (e.g., app/views/layouts/application.html.erb):
```
<%= content_for :render_async %>
```
For instance,
Add the following to the head of your application_controller.rb:
```
require 'will_paginate/array'
```
For instance,
create calls.txt
The tool needs to know all entrance controller actions from your application. It assumes them to be stored in a file called calls.txt. You can generate that file by running:
```
$rake routes | tail -n +2 | awk '{ for (i=1;i<=NF;i++) if (match($i, /.#./)) print $i}' | sed -e 's/#/,/g' | sort | uniq
```
in your app, and then copying it to <APPDIR>/calls.txt.

Clone the Panorama Static Analyzer source code from github.
The following packages need to be installed in order to run Panorama:
```
$ gem install yard
$ gem install activesupport
$ gem install work_queue
```
Start Panorama Static Analyer and Panorama IDE plugin
Before running Panorama, you may first visit a few webpages in the chrome. This will generate a log file, which will be analyzed by Panorama.
For instance, you have start the application blog-app whose path is /home/blog-app
Then go to the panorama folder and run the script to start a thread to monitor the browser activity, and send a request to change the source code if a patch suggestion is granted:
```
$ cd path_to_panorama-static-analyzer
$ ./compute_performance.sh PW-blog /home/blog-app/ BlogsController,index
```
For other applications, replace PW-blog with application name, /home/blog-app/ with the path to the app source, and BlogsController,index with the controller action you want to exam.
In the RubyMine IDE, open the app and turn on the Panorama:

Refresh the webpage it will look like this:

Lefthand side is a legend shows the “heat”, i.e., the cost to generate each element, with cooler color (on the side of scale 0) indicating less time and warmer color indicating more time. By default it shows the static cost, and you can choose other measuring method like using real cost numbers.
When you move the cursor to an element and click, it will show patches that Panorama can generate to accelerate the element:

Click the patch (e.g., pagination) and you can view the code change:

It shows which file it will change, the old code and the new patch code. If you wish to adopt a patch, click the “AcceptOrNot” on the “Panorama” menu, and the click “ok”.
Panorama will change the application source code if you accept a patch, and then you can see the accelerated webpage: