alu/tra-analysis
1
0
Fork 0
mirror of https://github.com/titanscouting/tra-analysis.git synced 2024-11-09 22:44:44 +00:00
Code Issues Packages Projects Releases Wiki Activity
Titan Robotics 2022 Strategy Team Analysis Repository
777 Commits 7 Branches 16 Tags 52 MiB
Python 99.8%
Dockerfile 0.1%
e4c912f4b6
Go to file
Arthur Lu e4c912f4b6 Merge pull request #33 from titanscout2022/Demo-for-Issue#32 
Merge Changes Proposed in Issue#32
2020-08-02 17:27:26 -05:00
.devcontainer fixed latest.whl to follow format for wheel files 2020-06-10 20:56:13 +00:00
.github i swear its working now 2020-05-18 16:14:16 -05:00
analysis-master made changes described in Issue#32 2020-07-30 19:05:07 +00:00
data-analysis made changes described in Issue#32 2020-07-30 19:05:07 +00:00
.gitattributes Initial commit 2018-11-06 21:56:51 -06:00
.gitignore added test.py to .gitignore 2020-05-23 19:43:59 -05:00
CONTRIBUTING.md Contributing guideline changes (#11) 2020-05-13 11:56:52 -05:00
LICENSE Update LICENSE 2020-05-13 12:04:59 -05:00
MAINTAINERS filled out Contributing section in README.md 2020-07-20 19:07:32 -05:00
README.md filled out Contributing section in README.md 2020-07-20 19:07:32 -05:00

README.md

Red Alliance Analysis · GitHub release (latest by date)

Titan Robotics 2022 Strategy Team Repository for Data Analysis Tools. Included with these tools are the backend data analysis engine formatted as a python package, associated binaries for the analysis package, and premade scripts that can be pulled directly from this repository and will integrate with other Red Alliance applications to quickly deploy FRC scouting tools.

Getting Started

Prerequisites

  • Python >= 3.6
  • Pip which can be installed by running python -m pip install -U pip after installing python

Installing

There are a few different services/packages that can be installed. Installation instructions are seperated by scenario and are ordered from least complex to most.

Linux (Most Distros)/Windows ｜ TRA Service plus GUI, Analysis Package

Portable application files are avaliable on the releases page.

  • Download the .zip or .tar.gz files from the releases page. If you want the GUI version, be sure to download the one marked with GUI.
  • Unzip the files and save the folder somewhere safe.
  • Navigate to the unzipped folder and run:
    • Windows: TRA-GUI.bat .
    • Linux: TRA-GUI.sh.

Linux (Most Distros)/Windows ｜ TRA Service, Analysis Package

Service application files are avaliable on the releases page.

  • Download the .zip or tar.gz files from from the releases page. If you want the Service version, be sure to download the one that is not marked with GUI. The GUI version will also contain the service application.
  • Unzip the files and save the folder somewhere safe.
  • Navigate to the unzipped folder and run:
    • Windows: TRA.bat.
    • Linux: TRA.sh.

Linux (Most Distros) CLI-Only ｜ TRA Service, Analysis Package

Service application files are avaliable on the releases page.

  • Download the .zip or tar.gz files from from the releases page with wget https://github.com/titanscout2022/red-alliance-analysis/releases/download/latest/TRA.tar.gz. If you want the Service version, be sure to download the one that is not marked with GUI. The GUI version will also contain the service application.
  • Unzip the files with tar -xzf TRA.tar.gz .
  • Navigate to the unzipped folder with cd TRA/ and run ./TRA.sh.

Installing Only the Analysis Package

Make sure that python an pip are already installed. Download the .whl file from the releases page. Then install the wheel file by running pip install [name of the .whl file].

Installing Only the Analysis Package From Source

Navigating to analysis-master/, running ./build.sh will build the analysis package from analysis-master/analysis/. The built wheel files are stored in analysis-master/dist/.

Config

Supported Platforms

Although any modern 64 bit platform should be supported, the following platforms have been tested to be working:

  • AMD64 (Tested on Zen 1, Zen +, and Zen 2)
  • Intel 64/x86_64/x64 (Tested on Kaby Lake)
  • ARM64 (Tested on Broadcom BCM2836 SoC, Broadcom BCM2711 SoC)

The following OSes have been tested to be working:

  • Linux Kernel 3.16, 4.4, 4.15, 4.19, 5.4
    • Ubuntu 16.04, 18.04, 20.04
    • Debian (and Debian derivaives) Jessie, Buster
  • Windows 7, 10

The following python versions are supported:

  • python 3.6 (not tested)
  • python 3.7
  • python 3.8

Contributing

Read our included contributing guidelines (CONTRIBUTING.md) for more information and feel free to reach out to any current maintainer for more information.

Build Statuses

Analysis Unit Tests Superscript Unit Tests