Welcome to the Host Galaxy Matcher

This is a work-in-progress prototype of a host galaxy matching service we are developing at NCSA in collaboration with Lawrence Berkeley National Lab. It is currently not a public service.

Obtain access token

Log in and press the Token button to display your authentication token, referenced as variable TOKEN in text below.

You can also obtain your token programmatically by supplying credentials:


        curl -X POST -d 'username=admin' -d 'password=password' http://localhost:8000/api/token/
        
        {
            "token":"22931ae344bdf163c01b324c34771d919c7ea8b5"
        }
    

Query positions and launch matching process

Query positions using GET /api/position/ with RA/Dec coordinates:


        curl --get -H "Authorization: Token ${TOKEN}" \
            -d 'ra_deg=302.890875' -d 'dec_deg=-41.95881944' \
            http://localhost:8000/api/position/
    

Launch a host matching task by submitting a new position using PUT /api/position/:


        curl -X PUT -H "Authorization: Token ${TOKEN}" \
            --data '{"coordinates": {"ra_deg": 302.890875, "dec_deg": -41.95881944}}' \
            http://localhost:8000/api/position/
    
        {
            "positions": [
                {
                    "uuid": "7eb32251-653a-4626-8120-b9dde8470abf",
                    "dec_deg": "-41d57m31.749984s",
                    "ra_deg": "302d53m27.15s"
                }
            ]
        }

    

Once the matching process completes, subsequent requests will yield host data.

        {
            "positions": [],
            "hosts": [
                {
                    "name": "186705",
                    "redshift": "0.0479399429341686",
                    "redshift_err": "0.0004793994293416",
                    "photometric_redshift": "None",
                    "photometric_redshift_err": "None",
                    "milkyway_dust_reddening": "None",
                    "dec_deg": "-41d57m32.8104s",
                    "ra_deg": "302d53m29.6556s"
                }
            ]
        }