Ero sivun ”Aprs.fi user guide” versioiden välillä

Radioamatööriwikistä
Siirry navigaatioon Siirry hakuun
>Oh7lzb
>Oh7lzb
 
(18 välissä olevaa versiota samalta käyttäjältä ei näytetä)
Rivi 39: Rivi 39:
=Sections=
=Sections=


[[Aprs.fi Real-time map]]
To ease up browsing and editing the guide has been split into separate pages for each section.


[[Aprs.fi Network tools]]
;[[Aprs.fi Common features|Common features]]
: Describes features which are common to many or all of the different views of the site, such as searching using wildcards and table sorting.


[[Aprs.fi Troubleshooting]]
;[[Aprs.fi Real-time map|Real-time map]]
: Describes the main feature of the site, the real-time map.


[[Aprs.fi Common features]]
;[[Aprs.fi Preferences|Preferences]]
: Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.


=Info page=
;[[Aprs.fi Info pages|Info pages]]
: Describes the station info and station graph views.


The [http://aprs.fi/info/ info] page summarizes most information aprs.fi has on an APRS station, item, object or AIS vessel. It shows the collected information in a table, a small static map with the most recent received position, and provides links to other pages with more details and history.
;[[Aprs.fi Static maps|Static maps]]
: Introduces the static maps feature.


;Comment
;[[Aprs.fi KML|KML and Google Earth]]
: The station's comment text, transmitted together with the position.
: Describes how to view aprs.fi in 3D using Google Earth.
;Last status
: The most recent status message transmitted.
;Location
: The last known location of the station. The coordinates are shown in the preferred format (see Preferences if you wish to change this). A maidenhead QTH locator is also shown, and a list of some cities or towns which are close, together with distance and bearing from the each town to the station.
;Last position
: The time when the last known position packet was transmitted.
;Course
: The course information from the last position packet (if available).
;Speed
: The speed information from the last position packet (if available).
;Last telemetry
: The most recent telemetry measurements received.
;Last WX report
: The most recent weather report from the station.
;Last path
: The APRS packet path from the last position packet, complemented with the APRS digipeater path advisor, where applicable.
;Positions stored
: The amount of position packets stored in the database.
;Packet rate
: The average interval between packets.
;Other SSIDs
: A list of other APRS stations having the same callsign but different SSID. The ones which have recently sent a position are shown with a larger font.


====Path advisor====
;[[Aprs.fi Web stations|Web stations]]
: Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.


[[Tiedosto:Aprsfi path-good.png|right]]If the packets seems to have originated from the RF side of the network, the path advisor will comment on the relative "goodness" of the packets APRS path settings. The advisor report appears right after the '''Last path''' on the info page. It will count the amount of total hops the packet seems to have traversed, and if the number is higher than 3, the path is considered suboptimal.
;[[Aprs.fi Messages and Status|Messages, status messages and the Bulletin Board]]
: Describes the messages, status messages and bulletin board views.


The advisor also suggests using the New-N paths of WIDE1-1,WIDE2-1 or WIDE1-1,WIDE2-2 which seem to be the most commonly accepted paths. It also gives advice on invalid usage of RELAY and WIDE1-1 when they're not the first component of the path, and suggests replacing RELAY with WIDE1-1.
;[[Aprs.fi Weather|Weather]]
: Describes the weather data visualization features of aprs.fi.


There are different opinions on "good" settings, and there are regional differences too. I believe the settings offered are good for most environments. It doesn't really matter so much if one uses TRACE or WIDE, as long as the total amount of digipeaters isn't very large. 2 is good in areas with good coverage digipeaters and igates, 3 is usually good elsewhere. 5, 6 or 7 is, well, not good.
;[[Aprs.fi Telemetry|Telemetry]]
: Describes telemetry collection and viewing.


====Packet rate advisor====
;[[Aprs.fi Raw packets and Beacons|Raw packets and Beacons]]
: Raw APRS and beacon packet listings.


The info page also gives advice if the packet transmit rate seems high. It calculates the [http://en.wikipedia.org/wiki/Arithmetic_mean arithmetic mean] (average) interval between recently transmitted packets. If the average interval falls below 30 seconds, the following advice is shown:
;[[Aprs.fi Prefix browsing|Prefix browsing]]


<blockquote>''This station is transmitting packets at a high rate, which can cause congestion in the APRS network.''</blockquote>
;[[Aprs.fi Network tools|Network tools]]
: Tools for people who run the digipeaters and igates of the APRS network.


If the interval falls below 15 seconds, the following advice is shown:
;[[Aprs.fi Exporting data|Exporting data]]
: How to download APRS position data from aprs.fi to your computer.


<blockquote>''This station is transmitting packets at a very high rate, which causes serious congestion in the APRS network. This could be considered an abuse of the network resources.''</blockquote>
;[[Aprs.fi Troubleshooting|Troubleshooting]]
: If you're having problems using aprs.fi, or if you think you've found a bug, please start reading here.


Up to last 50 packets from a station are considered, but the backwards-going lookup stops at the first 1-hour gap between packets, the intention being to look at the last or current trip of a vehicle. The interval is only calculated if there are at least 3 packets in the last trip. Because an average is used, this shouldn't trigger too easily from bursts generated by Smart Beaconing.
=Discussion group, blog and other points of communication=


There are some ideas how to make this more meaningful. I've been thinking of an algorithm to calculate some sort of fuzzy "network loading" value by multiplying the packet rate by the amount of digipeater hops requested in the packets and using the result to trigger the nagging. This would allow a higher rate to be used with no digipeater path, but trigger more quickly when a 3-hop path is used. It would also handle proportional pathing by looking at the path of each packet separately.
If you have any questions, answers, ideas, tips or tricks, please share them on the official [https://groups.google.com/forum/#!forum/aprsfi aprs.fi Google Group]. It's available as a web-based forum and as a regular mailing list. '''Before posting, please read the instructions on the forum's front page, especially the requirement for as many relevant details as possible (including exact callsigns and page links in question).''' The forum exists strictly for discussing the aprs.fi web service – please use the other relevant forums for discussion about generic APRS issues or tracker configuration problems.


====Nearby stations====
Please read through the [[Aprs.fi Troubleshooting|Troubleshooting]] section before posting to the discussion group about any problems. Thank you!


This is a table of other nearby stations which have transmitted their position within the past 30 days. To see a longer list, click on '''show more'''.
News about the aprs.fi service are posted on the [http://blog.aprs.fi/ aprs.fi blog], which can also be subscribed over email, or using an RSS reader such as [http://reader.google.com/ reader.google.com]. Headlines from the blog are shown regularly in the lower right corner of the real-time map.
 
====Stations heard by X, and stations which heard Y====
 
aprs.fi collects monthly summaries of digipeater and igate statistics. The info page shows both a table of digipeaters and igates which heard the given station, and (if the station is a digipeater or igate) which other stations where heard by that station. The most recently updated entries are shown using a larger font.
 
These statistics are usually somewhat correct, but there are several caveats, and as you've probably heard – there are lies, damn lies, and statistics.
 
* A lot of digipeaters do not add their own callsign in the packet's path when retransmitting a packet. aprs.fi cannot possibly know about those.
* A lot of digipeaters do callsign substitution instead of insertion, replacing original path components. A packet with a path of OH7RDÖ,WIDE2-1 could have been a WIDE1-1,WIDE2-1 packet in the first place, and gone through OH7RDÖ and another unknown digipeater.
* The aprs.fi "first heard" algorithm tries to go on the safe side: if it's not sure, it doesn't count as directly heard. But even then, some incorrect overly long paths are shown.
* Stations transmitting invalid or fake coordinates will skew these statistics. If the transmitting station claims to be 1000 km away (due to a bad GPS fix), my best guess can only be that the station actually is that far away.
* Items and objects are not shown here, since they are usually far away from the transmitter which transmitted the packets.
 
==Info graphs==
 
On the [http://aprs.fi/info/graphs/ info graphs page] various station statistics are shown in diagrams:
 
* Amount of APRS packets transmitted per hour
* New positions received per hour (positions which are actually new and different from the previous transmitted position)
* Reported speed of the station
* For digipeaters, igates and AIS receivers:
** Amount of packets heard per hour (very much underestimated, due to APRS-IS duplicate filtering)
** A monthly receiver performance report
* For igates:
** The amount of packets gated to the APRS-IS per hour (underestimated due to duplicate filtering)
 
 
[[Tiedosto:Aprsfi-shot-info-graphs-gated.png|center]]
 
 
Graphs for which no data is available are not drawn. Currently, the graphs only go back a few days, but this will probably improve in the future.
 
* [http://aprs.fi/info/graphs/OH7RDA OH7RDA], a digipeater, does not show a speed graph, but there is a nice receiver distance report in the end.
 
=Static maps=
 
Since the real-time map is quite heavy on computing resources, and appears slow (or does not work at all) on many old devices and mobile phone browsers, there is a '''Static map''' feature. It even supports looking up multiple stations at the same time, but due to technical limitations cannot show real APRS symbol graphics in that mode.
 
* [http://aprs.fi/static/OH2RCH OH2RCH on static map]
* [http://aprs.fi/static/OH2RCH,OH2TI,OH2RDK OH2RCH, OH2TI and OH2RDK on the same static map]
 
It is designed to be very simple and lightweight, and it should work fine on small devices or with slow Internet connections.
 
[[Tiedosto:Aprsfi-staticmap.png|center]]
 
=KML: Viewing APRS positions in Google Earth=
 
In addition to the real-time map on top of the Google Maps, aprs.fi also exports the real-time APRS view in the KML format so that it can be viewed in [http://earth.google.com/ Google Earth]. Google Earth provides a very nice 3-dimensional view which is especially useful for viewing flying objects such as planes and balloons. From the GE site:
 
<blockquote>Google Earth lets you fly anywhere on Earth to view satellite imagery, maps, terrain, 3D buildings, from galaxies in outer space to the canyons of the ocean. You can explore rich geographical content, save your toured places, and share with others.</blockquote>
 
Once you have installed Google Earth, you can click on the '''Google Earth KML''' link on the right side of the real-time map.
 
If you are tracking one or more stations, Google Earth will open up tracking those stations. Once Google Earth has started up:
 
# Open the '''APRS tracking''' tree under '''Temporary Places''' on the left side of the earth.
# Open '''APRS'''.
# Open '''X points of Y stations'''.
# Double-click a station to zoom in on it's current location.
 
If you're not tracking a specific station, simply zoom in at the area of interest. The KML view will display at most 1000 stations at a time, and a warning will be displayed when the limit is met. Zoom in to reduce the amount of stations in view.
 
=Telemetry=
 
APRS stations can transmit measured analogue and digital telemetry such as voltages, temperatures, and switch / alarm statuses. aprs.fi collects the data and presents it on the [http://aprs.fi/info/ info] and [http://aprs.fi/telemetry/ telemetry] pages. The telemetry page allows looking up historic data over the past year.
 
[[Tiedosto:Aprsfi-shot-telemetry-temp.png|center]]
 
* [http://aprs.fi/telemetry/VK3RAW-1 VK3RAW], like many other Australian digipeaters, reports temperature, battery voltage and transmitter PTT keydowns using APRS telemetry.
* [http://aprs.fi/telemetry/OH2RCH OH2RCH], an igate running the aprx software, reports channel busy status and received packets.
 
Telemetry is currently only collected for stations which have transmitted a position packet. This is a bug and will be fixed in the future.
 
=Preferences=
 
The preferences pop-up dialog allows you to customize aprs.fi to your liking. The settings are saved in a cookie within your browser, so if you switch to another computer or another browser, you will have to tune the settings again.
 
[[Tiedosto:Aprsfi-shot-preferences-filter.png|center]]
 
The settings are organized in tabs. You can go through all of the settings on all the tabs, and then click on '''Save''' in the end, which will store and apply all the settings and close the Preferences window. If the window is on the way and you wish to monitor the map behind it, you can drag it in a different place within the browser window.
 
====Filtering====
 
This tab sets limits on the targets which are displayed on the real-time map, controls how they are displayed. Currently there are only four classes of stations:
 
# APRS stations
# Items and objects
# Weather stations
# AIS ships
 
In addition, there is an option to filter out positions of stations which did not transmit their position over a radio channel.
 
This tab also hosts a check box to [[#Selecting_an_initial_default_view|save the current map view as the default view]].
 
====Units and time====
 
This tab lets you select your preferred measurement units (metric, imperial, nautical, Celsius, Fahrenheit), time zone settings, coordinate and locator formats.
 
====Colours====
 
This tab lets you tune the track line colours shown on the real-time map.
 
The tracking targets shown in the map are divided in 5 groups using the modulo operator – seemingly randomly, but each station will always get the same colour. Here you can select the colours for each of the five target groups so that the colours won't coincide with the ones used for roads in your area.
 
You can also choose the track line width.
 
====Details====
 
Here you can select which details are shown in the info balloons of the real-time map.
 
====Sound====
 
This tab is used for configuring sound effects in the real-time map.
 
=Messages=
 
The [http://aprs.fi/?c=message&limit=50 message browsing page] displays APRS chat messages sent between users. Initially it shows the most recent messages seen on the APRS-IS. If you look up a callsign, you will see all messages sent by or destined to that call. Messages sent by the station are shown with a red background, and received ones are shown in green.
 
aprs.fi currently does not have the possibility to transmit messages (or any other type of data), it serves only as a place to view data.
 
=Status messages=
 
Status message packets are shown in the [http://aprs.fi/?c=status status message page]. Initially, if opened without a callsign, it will let you browse the stations which have transmitted status messages, sorted by callsign. If you look up a callsign, you get to browse old status messages transmitted by that station over time.
 
===Difference between status messages and comment text===
 
Status messages are often confused with the comment text. They're another method to send some descriptive status message for the station, the difference from comments being:
 
# The comment text is transmitted in the same APRS packet with the position, as text right after the position data. aprs.fi associates the comment message with the position.
# The status message is transmitted in a separate APRS packet, such as the following one, together with a timestamp. On aprs.fi, the status message is stored separately from the position, and they can be browsed using the [http://aprs.fi/?c=status status message page].
 
  2010-07-02 10:09:00 UTC: CT2XXX-11>APU25N,WIDE3-3,qAR,CT1AKV:>282308zUI-View32 V2.03
 
As you can see from this example, the timestamp is quite often invalid, so it is ignored by aprs.fi. In practice, you can put your descriptive message in the comment text or the status message. It is not wise to put the same text in both comment and status, as it will then be sent twice, which will place unnecessary load on the busy APRS network.
 
=Beacon packets=
 
The [http://aprs.fi/?c=beacon&call= beacons page] shows packets received from the APRS-IS but which were not identified as APRS packets at all. They are typically identification beacons sent by network nodes, usually describing their hardware or software.
 
  2010-07-02 03:44:07 UTC: DB0EMS>UIDIGI: UIDIGI 1.9
  2010-07-02 03:44:38 UTC: DB0UAL>ID: DB0UAL * X-NET-DIGI * -9k6 Shift
 
=Bulletin board=
 
APRS bulletin messages are used for sending local announcements to other APRS network users. The aprs.fi [http://aprs.fi/bulletin/ Bulletin board] page shows all bulletins which have been transmitted recently and passed on the APRS-IS. The page allows looking up custom bulletin groups using the links provided in the beginning of the page.
 
=Raw packets=
 
The [http://aprs.fi/?c=raw raw packets] page allows you to browse and inspect APRS packets received from the APRS-IS. When you load the page initially (or click '''Clear''') it will show the most recent APRS packets received. The '''previous''' and '''next''' buttons can be used to browse older ones. If you click on '''Raw packets''' in the real-time map while tracking a station, you will automatically get the packets sent by that station.
 
Invalid packets (and ones which are valid but which are not supported by aprs.fi) are shown in red, together with an English error message. Unprintable non-ASCII characters are displayed in hex with a purple colour. '''<0x1c>''' stands for a byte which has a hex value of 1C (28 decimal).
 
To see a hex dump of the complete packet contents (revealing difference in whitespace: tabs, amount of space characters in the end of the line), move the mode selector from '''Normal''' to '''Hex'''.
 
To view the decoded contents of the packets, switch to the '''Decoded''' mode. This will display what information the [http://search.cpan.org/dist/Ham-APRS-FAP/ Ham::APRS::FAP APRS packet parser] is able to find from the packets, and is very useful for understanding the contents of mic-e and compressed format packets. aprs.fi internally uses the open-source Ham::APRS::FAP parser for decoding.
 
=Prefix browsing=
 
The [http://aprs.fi/browse/ prefix browsing] pages allow you to search for APRS users by the callsign prefix. It's useful for finding APRS users near you, even if they haven't transmitted for a while and are not shown in the real-time map.
 
=Exporting and downloading position data=
 
The [http://aprs.fi/export/ APRS data export tool] allows you to export and download APRS positions from the aprs.fi database. An aprs.fi user account is required for using this tool. If you have not logged in already, a login form will be presented.
 
The tool can export to KMZ format (zip'ed KML + embedded symbol graphics in the same file) which can be opened in Google Earth, and some third-party software tools can also digest the KML file inside the KMZ archive.
 
It can also export to CSV which opens up nicely in Excel, and both JSON and XML (for the programmers out there).
 
# Enter the callsign of the station you wish to export
# Specify the time range you're interested in, maximum 30 days
# Click on '''Search'''
# A preliminary report of the export results is shown, including the amount of points found in the time range
# Select the output file format, and click '''Export'''
# The export file will be generated and downloaded.
 
This feature is aimed at people who wish to download their balloon's track afterwards, or their path to Dayton and back. It's not aimed at people who wish to download the whole aprs.fi database, so it's rate limited quite heavily – you can only use it a few times per day. Also, it's not an API.
 
====Export file format====
 
The KMZ format is described by [http://code.google.com/apis/kml/documentation/ Google's KML documentation].
 
The CSV file is comma-separated, with dates in YYYY-MM-DD HH:MM:SS format in UTC.
 
Coordinates are provided in decimal format, north and east being positive. Other measurement units are metric: speed in km/h, altitude in meters, distance in kilometers.
 
The JSON and XML files use the [http://en.wikipedia.org/wiki/Unix_time Unix timestamp] format (seconds since 1970-01-01 00:00:00 excluding leap seconds), which can be converted to UTC using ''gmtime()'' and local time using ''strftime()'' functions (and their relatives in other programming languages).


[[Category:aprs.fi]]
[[Category:aprs.fi]]
[[Category:APRS]]
[[Category:APRS]]
[[Category:Pakettiradio]]
[[Category:Pakettiradio]]

Nykyinen versio 8. kesäkuuta 2011 kello 07.15

This is the official manual for the aprs.fi web service. This is also a Wiki page, so you're welcome to expand the document!

Introduction

The aprs.fi web service collects information from the Automatic Packet (or Position) Reporting System Internet network (APRS-IS). APRS is used by amateur (ham) radio operators to transmit real-time position information, weather data, telemetry and messages over the radio. A vehicle equipped with a GPS receiver, a VHF transmitter or HF transceiver and a small computer device called a tracker transmits it's location, speed and course in a small data packet, which is then received by a nearby iGate receiving site which forwards the packet on the Internet. Packets are also retransmitted on the radio channel by digipeaters to enhance the coverage of the system. Systems connected to the Internet can send information on the APRS-IS without a radio transmitter, or collect and display information transmitted anywhere in the world.

In addition to that, aprs.fi also displays AIS data transmitted by most large ships. AIS transmissions are received by volunteers at numerous sites, but most areas are largely uncovered.

This guide aims to become a comprehensive manual for the aprs.fi web site, and as such does not attempt to describe the APRS or AIS systems in detail. To get started with APRS, please consult the following pages:

AIS is described well on the Wikipedia page for Automatic Identification System.

Languages and localisation

The aprs.fi service has been translated by volunteer users to numerous different languages. The language shown to you will be selected based on your browser's language preference settings. If you wish to preview the site in different languages, please prepend the two-letter language code to the site URL:

The site also supports different measurement units (metric, imperial and nautical), which can be selected in the preferences.

Site navigation links

Aprsfi-shot-info-toplinks.png

Each page has a set of navigation links at the top of the page, and another at the bottom. On the real-time map, the links are provided in the navigation bar the right side of the map, which can be hidden by clicking the button in the top right corner of the page.

The general idea is that the links on the top provide links to different data views. If you have already looked up a specific station, the links will contain that callsign, and clicking on the weather link when viewing the info page of a weather station will give you that station's weather history graphs.

The links at the bottom page provide links to static content pages such as the FAQ and this user guide, which give general information about the whole site.

There are a few exceptions to these rules, of course – the My account and Moving stations links, for example.

Sections

To ease up browsing and editing the guide has been split into separate pages for each section.

Common features
Describes features which are common to many or all of the different views of the site, such as searching using wildcards and table sorting.
Real-time map
Describes the main feature of the site, the real-time map.
Preferences
Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.
Info pages
Describes the station info and station graph views.
Static maps
Introduces the static maps feature.
KML and Google Earth
Describes how to view aprs.fi in 3D using Google Earth.
Web stations
Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.
Messages, status messages and the Bulletin Board
Describes the messages, status messages and bulletin board views.
Weather
Describes the weather data visualization features of aprs.fi.
Telemetry
Describes telemetry collection and viewing.
Raw packets and Beacons
Raw APRS and beacon packet listings.
Prefix browsing
Network tools
Tools for people who run the digipeaters and igates of the APRS network.
Exporting data
How to download APRS position data from aprs.fi to your computer.
Troubleshooting
If you're having problems using aprs.fi, or if you think you've found a bug, please start reading here.

Discussion group, blog and other points of communication

If you have any questions, answers, ideas, tips or tricks, please share them on the official aprs.fi Google Group. It's available as a web-based forum and as a regular mailing list. Before posting, please read the instructions on the forum's front page, especially the requirement for as many relevant details as possible (including exact callsigns and page links in question). The forum exists strictly for discussing the aprs.fi web service – please use the other relevant forums for discussion about generic APRS issues or tracker configuration problems.

Please read through the Troubleshooting section before posting to the discussion group about any problems. Thank you!

News about the aprs.fi service are posted on the aprs.fi blog, which can also be subscribed over email, or using an RSS reader such as reader.google.com. Headlines from the blog are shown regularly in the lower right corner of the real-time map.

Noudettu kohteesta ”https://wiki.sral.fi/w/index.php?title=Aprs.fi_user_guide&oldid=1507”