Tropycal

Highlights

- Many minor bug fixes.
- ``tropycal.realtime`` now retrieves all global active tropical cyclones, includes forecast tracks from the Joint Typhoon Warning Center (JTWC), and improved several functions.
- Cleaned up underlying code for tool functions and moved many into a single ``tropycal.utils`` directory.

Specifics

New functions:
- tropycal.utils
- Created a new collection of utility functions that are used internally and are of use to the average user.

New features and updates:
- tropycal.realtime.RealtimeStorm:
- Added JTWC active tropical cyclones and forecasts.
- Renamed ``plot_nhc_forecast_realtime()`` as ``plot_forecast_realtime()`` to account for the inclusion of JTWC forecasts.
- Improved and fixed bugs in ``get_realtime_info()`` function.
- Added new function ``download_graphic_realtime()`` to download real time forecast graphics from NHC and JTWC.

- tropycal.tracks.Dataset:
- In ``gridded_stats``, composite difference plots between different ranges of years can now be created.

Notable Bug fixes:
- Overall:
- Cleaned up documentation for numerous functions.

- tropycal.recon:
- Fixed bugs for colorbar and contouring in ``plot_swath`` and ``plot_hovmoller``.

- tropycal.tracks:
- Fixed bugs for colorbar and contouring in ``gridded_stats``.

Highlights

- ``tropycal.recon`` has been substantially revised, with capabilities of plotting recon data in various formats such as hovmollers and storm-centered data.
- New class ``tropycal.realtime`` was added, with realtime storm handling capabilities. Currently this is only available for storms under NHC's area of responsibility.
- Substantial usability improvements, detailed further below.
- Documentation has been improved, with more detailed information on map domains and customization properties.

Specifics

New functions:
- tropycal.tracks.Dataset:
- ``download_tcr`` : Downloads the NHC offical Tropical Cyclone Report (TCR) for the requested storm to the requested directory.

- tropycal.tracks.Storm:
- ``sel_time`` : Subset this storm's data by a range of times or for a single time.
- ``query_nhc_discussions`` : Searches for the given word or phrase through all NHC forecast discussions for this storm.

- tropycal.tracks.Season:
- ``get_storm`` : Retrieves a Storm object for the requested storm.

New features and updates:
- Overall:
- For plotting functions, the keyword argument "zoom" has been replaced with "domain".

- tropycal.tracks.Dataset:
- Updated the default HURDATv2 source to reference the latest release through 2019.
- In ``gridded_stats``, the gridded 2D array can now be returned from the function as an xarray DataArray.
- ``get_season`` can now retrieve a composite of multiple seasons for HURDATv2 data.

- tropycal.tracks.Storm:
- Storm objects now have variables included as attributes. For example, type "storm.lon" to retrieve all longitude points.
- Added official NHC cone of uncertainty sizes for the 2020 Atlantic & Pacific Hurricane Seasons.
- Added a "dynamic_tropical" domain for plotting storms, only zooming on the portion of the storm when it was a tropical or subtropical cyclone.

- tropycal.tracks.Season:
- Season objects can now be added together using HURDATv2 data, for uses such as compositing seasons.
- Renamed the ``annual_summary`` function as ``summary``, in part to reflect the use of multiple seasons.

Notable Bug fixes:
- Overall:
- Cleaned up documentation for numerous functions.

- tropycal.tracks.Storm:
- When printing instance of Storm object, peak intensity statistics no longer include time spent as extratropical.
- Fixed a bug for retrieving operational NHC forecasts for 2019.
- An error message now appears when trying to download a tropical cyclone report (TCR) that doesn't exist.

- tropycal.tracks.Season:
- Fixed the calculation for the ending time of the season.

Version 0.1.1 of Tropycal features numerous minor bug fixes, as well as adding a `plot_storms()` function to TrackDataset allowing for plotting multiple storms in a single figure.

This is the first release of Tropycal! This package offers capability to analyze and plot global tropical cyclone data, as well as tornado data associated with hurricanes in the United States and the ability to retrieve past National Hurricane Center (NHC) forecasts and discussions for Atlantic and Pacific hurricanes.