Skip to main content

CSV Files

You can import a list of sites from a CSV file. Each row in the file becomes a radio in your project.

Importing

Drag a .csv file onto the map of an open project.

a CSV file held over the map

The import dialog shows you the rows it read from the file, and asks you to choose:

ChoiceEffect
NetworkThe network the new radios are added to. If the project doesn't have one yet, importing creates it.
TemplateThe template the new radios are based on. Anything the file doesn't set is taken from it.
the import dialog listing ten sites

When you import, the radios are added to the network and the map moves to show them.

ten imported sites on the map

Nothing is calculated at this point. The imported radios have no coverage until you press Calculate.

the same sites with coverage

What a File Needs

Every row needs a latitude and a longitude. Every other column is optional - if you leave a column out, or leave one of its cells empty, the radio uses the template's value instead.

Columns that aren't in the table below are ignored, and won't appear in the dialog. A file can hold up to 200 rows.

Column names aren't case sensitive, and spaces and underscores are interchangeable, so Power_W, power w and POWER W all mean the same thing.

When a Cell Is Wrong

The dialog highlights any cell it can't use and explains what's wrong with it. You can't import until every highlighted cell has been fixed.

three flagged cells in the import dialog

Columns

Each column below sets one field of a radio's settings.

ColumnSetsAccepts
Name or SiteNameAny text
LatitudePosition-90 to 90. Required
LongitudePosition-180 to 180. Required
Height_mHeight above ground0.1 to 120000
Frequency_MHzFrequency2 to 100000
Bandwidth_MHzBandwidth0.001 to 200
Power_WTransmit power0.001 to 5000000
Loss_dB or Antenna_Loss_dBFeeder loss0 to 90
Gain_dBi or Antenna_Gain_dBiAntenna gain-30 to 60
Azimuth_deg or Antenna_Azimuth_degAntenna azimuth0 to 359
Downtilt_deg or Antenna_Tilt_degAntenna tilt-90 to 90
Antenna_Horizontal_Beamwidth_degHorizontal beamwidth1 to 360
Antenna_Vertical_Beamwidth_degVertical beamwidth1 to 360
Front_to_backFront-to-back ratio0 or more
Antenna_PolarisationPolarisationV or H
Antenna_PatternAntenna patternAn antenna's name, or Custom
Receiver_Height_mReceiver height0.1 to 120000
Receiver_Gain_dBiReceiver gain-30 to 60
Receiver_Sensitivity_dBmReceiver sensitivityAny number
Noise_floor_dBmNoise floorAny number
Measured_unitsMeasured unitsA name the Output panel lists
Colour_schemaColour schemaA name the Output panel lists
ModelPropagation modelA name the Model panel lists
DiffractionDiffraction modelA name the Model panel lists
ContextContext1, 2 or 3
ReliabilityReliabilityA value the Model panel lists
ProfileClutter profileA profile's name

Where a column takes a name, use the name as it's written in the settings panel - for example Deygout 94, Received Power (dBm) or General Purpose VHF/UHF/SHF.

Example

name,longitude,latitude,Power_W,Height_m,Azimuth_deg,Gain_dBi
North Mast,2.2944813,48.8583701,2,8,0,0
Depot,2.337644,48.8606111,2,6,35,0
Hilltop,2.3431043,48.8867017,2,30,300,6

To import a whole project rather than a list of sites, see PNUT Files.