Adiftools

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

- **Save ADIF data as adi file**
- Saves the loaded ADIF data as an adi file conforming to the ADIF standard. adiftools adds a new header to the beginning of the adi file.
- Fields with no data are filled with `nan`.
- The header will contain information on the following two fields, CREATED_TIMESTAMP, and PROGRAMID.
- Call signature:
python
ADIFParser.to_adi(file_path)

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

- **Save ADIF data as excel file**: Save the DataFrame with the ADIF loaded to an excel file.
- Call signature:
python
ADIFParser.to_excel(file_path)

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


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.

shell
pip install adiftools


shell
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](issues).
* 日本語での説明はJS2IIUのブログをご覧ください：[アマチュア無線局JS2IIU](https://js2iiu.com)

Thank you, JS2IIU

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:
python
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:
python
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.

shell
pip install adiftools


shell
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](issues).
* 日本語での説明はJS2IIUのブログをご覧ください：[アマチュア無線局JS2IIU](https://js2iiu.com)

Thank you, JS2IIU

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

- **Generate Callsign file**
- Outputs call sign data without duplicates from data read from an ADIF file as a text file. The text file will contain one callsign per line.
- If the ADIF file has not been read, i.e., `read_adi()` has not been performed, it returns the error `AdifParserError`.
- Call signature:
python
ADIFParser.call_to_txt(filepath)

- Parameter:
- `file_path`: str or path-like or binary file-like
- A path of output txt file
- Returns:
- `None`

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.

shell
pip install adiftools


shell
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](issues).
* 日本語での説明はJS2IIUのブログをご覧ください：[アマチュア無線局JS2IIU](https://js2iiu.com)

Thank you, JS2IIU

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

- Calculate distance from two places' latitude and longitude
- Call signature
python
adiftools.get_dist(lat1, lon1, lat2, lon2)

- Parameters:
- `lat1` – latitude of the first point in degrees
- `lon1` – longitude of the first point in degrees
- `lat2` – latitude of the second point in degrees
- `lon2` – longitude of the second point in degrees
- Returns:
- the distance from the first point to the second in meters
- Reference
- [GeographicLib API — geographiclib 2.0 documentation](https://geographiclib.sourceforge.io/Python/doc/code.html#)

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.

shell
pip install adiftools


shell
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](issues).
* 日本語での説明はJS2IIUのブログをご覧ください：[アマチュア無線局JS2IIU](https://js2iiu.com)

Thank you, JS2IIU

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

- Check JA call sign
- Call signature
python
adiftools.is_ja(call_sign)

- Parameter:
- `call_sign` call sign as string
- Returns:
- `True`: JA call, `False`: other

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.

shell
pip install adiftools


shell
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](issues).
* 日本語での説明はJS2IIUのブログをご覧ください：[アマチュア無線局JS2IIU](https://js2iiu.com)

Thank you, JS2IIU

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

* `adiftools.latlon2gl(latitude, longitude)`
* In this release, a function called latlon2gl() has been added. This function calculates a grid locator from latitude and longitude. The grid locator is output in 6-digit string format.

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.

shell
pip install adiftools


shell
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](issues).
* 日本語での説明はJS2IIUのブログをご覧ください：[アマチュア無線局JS2IIU](https://js2iiu.com)

Thank you, JS2IIU