Merge branch 'main' into review/anirudh_manoj/2869

Author: rbuch

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @rbuch

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment (please complete the following information):**
+ - OS: [e.g. Linux, Windows]
+ - Projections Version
+ - Java Version
+ - Charm++ Version
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered, if applicable.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/test.yml

@@ -0,0 +1,28 @@
+name: Projections CI
+
+on:
+  pull_request: {}
+  push:
+    branches:
+      - main
+  schedule:
+    - cron:  '5 0 * * *'
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        java: [8, 11, 15]
+        os: [ubuntu-latest, macos-latest]
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK
+        uses: actions/setup-java@v1
+        with:
+          java-version: ${{ matrix.java }}
+      - name: Build with Gradle
+        run: gradle build
+      - name: Run test
+        if: ${{ matrix.os == 'ubuntu-latest' }}
+        run: xvfb-run -e /dev/stdout -a make test

.travis.yml

@@ -11,3 +11,6 @@ clean:
 
 run: bin/projections.jar
 	bin/projections test/hello.sts
+
+test: bin/projections.jar
+	bin/projections --exit test/hello.sts

Makefile

@@ -1,11 +1,16 @@
-[![Build Status](https://travis-ci.org/UIUC-PPL/projections.svg?branch=master)](https://travis-ci.org/UIUC-PPL/projections)
+# Projections
+
+![Projections CI](https://github.com/UIUC-PPL/projections/workflows/Projections%20CI/badge.svg?event=push)
+[![Documentation Status](https://readthedocs.org/projects/charm/badge/?version=latest)](https://charm.readthedocs.io/en/latest/projections/manual.html)
+[![DOI](https://zenodo.org/badge/86751036.svg)](https://zenodo.org/badge/latestdoi/86751036)
+
 
 Projections is a tool to visusalize execution traces of Charm++ and AMPI applications.
 
-# Compiling Projections
+## Compiling Projections
 
 1) Make sure the JDK commands `java`, `javac` and `jar`
-   are in your path. You should use at least Java version 1.6,
+   are in your path. You should use at least Java version 8,
    and your java and javac should be of the same version.
    You also need [`gradle`](https://gradle.org/) and, optionally,
    the GNU tool `make`.
@@ -21,11 +26,11 @@ Projections is a tool to visusalize execution traces of Charm++ and AMPI applica
       `projections.jar`       : archive of all the java and image files
 
 
-# Running Projections
+## Running Projections
 
 Run `$ ./bin/projections` from the root of the Projections directory.
 
-# Using Projections
+## Using Projections
 
 Projections is a visualization tool to help you understand and analyze what it
 happening in your parallel (Charm++) program.  To use Projections, you first
@@ -73,9 +78,9 @@ data:
 18. Streaming CCS
 19. Memory Usage
 
-## Tool descriptions
+### Tool descriptions
 
-### 1. Timelines
+#### 1. Timelines
 
 The Timelines window lets you look at what a specific processor is doing at
 each moment of the program.
@@ -183,7 +188,7 @@ The Timeline Window consists of two parts:
      into the selected area or reload the selected area.
 
 
-### 2. Usage Profile:
+#### 2. Usage Profile:
 
 The Usage Profile window lets you see percentage-wise what each processor
 spends its time on during a specified period.
@@ -207,23 +212,23 @@ portion of the bar, a pop-up window will appear telling you the name of the
 item, what percent of the usage it has, and the processor it is on.
 
 
-### 3. Communication Per Processor:
+#### 3. Communication Per Processor:
 
 This tool shows communication over the interval per selected
 PE. This view is in the processor domain. It can show the number of
 messages or bytes sent or received, depending on the option
 selected at the bottom of the window.
 
 
-### 4. Communication Over Time:
+#### 4. Communication Over Time:
 
 This tool shows communication over time across all selected PEs.
 This view is in the time domain. It can show the number of messages
 or bytes sent or received, depending on the option selected at the
 bottom of the window.
 
 
-### 5. Call Table:
+#### 5. Call Table:
 
 This tool shows all the entry methods invoked by other entry
 methods. The left aligned entry method name indicates the current
@@ -234,22 +239,22 @@ or the number of total messages received, bytes received, and
 statistics on the received bytes, respectively.
 
 
-### 6. View Log Files:
+#### 6. View Log Files:
 
 This tool shows raw log files for the selected PEs and time
 interval. The log files are parsed by Projections and event types,
 entry method names, etc. are printed rather than the raw integers
 of the actual logs.
 
 
-### 7. Histograms:
+#### 7. Histograms:
 
 This tool creates histograms for various properties of the program,
 execution time, accumulated execution time, message size, and idle
 percentage.
 
 
-### 8. Overview:
+#### 8. Overview:
 
 This tool shows a high level overview of execution across the
 selected PEs and time interval. It displays a dense, quantized view
@@ -258,7 +263,7 @@ or utilization.  Essentially, it provides a coarser view of the
 same information as Timeline (see #1).
 
 
-### 9. Animations:
+#### 9. Animations:
 
 This window animates the processor usage by displaying
 different colors for different amount of usage.
@@ -267,7 +272,7 @@ The left box allows you to select the real time between frames;
 the right box the processor time between frames.
 
 
-### 10. Time Profile:
+#### 10. Time Profile:
 
 This tool shows execution across the selected PEs and time
 interval. This view is in the time domain. This tool shows a high
@@ -278,71 +283,71 @@ Essentially, it provides a coarser view of the same information as
 Timeline (see #1).
 
 
-### 11. Performance Counters:
+#### 11. Performance Counters:
 
 This tool shows the values of performance counters per entry point
 and PE. This option is disabled unless Charm++ was compiled with
 support for PAPI counters.
 
 
-### 12. User Events:
+#### 12. User Events:
 
 This tool shows the summation of bracketed user events per PE
 across the selected PEs and time interval.
 
 
-### 13. User Stats Over Time:
+#### 13. User Stats Over Time:
 
 This tool shows the values of user stats over the program execution
 across the selected PEs and time interval. This view is in the
 time domain.
 
 
-### 14. User Stats Per Processor:
+#### 14. User Stats Per Processor:
 
 This tool shows the values of user stats per PE
 across the selected PEs and time interval. This view is in the
 PE domain.
 
 
-### 15. Extrema Analysis:
+#### 15. Extrema Analysis:
 
 This tool identifies extreme clusters of particular attributes
 through the execution. The attribute, activity, extrema threshold,
 and number of clusters are customizable when selecting a time range.
 
 
-### 16. Multirun Analysis:
+#### 16. Multirun Analysis:
 
 This tool compares multiple executions of a program to each other,
 showing how time spent in entry methods changes across the
 execution. Currently, this view only works with summary data due to
 memory constraints.
 
 
-### 17. Noise Miner:
+#### 17. Noise Miner:
 
 This tool identifies abnormally long entry methods to detect
 symptoms consistent with computational noise.  Long events are
 filtered and clustered to provide a summary of such occurrences.
 
 
-### 18. Streaming CCS:
+#### 18. Streaming CCS:
 
 This tool uses the Converse Client Server feature of Charm++ to
 stream performance data from running programs.  To use it, the
 Charm++ program must be compiled with `-tracemode utilization`, and
 executed with `++server ++server-port <port number>`.
 
 
-### 19. Memory Usage:
+#### 19. Memory Usage:
 
 This tool provides a view of memory utilization in the application
 when it is linked with the memory tracing module.
 
 
 
-# Notes
+## Notes
 
 Charts in some tools are produced by JFreeChart.
 Image output is performed by FreeHEP.

README.md

@@ -1,13 +1,24 @@
-#!/bin/sh
+#!/bin/bash
 
 jarpath="`dirname $0`/projections.jar"
 
+if [[ ! -f $jarpath ]]; then
+  echo "'$jarpath' is missing. Did you run 'make'?"
+  exit 1
+fi
+
 if test -x /usr/bin/cygpath
-then 
+then
   if test "`uname -o`" = "Cygwin"
   then
     jarpath=`/usr/bin/cygpath -w -a $jarpath`
-  fi 
+  fi
+fi
+
+IS_WAYLAND=`env | grep -i wayland`
+if [ -n "$IS_WAYLAND" ]
+then
+  export _JAVA_AWT_WM_NONREPARENTING=1
 fi
 
 #java -Xms4G -Xmx4G -ms4G -mx4G -XX:+UseParallelGC -classpath $jarpath projections.analysis.ProjMain $*

bin/projections

@@ -6,22 +6,21 @@ repositories {
 }
 
 dependencies {
-  compile 'org.freehep:freehep-graphicsbase:2.4'
-  compile 'org.freehep:freehep-graphics2d:2.4'
-  compile 'org.freehep:freehep-graphicsio:2.4'
-  compile 'org.freehep:freehep-graphicsio-pdf:2.4'
-  compile 'org.freehep:freehep-graphicsio-svg:2.4'
-  compile 'org.freehep:freehep-graphicsio-ps:2.4'
-  compile 'org.freehep:freehep-vectorgraphics:2.4'
-
-  compile 'org.jfree:jcommon:1.0.23'
-  compile 'org.jfree:jfreechart:1.0.19'
+  implementation 'org.freehep:freehep-graphicsbase:2.4'
+  implementation 'org.freehep:freehep-graphics2d:2.4'
+  implementation 'org.freehep:freehep-graphicsio:2.4'
+  implementation 'org.freehep:freehep-graphicsio-pdf:2.4'
+  implementation 'org.freehep:freehep-graphicsio-svg:2.4'
+  implementation 'org.freehep:freehep-graphicsio-ps:2.4'
+  implementation 'org.freehep:freehep-vectorgraphics:2.4'
+
+  implementation 'org.jfree:jfreechart:1.5.0'
 }
 
 mainClassName = 'projections.analysis.ProjMain'
 sourceCompatibility = 1.8
 targetCompatibility = 1.8
-version = '6.8.0'
+version = '6.10.0'
 
 sourceSets {
   main {
@@ -34,10 +33,15 @@ sourceSets {
 task fatJar(type: Jar) {
   manifest {
     attributes 'Implementation-Title': 'Projections',
-               'Implementation-Version': version
+               'Implementation-Version': project.version
+  }
+  project.archivesBaseName = 'projections-all'
+  duplicatesStrategy = DuplicatesStrategy.INCLUDE
+
+  from {
+    configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
   }
-  baseName = 'projections-all'
-  from { configurations.compile.collect { it.isDirectory() ? it : zipTree(it) } }
+
   into ('projections/images') {
       from('src/projections/images') {
           include '*'
@@ -58,3 +62,4 @@ task copyJarToBin(type: Copy) {
   into 'bin/'
   rename 'projections-all-' + version + '.jar', 'projections.jar'
 }
+