Skip to content

Commit 986003d

Browse files
committed
readme
1 parent 5a1553b commit 986003d

File tree

2 files changed

+38
-60
lines changed

2 files changed

+38
-60
lines changed

.idea/workspace.xml

Lines changed: 23 additions & 22 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

README.md

Lines changed: 15 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,61 +1,39 @@
11
# CodeGRITS
22

3-
[![Website](https://img.shields.io/badge/Website-Visit-brightgreen)](https://codegrits.github.io/CodeGRITS/)
4-
[![Javadoc](https://img.shields.io/badge/Javadoc-Docs-blue)](https://codegrits.github.io/CodeGRITS/docs/index.html)
5-
[![Paper PDF](https://img.shields.io/badge/Paper-PDF-olive)](https://codegrits.github.io/CodeGRITS/static/paper.pdf)
6-
[![Demo Video](https://img.shields.io/badge/Demo-Video-orange)](https://www.youtube.com/watch?v=d-YsJfW2NMI)
7-
[![Archived](https://img.shields.io/badge/Archived-SWH-blueviolet)](https://archive.softwareheritage.org/swh:1:dir:1f4865d95a6d6846c4493696723657dc10627bc6)
8-
[![MIT License](https://img.shields.io/badge/License-MIT-green)](https://github.com/codegrits/CodeGRITS/blob/main/LICENSE)
9-
10-
[CodeGRITS](https://codegrits.github.io/CodeGRITS/) stands for **G**aze **R**ecording & **I**DE **T**racking **S**ystem.
11-
It's a plugin developed by the [SaNDwich Lab](https://toby.li/) and is specially designed for empirical software
12-
engineering researchers. CodeGRITS is built on top
13-
of [IntelliJ Platform SDK](https://plugins.jetbrains.com/docs/intellij/welcome.html), with wide compatibility with the
14-
entire family of [JetBrains IDEs](https://www.jetbrains.com/) and [Tobii eye-tracking devices](https://www.tobii.com/),
15-
to track developers’ IDE interactions and eye gaze data.
3+
[![Website](https://img.shields.io/badge/Website-Visit-brightgreen)](https://codegrits.github.io/CodeGRITS/) [![Javadoc](https://img.shields.io/badge/Javadoc-Docs-blue)](https://codegrits.github.io/CodeGRITS/docs/index.html) [![Paper PDF](https://img.shields.io/badge/Paper-PDF-olive)](https://codegrits.github.io/CodeGRITS/static/paper.pdf) [![Demo Video](https://img.shields.io/badge/Demo-Video-orange)](https://www.youtube.com/watch?v=d-YsJfW2NMI) [![Archived](https://img.shields.io/badge/Archived-SWH-blueviolet)](https://archive.softwareheritage.org/swh:1:dir:1f4865d95a6d6846c4493696723657dc10627bc6) [![MIT License](https://img.shields.io/badge/License-MIT-green)](https://github.com/codegrits/CodeGRITS/blob/main/LICENSE)
4+
5+
[CodeGRITS](https://codegrits.github.io/CodeGRITS/) stands for **G**aze **R**ecording & **I**DE **T**racking **S**ystem. It's a plugin developed by the [SaNDwich Lab](https://toby.li/) and is specially designed for empirical software engineering researchers. CodeGRITS is built on top of [IntelliJ Platform SDK](https://plugins.jetbrains.com/docs/intellij/welcome.html), with wide compatibility with the entire family of [JetBrains IDEs](https://www.jetbrains.com/) and [Tobii eye-tracking devices](https://www.tobii.com/), to track developers’ IDE interactions and eye gaze data.
166

177
<p align="center">
188
<img src="site/static/overview.png" width="600px" max-width="100%" alt="CodeGRITS Overview">
199
</p>
2010

21-
The data collected by CodeGRITS can be used by empirical SE researchers to understand the behaviors of developers,
22-
especially those related to eye gaze. CodeGRITS also provides a [real-time data API](developer.md)
23-
for future plugin developers and researchers to design context-aware programming support tools.
11+
The [website](https://codegrits.github.io/CodeGRITS/)'s source code is stored in the `./site` folder of this repository and deployed via GitHub Pages. The [JavaDoc](https://codegrits.github.io/CodeGRITS/docs/index.html) documentation is located in the `./site/docs` folder of this repository. They are archived together with the source code in the Software Heritage.
12+
13+
The data collected by CodeGRITS can be used by empirical SE researchers to understand the behaviors of developers, especially those related to eye gaze. CodeGRITS also provides a [real-time data API](developer.md) for future plugin developers and researchers to design context-aware programming support tools.
2414

25-
We provide an example project [DataStreamReceiver](https://github.com/codegrits/DataStreamReceiver) that builds on top
26-
of the real-time data API. It is designed to receive the IDE and eye tracking data and directly visualize them in two
27-
separate windows.
15+
We provide an example project [DataStreamReceiver](https://github.com/codegrits/DataStreamReceiver) that builds on top of the real-time data API. It is designed to receive the IDE and eye tracking data and directly visualize them in two separate windows.
2816

2917
## Key Features
3018

3119
- :mag: **IDE Tracking**: CodeGRITS tracks developers’ IDE interactions, including mouse clicks, keyboard inputs, etc.
32-
- :eye: **Eye Tracking**: CodeGRITS tracks developers’ eye gaze data
33-
from [Tobii eye-tracking devices](https://www.tobii.com/), and maps them to corresponding source code elements.
20+
- :eye: **Eye Tracking**: CodeGRITS tracks developers’ eye gaze data from [Tobii eye-tracking devices](https://www.tobii.com/), and maps them to corresponding source code elements.
3421
- :computer: **Screen Recording**: CodeGRITS simultaneously records developers’ screen for visualizing their behaviors.
35-
- 🔨 **Research Toolkit**: CodeGRITS provides a set of extra features for empirical SE
36-
researchers, including dynamic configuration, activity labeling, real-time data API, etc.
37-
- 🗃️ **Data Export**: CodeGRITS exports data in XML format for further data analysis. See [Data Format](data.md)
38-
for more details.
22+
- 🔨 **Research Toolkit**: CodeGRITS provides a set of extra features for empirical SE researchers, including dynamic configuration, activity labeling, real-time data API, etc.
23+
- 🗃️ **Data Export**: CodeGRITS exports data in XML format for further data analysis. See [Data Format](data.md) for more details.
3924

4025
### Cross-platform and Multilingual Support
4126

42-
- [x] CodeGRITS provides cross-platform support for Windows, macOS,
43-
and Linux, and is expected to be compatible with the entire family of JetBrains IDEs, including IntelliJ IDEA,
44-
PyCharm, WebStorm, etc.
45-
- [x] CodeGRITS could extract the abstract syntax tree (AST) structure of eye gazes on multiple
46-
programming languages, as long as the IDE supports them, including Java, Python, C/C++, JavaScript, etc.
27+
- [x] CodeGRITS provides cross-platform support for Windows, macOS, and Linux, and is expected to be compatible with the entire family of JetBrains IDEs, including IntelliJ IDEA, PyCharm, WebStorm, etc.
28+
- [x] CodeGRITS could extract the abstract syntax tree (AST) structure of eye gazes on multiple programming languages, as long as the IDE supports them, including Java, Python, C/C++, JavaScript, etc.
4729

4830
## Usage Guide
4931

50-
Please see the [CodeGRITS website](https://codegrits.github.io/CodeGRITS/) for more details.
51-
The Javadoc documentation is available [here](https://codegrits.github.io/CodeGRITS/docs/index.html).
32+
Please see the [CodeGRITS website](https://codegrits.github.io/CodeGRITS/) for more details. The Javadoc documentation is available [here](https://codegrits.github.io/CodeGRITS/docs/index.html).
5233

5334
## Citation
5435

55-
The paper of CodeGRITS has been accepted
56-
by [ICSE 2024 Demonstrations Track](https://conf.researchr.org/track/icse-2024/icse-2024-demonstrations).
57-
The PDF version is available [here](https://codegrits.github.io/CodeGRITS/static/paper.pdf).
58-
The [video demonstration](https://www.youtube.com/watch?v=d-YsJfW2NMI) is available on YouTube.
36+
The paper of CodeGRITS has been accepted by [ICSE 2024 Demonstrations Track](https://conf.researchr.org/track/icse-2024/icse-2024-demonstrations). The PDF version is available [here](https://codegrits.github.io/CodeGRITS/static/paper.pdf). The [video demonstration](https://www.youtube.com/watch?v=d-YsJfW2NMI) is available on YouTube.
5937

6038
Please cite the following if you use CodeGRITS in your research.
6139

@@ -71,5 +49,4 @@ Please cite the following if you use CodeGRITS in your research.
7149

7250
## Contact us
7351

74-
Please feel free to contact Ningzhi Tang at ntang@nd.edu or Junwen An at jan2@nd.edu/feasiblechart@gmail.com
75-
if you have any questions or suggestions.
52+
Please feel free to contact Ningzhi Tang at ntang@nd.edu or Junwen An at jan2@nd.edu/feasiblechart@gmail.com if you have any questions or suggestions.

0 commit comments

Comments
 (0)