bulletPreprocessor

Overview

The groove detection algorithm in bulletAnalyzr 1.0.0 does not always place the grooves in the correct location. While bulletAnalyzr now allows users to adjust the groove locations during bullet comparisons, the slow processing time is inefficient for comparing large numbers of bullets.

BulletPreprocessor allows the user to upload a bullet land, adjust the crosscut and groove locations if necessary, and save the extracted signal. Then, R scripts can be written to perform bullet comparisons using the saved signals.

Installation

1. Clone CSAFE-ISU/bulletPreprocessor from GitHub.
2. Install the following R packages from CRAN with install.packages(): bslib, dplyr, ggplot2, rgl, shiny, shinyFiles, shinyjs, and stringr.
3. Install R packages from GitHub:
   • devtools::install_github("Heike/x3ptools")
   • devtools::install_github("Heike/bulletxtrctr")

Usage

1. Open the bulletPreprocessor project in RStudio.

2. Open either server.R or ui.R.

3. Click Run App to launch the app.

4. Select the bullet study from the drop-down menu. Currently, the app only works on Houston and CTS lands. Hamby44 and Phoenix are listed in the drop-down menu, but their naming rules have not been set up yet. The app throws an error on these datasets.

5. Open a land's x3p file.

6. A pop-up window will show the basic details about the file. Verify that the barrel, bullet, and land names are correct. Click cancel or continue as necessary.

7. The app will try to automatically locate the crosscut and grooves. Use the sliders to adjust the locations if necessary.

8. Click Get Signal. A plot of the signal will be displayed.

9. If something about the signal doesn't look right, click on Land with Crosscut and Grooves tab. Readjust the crosscut or grooves. Click Get Signal again.

10. When you are satisfied with the signal, click Download.

11. Click Reset to upload the next land.

Known Limitations and Bugs

The current version of BulletPreprocessor did not work on the Windows laptop I tested it on. The app would not display the image of the land.

The current version of BulletPreprocessor tries to automatically extract the barrel, bullet, and land names from the x3p filename based on the bullet study. The app currently only supports Houston and CTS bullet study lands.