Mark Location File

neoEBV can read CSV files and place marks on screen.

Preamble can specify the details of the mark operation in the CSV file.

File Structure

neoEBV searches the first 100 lines of the file for a line which consists of only ‘@’ character. The line is considered as the delimiter and the next line after that is assumed the first line of the data part. Blank Lines are ignored.

The part before the delimiter is assumed as the preamble.

Preamble

The preamble is basically skipped, but a line written in the particular format is read as an additional information.

Display Status Specification

Comma-separated lines (CSV lines) begininig with #computed columns in the preamble are treated as the display status specifications of Computed Column. If the second column is “on”, the display of Computed Columns is turned on.

#computed columns, on

Column Interpretation Specification

Comma-separated lines (CSV lines) beginning with #assign in the preamble are treated as the column interpretation specifications for the computed column function. The second column is interpreted as a target property name, and the third column is as an assigned column expression.

#assign,$X,x
#assign,$Y,y + 10

There are several values that can be used for the computed column and the column expressions. Refer to Advanced Configuration of Mark page.

Display Columns Specification

Comma-separated lines (CSV lines) beginning with #show-columns in the preamble are treated as display columns specifications. Only columns with names specified in the second column and subsequent columns are displayed in the specified order. Similarly, column names not to display can be specidied by lines beginning with #hide-columns. Only the last one specified of these display or hide columns specifications becomes valid.

#show-columns, columnB, columnA

Column Display Order Specification

Comma-separated lines (CSV lines) beginning with #display-orders in the preamble are treated as column display order specifications. Columns specified in the second and subsequent columns are displayed in the order of the specification. Then columns that are not in the specification are displayed after them.

Superiority of Column Display Order Specification

Although the display columns specification by #show-columns preamble includes specification of the order of display as well, the column display order specification by #display-orders overrides it.

#display-order columnE, columnC

Filter Specification

Comma-separated lines (CSV lines) beginning with #filter in the preamble are treated as filter specifications. The string specified in the second column is set to the filter.

#filter, x > 100

Data Part

The first line of the data part is interpreted as the column name line, and all following lines are treated as value lines. Each value line corresponds to a mark. Each line is interpreted as a CSV line.

x,y,name,mark_group,mark_shape,mark_color,mark_representative
130.7,127.9,Mark 1,,,,
...

Column Name

Values in the column name line are treated as names of the columns. It is also possible to load a file which does not have the column name line by turning off Use the First Line as the Column Name in the Load dialog.

Sample of Mark Location File

This is a sample of the file output by neoEBV. As for input, neoEBV can load any CSV files.

#MarkLocationFile Created by nebv VERSION (uid=UID) USER@HOSTNAME DATE
#computed columns, on
#assign,$X,x
#assign,$Y,y
#assign,$Size,5
#assign,$Label,name
#assign,$Name,name
#assign,$Color,mark_color
#assign,$Group,mark_group
#assign,$Shape,mark_shape
#assign,$Representation,mark_representative
#assign,$FWidth,0
#assign,$FHeight,0
#assign,$FAngle,0
@
x,y,name,mark_group,mark_shape,mark_color,mark_representative
130.7,127.9,Mark 1,,,,
86.3,141.5,Mark 2,,,,