CSV Files
CSV (Comma-Separated Values) is a universal plain-text format that Network Survey uses to log survey data. CSV files can be opened in spreadsheets, databases, and analysis tools. NS CSV files can also be imported into NS Analytics.
What is CSV?
Section titled “What is CSV?”- Format: Plain text, comma-delimited
- File Extension:
.csv
- Structure: One row per record, columns for fields
- Header Row: First row contains field names
- Compatibility: Universal (Excel, Google Sheets, Python, R)
File Naming
Section titled “File Naming”Network Survey creates separate CSV files for each cellular network type and technology:
Cellular:
craxiom-gsm-YYYYMMDD-HHMMSS.csvcraxiom-cdma-YYYYMMDD-HHMMSS.csvcraxiom-umts-YYYYMMDD-HHMMSS.csvcraxiom-lte-YYYYMMDD-HHMMSS.csvcraxiom-nr-YYYYMMDD-HHMMSS.csvcraxiom-phonestate-YYYYMMDD-HHMMSS.csvcraxiom-cdr-YYYYMMDD-HHMMSS.csv
Other Technologies:
craxiom-wifi-YYYYMMDD-HHMMSS.csvcraxiom-bluetooth-YYYYMMDD-HHMMSS.csvcraxiom-gnss-YYYYMMDD-HHMMSS.csvcraxiom-devicestatus-YYYYMMDD-HHMMSS.csv
CSV Structure
Section titled “CSV Structure”Header Row: Field names (first row)
Data Rows: Survey records (one per line)
Delimiter: Comma (,
)
Text Qualifier: Double quotes ("
) for fields containing commas
Example LTE CSV:
# Created by Network Survey version=1.43-cdr# CSV Version=0.4.0deviceTime,latitude,longitude,altitude,speed,accuracy,missionId,recordNumber,groupNumber,mcc,mnc,tac,eci,earfcn,pci,rsrp,rsrq,ta,servingCell,lteBandwidth,provider,signalStrength,cqi,slot,snr,deviceSerialNumber,locationAge2025-10-10T13:58:27.603261-04:00,37.7749,-122.4194,15.58,0,22,NS 1234abc12e56789f 20251010-135821,1,2,310,260,12345,12345678,750,36,-112.0,-9.0,39,true,MHZ_10,T-Mobile,-61.0,11,,-1.0,1234abc12e56789f,4916
The full list of possible fields captured by NS is defined in the NS Message API Documentation.
Related
Section titled “Related”- File Logging Overview - Logging basics
- GeoPackage Files - Alternative format
- Cellular Networks - Understanding cellular fields