EgbertsTribometer

This repo contains work done by Liam Pond and Albert Kalayil on the oleic acid project in the Nanotribology Lab in 2024. Supervised by Drs. Philip Egberts, Vinay Saini, and Kasimuthumaniyan Subramanian.

Setup

Note: The following commands are for Mac and Linux. Setup for Windows is slightly different.

1. Create a new project using your selected IDE (I use PyCharm).
2. Clone this repo. Save it in the project directory you just created.
3. Change directories to the one you just created by typing cd <repodir> into the command line (replace with the path to your directory).
4. Activate the venv by typing source bin/activate in Terminal.
5. Download required packages by typing pip install -e requirements.txt.

Download relevant data here. If the link isn't working, email [email protected] or [email protected]. Store data in the root directory of your project folder. The default name is Data. If you wish to change it, remember to modify the name in parse_tribometer.py. Find information about the test procedure here.

Using the Scripts

Raw data will first need to be parsed with parse_tribometer.py. Set folder_path to the name of the subdirectory that contains your data and verify that valid tests are correct by modifying entirely_valid_samples and the return statement of the test_validity function. All files and subdirectories in folder_path will be parsed except directories listed in excluded_dirs. Next, main.py will output .csv files and plot the results. Make sure that your directory contains folders called ParsedFiles, FrictionCoefficientCSV, and FrictionCoefficientGraphs.

Output Files by Directory

ParsedFiles/

• Master.csv: Contains information about all parsed tests
• ValidMaster.csv: Master, but only for tests specified as valid in the test_validity function in parse_tribometer.py.

FrictionCoefficientCSV/

• FrictionCoefficientData.csv: .csv that contains the average friction per cycle for each test. Average friction is calculated by averaging friction values in the middle 40% of both the outgoing and returning phase of each cycle.
• AverageFrictionCoefficientData.csv: Same as above, but with per-cycle values further averaged to result in one number per test.

FrictionCoefficientGraphs/

Outdated — graphs are now generated in Origin using the .csv files above.

Common Errors

This means that a test parameter (in this case SampleNo) was unable to be read from the test filename. To fix this, modify either the regex code in parse_tribometer.py or your test's filename. If you're unfamiliar with regex expressions, ChatGPT is a good tool to build your own. For example, you can ask it to make regex that will return all numbers following the string 'SampleNo'. Remember that many test parameters are not recorded in the file itself and must be extracted from the filename.