kopia lustrzana https://github.com/ctjacobs/pyqso
85 wiersze
3.0 KiB
ReStructuredText
85 wiersze
3.0 KiB
ReStructuredText
|
Introduction
|
|||
|
|
============
|
|||
|
|
|
|||
|
|
Overview
|
|||
|
|
--------
|
|||
|
|
|
|||
|
|
PyQSO is a logging tool for amateur radio operators. It provides a
|
|||
|
|
simple graphical interface through which users can manage information
|
|||
|
|
about the contacts/QSOs they make with other operators on the air. All
|
|||
|
|
information is stored in a light-weight SQL database. Other key features
|
|||
|
|
include:
|
|||
|
|
|
|||
|
|
- Customisable interface (e.g. only show callsign and frequency
|
|||
|
|
information).
|
|||
|
|
|
|||
|
|
- Import and export logs in ADIF format.
|
|||
|
|
|
|||
|
|
- Perform callsign lookups and auto-fill data fields using the qrz.com
|
|||
|
|
database.
|
|||
|
|
|
|||
|
|
- Sort the logs by individual fields.
|
|||
|
|
|
|||
|
|
- Print a hard-copy of logs, or print to PDF.
|
|||
|
|
|
|||
|
|
- Connect to Telnet-based DX clusters.
|
|||
|
|
|
|||
|
|
- Progress tracker for the DXCC award.
|
|||
|
|
|
|||
|
|
- Grey line plotter.
|
|||
|
|
|
|||
|
|
- Filter out QSOs based on the callsign field (e.g. only display
|
|||
|
|
contacts with callsigns beginning with "M6").
|
|||
|
|
|
|||
|
|
- Remove duplicate QSOs.
|
|||
|
|
|
|||
|
|
- Basic support for the Hamlib library.
|
|||
|
|
|
|||
|
|
The source code for PyQSO is available for download at:
|
|||
|
|
|
|||
|
|
``https://github.com/ctjacobs/pyqso``
|
|||
|
|
|
|||
|
|
Data storage model
|
|||
|
|
------------------
|
|||
|
|
|
|||
|
|
Many amateur radio operators choose to store all the contacts they ever
|
|||
|
|
make in a single *logbook*, whereas others keep a separate logbook for
|
|||
|
|
each year, for example. Each logbook may be divided up to form multiple
|
|||
|
|
distinct *logs*, perhaps one for casual repeater contacts and another
|
|||
|
|
for DX’ing. Finally, each log can contain multiple *records*. PyQSO is
|
|||
|
|
based around this three-tier model for data storage, going from logbooks
|
|||
|
|
at the top to individual records at the bottom.
|
|||
|
|
|
|||
|
|
Rather than storing each log in a separate file, a single database can
|
|||
|
|
hold several logs together; in PyQSO, a database is therefore analogous
|
|||
|
|
to a logbook. Within a database the user can create multiple tables
|
|||
|
|
which are analogous to the logs. Within each table the user can
|
|||
|
|
create/modify/delete records which are analogous to the records in each
|
|||
|
|
log.
|
|||
|
|
|
|||
|
|
Licensing
|
|||
|
|
---------
|
|||
|
|
|
|||
|
|
PyQSO is free software, released under the GNU General Public License.
|
|||
|
|
Please see the file called COPYING for more information.
|
|||
|
|
|
|||
|
|
Structure of this manual
|
|||
|
|
------------------------
|
|||
|
|
|
|||
|
|
The structure of this manual is as follows. Chapter
|
|||
|
|
[chap:getting:sub:`s`\ tarted] is all about getting started with PyQSO –
|
|||
|
|
from the installation process through to creating a new logbook (or
|
|||
|
|
opening an existing one). Chapter [chap:log:sub:`m`\ anagement] explains
|
|||
|
|
how to create a log in the logbook, as well as the basic operations that
|
|||
|
|
users can perform with existing logs, such as printing, importing
|
|||
|
|
from/exporting to ADIF format, and sorting. Chapter
|
|||
|
|
[chap:record:sub:`m`\ anagement] deals with the bottom layer of the
|
|||
|
|
three-tier model – the creation, deletion, and modification of QSO
|
|||
|
|
records in a log. Chapter [chap:toolbox] introduces the PyQSO toolbox
|
|||
|
|
which contains three tools that are useful to amateur radio operators: a
|
|||
|
|
DX cluster, a grey line plotter, and an awards progress tracker.
|
|||
|
|
Finally, Chapter [chap:preferences] explains how users can set up Hamlib
|
|||
|
|
support and show/hide various fields in a log, along with several other
|
|||
|
|
user preferences that can be set via the Preferences dialog window.
|
|||
|
|
|