The PSLab Android App allows users to log data from the sensors connected to the PSLab hardware device. Sensor Data is stored locally but can be exported in various formats. Currently the app supports exporting data in .txt and .csv (comma-separated values) format. Exported data can be used by other users or scientists to study or analyze the data. Data can also be used by other softwares like Python, GNU octave, Matlab to further process it or visualise it in 3D. In this post, we will discuss how to export the locally stored realm data in .txt or .csv format. We will take the data of MPU6050 sensor as an example for understanding how locally logged data is exported.
Query Local Realm Data
We have attached a long click listener to sensor list view that detects which list item is selected. Clicking any sensor from sensor list for slightly longer than usual would result in a dialog popping up with the option to
- Export Data: Results in exporting data in a format which is selected in App settings
- Share Data: Shares sensor data with other users or on social media (yet to be implemented)
As soon as the Export Data option is selected from the dialog, sensor data of the corresponding sensor is queried. The data model of the sensor and how it’s saved in the local realm database is discussed in the post Sensor Data Logging in the PSLab Android App.
RealmResults<DataMPU6050> results = realm.where(DataMPU6050.class).findAll();
Once we get the required data, we need to write it in .txt or .csv format depending on what the user has selected as a preference in App Settings.
Getting User Preference from App Settings
The format in which the sensor data should be exported is presented to the user as a preference in App Settings. Currently the app supports two formats .txt and .csv.
private String format; SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(this); String formatValue = preferences.getString("export_data_format_list", "0"); if ("0".equals(formatValue)) format = "txt"; else format = "csv";
Export Data in .txt Format
To export the sensor data in .txt format, we need to create a .txt file in the external storage. folder variable is a path to PSLab Android folder in the external storage. If the folder doesn’t exist, it will be created.
File folder = new File(Environment.getExternalStorageDirectory() + File.separator + "PSLab Android");
After getting reference of the app folder in the external storage, we would create a text file in the PSLab Android folder. As soon as the text file is created, we initialize the FileOutputStream object to write data into the text file. The sensor data that was queried in the previous section is written into the text file just created. Finally after the complete sensor data is written, the stream is closed by stream.close() method.
FileOutputStream stream = null; File file = new File(folder, "sensorData.txt"); try { stream = new FileOutputStream(file); for (DataMPU6050 temp : results) { stream.write((String.valueOf(temp.getAx()) + " " + temp.getAy() + " " + temp.getAz() + " " + temp.getGx() + " " + temp.getGy() + " " + temp.getGz() + " " + temp.getTemperature() + "\n").getBytes()); } } catch (IOException e) { e.printStackTrace(); } finally { try { if (stream != null) { stream.close(); } } catch (IOException e) { e.printStackTrace(); } }
Export Data in .csv Format
Writing data in .csv format is similar to that in .txt format. As CSV stands for Comma Separated Values, which means each data value is separated by “,” (comma). It is similar to an excel sheet. The first row consists of labels that denote the type of value in that particular column. The other rows consist of the sensor data, with each row corresponding to a sample of the sensor data.
File file = new File(folder, "sensorData.csv"); PrintWriter writer; try { writer = new PrintWriter(file); StringBuilder stringBuilder = new StringBuilder(); stringBuilder.append("Ax,Ay,Ax,Gx,Gy,Gz,Temperature\n"); for (DataMPU6050 temp : results) { stringBuilder.append(String.valueOf(temp.getAx())); stringBuilder.append(','); stringBuilder.append(String.valueOf(temp.getAy())); stringBuilder.append(','); stringBuilder.append(String.valueOf(temp.getAz())); stringBuilder.append(','); stringBuilder.append(String.valueOf(temp.getGx())); stringBuilder.append(','); stringBuilder.append(String.valueOf(temp.getGy())); stringBuilder.append(','); stringBuilder.append(String.valueOf(temp.getGz())); stringBuilder.append(','); stringBuilder.append(String.valueOf(temp.getTemperature())); stringBuilder.append('\n'); } writer.write(stringBuilder.toString()); writer.close(); } catch (FileNotFoundException e) { e.printStackTrace(); }
Resources
- Journaldev tutorial on Read, Write and Save File in Android’s External Storage
- Android Developer Training on Saving Files in Android
- Stackoverflow post on writing CSV files in JAVA