magma-var

Python package for MAGMA Volcanic Activity Report (VAR)

1. How to use

Make sure you have MAGMA token. Check examples directory.

Volcano name and code:

1.1 Install module

pip install magma-var

Check your version:

print(magma_var.__version__)

1.2 Download Volcanic Activity Report (VAR)

To download Volcanic Activity Report (VAR):

import magma_var
from magma_auth import auth
from magma_var import Download

print(magma_var.__version__)

token = auth.token # or replace with your own token

download = Download(
    token=token,
    volcano_code='LOK',
    start_date='2025-01-01',
    end_date='2025-06-08',
    locale="id", # [testing] Change to "en" for english translation 
    current_dir='D:\\Projects\\magma-var', # Change your current directory. Default to None.
    verbose=True,
)

download.var()

download.to_excel()

download.to_csv()

1.3 Plot VAR

Plot seismicity count:

Earthquake name and code:

from magma_auth import auth
from magma_var import Plot

token = auth.token or replace with your own token

plot = Plot(
    token = token,
    volcano_code = 'LOK',
    start_date = '2025-01-01',
    end_date = '2025-03-13',
    earthquake_code = '*', # Check table above for earthquake code
    locale = 'en', # change to "id" for Indonesia. Default to "id"
    overwrite=True, # Overwrite existing downloaded file
    verbose=True, # Show detailed information
)

Print DataFrame:

plot.df

Show plot:

plot.show(
    interval=7, # 7 days. X-axis interval in days. 
    width=1.0, # Size bar width
    title='Lokon', # Plot title
    figsize=(10,1),
    title_fontsize=12,
    figure_ylabel_fontsize=9,
    x_labelsize=8,
    y_labelsize=8,
    legend_fontsize=6,
    color='black', # remove or change to None to use default color
)

Changelog

[0.1.1] 2025-09-04

Bug fix.

Added

• Update jupyter notebook example.

Fixed

• Fix readme.
• Fix color options.

Changed

• Code reformatting using black.