Best Track Data
This section will discuss the process of downloading and loading Best Track data both from JMA and IBTrACS.
Downloading
To download the JMA Best Track data, simply run the following:
julia> using Bagyojulia> get(BestTrack, :jma)[ Info: Unzipping file [ Info: Zip file path /home/runner/work/Bagyo.jl/Bagyo.jl/src/../db/jma/bt/bst_all.txt [ Info: Deleting zip file [ Info: Parsing raw data [ Info: Saving cleaned data "/home/runner/work/Bagyo.jl/Bagyo.jl/src/../db/jma/bt/track_data.csv"
As for IBTrACS, replace :jma with :ibtracs:
julia> get(BestTrack, :ibtracs)"/home/runner/work/Bagyo.jl/Bagyo.jl/src/../db/ibtracs/bt/bst_all.csv"
Bagyo.jl only downloads the Western-North Pacific data of IBTrACS.
Loading
To load the JMA Best Track data, run the following:
julia> meta, data = load(BestTrack, :jma);julia> meta1926×7 DataFrame Row │ INTERNATIONAL_ID NUMBER_OF_LINES CYCLONE_NUMBER LAST_FLAG TIME_DIF ⋯ │ Int64 Int64 Int64? Int64 Missing ⋯ ──────┼───────────────────────────────────────────────────────────────────────── 1 │ 5101 10 missing 0 missin ⋯ 2 │ 5102 37 missing 0 missin 3 │ 5103 36 missing 0 missin 4 │ 5104 66 missing 0 missin 5 │ 5105 45 missing 1 missin ⋯ 6 │ 5106 29 missing 0 missin 7 │ 5107 34 missing 1 missin 8 │ 5108 17 missing 0 missin ⋮ │ ⋮ ⋮ ⋮ ⋮ ⋮ ⋱ 1920 │ 2422 40 28 0 missin ⋯ 1921 │ 2423 30 29 0 missin 1922 │ 2424 50 30 0 missin 1923 │ 2425 31 31 0 missin 1924 │ 2426 16 33 0 missin ⋯ 1925 │ 2501 22 1 0 missin 1926 │ 2502 22 3 0 missin 3 columns and 1911 rows omittedjulia> data70261×19 DataFrame Row │ INTERNATIONAL_ID DATE_TIME YEAR MONTH DAY HOUR ST ⋯ │ Int64 DateTime Int64 Int64 Int64 Int64 St ⋯ ───────┼──────────────────────────────────────────────────────────────────────── 1 │ 5101 1951-02-19T06:00:00 1951 2 19 6 mi ⋯ 2 │ 5101 1951-02-19T12:00:00 1951 2 19 12 mi 3 │ 5101 1951-02-19T18:00:00 1951 2 19 18 mi 4 │ 5101 1951-02-20T00:00:00 1951 2 20 0 mi 5 │ 5101 1951-02-20T06:00:00 1951 2 20 6 mi ⋯ 6 │ 5101 1951-02-20T12:00:00 1951 2 20 12 mi 7 │ 5101 1951-02-20T18:00:00 1951 2 20 18 mi 8 │ 5101 1951-02-21T00:00:00 1951 2 21 0 mi ⋮ │ ⋮ ⋮ ⋮ ⋮ ⋮ ⋮ ⋱ 70255 │ 2502 2025-06-25T00:00:00 2025 6 25 0 SE ⋯ 70256 │ 2502 2025-06-25T06:00:00 2025 6 25 6 SE 70257 │ 2502 2025-06-25T12:00:00 2025 6 25 12 SE 70258 │ 2502 2025-06-25T18:00:00 2025 6 25 18 SE 70259 │ 2502 2025-06-26T00:00:00 2025 6 26 0 SE ⋯ 70260 │ 2502 2025-06-26T06:00:00 2025 6 26 6 SE 70261 │ 2502 2025-06-26T12:00:00 2025 6 26 12 SE 13 columns and 70246 rows omitted
Note that JMA returns two datasets, the metadata which contains the information about the storm, and the corresponding data of the storm tracks. For the description of the columns, please refer to JMA documentation.
As for IBTrACS, there is only one data containing all the information about the cyclone.
julia> data = load(BestTrack, :ibtracs);julia> data243495×163 DataFrame Row │ SID SEASON NUMBER BASIN SUBBASIN NAME ISO_TIM ⋯ │ String15 Int64 Int64 String3 String3 String31 String3 ⋯ ────────┼─────────────────────────────────────────────────────────────────────── 1 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 ⋯ 2 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 3 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 4 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 5 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 ⋯ 6 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 7 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 8 │ 1884177N17124 1884 14 WP MM NOT_NAMED 1884-06 ⋮ │ ⋮ ⋮ ⋮ ⋮ ⋮ ⋮ ⋱ 243489 │ 2024146N11126 2024 26 WP MM EWINIAR 2024-05 ⋯ 243490 │ 2024146N11126 2024 26 WP MM EWINIAR 2024-05 243491 │ 2024146N11126 2024 26 WP MM EWINIAR 2024-05 243492 │ 2024146N11126 2024 26 WP MM EWINIAR 2024-05 243493 │ 2024146N11126 2024 26 WP MM EWINIAR 2024-05 ⋯ 243494 │ 2024146N11126 2024 26 WP MM EWINIAR 2024-05 243495 │ 2024146N11126 2024 26 WP MM EWINIAR 2024-05 157 columns and 243480 rows omitted
Please refer to IBTrACS documentation for the description of the columns of the data above.
Deleting
The downloaded data are saved in the local directory of your machine, and the following APIs helps on managing this data, in particular for deleting the said data.
julia> # delete only the Best Track of JMA Data delete!(BestTrack, :jma) # delete all JMA Data folders and files[ Info: JMA Best Track DB successfully deleted.julia> delete!(:jma)[ Info: JMA DB successfully deleted.
For IBTrACS,
julia> # delete only the Best Track of IBTrACS Data delete!(BestTrack, :ibtracs) # delete all IBTrACS Data folders and files[ Info: IBTrACS Best Track DB successfully deleted.julia> delete!(:ibtracs)[ Info: IBTrACS DB successfully deleted.