adiftools release v0.1.5

This is an official release version.

Functions

• Read adif file into Pandas DataFrame.
• Generate basic Matplotlib plots from adif data.
• Utility tool to calculate Grid Locator from/to geographic coordinate.

New

Add pickle file interface to improve file reading response

• Save ADIF data to pickle file: Save the DataFrame with the ADIF loaded to a pickle file.

  • Loading an ADIF file into a DataFrame can be quite time consuming.
  • It is especially long if there are many QSOsin the ADIF file, and it is very cumbersome to read the data every time.
  • It is recommended to serialize the ADIF data once loaded and save it in a pickle format, which is expected to be 50 times faster than loading a raw ADIF file.
  • Call signature:

    ADIFParser.to_pickle(file_path)

  • Parameter:
    • file_path: str or path-like or binary file-like
      • A path, or a Python file-like object of pickle file to save
    • Returns:
      • None

• Load Pickle data

  • Provides a way to read ADIF data once it has been loaded by ADIFParser and saved in a pickle file.
  • The read_pickle method does not check whether the QSO data is saved in the read pickle file.
  • Call signature:

    ADIFParser.read_pickle(file_path)

  • Parameter:
    • file_path: str or path-like or binary file-like
      • A path, or a Python file-like object of pickle file to read
    • Returns:
      • pd.DataFrame
        • The created pandas.DataFrame instance includes QSO data from ADIF file

Install

adiftools can now officially pip install from PyPI. If you have already installed a previous version, please update it with the following command All previous functions can still be used with this update.

pip install adiftools

pip install -U adiftools

• When you got an error from subprocess, try to install wheel by pip install wheel command

Other

• Please report any issues with the release on the adiftools issue tracker.
• 日本語での説明はJS2IIUのブログをご覧ください：アマチュア無線局JS2IIU

Thank you, JS2IIU