Elements / Grid

GridLocationInfo2

SYNOPSIS --------

SYNOPSIS§

GridLocationInfo2(LATITUDE, LONGITUDE [, HEIGHT, KEYWORDS])

Ports: None

DESCRIPTION§

This element implements the GridGenericLocInfo interface. Unlike GridLocationInfo, this element can work in the kernel.

LATITUDE and LONGITUDE are in milliseconds. Positive is North and East, negative is South and West. HEIGHT is in millimetres, positive is up. All are integers.

Keyword arguments are:

• LOC_GOOD — Boolean. If true, it means the location information (including error radius) can be believed. If false, don't believe the hype, it's a sequel, i.e. it's all bogus.
• ERR_RADIUS — Unsigned short. The error radius in metres. The node's actual location is within a circle of ERR_RADIUS metres, centered at the supplied location.
• TAG — String. A symbolic name used to identify this node's location, e.g. "ne43-521b", or "Robert's office".

ELEMENT HANDLERS§

• loc (read/write) — When reading, returns the element's location information, in this format: ``lat, lon, height (err= good= seq=)''.

   <err-radius> is in metres, <good?> is "yes" or "no", indicating
   whether the location information is at all valid (i.e. don't
   believe any of it unless <good?> is "yes"), and <seq> is the
   location sequence number; it changes every time the location or
   other parameters change.
  

  When writing, use the same syntax as the configuration arguments.

• tag (read/write) — Read/write the location tag. Read format is: ``tag=''.

SEE ALSO§

FixSrcLoc, GridLocationInfo

Generated by click-elem2man from ../elements/grid/gridlocationinfo2.hh:8 on 2026/11/02.