magma-converter

Python package to convert CVGHM seismic data structures into SDS format.
https://pypi.org/project/magma-converter/

Install

pip install magma-converter

Supported Directory Structure (Indonesia)

Volcano	directory_structure	Group
Anak Krakatau	`kra`,`krakatau`,`anak krakatau`,`anak-krakatau`	SAC
Awu	`awu`	Seisan
Bromo	`bro`,`bromo`	SAC
Dieng**	`die`,`dieng`	SAC, Seisan
Dukono	`duk`,`dukono`	Seisan
Ibu	`ibu`	Seisan
Ijen*	`ije`,`ijen`	Ijen
Kelud	`kld`,`kelud`	Kelud
Lamongan	`lam`,`lamongan`	SAC
Lewotobi Laki-laki	`lwk`,`lewotobi laki-laki`	Seisan
Lokon	`lok`,`lokon`	Seisan
Mahawu	`mah`,`mahawu`	Seisan
Marapi	`mar`,`marapi`	SAC
Papandayan	`pap`,`papandayan`	SAC
Rinjani	`rin`,`rinjani`	SAC
Ruang	`rua`,`ruang`	Seisan
Semeru	`smr`,`semeru`	SAC
Soputan	`sop`,`soputan`	Seisan
Tambora	`tam`,`tambora`	Seisan
Tandikat	`tan`,`tandikat`	SAC

*) Special case

**) Depends on time. For Dieng, SAC was used from 2013-08-12 to 2021-09-15 and 2023-10-16 to 2024-08-15. Seisan was used from 2021-03-26 to 2023-10-16.

How to

Run this codes:

from magma_converter import Convert

input_dir = 'L:\\Ijen\\Seismik Ijen'
output_dir = 'L:\\converted'
start_date: str = "2019-01-01"
end_date: str = "2019-12-31"

convert = Convert(
    input_dir=input_dir,
    output_directory=output_dir,
    directory_structure='ijen', # check table above
    min_completeness=30, # convert to SDS if completeness of data greater than 30%
).between_dates(start_date, end_date)

convert.run()

Check converting results

convert.success
convert.failed

Example output for convert.success or convert.failed:

[{'trace_id': 'VG.KRA1.00.EHZ',
  'date': '2018-01-01',
  'start_time': '2018-01-01 00:00:00',
  'end_time': '2018-01-01 23:59:59',
  'sampling_rate': 100.0,
  'completeness': 99.7532986111111,
  'file_location': 'L:\\converted\\SDS\\2018\\VG\\KRA1\\EHZ.D\\VG.KRA1.00.EHZ.D.2018.001'},
 {'trace_id': 'VG.KRA2.00.EHZ',
  'date': '2018-01-01',
  'start_time': '2018-01-01 00:00:00',
  'end_time': '2018-01-01 23:59:59',
  'sampling_rate': 100.0,
  'completeness': 99.99770833333334,
  'file_location': 'L:\\converted\\SDS\\2018\\VG\\KRA2\\EHZ.D\\VG.KRA2.00.EHZ.D.2018.001'},
 {'trace_id': 'VG.KRA3.00.EHZ',
  'date': '2018-01-01',
  'start_time': '2018-01-01 00:00:00',
  'end_time': '2018-01-01 23:59:59',
  'sampling_rate': 100.0,
  'completeness': 99.79653935185185,
  'file_location': 'L:\\converted\\SDS\\2018\\VG\\KRA3\\EHZ.D\\VG.KRA3.00.EHZ.D.2018.001'},
 {'trace_id': 'VG.PULO.00.EHZ',
  'date': '2018-01-01',
  'start_time': '2018-01-01 00:00:00',
  'end_time': '2018-01-01 23:59:59',
  'sampling_rate': 100.0,
  'completeness': 98.79126157407407,
  'file_location': 'L:\\converted\\SDS\\2018\\VG\\PULO\\EHZ.D\\VG.PULO.00.EHZ.D.2018.001'},
 {'trace_id': 'VG.SRTG.00.EHZ',
  'date': '2018-01-01',
  'start_time': '2018-01-01 00:00:00',
  'end_time': '2018-01-01 23:59:59',
  'sampling_rate': 100.0,
  'completeness': 99.995625,
  'file_location': 'L:\\converted\\SDS\\2018\\VG\\SRTG\\EHZ.D\\VG.SRTG.00.EHZ.D.2018.001'},
 {'trace_id': 'VG.INFR.00.EHZ',
  'date': '2018-01-01',
  'start_time': '2018-01-01 00:00:00',
  'end_time': '2018-01-01 23:59:59',
  'sampling_rate': 100.0,
  'completeness': 99.99770833333334,
  'file_location': 'L:\\converted\\SDS\\2018\\VG\\INFR\\EHZ.D\\VG.INFR.00.EHZ.D.2018.001'}]

Metadata

Release files for magma-converter 1.9.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for magma-converter 1.9.5
File	Size	Uploaded
magma_converter-1.9.5.tar.gz	24.3 kB	May 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for magma-converter 1.9.5
File	Interpreter	ABI	Platform	Reset
magma_converter-1.9.5-py3-none-any.whl 29.4 kB May 5, 2026	Python 3	none	any	Details

Total release size: 53.8 kB

Release files / magma_converter-1.9.5.tar.gz

Download URL	magma_converter-1.9.5.tar.gz
Size	24.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`2f111ca869c98c37532197d049bbb48ae6835f08b656e1888c98986458a3a1dc`
BLAKE2b-256 checksum How to use checksums	`46ab9873b0fd6d26714dce7d3c0f969089dc77948268af982436dae4f42efc30`
Upload date	May 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.7`

Release files / magma_converter-1.9.5-py3-none-any.whl

Download URL	magma_converter-1.9.5-py3-none-any.whl
Size	29.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`bf966defae7805e75f79a3045250fc1750b1f925831c3ba73b812ea709054fc4`
BLAKE2b-256 checksum How to use checksums	`a432a5cd597de3c7ee580e4460a0dc46b42e83aa0a91ac51a9f27e922fdab537`
Upload date	May 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.7`