Libraries.Science.Astronomy.Skynet

This class is used to send instructions to the Skynet robotic telescope network using the internet and the token from you skynet account. If you don't have an account, contact Skynet (https://skynet.unc.edu/help/contact) for information.

Example Code

use Libraries.Data.Formats.JavaScriptObjectNotation
use Libraries.Network.NetworkResponseEvent
use Libraries.Science.Astronomy.Skynet
use Libraries.Science.Astronomy.SkynetListener

class DriverCode is SkynetListener
    text token = "your security token goes here"
    Skynet skynet

    action Main
        skynet:AddListener(me)
        skynet:SetRightAscension("11:12:20.1")
        skynet:SetDeclination("-04:18:57")
        skynet:SetName("2018 CY1")
        skynet:SetAccountKey(token)
        skynet:SetMaxSun(-14)
        skynet:SetMinElevation(30.0)
        skynet:SetTimeAccount(555)
        skynet:AddTelescope("CTIO-1.0m")
        skynet:AddFilter("Open")
        skynet:SetNumberOfExposures(1)
        skynet:SetExposureLength(1.0)
        skynet:SubmitObservationByCoordinates()
    end

    action ResponseReceived(NetworkResponseEvent response)
        // do something with the response
    end
end

This method is used to add the name of the filter to your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:AddFilter("Open")
        end
    end

This method is used to add the listener to the Skynet object. Attribute parameter listener The SkynetListener object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
        end
    end

This method is used to add the name of the telescope to your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:AddTelescope("CTIO-1.0m")
        end
    end

This action compares two object hash codes and returns an integer. The result is larger if this hash code is larger than the object passed as a parameter, smaller, or equal. In this case, -1 means smaller, 0 means equal, and 1 means larger. This action was changed in Quorum 7 to return an integer, instead of a CompareResult object, because the previous implementation was causing efficiency issues.

Example Code

Object o
        Object t
        integer result = o:Compare(t) //1 (larger), 0 (equal), or -1 (smaller)

This action allows us to obtain the progress of any file download as the network is processing it.

Example Code

use Libraries.Network.NetworkConnection
    use Libraries.Network.NetworkRequest
    use Libraries.Network.NetworkResponseEvent
    use Libraries.Network.NetworkRequestListener

    class Main is NetworkRequestListener
        action Main
            NetworkConnection conn
            conn:AddListener(me)
            File myFile
            myFile:SetPath("logo.png")
            NetworkRequest request
            request:SetRequestTypeToGet()
            request:SetWebAddress("https://quorumlanguage.com/media/QuorumLogo.png")
            request:SetDownloadFile(myFile)
        end

        action ResponseReceived(NetworkResponseEvent response)
            output response:GetResponseText()
        end

        action DownloadProgress(integer length, integer read)
            output read + " of " + length + " bytes read." 
        end
    end

This action determines if two objects are equal based on their hash code values.

Example Code

use Libraries.Language.Object
        use Libraries.Language.Types.Text
        Object o
        Text t
        boolean result = o:Equals(t)

This method is used internally by the class to return the exposure parameters set in the object.

Example Code

use Libraries.Network.NetworkRequest
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action SubmitExposureRequest
        NetworkRequest request
        request:SetParameters(GetExposureParameters())
    end

This method is used internally by the class to return the filter list set in the object.

Example Code

use Libraries.Network.NetworkRequest
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action GetExposureParameters returns JavaScriptObjectNotation
        JavaScriptObjectNotation params
        params:Add("filterRequested", me:GetFilterList())
        return params
    end

This action gets the hash code for an object.

Example Code

Object o
        integer hash = o:GetHashCode()

This method is used to get an iterator to the set of listeners attached to the Skynet object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener
    use Libraries.Containers.Iterator

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            Iterator<NetworkRequestListener> iterator
            iterator = skynet:GetListenerIterator()
        end
    end

This method is used internally by the class to return the observation parameters by coordinates set in the object.

Example Code

use Libraries.Network.NetworkRequest
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action SubmitObservationByCoordinates
        NetworkRequest request
        request:SetParameters(GetObservationParametersByCoordinates())
    end

This method is used internally by the class to return the observation parameters by name set in the object.

Example Code

use Libraries.Network.NetworkRequest
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action SubmitObservationByName
        NetworkRequest request
        request:SetParameters(GetObservationParametersByName())
    end

This method is used internally by the class to return the skynet headers set in the object.

Example Code

use Libraries.Network.NetworkRequest
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action SubmitObservationByCoordinates
        NetworkRequest request
        request:SetHeaders(GetSkynetHeaders())
    end

This method is used internally by the class to return the telescope list set in the object.

Example Code

use Libraries.Network.NetworkRequest
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action GetExposureParameters returns JavaScriptObjectNotation
        JavaScriptObjectNotation params
        params:Add("telescope", me:GetTelescopeList())
        return params
    end

This method notifies all the listerners that a NetworkResponseEvent has been receied by the Skynet Object.

Example Code

use Libraries.Network.NetworkResponseEvent
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action ResponseReceived(NetworkResponseEvent response)
        JavaScriptObjectNotation json
        json:Read(response:GetResponseText())
        if status = STATUS_WAITING_FOR_OBSERVATIONID
            observationID = cast(integer, json:GetValue("id"))
            status = STATUS_OBSERVATIONID_RECEIVED
            SubmitExposureRequest()
        elseif status = STATUS_OBSERVATIONID_RECEIVED
            status = STATUS_NO_REQUEST_MADE
            Notify(response)
        end
    end

This method is used to remove the listener to the Skynet object. Attribute parameter listener The SkynetListener object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:RemoveListener(me)
        end
    end

This method is the callback for the NetworkResponseEvent object.

Example Code

use Libraries.Network.NetworkRequest
    use Libraries.Network.NetworkConnection
    use Libraries.Network.NetworkResponseEvent
    use Libraries.Network.NetworkResponseListener

    class Skynet is NetworkResponseListener
        action Submit
            NetworkRequest request
            request:SetRequestTypeToPost()
            NetworkConnection http
            http:AddListener(me)
            http:SendRequest(request)
        end

        action ResponseReceived(NetworkResponseEvent response)
            // do something with the response
        end
    end

This method is used to set the security token of your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetAccountKey(token)
        end
    end

This method is used to set the astronomical type value your Skynet request object. Allowable values include: sidereal, planet, asteroids, comet or nothing.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetPriority(1)
        end
    end

This method is used to set the binning value of your Skynet request object. The default value is 1.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetBinning(2)
        end
    end

This method is used to set the declination value of your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetDeclination("-04:18:57")
        end
    end

This method is used to set the exposure length value of your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetExposureLength(1.0)
        end
    end

This method is used to set the isToo value of your Skynet request object. The default value is false.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetIsToo(false)
        end
    end

This method is used to set the MaxSun value of your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetMaxSun(-14)
        end
    end

This method is used to set the Minimum Elevation value of your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetMinElevation(30.0)
        end
    end

This method is used to set the mode value of your Skynet request object. The default value is 0.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetMode(0)
        end
    end

This method is used to set the name of your Skynet request object if you are going to request an observation by name.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetName("2018 CY1")
        end
    end

This method is used to set the number of exposures for your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetNumberOfExposures(1)
        end
    end

This method is used to set the priority value your Skynet request object. The default value is 1.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetPriority(1)
        end
    end

This method is used to set the right ascension value your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetRightAscension("11:12:20.1")
        end
    end

This method is used to set the time account value your Skynet request object.

Example Code

use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        integer account = 555
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetTimeAccount(account)
        end
    end

This method is used internally by the class to submit the exposure parameters after an observation id has been obtained.

Example Code

use Libraries.Network.NetworkResponseEvent
    use Libraries.Data.Formats.JavaScriptObjectNotation

    action ResponseReceived(NetworkResponseEvent response)
        JavaScriptObjectNotation json
        json:Read(response:GetResponseText())
        if status = STATUS_WAITING_FOR_OBSERVATIONID
            observationID = cast(integer, json:GetValue("id"))
            status = STATUS_OBSERVATIONID_RECEIVED
            SubmitExposureRequest()
        elseif status = STATUS_OBSERVATIONID_RECEIVED
            status = STATUS_NO_REQUEST_MADE
            Notify(response)
        end
    end

This method is used to submit the request using the coordinates method.

Example Code

use Libraries.Data.Formats.JavaScriptObjectNotation
    use Libraries.Network.NetworkResponseEvent
    use Libraries.Data.Formats.JavaScriptObjectNotation
    use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener
    use Libraries.System.File
    use Libraries.Containers.HashTable
    use Libraries.Containers.Iterator

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetRightAscension("11:12:20.1")
            skynet:SetDeclination("-04:18:57")
            skynet:SetName("2018 CY1")
            skynet:SetAccountKey(token)
            skynet:SetMaxSun(-14)
            skynet:SetMinElevation(30.0)
            skynet:SetTimeAccount(555)
            skynet:AddTelescope("CTIO-1.0m")
            skynet:AddFilter("Open")
            skynet:SetNumberOfExposures(1)
            skynet:SetExposureLength(1.0)
            skynet:SubmitObservationByCoordinates()
        end

        action ResponseReceived(NetworkResponseEvent response)
            // do something with the response
        end
    end

This method is used to submit the request using the names method.

Example Code

use Libraries.Data.Formats.JavaScriptObjectNotation
    use Libraries.Network.NetworkResponseEvent
    use Libraries.Data.Formats.JavaScriptObjectNotation
    use Libraries.Science.Astronomy.Skynet
    use Libraries.Science.Astronomy.SkynetListener
    use Libraries.System.File
    use Libraries.Containers.HashTable
    use Libraries.Containers.Iterator

    class DriverCode is SkynetListener
        text token = "your security token goes here"
        Skynet skynet

        action Main
            skynet:AddListener(me)
            skynet:SetAstronomicalType("asteroid")
            skynet:SetName("tylerlinder")
            skynet:SetAccountKey(token)
            skynet:SetMaxSun(-14)
            skynet:SetMinElevation(30.0)
            skynet:SetTimeAccount(555)
            skynet:AddTelescope("CTIO-1.0m")
            skynet:AddFilter("Open")
            skynet:SetNumberOfExposures(1)
            skynet:SetExposureLength(1.0)
            skynet:skynet:SubmitObservationByName()
        end

        action ResponseReceived(NetworkResponseEvent response)
            // do something with the response
        end
    end