Description

This Notebook provides an example of using the EDC API to request laser ranging data. It is adapted from the examples at https://edc.dgfi.tum.de/en/api/doc/python/ .

Configuring the account to use laser ranging data from the EDC TUM service. You need an account, it can be created for free at https://edc.dgfi.tum.de/en/register/.

In [1]:
from getpass import getpass
url = 'https://edc.dgfi.tum.de/api/v1/'
username = 'jonglez' # Modify with your own username
password = getpass(prompt='Enter EDC API password for account {}'.format(username)) # You will get prompted for your password

Listing the satellites available in the service

In [2]:
import requests
import json

args = {}
""" required options """
args['username'] = username
args['password'] = password
args['action'] = 'list-satellites'

""" optional options """
args['status'] = 'present'

""" send request as method POST """
response = requests.post(url, data=args)

if response.status_code == 200:
	""" convert json string in python list """
	data = json.loads(response.text)
	print(json.dumps(data, indent=4, sort_keys=True))
else:
	print(response.status_code)
	print(response.text)
[
    {
        "bin_size": null,
        "ext": "a11",
        "norad_number": null,
        "np_indicator": "2",
        "satellite_id": "0000100",
        "satellite_name": "apollo11",
        "sic_code": "0100",
        "status": "present"
    },
    {
        "bin_size": null,
        "ext": "l17",
        "norad_number": null,
        "np_indicator": "2",
        "satellite_id": "0000101",
        "satellite_name": "luna17",
        "sic_code": "0101",
        "status": "present"
    },
    {
        "bin_size": null,
        "ext": "a14",
        "norad_number": null,
        "np_indicator": "2",
        "satellite_id": "0000102",
        "satellite_name": "apollo14",
        "sic_code": "0102",
        "status": "present"
    },
    {
        "bin_size": null,
        "ext": "a15",
        "norad_number": null,
        "np_indicator": "2",
        "satellite_id": "0000103",
        "satellite_name": "apollo15",
        "sic_code": "0103",
        "status": "present"
    },
    {
        "bin_size": null,
        "ext": "l21",
        "norad_number": null,
        "np_indicator": "2",
        "satellite_id": "0000104",
        "satellite_name": "luna21",
        "sic_code": "0104",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "env",
        "norad_number": "27386",
        "np_indicator": "3",
        "satellite_id": "0200901",
        "satellite_name": "envisat",
        "sic_code": "6179",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "lar",
        "norad_number": "27944",
        "np_indicator": "5",
        "satellite_id": "0304206",
        "satellite_name": "larets",
        "sic_code": "5557",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "102g",
        "norad_number": "29670",
        "np_indicator": "9",
        "satellite_id": "0606201",
        "satellite_name": "glonass102",
        "sic_code": "9102",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "103g",
        "norad_number": "29671",
        "np_indicator": "9",
        "satellite_id": "0606202",
        "satellite_name": "glonass103",
        "sic_code": "9103",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "tsx",
        "norad_number": "31698",
        "np_indicator": "1",
        "satellite_id": "0702601",
        "satellite_name": "terrasarx",
        "sic_code": "6201",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "106g",
        "norad_number": "32275",
        "np_indicator": "9",
        "satellite_id": "0705201",
        "satellite_name": "glonass106",
        "sic_code": "9106",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "105g",
        "norad_number": "32276",
        "np_indicator": "9",
        "satellite_id": "0705202",
        "satellite_name": "glonass105",
        "sic_code": "9105",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "107g",
        "norad_number": "32393",
        "np_indicator": "9",
        "satellite_id": "0706501",
        "satellite_name": "glonass107",
        "sic_code": "9107",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "109g",
        "norad_number": "32395",
        "np_indicator": "9",
        "satellite_id": "0706503",
        "satellite_name": "glonass109",
        "sic_code": "9109",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "ja2",
        "norad_number": "33105",
        "np_indicator": "3",
        "satellite_id": "0803201",
        "satellite_name": "jason2",
        "sic_code": "1025",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "116g",
        "norad_number": "36111",
        "np_indicator": "9",
        "satellite_id": "0907001",
        "satellite_name": "glonass116",
        "sic_code": "9116",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "117g",
        "norad_number": "36112",
        "np_indicator": "9",
        "satellite_id": "0907002",
        "satellite_name": "glonass117",
        "sic_code": "9117",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "118g",
        "norad_number": "36113",
        "np_indicator": "9",
        "satellite_id": "0907003",
        "satellite_name": "glonass118",
        "sic_code": "9118",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "cg1",
        "norad_number": "36287",
        "np_indicator": "9",
        "satellite_id": "1000101",
        "satellite_name": "compassg1",
        "sic_code": "2002",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "119g",
        "norad_number": "36400",
        "np_indicator": "9",
        "satellite_id": "1000701",
        "satellite_name": "glonass119",
        "sic_code": "9119",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "121g",
        "norad_number": "36401",
        "np_indicator": "9",
        "satellite_id": "1000702",
        "satellite_name": "glonass121",
        "sic_code": "9121",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "120g",
        "norad_number": "36402",
        "np_indicator": "9",
        "satellite_id": "1000703",
        "satellite_name": "glonass120",
        "sic_code": "9120",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "cry",
        "norad_number": "36508",
        "np_indicator": "3",
        "satellite_id": "1001301",
        "satellite_name": "cryosat2",
        "sic_code": "8006",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "tan",
        "norad_number": "36605",
        "np_indicator": "1",
        "satellite_id": "1003001",
        "satellite_name": "tandemx",
        "sic_code": "6202",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "122g",
        "norad_number": "37139",
        "np_indicator": "9",
        "satellite_id": "1004103",
        "satellite_name": "glonass122",
        "sic_code": "9122",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "qzs",
        "norad_number": "37158",
        "np_indicator": "9",
        "satellite_id": "1004501",
        "satellite_name": "qzs1",
        "sic_code": "1581",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "125g",
        "norad_number": "37372",
        "np_indicator": "9",
        "satellite_id": "1100901",
        "satellite_name": "glonass125",
        "sic_code": "9125",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "ci3",
        "norad_number": "37384",
        "np_indicator": "9",
        "satellite_id": "1101301",
        "satellite_name": "compassi3",
        "sic_code": "2003",
        "status": "present"
    },
    {
        "bin_size": "60",
        "ext": "rad",
        "norad_number": "37755",
        "np_indicator": "6",
        "satellite_id": "1103701",
        "satellite_name": "radioastro",
        "sic_code": "5559",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "h2a",
        "norad_number": "37781",
        "np_indicator": "5",
        "satellite_id": "1104301",
        "satellite_name": "hy2a",
        "sic_code": "2201",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "126g",
        "norad_number": "37829",
        "np_indicator": "9",
        "satellite_id": "1105501",
        "satellite_name": "glonass126",
        "sic_code": "9126",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g101",
        "norad_number": "37846",
        "np_indicator": "9",
        "satellite_id": "1106001",
        "satellite_name": "galileo101",
        "sic_code": "7101",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g102",
        "norad_number": "37847",
        "np_indicator": "9",
        "satellite_id": "1106002",
        "satellite_name": "galileo102",
        "sic_code": "7102",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "128g",
        "norad_number": "37867",
        "np_indicator": "9",
        "satellite_id": "1106401",
        "satellite_name": "glonass128",
        "sic_code": "9128",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "129g",
        "norad_number": "37868",
        "np_indicator": "9",
        "satellite_id": "1106402",
        "satellite_name": "glonass129",
        "sic_code": "9129",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "127g",
        "norad_number": "37869",
        "np_indicator": "9",
        "satellite_id": "1106403",
        "satellite_name": "glonass127",
        "sic_code": "9127",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "ci5",
        "norad_number": "37948",
        "np_indicator": "9",
        "satellite_id": "1107301",
        "satellite_name": "compassi5",
        "sic_code": "2005",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "las",
        "norad_number": "38077",
        "np_indicator": "5",
        "satellite_id": "1200601",
        "satellite_name": "lares",
        "sic_code": "5987",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "cm3",
        "norad_number": "38250",
        "np_indicator": "9",
        "satellite_id": "1201801",
        "satellite_name": "compassm3",
        "sic_code": "2004",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g103",
        "norad_number": "38857",
        "np_indicator": "9",
        "satellite_id": "1205501",
        "satellite_name": "galileo103",
        "sic_code": "7103",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g104",
        "norad_number": "38858",
        "np_indicator": "9",
        "satellite_id": "1205502",
        "satellite_name": "galileo104",
        "sic_code": "7104",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "s2c",
        "norad_number": "39068",
        "np_indicator": "3",
        "satellite_id": "1300301",
        "satellite_name": "stsat2c",
        "sic_code": "3804",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "sar",
        "norad_number": "39086",
        "np_indicator": "3",
        "satellite_id": "1300901",
        "satellite_name": "saral",
        "sic_code": "3201",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "131g",
        "norad_number": "39155",
        "np_indicator": "9",
        "satellite_id": "1301901",
        "satellite_name": "glonass131",
        "sic_code": "9131",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "i1a",
        "norad_number": "39199",
        "np_indicator": "9",
        "satellite_id": "1303401",
        "satellite_name": "irnss1a",
        "sic_code": "3301",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "kp5",
        "norad_number": "39227",
        "np_indicator": "1",
        "satellite_id": "1304201",
        "satellite_name": "kompsat5",
        "sic_code": "3803",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "swb",
        "norad_number": "39451",
        "np_indicator": "1",
        "satellite_id": "1306701",
        "satellite_name": "swarmb",
        "sic_code": "8008",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "swa",
        "norad_number": "39452",
        "np_indicator": "1",
        "satellite_id": "1306702",
        "satellite_name": "swarma",
        "sic_code": "8007",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "swc",
        "norad_number": "39453",
        "np_indicator": "1",
        "satellite_id": "1306703",
        "satellite_name": "swarmc",
        "sic_code": "8009",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "132g",
        "norad_number": "39620",
        "np_indicator": "9",
        "satellite_id": "1401201",
        "satellite_name": "glonass132",
        "sic_code": "9132",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "i1b",
        "norad_number": "39635",
        "np_indicator": "9",
        "satellite_id": "1401701",
        "satellite_name": "irnss1b",
        "sic_code": "3302",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "133g",
        "norad_number": "40001",
        "np_indicator": "9",
        "satellite_id": "1403201",
        "satellite_name": "glonass133",
        "sic_code": "9133",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g201",
        "norad_number": "40128",
        "np_indicator": "9",
        "satellite_id": "1405001",
        "satellite_name": "galileo201",
        "sic_code": "7201",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g202",
        "norad_number": "40129",
        "np_indicator": "9",
        "satellite_id": "1405002",
        "satellite_name": "galileo202",
        "sic_code": "7202",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "i1c",
        "norad_number": "40269",
        "np_indicator": "9",
        "satellite_id": "1406101",
        "satellite_name": "irnss1c",
        "sic_code": "3303",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "134g",
        "norad_number": "40315",
        "np_indicator": "9",
        "satellite_id": "1407501",
        "satellite_name": "glonass134",
        "sic_code": "9134",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g203",
        "norad_number": "40544",
        "np_indicator": "9",
        "satellite_id": "1501701",
        "satellite_name": "galileo203",
        "sic_code": "7203",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g204",
        "norad_number": "40545",
        "np_indicator": "9",
        "satellite_id": "1501702",
        "satellite_name": "galileo204",
        "sic_code": "7204",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "i1d",
        "norad_number": "40547",
        "np_indicator": "9",
        "satellite_id": "1501801",
        "satellite_name": "irnss1d",
        "sic_code": "3304",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "cis1",
        "norad_number": "40549",
        "np_indicator": "9",
        "satellite_id": "1501901",
        "satellite_name": "compassis1",
        "sic_code": "2006",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "cms2",
        "norad_number": "40748",
        "np_indicator": "9",
        "satellite_id": "1503701",
        "satellite_name": "compassms2",
        "sic_code": "2008",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "cms1",
        "norad_number": "40749",
        "np_indicator": "9",
        "satellite_id": "1503702",
        "satellite_name": "compassms1",
        "sic_code": "2007",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g205",
        "norad_number": "40889",
        "np_indicator": "9",
        "satellite_id": "1504501",
        "satellite_name": "galileo205",
        "sic_code": "7205",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g206",
        "norad_number": "40890",
        "np_indicator": "9",
        "satellite_id": "1504502",
        "satellite_name": "galileo206",
        "sic_code": "7206",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "pn1a",
        "norad_number": "40903",
        "np_indicator": "1",
        "satellite_id": "1504905",
        "satellite_name": "pn1a",
        "sic_code": "2203",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "cis2",
        "norad_number": "40938",
        "np_indicator": "9",
        "satellite_id": "1505301",
        "satellite_name": "compassis2",
        "sic_code": "2010",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g209",
        "norad_number": "41174",
        "np_indicator": "9",
        "satellite_id": "1507901",
        "satellite_name": "galileo209",
        "sic_code": "7209",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g208",
        "norad_number": "41175",
        "np_indicator": "9",
        "satellite_id": "1507902",
        "satellite_name": "galileo208",
        "sic_code": "7208",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "ja3",
        "norad_number": "41240",
        "np_indicator": "3",
        "satellite_id": "1600201",
        "satellite_name": "jason3",
        "sic_code": "4379",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "i1e",
        "norad_number": "41241",
        "np_indicator": "9",
        "satellite_id": "1600301",
        "satellite_name": "irnss1e",
        "sic_code": "3305",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "135g",
        "norad_number": "41330",
        "np_indicator": "9",
        "satellite_id": "1600801",
        "satellite_name": "glonass135",
        "sic_code": "9135",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "s3a",
        "norad_number": "41335",
        "np_indicator": "3",
        "satellite_id": "1601101",
        "satellite_name": "sentinel3a",
        "sic_code": "8010",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "i1f",
        "norad_number": "41384",
        "np_indicator": "9",
        "satellite_id": "1601501",
        "satellite_name": "irnss1f",
        "sic_code": "3306",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "c6b",
        "norad_number": "41434",
        "np_indicator": "9",
        "satellite_id": "1602101",
        "satellite_name": "compassi6b",
        "sic_code": "2012",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g211",
        "norad_number": "41549",
        "np_indicator": "9",
        "satellite_id": "1603001",
        "satellite_name": "galileo211",
        "sic_code": "7211",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g210",
        "norad_number": "41550",
        "np_indicator": "9",
        "satellite_id": "1603002",
        "satellite_name": "galileo210",
        "sic_code": "7210",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "136g",
        "norad_number": "41554",
        "np_indicator": "9",
        "satellite_id": "1603201",
        "satellite_name": "glonass136",
        "sic_code": "9136",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "gi2",
        "norad_number": "41579",
        "np_indicator": "5",
        "satellite_id": "1603401",
        "satellite_name": "geoik2",
        "sic_code": "5561",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "tg2",
        "norad_number": "41765",
        "np_indicator": "1",
        "satellite_id": "1605701",
        "satellite_name": "tiangong2",
        "sic_code": "2207",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g207",
        "norad_number": "41859",
        "np_indicator": "9",
        "satellite_id": "1606901",
        "satellite_name": "galileo207",
        "sic_code": "7207",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g212",
        "norad_number": "41860",
        "np_indicator": "9",
        "satellite_id": "1606902",
        "satellite_name": "galileo212",
        "sic_code": "7212",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g213",
        "norad_number": "41861",
        "np_indicator": "9",
        "satellite_id": "1606903",
        "satellite_name": "galileo213",
        "sic_code": "7213",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g214",
        "norad_number": "41862",
        "np_indicator": "9",
        "satellite_id": "1606904",
        "satellite_name": "galileo214",
        "sic_code": "7214",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "qz2",
        "norad_number": "42738",
        "np_indicator": "9",
        "satellite_id": "1702801",
        "satellite_name": "qzs2",
        "sic_code": "1582",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "tec",
        "norad_number": "42829",
        "np_indicator": "3",
        "satellite_id": "1704205",
        "satellite_name": "technosat",
        "sic_code": "6203",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "qz3",
        "norad_number": "42917",
        "np_indicator": "9",
        "satellite_id": "1704801",
        "satellite_name": "qzs3",
        "sic_code": "1583",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "137g",
        "norad_number": "42939",
        "np_indicator": "9",
        "satellite_id": "1705501",
        "satellite_name": "glonass137",
        "sic_code": "9137",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "qz4",
        "norad_number": "42965",
        "np_indicator": "9",
        "satellite_id": "1706201",
        "satellite_name": "qzs4",
        "sic_code": "1584",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "b3m1",
        "norad_number": "43001",
        "np_indicator": "9",
        "satellite_id": "1706901",
        "satellite_name": "beidou3m1",
        "sic_code": "2013",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "b3m2",
        "norad_number": "43002",
        "np_indicator": "9",
        "satellite_id": "1706902",
        "satellite_name": "beidou3m2",
        "sic_code": "2014",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "che",
        "norad_number": "43044",
        "np_indicator": "3",
        "satellite_id": "1707108",
        "satellite_name": "chefsat",
        "sic_code": "1079",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g215",
        "norad_number": "43055",
        "np_indicator": "9",
        "satellite_id": "1707901",
        "satellite_name": "galileo215",
        "sic_code": "7215",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g216",
        "norad_number": "43056",
        "np_indicator": "9",
        "satellite_id": "1707902",
        "satellite_name": "galileo216",
        "sic_code": "7216",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g217",
        "norad_number": "43057",
        "np_indicator": "9",
        "satellite_id": "1707903",
        "satellite_name": "galileo217",
        "sic_code": "7217",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g218",
        "norad_number": "43058",
        "np_indicator": "9",
        "satellite_id": "1707904",
        "satellite_name": "galileo218",
        "sic_code": "7218",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "sn2",
        "norad_number": "43186",
        "np_indicator": "1",
        "satellite_id": "1801407",
        "satellite_name": "snet2",
        "sic_code": "6205",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "sn3",
        "norad_number": "43187",
        "np_indicator": "1",
        "satellite_id": "1801408",
        "satellite_name": "snet3",
        "sic_code": "6206",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "sn4",
        "norad_number": "43188",
        "np_indicator": "1",
        "satellite_id": "1801409",
        "satellite_name": "snet4",
        "sic_code": "6207",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "sn1",
        "norad_number": "43189",
        "np_indicator": "1",
        "satellite_id": "1801410",
        "satellite_name": "snet1",
        "sic_code": "6204",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "b3m3",
        "norad_number": "43208",
        "np_indicator": "9",
        "satellite_id": "1801802",
        "satellite_name": "beidou3m3",
        "sic_code": "2015",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "paz",
        "norad_number": "43215",
        "np_indicator": "1",
        "satellite_id": "1802001",
        "satellite_name": "paz",
        "sic_code": "2501",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "b3m9",
        "norad_number": "43245",
        "np_indicator": "9",
        "satellite_id": "1802901",
        "satellite_name": "beidou3m9",
        "sic_code": "2019",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "bm10",
        "norad_number": "43246",
        "np_indicator": "9",
        "satellite_id": "1802902",
        "satellite_name": "beidou3m10",
        "sic_code": "2020",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "i1i",
        "norad_number": "43286",
        "np_indicator": "9",
        "satellite_id": "1803501",
        "satellite_name": "irnss1i",
        "sic_code": "3309",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "s3b",
        "norad_number": "43437",
        "np_indicator": "3",
        "satellite_id": "1803901",
        "satellite_name": "sentinel3b",
        "sic_code": "8011",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "gf1",
        "norad_number": "43476",
        "np_indicator": "1",
        "satellite_id": "1804701",
        "satellite_name": "gracefo1",
        "sic_code": "0123",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "gf2",
        "norad_number": "43477",
        "np_indicator": "1",
        "satellite_id": "1804702",
        "satellite_name": "gracefo2",
        "sic_code": "0124",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "138g",
        "norad_number": "43508",
        "np_indicator": "9",
        "satellite_id": "1805301",
        "satellite_name": "glonass138",
        "sic_code": "9138",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g221",
        "norad_number": "43564",
        "np_indicator": "9",
        "satellite_id": "1806001",
        "satellite_name": "galileo221",
        "sic_code": "7221",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g222",
        "norad_number": "43565",
        "np_indicator": "9",
        "satellite_id": "1806002",
        "satellite_name": "galileo222",
        "sic_code": "7222",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g219",
        "norad_number": "43566",
        "np_indicator": "9",
        "satellite_id": "1806003",
        "satellite_name": "galileo219",
        "sic_code": "7219",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "g220",
        "norad_number": "43567",
        "np_indicator": "9",
        "satellite_id": "1806004",
        "satellite_name": "galileo220",
        "sic_code": "7220",
        "status": "present"
    },
    {
        "bin_size": "5",
        "ext": "ice2",
        "norad_number": "43613",
        "np_indicator": "1",
        "satellite_id": "1807001",
        "satellite_name": "icesat2",
        "sic_code": "6873",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "h2b",
        "norad_number": "43655",
        "np_indicator": "5",
        "satellite_id": "1808101",
        "satellite_name": "hy2b",
        "sic_code": "2208",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "139g",
        "norad_number": "43687",
        "np_indicator": "9",
        "satellite_id": "1808601",
        "satellite_name": "glonass139",
        "sic_code": "9139",
        "status": "present"
    },
    {
        "bin_size": "15",
        "ext": "bec",
        "norad_number": "1328",
        "np_indicator": "3",
        "satellite_id": "6503201",
        "satellite_name": "beaconc",
        "sic_code": "0317",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "sta",
        "norad_number": "7646",
        "np_indicator": "5",
        "satellite_id": "7501001",
        "satellite_name": "starlette",
        "sic_code": "1134",
        "status": "present"
    },
    {
        "bin_size": "120",
        "ext": "la1",
        "norad_number": "8820",
        "np_indicator": "7",
        "satellite_id": "7603901",
        "satellite_name": "lageos1",
        "sic_code": "1155",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "aji",
        "norad_number": "16908",
        "np_indicator": "5",
        "satellite_id": "8606101",
        "satellite_name": "ajisai",
        "sic_code": "1500",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "et1",
        "norad_number": "19751",
        "np_indicator": "9",
        "satellite_id": "8900103",
        "satellite_name": "etalon1",
        "sic_code": "0525",
        "status": "present"
    },
    {
        "bin_size": "300",
        "ext": "et2",
        "norad_number": "20026",
        "np_indicator": "9",
        "satellite_id": "8903903",
        "satellite_name": "etalon2",
        "sic_code": "4146",
        "status": "present"
    },
    {
        "bin_size": "120",
        "ext": "la2",
        "norad_number": "22195",
        "np_indicator": "7",
        "satellite_id": "9207002",
        "satellite_name": "lageos2",
        "sic_code": "5986",
        "status": "present"
    },
    {
        "bin_size": "30",
        "ext": "ste",
        "norad_number": "22824",
        "np_indicator": "5",
        "satellite_id": "9306102",
        "satellite_name": "stella",
        "sic_code": "0643",
        "status": "present"
    }
]

Getting information about Technosat, which bears the COSPAR ID 1704205. See the available satellites at https://edc.dgfi.tum.de/en/satellites/, or in the JSON list printed above.

In [3]:
cosparId = '1704205' 

args = {}
""" required options """
args['username'] = username
args['password'] = password
args['action'] = 'satellite-info'

""" optional options """
args['satellite_id'] = cosparId
#args['satellite_name'] = 'technosat'

""" send request as method POST """
response = requests.post(url, data=args)

if response.status_code == 200:
	""" convert json string in python list """
	data = json.loads(response.text)	
	for key in data.keys():
		print(key,':',data[key])
else:
	print(response.status_code)
	print(response.text)
status : present
np_indicator : 3
satellite_name : technosat
end_date : None
bin_size : 15
nice_name : Technosat
start_date : None
satellite_id : 1704205
ext : tec
launch_date : 2017-07-14
sic_code : 6203
norad_number : 42829
decay_date : None

Listing the ground stations.

In [4]:
args = {}
""" required options """
args['username'] = username
args['password'] = password
args['action'] = 'list-stations'

""" optional options """
args['active'] = 'yes'

""" send request as method POST """
response = requests.post(url, data=args)

if response.status_code == 200:
	""" convert json string in python list """
	data = json.loads(response.text)
	print(json.dumps(data, indent=4, sort_keys=True))
else:
	print(response.status_code)
	print(response.text)
[
    {
        "active": "yes",
        "code": "GLSL",
        "datacenter": "EDC",
        "latitude": "50.3633",
        "longitude": "30.4961",
        "site": "Golosiiv, Ukraine",
        "station_id": "1824"
    },
    {
        "active": "yes",
        "code": "MAIL",
        "datacenter": "EDC",
        "latitude": "38.6849",
        "longitude": "66.94309",
        "site": "Maidanak 1, Uzbekistan",
        "station_id": "1864"
    },
    {
        "active": "yes",
        "code": "KOML",
        "datacenter": "EDC",
        "latitude": "50.69461",
        "longitude": "136.74383",
        "site": "Komsomolsk-na-Amure, Russia",
        "station_id": "1868"
    },
    {
        "active": "yes",
        "code": "SIML",
        "datacenter": "EDC",
        "latitude": "44.4128",
        "longitude": "33.9931",
        "site": "Simeiz, Ukraine",
        "station_id": "1873"
    },
    {
        "active": "yes",
        "code": "MDVS",
        "datacenter": "EDC",
        "latitude": "56.0277",
        "longitude": "37.2249",
        "site": "Mendeleevo 2, Russia",
        "station_id": "1874"
    },
    {
        "active": "yes",
        "code": "ALTL",
        "datacenter": "EDC",
        "latitude": "51.2",
        "longitude": "82.3",
        "site": "Altay, Russia",
        "station_id": "1879"
    },
    {
        "active": "yes",
        "code": "RIGL",
        "datacenter": "EDC",
        "latitude": "56.948551",
        "longitude": "24.059075",
        "site": "Riga, Latvia",
        "station_id": "1884"
    },
    {
        "active": "yes",
        "code": "ARKL",
        "datacenter": "EDC",
        "latitude": "43.6500",
        "longitude": "41.4333",
        "site": "Arkhyz, Russia",
        "station_id": "1886"
    },
    {
        "active": "yes",
        "code": "BAIL",
        "datacenter": "EDC",
        "latitude": "45.7047",
        "longitude": "63.3422",
        "site": "Baikonur, Kazakhstan",
        "station_id": "1887"
    },
    {
        "active": "yes",
        "code": "SVEL",
        "datacenter": "EDC",
        "latitude": "60.5332",
        "longitude": "29.7805",
        "site": "Svetloe, Russia",
        "station_id": "1888"
    },
    {
        "active": "yes",
        "code": "ZELL",
        "datacenter": "EDC",
        "latitude": "43.7887",
        "longitude": "41.5654",
        "site": "Zelenchukskya, Russia",
        "station_id": "1889"
    },
    {
        "active": "yes",
        "code": "BADL",
        "datacenter": "EDC",
        "latitude": "51.7700",
        "longitude": "102.2354",
        "site": "Badary, Russia",
        "station_id": "1890"
    },
    {
        "active": "yes",
        "code": "IRKL",
        "datacenter": "EDC",
        "latitude": "52.2191",
        "longitude": "104.3164",
        "site": "Irkutsk, Russia",
        "station_id": "1891"
    },
    {
        "active": "yes",
        "code": "KTZL",
        "datacenter": "EDC",
        "latitude": "44.3932",
        "longitude": "33.9701",
        "site": "Katzively, Ukraine",
        "station_id": "1893"
    },
    {
        "active": "yes",
        "code": "APOL",
        "datacenter": "CDDIS",
        "latitude": "32.780361",
        "longitude": "-105.820417",
        "site": "Apache Point, NM",
        "station_id": "7045"
    },
    {
        "active": "yes",
        "code": "MDOL",
        "datacenter": "CDDIS",
        "latitude": "30.6802",
        "longitude": "255.9848",
        "site": "McDonald Observatory, Texas",
        "station_id": "7080"
    },
    {
        "active": "yes",
        "code": "YARL",
        "datacenter": "CDDIS",
        "latitude": "-29.0464",
        "longitude": "115.3467",
        "site": "Yarragadee, Australia",
        "station_id": "7090"
    },
    {
        "active": "yes",
        "code": "GODL",
        "datacenter": "CDDIS",
        "latitude": "39.0206",
        "longitude": "-76.82770",
        "site": "Greenbelt, Maryland",
        "station_id": "7105"
    },
    {
        "active": "yes",
        "code": "MONL",
        "datacenter": "CDDIS",
        "latitude": "32.8917",
        "longitude": "243.5773",
        "site": "Monument Peak, California",
        "station_id": "7110"
    },
    {
        "active": "yes",
        "code": "HA4T",
        "datacenter": "CDDIS",
        "latitude": "20.706486",
        "longitude": "203.743084",
        "site": "Haleakala, Hawaii",
        "station_id": "7119"
    },
    {
        "active": "yes",
        "code": "THTL",
        "datacenter": "CDDIS",
        "latitude": "-17.5768",
        "longitude": "210.3937",
        "site": "Tahiti, French Polynesia",
        "station_id": "7124"
    },
    {
        "active": "yes",
        "code": "WUHL",
        "datacenter": "CDDIS",
        "latitude": "39.0202692",
        "longitude": "283.1725524",
        "site": "Wuhan, China",
        "station_id": "7231"
    },
    {
        "active": "yes",
        "code": "CHAL",
        "datacenter": "EDC",
        "latitude": "43.7905",
        "longitude": "125.4433",
        "site": "Changchun, China",
        "station_id": "7237"
    },
    {
        "active": "yes",
        "code": "BEIL",
        "datacenter": "EDC",
        "latitude": "39.6069",
        "longitude": "115.8920",
        "site": "Beijing, China",
        "station_id": "7249"
    },
    {
        "active": "yes",
        "code": "KOGC",
        "datacenter": "CDDIS",
        "latitude": "35.710",
        "longitude": "139.489",
        "site": "Koganei, Japan (CRL)",
        "station_id": "7308"
    },
    {
        "active": "yes",
        "code": "GMSL",
        "datacenter": "CDDIS",
        "latitude": "30.556513",
        "longitude": "131.015412",
        "site": "Tanegashima, Japan",
        "station_id": "7358"
    },
    {
        "active": "yes",
        "code": "SEJL",
        "datacenter": "EDC",
        "latitude": "36.5210",
        "longitude": "127.3029",
        "site": "Sejong City, Republic of Korea",
        "station_id": "7394"
    },
    {
        "active": "yes",
        "code": "GEOL",
        "datacenter": "EDC",
        "latitude": "35.5902",
        "longitude": "127.9201",
        "site": "Geochang, Republic of Korea",
        "station_id": "7395"
    },
    {
        "active": "yes",
        "code": "AREL",
        "datacenter": "CDDIS",
        "latitude": "-16.4657",
        "longitude": "-71.4930",
        "site": "Arequipa, Peru",
        "station_id": "7403"
    },
    {
        "active": "yes",
        "code": "SJUL",
        "datacenter": "EDC",
        "latitude": "-31.5086249",
        "longitude": "-68.6231602",
        "site": "San Juan, Argentina",
        "station_id": "7406"
    },
    {
        "active": "yes",
        "code": "BRAL",
        "datacenter": "EDC",
        "latitude": "-15.7731",
        "longitude": "-47.8653",
        "site": "Brasilia, Brazil",
        "station_id": "7407"
    },
    {
        "active": "yes",
        "code": "HARL",
        "datacenter": "CDDIS",
        "latitude": "-25.8897",
        "longitude": "27.6861",
        "site": "Hartebeesthoek, South Africa",
        "station_id": "7501"
    },
    {
        "active": "yes",
        "code": "HRTL",
        "datacenter": "EDC",
        "latitude": "-25.8892",
        "longitude": "27.6861",
        "site": "Hartebeesthoek, South Africa",
        "station_id": "7503"
    },
    {
        "active": "yes",
        "code": "METL",
        "datacenter": "CDDIS",
        "latitude": "60.2172",
        "longitude": "24.3946",
        "site": "Metsahovi, Finland",
        "station_id": "7806"
    },
    {
        "active": "yes",
        "code": "ZIML",
        "datacenter": "EDC",
        "latitude": "46.8772",
        "longitude": "7.4652",
        "site": "Zimmerwald, Switzerland",
        "station_id": "7810"
    },
    {
        "active": "yes",
        "code": "BORL",
        "datacenter": "EDC",
        "latitude": "52.2770",
        "longitude": "17.0746",
        "site": "Borowiec, Poland",
        "station_id": "7811"
    },
    {
        "active": "yes",
        "code": "UROL",
        "datacenter": "EDC",
        "latitude": "48.7824",
        "longitude": "9.1964",
        "site": "Stuttgart, Germany",
        "station_id": "7816"
    },
    {
        "active": "yes",
        "code": "KUN2",
        "datacenter": "EDC",
        "latitude": "25.0298",
        "longitude": "102.7977",
        "site": "Kunming, China",
        "station_id": "7819"
    },
    {
        "active": "yes",
        "code": "KUNL",
        "datacenter": "EDC",
        "latitude": "25.0299",
        "longitude": "102.7972",
        "site": "Kunming, China",
        "station_id": "7820"
    },
    {
        "active": "yes",
        "code": "SHA2",
        "datacenter": "EDC",
        "latitude": "31.0961",
        "longitude": "121.1866",
        "site": "Shanghai, China",
        "station_id": "7821"
    },
    {
        "active": "yes",
        "code": "SFEL",
        "datacenter": "EDC",
        "latitude": "36.4650",
        "longitude": "-6.2055",
        "site": "San Fernando, Spain",
        "station_id": "7824"
    },
    {
        "active": "yes",
        "code": "STL3",
        "datacenter": "EDC",
        "latitude": "-35.3161",
        "longitude": "149.0099",
        "site": "Mt Stromlo, Australia",
        "station_id": "7825"
    },
    {
        "active": "yes",
        "code": "SOSW",
        "datacenter": "EDC",
        "latitude": "49.1449402",
        "longitude": "14.87810000",
        "site": "Wettzell, Germany (SOSW)",
        "station_id": "7827"
    },
    {
        "active": "yes",
        "code": "HLWL",
        "datacenter": "EDC",
        "latitude": "31.3427",
        "longitude": "29.8590",
        "site": "Helwan, Egypt",
        "station_id": "7831"
    },
    {
        "active": "yes",
        "code": "RIYL",
        "datacenter": "EDC",
        "latitude": "24.9102",
        "longitude": "46.4004",
        "site": "Riyadh, Saudi Arabia",
        "station_id": "7832"
    },
    {
        "active": "yes",
        "code": "SHAL",
        "datacenter": "CDDIS",
        "latitude": "31.0975",
        "longitude": "121.1917",
        "site": "Shanghai, China",
        "station_id": "7837"
    },
    {
        "active": "yes",
        "code": "SISL",
        "datacenter": "CDDIS",
        "latitude": "33.5777",
        "longitude": "135.9370",
        "site": "Simosato, Japan",
        "station_id": "7838"
    },
    {
        "active": "yes",
        "code": "GRZL",
        "datacenter": "EDC",
        "latitude": "47.0678",
        "longitude": "15.4942",
        "site": "Graz, Austria",
        "station_id": "7839"
    },
    {
        "active": "yes",
        "code": "HERL",
        "datacenter": "EDC",
        "latitude": "50.8674",
        "longitude": "0.3361",
        "site": "Herstmonceux, United Kingdom",
        "station_id": "7840"
    },
    {
        "active": "yes",
        "code": "POT3",
        "datacenter": "EDC",
        "latitude": "52.3800",
        "longitude": "13.0649",
        "site": "Potsdam, Germany",
        "station_id": "7841"
    },
    {
        "active": "yes",
        "code": "GRSM",
        "datacenter": "EDC",
        "latitude": "43.7546",
        "longitude": "6.9216",
        "site": "Grasse, France (LLR)",
        "station_id": "7845"
    },
    {
        "active": "yes",
        "code": "MATM",
        "datacenter": "EDC",
        "latitude": "40.6486",
        "longitude": "16.7046",
        "site": "Matera, Italy (MLRO)",
        "station_id": "7941"
    },
    {
        "active": "yes",
        "code": "WETL",
        "datacenter": "EDC",
        "latitude": "49.1444",
        "longitude": "12.8780",
        "site": "Wettzell, Germany (WLRS)",
        "station_id": "8834"
    }
]

Getting detailed information about a ground station

In [5]:
args = {}
""" required options """
args['username'] = username
args['password'] = password
args['action'] = 'station-info'
args['station_id'] = '7080'

""" send request as method POST """
response = requests.post(url, data=args)

if response.status_code == 200:
	""" convert json string in python list """
	data = json.loads(response.text)	
	for key in data.keys():
		print(key,':',data[key])
else:
	print(response.status_code)
	print(response.text)
datacenter : CDDIS
code : MDOL
longitude : 255.9848
site : McDonald Observatory, Texas
station_id : 7080
latitude : 30.6802
secondary_name : Anthony Garcia
primary_name : Jerry Wiant
secondary_mail : anthg@utexas.edu
primary_mail : jerryrw@utexas.edu
active : yes

Searching for datasets corresponding to the user criteria, from December 1st 2018 to December 9th 2018. In this case, the Normal Point Data (NPT) is requested. More information on the different data formats for laser ranging: https://edc.dgfi.tum.de/en/data/

In [6]:
args = {}
""" required options """
args['username'] = username
args['password'] = password
args['action'] = 'data-query'
args['data_type'] = 'NPT' # Normal pointing data

""" optional options """
args['start_data_date'] = '2018-12-0%'
args['end_data_date'] = '2018-12-0%'
args['satellite'] = cosparId
#args['provider'] = 'COD'
#args['station'] = '78403501'

""" send request as method POST """
response = requests.post(url, data=args)

if response.status_code == 200:
	""" convert json string in python list """
	data = json.loads(response.text)
	print(json.dumps(data, indent=4, sort_keys=True))
else:
	print(response.status_code)
	print(response.text)
[
    {
        "end_data_date": "2018-12-01 12:39:55",
        "errors": "",
        "id": "1790842",
        "incoming_date": "2018-12-02 23:24:34",
        "incoming_filename": "7825_technosat_20181201_12_00.NPT",
        "observations": "6",
        "satellite": "1704205",
        "start_data_date": "2018-12-01 12:35:00",
        "station": "78259001",
        "status": "valid",
        "version": "00",
        "wavelength": "532.10"
    },
    {
        "end_data_date": "2018-12-01 13:53:35",
        "errors": "",
        "id": "1790375",
        "incoming_date": "2018-12-01 14:02:16",
        "incoming_filename": "7237_technosat_crd_20181201_13_00.npt",
        "observations": "7",
        "satellite": "1704205",
        "start_data_date": "2018-12-01 13:51:00",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-01 14:12:12",
        "errors": "",
        "id": "1790437",
        "incoming_date": "2018-12-01 17:24:02",
        "incoming_filename": "nasa_201812011700.npt",
        "observations": "14",
        "satellite": "1704205",
        "start_data_date": "2018-12-01 14:08:45",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-01 15:29:34",
        "errors": "",
        "id": "1790407",
        "incoming_date": "2018-12-01 15:48:40",
        "incoming_filename": "7237_technosat_crd_20181201_15_00.npt",
        "observations": "6",
        "satellite": "1704205",
        "start_data_date": "2018-12-01 15:28:28",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-01 15:37:00",
        "errors": "",
        "id": "1790537",
        "incoming_date": "2018-12-01 20:40:52",
        "incoming_filename": "7819_technosat_crd_20181201_15_00.npt",
        "observations": "2",
        "satellite": "1704205",
        "start_data_date": "2018-12-01 15:30:00",
        "station": "78198201",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-02 03:36:52",
        "errors": "",
        "id": "1790626",
        "incoming_date": "2018-12-02 05:24:02",
        "incoming_filename": "nasa_201812020500.npt",
        "observations": "5",
        "satellite": "1704205",
        "start_data_date": "2018-12-02 03:35:49",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-02 13:00:00",
        "errors": "",
        "id": "1790931",
        "incoming_date": "2018-12-03 05:58:34",
        "incoming_filename": "7825_technosat_20181202_12_00.NPT",
        "observations": "2",
        "satellite": "1704205",
        "start_data_date": "2018-12-02 12:43:20",
        "station": "78259001",
        "status": "valid",
        "version": "00",
        "wavelength": "532.10"
    },
    {
        "end_data_date": "2018-12-02 14:20:36",
        "errors": "",
        "id": "1790723",
        "incoming_date": "2018-12-02 17:24:02",
        "incoming_filename": "nasa_201812021700.npt",
        "observations": "6",
        "satellite": "1704205",
        "start_data_date": "2018-12-02 14:19:20",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-02 14:23:52",
        "errors": "",
        "id": "1790725",
        "incoming_date": "2018-12-02 17:24:02",
        "incoming_filename": "nasa_201812021700.npt",
        "observations": "5",
        "satellite": "1704205",
        "start_data_date": "2018-12-02 14:22:48",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-03 12:58:31",
        "errors": "",
        "id": "1791186",
        "incoming_date": "2018-12-04 02:28:41",
        "incoming_filename": "7825_technosat_20181203_12_00.NPT",
        "observations": "2",
        "satellite": "1704205",
        "start_data_date": "2018-12-03 12:54:00",
        "station": "78259001",
        "status": "valid",
        "version": "00",
        "wavelength": "532.10"
    },
    {
        "end_data_date": "2018-12-03 14:12:26",
        "errors": "",
        "id": "1790990",
        "incoming_date": "2018-12-03 14:17:57",
        "incoming_filename": "7237_technosat_crd_20181203_14_00.npt",
        "observations": "10",
        "satellite": "1704205",
        "start_data_date": "2018-12-03 14:10:10",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 03:08:35",
        "errors": "",
        "id": "1791269",
        "incoming_date": "2018-12-04 07:24:02",
        "incoming_filename": "nasa_201812040700.npt",
        "observations": "7",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 03:07:11",
        "station": "71050725",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 03:57:52",
        "errors": "",
        "id": "1791266",
        "incoming_date": "2018-12-04 06:24:02",
        "incoming_filename": "nasa_201812040600.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 03:57:13",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 04:45:15",
        "errors": "",
        "id": "1791330",
        "incoming_date": "2018-12-04 09:24:03",
        "incoming_filename": "nasa_201812040900.npt",
        "observations": "21",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 04:39:47",
        "station": "71050725",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 10:46:00",
        "errors": "",
        "id": "1791431",
        "incoming_date": "2018-12-04 12:45:57",
        "incoming_filename": "7840_technosat_crd_20181204_10_00.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 10:45:07",
        "station": "78403501",
        "status": "valid",
        "version": "00",
        "wavelength": "532.080"
    },
    {
        "end_data_date": "2018-12-04 14:21:51",
        "errors": "",
        "id": "1791604",
        "incoming_date": "2018-12-04 17:51:18",
        "incoming_filename": "7237_technosat_crd_20181204_14_00.npt",
        "observations": "11",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 14:19:22",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 14:43:54",
        "errors": "",
        "id": "1791578",
        "incoming_date": "2018-12-04 17:24:02",
        "incoming_filename": "nasa_201812041700.npt",
        "observations": "9",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 14:38:40",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 15:57:45",
        "errors": "",
        "id": "1791605",
        "incoming_date": "2018-12-04 17:51:16",
        "incoming_filename": "7237_technosat_crd_20181204_15_00.npt",
        "observations": "5",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 15:56:39",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 21:08:41",
        "errors": "",
        "id": "1791732",
        "incoming_date": "2018-12-05 02:24:02",
        "incoming_filename": "nasa_201812050200.npt",
        "observations": "5",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 21:05:06",
        "station": "75010602",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-04 22:25:28",
        "errors": "",
        "id": "1791829",
        "incoming_date": "2018-12-05 06:32:48",
        "incoming_filename": "7827_technosat_crd_20181204_2221_00.npt",
        "observations": "6",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 22:22:43",
        "station": "78272201",
        "status": "valid",
        "version": "00",
        "wavelength": "849.800"
    },
    {
        "end_data_date": "2018-12-04 22:23:51",
        "errors": "",
        "id": "1791663",
        "incoming_date": "2018-12-04 22:30:12",
        "incoming_filename": "7811_technosat_crd_20181204_22_00.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-04 22:23:06",
        "station": "78113802",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-05 03:32:13",
        "errors": "",
        "id": "1791841",
        "incoming_date": "2018-12-05 07:24:02",
        "incoming_filename": "nasa_201812050700.npt",
        "observations": "6",
        "satellite": "1704205",
        "start_data_date": "2018-12-05 03:30:07",
        "station": "74031306",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-05 04:55:39",
        "errors": "",
        "id": "1791886",
        "incoming_date": "2018-12-05 08:24:02",
        "incoming_filename": "nasa_201812050800.npt",
        "observations": "21",
        "satellite": "1704205",
        "start_data_date": "2018-12-05 04:49:00",
        "station": "71050725",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-05 09:19:05",
        "errors": "",
        "id": "1791898",
        "incoming_date": "2018-12-05 09:30:47",
        "incoming_filename": "8834_technosat_crd_20181205_09_00.det1.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-05 09:18:28",
        "station": "88341001",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-05 14:50:00",
        "errors": "",
        "id": "1792133",
        "incoming_date": "2018-12-05 17:24:02",
        "incoming_filename": "nasa_201812051700.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-05 14:49:18",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-05 22:33:24",
        "errors": "",
        "id": "1792198",
        "incoming_date": "2018-12-05 23:25:10",
        "incoming_filename": "7941_technosat_crd_20181205_2232_00.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-05 22:32:33",
        "station": "79417701",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-06 01:04:39",
        "errors": "",
        "id": "1794086",
        "incoming_date": "2018-12-10 03:48:14",
        "incoming_filename": "7825_technosat_20181206_00_00.NPT",
        "observations": "5",
        "satellite": "1704205",
        "start_data_date": "2018-12-06 00:58:26",
        "station": "78259001",
        "status": "valid",
        "version": "00",
        "wavelength": "532.10"
    },
    {
        "end_data_date": "2018-12-06 03:28:30",
        "errors": "",
        "id": "1792283",
        "incoming_date": "2018-12-06 07:24:02",
        "incoming_filename": "nasa_201812060700.npt",
        "observations": "21",
        "satellite": "1704205",
        "start_data_date": "2018-12-06 03:23:30",
        "station": "71050725",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-06 03:41:45",
        "errors": "",
        "id": "1792276",
        "incoming_date": "2018-12-06 07:24:02",
        "incoming_filename": "nasa_201812060700.npt",
        "observations": "5",
        "satellite": "1704205",
        "start_data_date": "2018-12-06 03:38:37",
        "station": "74031306",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-06 11:51:29",
        "errors": "",
        "id": "1794087",
        "incoming_date": "2018-12-10 03:48:16",
        "incoming_filename": "7825_technosat_20181206_11_00.NPT",
        "observations": "2",
        "satellite": "1704205",
        "start_data_date": "2018-12-06 11:46:58",
        "station": "78259001",
        "status": "valid",
        "version": "00",
        "wavelength": "532.10"
    },
    {
        "end_data_date": "2018-12-06 14:41:46",
        "errors": "",
        "id": "1792696",
        "incoming_date": "2018-12-06 22:02:50",
        "incoming_filename": "7237_technosat_crd_20181206_14_00.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-06 14:40:39",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-06 15:01:41",
        "errors": "",
        "id": "1792540",
        "incoming_date": "2018-12-06 17:24:02",
        "incoming_filename": "nasa_201812061700.npt",
        "observations": "6",
        "satellite": "1704205",
        "start_data_date": "2018-12-06 15:00:25",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-07 01:14:00",
        "errors": "",
        "id": "1794088",
        "incoming_date": "2018-12-10 03:48:18",
        "incoming_filename": "7825_technosat_20181207_01_00.NPT",
        "observations": "7",
        "satellite": "1704205",
        "start_data_date": "2018-12-07 01:08:03",
        "station": "78259001",
        "status": "valid",
        "version": "00",
        "wavelength": "532.10"
    },
    {
        "end_data_date": "2018-12-07 02:50:30",
        "errors": "",
        "id": "1792786",
        "incoming_date": "2018-12-07 06:24:02",
        "incoming_filename": "nasa_201812070600.npt",
        "observations": "6",
        "satellite": "1704205",
        "start_data_date": "2018-12-07 02:49:22",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-07 13:34:56",
        "errors": "",
        "id": "1793010",
        "incoming_date": "2018-12-07 16:24:02",
        "incoming_filename": "nasa_201812071600.npt",
        "observations": "3",
        "satellite": "1704205",
        "start_data_date": "2018-12-07 13:34:16",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-07 14:27:02",
        "errors": "",
        "id": "1793069",
        "incoming_date": "2018-12-07 18:24:03",
        "incoming_filename": "nasa_201812071800.npt",
        "observations": "5",
        "satellite": "1704205",
        "start_data_date": "2018-12-07 14:24:59",
        "station": "71050725",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-07 14:50:09",
        "errors": "",
        "id": "1792992",
        "incoming_date": "2018-12-07 15:47:39",
        "incoming_filename": "7237_technosat_crd_20181207_14_00.npt",
        "observations": "4",
        "satellite": "1704205",
        "start_data_date": "2018-12-07 14:49:08",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-07 15:13:17",
        "errors": "",
        "id": "1793055",
        "incoming_date": "2018-12-07 18:24:03",
        "incoming_filename": "nasa_201812071800.npt",
        "observations": "22",
        "satellite": "1704205",
        "start_data_date": "2018-12-07 15:06:49",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-07 22:51:28",
        "errors": "",
        "id": "1793214",
        "incoming_date": "2018-12-08 01:36:35",
        "incoming_filename": "7840_technosat_crd_20181207_22_00.npt",
        "observations": "7",
        "satellite": "1704205",
        "start_data_date": "2018-12-07 22:49:52",
        "station": "78403501",
        "status": "valid",
        "version": "00",
        "wavelength": "532.080"
    },
    {
        "end_data_date": "2018-12-08 03:02:00",
        "errors": "",
        "id": "1793299",
        "incoming_date": "2018-12-08 06:24:02",
        "incoming_filename": "nasa_201812080600.npt",
        "observations": "12",
        "satellite": "1704205",
        "start_data_date": "2018-12-08 02:58:21",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-08 09:49:33",
        "errors": "",
        "id": "1793390",
        "incoming_date": "2018-12-08 10:37:05",
        "incoming_filename": "7840_technosat_crd_20181208_09_00.npt",
        "observations": "13",
        "satellite": "1704205",
        "start_data_date": "2018-12-08 09:46:13",
        "station": "78403501",
        "status": "valid",
        "version": "00",
        "wavelength": "532.080"
    },
    {
        "end_data_date": "2018-12-08 15:02:56",
        "errors": "",
        "id": "1793468",
        "incoming_date": "2018-12-08 16:04:31",
        "incoming_filename": "7237_technosat_crd_20181208_14_00.npt",
        "observations": "15",
        "satellite": "1704205",
        "start_data_date": "2018-12-08 14:58:09",
        "station": "72371901",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-09 13:54:00",
        "errors": "",
        "id": "1793790",
        "incoming_date": "2018-12-09 17:24:02",
        "incoming_filename": "nasa_201812091700.npt",
        "observations": "8",
        "satellite": "1704205",
        "start_data_date": "2018-12-09 13:51:29",
        "station": "70900513",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-09 15:18:00",
        "errors": "",
        "id": "1793867",
        "incoming_date": "2018-12-09 19:38:16",
        "incoming_filename": "7819_technosat_crd_20181209_15_00.npt",
        "observations": "11",
        "satellite": "1704205",
        "start_data_date": "2018-12-09 15:11:59",
        "station": "78198201",
        "status": "valid",
        "version": "00",
        "wavelength": "532.000"
    },
    {
        "end_data_date": "2018-12-09 23:13:30",
        "errors": "",
        "id": "1794231",
        "incoming_date": "2018-12-10 12:28:30",
        "incoming_filename": "7840_technosat_crd_20181209_23_00.npt",
        "observations": "16",
        "satellite": "1704205",
        "start_data_date": "2018-12-09 23:09:10",
        "station": "78403501",
        "status": "valid",
        "version": "00",
        "wavelength": "532.080"
    }
]

Getting more information about a specific dataset

In [7]:
args = {}
""" required options """
args['username'] = username
args['password'] = password
args['action'] = 'data-info'
args['id'] = '1790842' # The first returned dataset from the query above
args['data_type'] = 'NPT'

""" send request as method POST """
response = requests.post(url, data=args)

if response.status_code == 200:
	""" convert json string in python list """
	data = json.loads(response.text)	
	for key in data.keys():
		print(key,':',data[key])
else:
	print(response.status_code)
	print(response.text)
status : valid
satellite : 1704205
errors : 
version : 00
incoming_date : 2018-12-02 23:24:34
start_data_date : 2018-12-01 12:35:00
end_data_date : 2018-12-01 12:39:55
incoming_filename : 7825_technosat_20181201_12_00.NPT
station : 78259001
observations : 6
wavelength : 532.10
id : 1790842
In [8]:
args = {}
""" required options """
args['username'] = username
args['password'] = password
args['action'] = 'data-download'
args['id'] = '1790842'
args['data_type'] = 'NPT'

""" send request as method POST """
response = requests.post(url, data=args)

if response.status_code == 200:
	""" convert json string in python list """
	data = json.loads(response.text)
	print(json.dumps(data, indent=4, sort_keys=True))
else:
	print(response.status_code)
	print(response.text)
[
    "H1 CRD  1 2018 12 02 04",
    "H2 STL3       7825 90 01  4",
    "H3 technosat   1704205 6203   042829 0 1",
    "H4  1 2018 12 01 12 35 00 2018 12 01 12 39 55  0 0 0 0 1 0 2 0",
    "C0 0 532.10 IDAA IDAB IDAJ IDAV",
    "C1 0 IDAB Nd-YAG 1064.00 0.00 20.00 12.0 0.00 1",
    "C2 0 IDAJ CSPAD 532.00 20.00 11.0 100.0 ECL 12.0 2.00 90.0 0.1 Manual",
    "C3 0 IDAV TrueTime_XLi TrueTime_OCXO MRCS NA 0.2322",
    "20 45304.419250999999 918.05 293.13 24.1 0",
    "20 45331.103251000000 918.05 293.13 24.1 0",
    "20 45355.130234999997 918.05 293.09 24.5 0",
    "20 45384.537235000003 918.05 293.04 24.6 0",
    "20 45405.072235000000 918.06 293.00 24.7 0",
    "20 45425.072235000000 918.06 292.97 24.7 0",
    "20 45445.074235000000 918.06 292.96 24.8 0",
    "20 45465.074235000000 918.06 292.94 24.8 0",
    "20 45485.075234999997 918.05 292.93 24.6 0",
    "20 45505.076235000000 918.05 292.91 24.8 0",
    "20 45532.685234999997 918.06 292.90 24.9 0",
    "20 45554.432235000000 918.05 292.86 24.8 0",
    "20 45574.437234999998 918.05 292.84 24.9 0",
    "20 45595.114235000001 918.05 292.83 25.0 0",
    "40 45300.000000000000 0 IDAA 1857 206 69.592 158519.0 -1.3 19.3 -0.000 -0.300 -6.7 2 2 0",
    "11 45503.671869229707 0.006465817421 IDAA  2    15.0     86       17.70     -0.21     -0.98        0.00   28.20 0",
    "11 45516.688535825480 0.006940238973 IDAA  2    15.0    109       19.40     -0.20     -1.05        0.00   48.66 0",
    "11 45528.888535828577 0.007405701140 IDAA  2    15.0     20       15.10     -0.00     -0.97        0.00   22.22 0",
    "11 45546.638535823484 0.008111399748 IDAA  2    15.0     27       17.10     -0.18     -0.74        0.00   25.47 0",
    "11 45561.621869220253 0.008727827809 IDAA  2    15.0     40       16.70      0.10     -0.88        0.00   33.06 0",
    "11 45577.171869229751 0.009383209968 IDAA  2    15.0     13       14.10     -0.10     -0.82        0.00   17.81 0",
    "50 IDAA 18.0 -0.150 -0.910 0.0 0",
    "H8",
    "H9"
]

In the example dataset above, we can see information headers about the satellite and the ground station (H1 to H4), then configuration data for the laser system (C0 to C3), and then several data fields:

  • 20: meteorological record. It can be used to model the laser propagation in the atmosphere (delay, attenuation, etc.)
  • 40: calibration record
  • 11: normal point range data
  • 50: session statistics record

More details about the normal point data:

  • The second field (ex: 45503.67) is the measurement time, given in seconds of day
  • The third field is the time-of-flight ($TOF$). This value directly gives the satellite range $r$ by multiplying by the speed of light $c$: $r = c * TOF / 2$
  • The fifth field is the type of epoch event. It tells how is the measurement time defined:
    • 1: at spacecraft bounce time
    • 2: at ground transmit time (the most common)

The following below browses the data file and prints the measurement time and satellite range.

In [9]:
c = 299792458 # m/s

currentLine = ''
i = 0
n = len(data)

while (not currentLine.startswith('H4')) and i < n: # Reading lines until the H4 header
    currentLine = data[i]
    i += 1
    
lineData = currentLine.split() # Reading day in H4 header
y = int(lineData[2])
m = int(lineData[3])
d = int(lineData[4])
from datetime import datetime
from datetime import timedelta
measurementDay = datetime(y, m, d)

while (not currentLine.startswith('11')) and i < n: # Reading lines until the start of normal point data
    currentLine = data[i]
    i += 1

while currentLine.startswith('11') and i < n: # Reading until the end of normal point data
    lineData = currentLine.split()
    timeOfDay = float(lineData[1])
    timeOfFlight = float(lineData[2])
    timestampType = int(lineData[4])
    
    r = c * timeOfFlight / 2
    
    if timestampType == 1:
        transmitTime = measurementDay + timedelta(seconds=(timeOfDay - timeOfFlight/2))
    else:
        transmitTime = measurementDay + timedelta(seconds=timeOfDay)
            
    bounceTime = transmitTime + timedelta(seconds=timeOfFlight/2)
    receiveTime = bounceTime + timedelta(seconds=timeOfFlight/2)
    
    print('Transmit time: {}, receive time: {}'.format(transmitTime, receiveTime))
    print('Time of flight: {} milliseconds, satellite range: {} kilometers'.format(timeOfFlight*1000, r/1000))
    print('')
    
    currentLine = data[i]
    i += 1
Transmit time: 2018-12-01 12:38:23.671869, receive time: 2018-12-01 12:38:23.678335
Time of flight: 6.465817421 milliseconds, satellite range: 969.2016488104053 kilometers

Transmit time: 2018-12-01 12:38:36.688536, receive time: 2018-12-01 12:38:36.695476
Time of flight: 6.940238973 milliseconds, satellite range: 1040.3156504115327 kilometers

Transmit time: 2018-12-01 12:38:48.888536, receive time: 2018-12-01 12:38:48.895942
Time of flight: 7.40570114 milliseconds, satellite range: 1110.0866739870012 kilometers

Transmit time: 2018-12-01 12:39:06.638536, receive time: 2018-12-01 12:39:06.646648
Time of flight: 8.111399748 milliseconds, satellite range: 1215.8682341367505 kilometers

Transmit time: 2018-12-01 12:39:21.621869, receive time: 2018-12-01 12:39:21.630597
Time of flight: 8.727827808999999 milliseconds, satellite range: 1308.268475930432 kilometers

Transmit time: 2018-12-01 12:39:37.171869, receive time: 2018-12-01 12:39:37.181253
Time of flight: 9.383209968 milliseconds, satellite range: 1406.5077901184106 kilometers

In [ ]: