New Stellarium script example request to update Stellarium view based on telescope Line of sight

[vpicouet]

Telescope control is a very interesting feature but I could not find a way to do the reverse action:
Use some updating line of sight position from a telescope (+ possibly GPS positions for a balloon or satellite project for instance)
and update Stellarium view accordingly.

Is there already a .ssc script that does a similar thing (like read the last line of a catalog every second and update the Stellarium sky position)?
Thanks a lot for the help!

[github-actions]

Thanks for adding your first issue to Stellarium. If you have questions, please do not hesitate to contact us.

[gzotti]

TelescopeControl sends GOTO commands to connected telescopes and displays a marker at the position which these telescopes transmits. There is no known scripting application with the TelescopeControl plugin I am aware of.

Can you explain more clearly a scenario of what you want to achieve?

[vpicouet]

Thanks for your quick reply!
Sure!
I work on a balloon borne telescope project (~40km altitude).
We have guidance capabilities so we always know what is the line of sight of the instrument.
We receive this information quasi in real time (added in a standard .csv table).

During the balloon flight, we would like to have the capability to display on Stellarium the evolution of the line of sight / FOV of the telescope.

I guess that in order to do that we should use the scripting capabilities of Stellarium and write a .ssc script that:

• Read the the .csv table every second to extract time + GPS (3D) + line of sight information + rotation
• Then apply the position of the observer: core.setObserverLocation(x, y, 1., 1., "payload location", "Earth")
• apply the time and line of sight

We already have an estimation of the RA,DEC so a simpler alternative would just be to ask Stellarium to stay on the last RA,DEC,rotation values.

I feel it's a pretty interesting & useful feature, so I guess this kind of scripts must have been already developed several times by space agencies or universities in the past.
Do you see more what I was refering to?

[gzotti]

Not sure if you can read a CSV file. It may be far simpler to use the RemoteControl API. Just reset view direction and location via HTTP whenever you write out a line to CSV.

[vpicouet]

Ok thanks:
You are suggesting to just use
curl -d "j2000=[3, 2, 2]" http://localhost:8090/api/main/view
each time the table is updated.

I did not find the Stellarium documentation to convert J2000(ra,dec) into Vec3d used for setViewDirectionJ2000.
Let's say I want to move on RAD/DEC J2000: 279.24°/38.78°, what x,y,z should I give to
curl -d "j2000=[x,y,z]" http://localhost:8090/api/main/view ?

Thanks for the help!

[gzotti]

/api/main/view is documented at https://stellarium.org/doc/head/remoteControlApi.html#rcMainService

[vpicouet]

Ok thanks, indeed I developed a short python script to do so:

def follow_FB_LOS_on_Stellarium(path="/tmp/test.csv",ftype="replay",n_ra="DV Asc D",n_dec="DV Dec",gtype="radec",n_alt="DV EL",n_az="DV Az",lat="Latitude",lon="Longi",alt="Altitude",date="Datation GPS",dformat="%d/%m/%y %H:%M:%S",sleep=0.1):
    
    i=0
    cat = Table.read(path,format="csv",delimiter=";")
    loc = EarthLocation(lat = cat[lat][-1]*u.deg, lon = cat[lon][-1]*u.deg, height = cat[alt][-1]*u.m)
    obj = SkyCoord(ra = cat[n_ra]*u.deg, dec = cat[n_dec]*u.deg)
    delay=1*u.min
    altaz = obj.transform_to(AltAz(obstime=Time([datetime.datetime.strptime(cat[date][i], dformat) for i in range(len(cat))])+delay, location = loc))
    cat["alt_from_ra"] =  np.array((altaz.alt)*u.deg)
    cat["az_from_ra"] =  np.array((altaz.az)*u.deg)

    n_az_b = n_az+"_b"
    cat[n_az_b] = 180 - cat[n_az]
    os.system('curl -d "latitude=%0.3f" http://localhost:8090/api/location/setlocationfields > /dev/null 2>&1'%(cat[lat][0]))
    os.system('curl -d "longitude=%0.3f" http://localhost:8090/api/location/setlocationfields  > /dev/null 2>&1'%(cat[lon][0]))
    os.system('curl -d "altitude=%0.3f" http://localhost:8090/api/location/setlocationfields  > /dev/null 2>&1'%(cat[alt][0]))
    
    while 1>0:
        cat = Table.read(path,format="csv",delimiter=";")
        cat[n_az_b] =  180-cat[n_az]
        if gtype=="radec":
            a,b = n_ra, n_dec
        elif gtype=="altaz":
            b,a = n_alt, n_az_b

        
        if ftype=="real-time":
            i=-1
        elif ftype=="replay":
            cat["x"] = np.cos(cat[b] * np.pi / 180) * np.cos(cat[a] * np.pi / 180)
            cat["y"] = np.cos(cat[b] * np.pi / 180) * np.sin(cat[a] * np.pi / 180)
            cat["z"] = np.sin(cat[b] * np.pi / 180)
            i+=1
            
        alpha, delta = cat[a][int(i)], cat[b][int(i)]
        x = np.cos(delta * np.pi / 180) * np.cos(alpha * np.pi / 180)
        y = np.cos(delta * np.pi / 180) * np.sin(alpha * np.pi / 180)
        z = np.sin(delta * np.pi / 180)
        
        if gtype=="radec":
            command = ['curl -d "j2000=[%0.10f,%0.10f,%0.10f]" http://localhost:8090/api/main/view  > /dev/null 2>&1'%(x,y,z)]
            command.append('curl -d "time=%0.10f" http://localhost:8090/api/main/time  > /dev/null 2>&1'%(convert_to_julian(cat[date][i], dformat)))
            os.system(";".join(command))
        elif gtype=="altaz":
            command = ['curl -d "altAz=[%0.10f,%0.10f,%0.10f]" http://localhost:8090/api/main/view  > /dev/null 2>&1'%(x,y,z)]
            command.append('curl -d "time=%0.10f" http://localhost:8090/api/main/time  > /dev/null 2>&1'%(convert_to_julian(cat[date][i], dformat)))
            # os.system('curl -d "latitude=%0.3f" http://localhost:8090/api/location/setlocationfields  > /dev/null 2>&1'%(cat[lat][i]))
            # os.system('curl -d "longitude=%0.3f" http://localhost:8090/api/location/setlocationfields  > /dev/null 2>&1'%(cat[lon][i]))
            # os.system('curl -d "altitude=%0.3f" http://localhost:8090/api/location/setlocationfields  > /dev/null 2>&1'%(cat[alt][i]))
            os.system(";".join(command))

        time.sleep(sleep)

Unfortunately, because it takes some time for stellarium to interpret each command (~0.1sec), if I want to both change LOS(alt/az) and time, we see 2 moves in stellarium while there should be continuity (as we are guiding).

Is there a way with the API to send two commands at once so that Stellarium change the display only once (when both command have been interpreted).
Thanks for the help

[10110111]

Is there a way with the API to send two commands at once so that Stellarium change the display only once

Have you tried passing multiple -d parameters to curl? This way you could use a single setlocationfields request for latitude, longitude and altitude. Maybe this is what gives you two movements, rather than the separation of time setting.

[vpicouet]

Thanks for the answer, but for now the issue is when I use

            command = ['curl -d "j2000=[%0.10f,%0.10f,%0.10f]" http://localhost:8090/api/main/view  > /dev/null 2>&1'%(x,y,z)]
            command.append('curl -d "time=%0.10f" http://localhost:8090/api/main/time  > /dev/null 2>&1'%(convert_to_julian(cat[date][i], dformat)))
            os.system(";".join(command))

or

            command = ['curl -d "altAz=[%0.10f,%0.10f,%0.10f]" http://localhost:8090/api/main/view  > /dev/null 2>&1'%(x,y,z)]
            command.append('curl -d "time=%0.10f" http://localhost:8090/api/main/time  > /dev/null 2>&1'%(convert_to_julian(cat[date][i], dformat)))
            os.system(";".join(command))

Is there a command to both set LOS and time at the same time?

[10110111]

There's no such command, but you can try using the same connection, so that curl doesn't have to connect, send first command, disconnect, then again connect, and send second command. This should reduce time gap. See this discussion.

[vpicouet]

Thanks! indeed using
command = ['curl -d "j2000=[%0.10f,%0.10f,%0.10f]" http://localhost:8090/api/main/view > /dev/null 2>&1'%(x,y,z)] command.append(' -d "time=%0.10f" http://localhost:8090/api/main/time > /dev/null 2>&1'%(convert_to_julian(cat[date][i], dformat))) os.system(" --next ".join(command))
helps to go from 0.1s lag to ~0.03s lag, though it still impacts the visual rendering.
For now I can live with this small issue.

I was wondering if there is also a way to change the angle of the oculars captors via the API.
This could be very helpful for lost in sky / field recognition.

[10110111]

I was wondering if there is also a way to change the angle of the oculars captors via the API.

I don't think there is (at least there's no mention of "ocular" in RemoteControl plugin sources). But if your aim is to have orientation of the stars always the same relative to the sensor frame, maybe you just need to enable equatorial mount in the Telescopes tab?

[gzotti]

There is no dedicated RemoteControl API for the Oculars plugin, and Oculars was not in focus of this RC development. If Oculars settings are StelProperties (I have not checked), it should work, though.

[vpicouet]

Thanks for your answers, it helped a lot

[Oegtsgeest]

I made a telescope and wrote software to control the scope.
Would it be possible to move the cursor of Stellarium to a selestial body e.g. Vega by sending a curl to Stellariums remote control API?
My software does not use Stellarium for it position but I would like Stellarium to follow where I am looking at.
I could not figure out what curl command I have to sent, Focus or move? How should that command look like? Would there be a difference if I use the CMD of windows or if i write the command e.g. by an EPS32 via wifi? I am using Stellarium 24.3