---

How to

Connect IP: 141.52.67.147 -P 55000 Request type: JSON-RPC Protocol: http Authentication: HTTP Basic Auth

Possible requests: Data requests Request status List of requests Remove request from the list Download file

Possible request status: Running Scheduled Finished Failed Deleting Expired

The requests can be made either for individual setup and for several ones (see the examples below).

Warning! Some cuts are available only in command line interface.

Back

Data available:

KASCADE

Parameter	Range	Request field
Azimuth [°]	0 –  360	azimuth
Core X distance [m]	-91 –  91	core_x
Core Y distance [m]	-91 –  91	core_y
Datetime	1998-05-08 16:35:38 –  2013-01-15 09:40:36	datetime
Electron number [log10]	2 –  8.7	electron_number
Energy [eV (log10)]	13 –  19	energy
Muon number [log10]	2 –  7.7	muon_number
Shower age	0.1 –  1.48	shower_age
Zenith [°]	0 –  60	zenith

Back

GRANDE

Parameter	Range	Request field
Azimuth [°]	0 –  360	azimuth
Charged number [log10]	3 –  9	charged_number
Core X distance [m]	-500 –  100	core_x
Core Y distance [m]	-600 –  100	core_y
Datetime	2004-03-09 03:47:50 –  2012-10-08 07:31:42	datetime
Muon number [log10]	3.17 –  8	muon_number
Shower age	-0.385 –  1.485	shower_age
Zenith [°]	0 –  40	zenith

Back

LOPES

Parameter	Range	Request field
Datetime	2005-12-03 11:09:53 –  2009-10-25 20:18:02	datetime
Azimuth EW [°]	0 –  360	AzL_EW
Azimuth NS [°]	0 –  360	AzL_NS
CCheight EW [?V/m/MHz]	0 –  20	CCheight_EW
CCheight NS [?V/m/MHz]	0 –  20	CCheight_NS
EfieldMaxAbs [V/m]	0 –  5e+4	EfieldMaxAbs
Elevation EW [°]	40 –  90	ElL_EW
Elevation NS [°]	40 –  90	ElL_NS
Geomagnetic Angle [°]	0 –  120	Geomagnetic_Angle
Geomagnetic AngleG [°]	0 –  120	Geomagnetic_AngleG
LopesCompID	0 –  1	LopesCompID
NCCbeamAntennas EW	0 –  30	NCCbeamAntennas_EW
NCCbeamAntennas NS	0 –  30	NCCbeamAntennas_NS
Xheight EW [?V/m/MHz]	0 –  20	Xheight_EW
Xheight NS [?V/m/MHz]	0 –  20	Xheight_NS
ConeAngle EW [rad]	0 –  0.1	coneAngle_EW
ConeAngle NS [rad]	0 –  0.1	coneAngle_NS
Eps EW [?V/m/MHz]	0 –  100	eps_EW
Eps NS [?V/m/MHz]	0 –  100	eps_NS
Eta EW [1/m]	-0.04 –  -0.1	eta_EW
Eta NS [1/m]	-0.04 –  -0.1	eta_NS
Reconstruction	65 –  71	reconstruction
RmsCCbeam EW [?V/m/MHz]	0 –  0.5	rmsCCbeam_EW
RmsCCbeam NS [?V/m/MHz]	0 –  0.5	rmsCCbeam_NS

Back

KASCADE combined

Parameter	Range	Request field
Azimuth [°]	0 –  360	azimuth
Core X distance [m]	-520 –  100	core_x
Core Y distance [m]	-600 –  100	core_y
Datetime	2004-03-08 10:25:12 –  2010-11-04 13:16:12	datetime
Electron number [log10]	5 –  9	electron_number
Energy [eV (log10)]	14 –  19	energy
Muon number [log10]	3 –  8	muon_number
Shower age	0.1 –  1.48	shower_age
Zenith [°]	0 –  30	zenith

Back

Tunka-133

Parameter	Range	Request field
Azimuth [°]	0 –  360	azimuth
Core distance [m]	0 –  7785.41	core_distance
Datetime	2009-10-25 15:33:18 –  2017-03-31 20:50:38	datetime
Energy [eV (log10)]	12.999 –  21.202	energy
X max [g/cm^2]	0 –  1499	x_max
Zenith [°]	0 –  90	zenith

Back

Tunka-Rex

Data layers (DL):

• DL0: raw traces recorded by the ACDs

Data is storen in blobs and can be queried by 'datetime' parameter (2012-10-09 – 2018-08-20).

Back

Simulations: KASCADE, KASCADE-GRANDE, COMBINED

Parameter	Posible values	Request field
Particle	'gamma', 'proton', 'helium', 'carbon', 'silicon', 'iron', 'all_nuclei'	'particle'
Model	QGSjet-II-02, QGSjet-II-04, EPOS 1.99, EPOS LHC, SIBYLL 2.1, SIBYLL 2.3, SIBYLL 2.3c	'model'
Energy [eV (log10)]	'middle': 1.0×1014 &< E0 < 1.0×1018 eV 'high': High Energy Extension -> 5.62×1017 to 3.16×1018 eV	'energy'
Setup	'kascade', 'grande', 'combined'	'setup'

Back

Examples:

+ Requests:

* One experiment, one data cut

• Request:

{
    "id": "4998715b-cd5d-4c17-80fb-8139a74d66ea",
    "jsonrpc": "2.0",
    "method": "new_task",
    "params": {
        "kascade_exp": {
            "datetime_max": "2011-10-10 00:00:00",
            "datetime_min": "2010-10-10 00:00:00"
        }
    }
}

• Response:

{
    "id": "4998715b-cd5d-4c17-80fb-8139a74d66ea",
    "jsonrpc": "2.0",
    "result": {
        "url": "https://gradlc-dc.iap.kit.edu/download/c3feaa45-b654-44d3-83e7-671b1ac0499c.7z",
        "uuid": "c3feaa45-b654-44d3-83e7-671b1ac0499c"
    }
}

* One experiment, several data cuts

• Request:

{
    "id": "4998715b-cd5d-4c17-80fb-8139a74d66ea",
    "jsonrpc": "2.0",
    "method": "new_task",
    "params": {
        "kascade_exp": {
            "datetime_max": "2011-10-10 00:00:00",
            "datetime_min": "2010-10-10 00:00:00",
            "zenith_max": 20.0,
            "zenith_min": 0.0
        }
    }
}

• Response:

{
    "id": "4998715b-cd5d-4c17-80fb-8139a74d66ea",
    "jsonrpc": "2.0",
    "result": {
        "url": "https://gradlc-dc.iap.kit.edu/download/c3feaa45-b654-44d3-83e7-671b1ac0499c.7z",
        "uuid": "c3feaa45-b654-44d3-83e7-671b1ac0499c"
    }
}

* Many experiments, several data cuts

• Request:

{
    "id": "43268cba-db6f-40a6-92fb-ac24b62b00e7",
    "jsonrpc": "2.0",
    "method": "new_task",
    "params": {
        "kascade_exp": {
            "datetime_max": "2011-10-10 00:00:00",
            "datetime_min": "2010-10-10 00:00:00",
            "zenith_max": 20.0,
            "zenith_min": 0.0
        },
        "tunka133_exp": {
            "datetime_max": "2011-10-11 00:00:00",
            "datetime_min": "2010-10-10 00:00:00",
            "zenith_max": 30.0,
            "zenith_min": 0.0
        }
    }
}

• Response:

{
    "id": "43268cba-db6f-40a6-92fb-ac24b62b00e7",
    "jsonrpc": "2.0",
    "result": {
        "url": "https://gradlc-dc.iap.kit.edu/download/d0e641cf-d0e5-471c-a096-dcb054a9853b.7z",
        "uuid": "d0e641cf-d0e5-471c-a096-dcb054a9853b"
    }
}

Back

+ Request status

• Request:

{
    "id": "e7cbcfdc-8bfb-440f-8fc9-3e8bbadaf99d",
    "jsonrpc": "2.0",
    "method": "show_task",
    "params": {
        "uuid": "d0e641cf-d0e5-471c-a096-dcb054a9853b"
    }
}

• Response:

{
    "id": "e7cbcfdc-8bfb-440f-8fc9-3e8bbadaf99d",
    "jsonrpc": "2.0",
    "result": {
        "status.name": "Finished",
        "task.log": "\n2020-06-23 21:15:06.052164: fetching KASCADE events...\n2020-06-23 21:28:32.283243: fetched 13543807 KASCADE events...\n2020-06-23 21:28:32.345633: fetching Tunka-133 events...\n2020-06-23 21:28:54.627324: fetched 877489 Tunka-133 events.\n",
        "task.parameters": "{\"kascade_exp\": {\"datetime_min\": \"2010-10-10 00:00:00\", \"datetime_max\": \"2011-10-10 00:00:00\", \"zenith_min\": 0.0, \"zenith_max\": 20.0}, \"tunka133_exp\": {\"datetime_min\": \"2010-10-10 00:00:00\", \"datetime_max\": \"2011-10-11 00:00:00\", \"zenith_min\": 0.0, \"zenith_max\": 30.0}}",
        "task.status": 3,
        "task.time_end": "2020-06-23 21:28:55",
        "task.time_start": "2020-06-23 18:50:13",
        "task.uuid": "d0e641cf-d0e5-471c-a096-dcb054a9853b",
        "url": "https://gradlc-dc.iap.kit.edu/download/d0e641cf-d0e5-471c-a096-dcb054a9853b.7z",
        "user.login": "example_login",
        "user.username": "Example User Name"
    }
}

Back

+ List of requests

• Request:

{
    "id": "3c325e96-c073-44de-abb6-3c84b2e21297",
    "jsonrpc": "2.0",
    "method": "list_tasks"
}

• Response:

{
    "id": "3c325e96-c073-44de-abb6-3c84b2e21297",
    "jsonrpc": "2.0",
    "result": [
        {
            "status.name": "Finished",
            "task.status": 3,
            "task.time_end": "2020-06-23 21:28:55",
            "task.time_start": "2020-06-23 18:50:13",
            "task.uuid": "d0e641cf-d0e5-471c-a096-dcb054a9853b",
            "url": "https://gradlc-dc.iap.kit.edu/download/d0e641cf-d0e5-471c-a096-dcb054a9853b.7z",
            "user.login": "example_login",
            "user.username": "Example User Name"
        },
        {
            "status.name": "Expired",
            "task.status": 6,
            "task.time_end": "2020-06-18 08:42:13",
            "task.time_start": "2020-06-18 06:42:11",
            "task.uuid": "80f0b5e8-db48-493c-8f37-f12b73d5d452",
            "url": "https://gradlc-dc.iap.kit.edu/download/80f0b5e8-db48-493c-8f37-f12b73d5d452.7z",
            "user.login": "example_login",
            "user.username": "Example User Name"
        }
    ]
}

Back

+ Remove request from the list

The request will be deleted from the list. All related files will be removed from the disk.

• Request:

{
    "id": "e7cbcfdc-8bfb-440f-8fc9-3e8bbadaf99d",
    "jsonrpc": "2.0",
    "method": "delete_task",
    "params": {
        "uuid": "d0e641cf-d0e5-471c-a096-dcb054a9853b"
    }
}

• Response:

{
    "id": "e7cbcfdc-8bfb-440f-8fc9-3e8bbadaf99d",
    "jsonrpc": "2.0",
    "result": {
        "deleted": "d0e641cf-d0e5-471c-a096-dcb054a9853b"
    }
}

Back

+ Download file