Associated Wikis
(privileges may be required)
Associated Wikis
(privileges may be required)
This is an old revision of the document!
This document describes how to solve common problems that sometimes arise at the array.
This is a list of simple things to check if you can't find fringes:
A number of servers use an interim bootlaunch paradigm to restart. This is confined to servers that run on ubuntu machines, namely the telescope bunker computers and gps. The basic syntax is “bootlaunch_<server>” where “<server>” is replaced by the server the script is designed to address. The scripts have a number of safeties built in, so it is safe to run them even if a server is already running – they just output the process ID of the running server. The scripts also take care of the entry in socket manager as well any serial port lock files. All the pertinent information is world writeable, so one should be able to run a bootlaunch script as observe.
One thing of note about the output of the bootlaunch scripts, they call a number of other programs which themselves have output that may be misleading in the context of bootlaunch. Chief among these is the output of “tsockman”. If a server stopped unexpectedly, it may leave behind an entry in the socket manager. In order to launch a new server, one needs to clean out the socket manager entry if it is there. To do that, “tsockman remove <entry>” is called to remove “<entry>” before the new server is launched. If there is no entry, tsockman will respond with “Process by that name does not exist”. THIS IS NORMAL and is not indicative of an error. The server in question launched (without fanfare) right after that output text.
Here are the available bootlaunch scripts as of June 2017:
gps computer:
telescope bunker computers:
Note: The bootlaunch scripts will not start a new server if there is an existing process running. Therefore, type “ps aux | grep server_name” where server_name is the name of the server. If there is a dead process running, look up the process identification number (PID) and type “kill -9 PID” to kill the process and then run the relevant bootlaunch script.
This procedure is applicable to servers that have not switched over to the bootlaunch paradigm.
If a server is not running or Socket Manager reports that a server is dead, then look at the socket manager list to find out what computer the server runs on (socket_manager.list). You can also look at the up-to-date file by opening a terminal window and typing “less /chara/observe/socket_manager.list” Note that servers can be running fine, but if the Socket Manager drops the connection to them, they are as good as dead when it comes to functioning with other servers or as part of a larger sequence.
Log on to the relevant computer by typing the computer name (ctrscrut, ople, s1, …). If the shortcut doesn't work then type “ssh name” where name is the computer name.
Find out if the server is running by typing “ps aux | grep server_name” where server_name is the name of the server.
[ctrscrut:599] ps aux | grep pico_1
observe 9281 0.0 0.0 61156 692 pts/3 S+ 13:58 0:00 grep pico_1
observe 12578 0.0 0.0 24524 11212 ? S Jun16 33:14 /usr/local/bin/pico_server /dev/ttyC8 /ctrscrut/chara/etc/pico_1.cfg
If the entry for the dead server shows up in the process list, then identify the process identification number (12578 for the example above) and kill the server by typing “kill -9 PID” where PID is the process identification number.
Look up the commands to restart the server by typing “more /etc/rc.local” (this is relevant for servers that run in the background). Press the space bar to scroll through the contents of the rc.local file. Locate the commands relevant for the server that needs to be restarted and copy and paste into a terminal window:
#Start PICO server for PICO #1
/bin/rm -f /var/lock/LCK..ttyC8
/usr/local/bin/tsockman remove PICO_1
/usr/local/bin/pico_server /dev/ttyC8 /ctrscrut/chara/etc/pico_1.cfg &
The first command removes the lock to allow the server to restart. The second command removes the name from the socket manager listing. The last command restarts the server. Note that if you are restarting the servers as observe, you will need to remove the part of the command in the rc.local file that saves information in /var/log/server_name.log file (the actual command typed should resemble the last line above).
There are text files on the desktop with many of the restart commands. Use these files for quick access to the relevant commands. The commands are edited and can be copied exactly as written. Files include Dome servers and all servers running on ctrscrut. Many of these commands are also located on the Restarting Servers page.
The Shutters server can become unresponsive or disconnected from the Socket Manager. This server must be restarted from the lab and not from the Control Room. Follow these instructions to restart it. Note that Shutters runs on ople, not ctrscrut.
To start the shutter server on ople:
Log into the ople computer and kill the process labeled shutters with the PID as described in Restarting Servers above.
Turn off the power to the Shutters with the switch on the computer rack which is to the left of the computer desk and marked “SHUTTERS”. Restart the Shutters server with the commands below. After restarting the server and testing the gui to see that it works, turn the SHUTTERS power back on with the switch. There is a printed sheet of directions in the lab to help you.
/usr/local/bin/tsockman rm shutters
ctrscrut/usr/local/bin/shutter_server /ctrscrut/chara/etc/shutter.cfg &
Here we discuss things that can go wrong with the telescopes.
Have the powers been turned on to the drives? Are the scopes disabled? The usual state of the telescopes is disabled until enabled. This is due to the stall function of the scopes which eventually disables the scopes when they are stowed. Enable the scopes by hitting [ENABLE] on the dome gui or in the telescope gui control tab. If a scope disables itself during a slew, it may be just an overcautious stall function. Hit ENABLE and the scope should continue to slew. If it disables again without moving, there may be something wrong at the scope, ie. a hatch left open, a ladder not put away, a tool on the floor, or something else physically impeding the motion of the scope. You will need to go to the dome to see what it is. The computer in the dome will give you control of the scope to turn it away from the problem.
Sometimes the dome guis get hung up and can cause erratic motion or no motion of the scopes. Check them for current times and continuous updates of numbers. If they are not updating, try to REOPEN them first. If that does not work, close the gui and open a new one. If a new one does not open, the dome server may be dead or Sockman lost track of it. See Dome Server Restart below.
Azimuth Limit Switches
As of 11-'17, the azimuth limit switches are enabled and can stop the motion of the scopes if they try to go beyond -90º or +450º. The scopes will not be movable with normal inputs so follow these instructions to return them from the out of range condition.
1. On the domegui MANUAL tab, click STOP so pulses won't be sent to the drive by the control software.
2. Make sure you understand why the limit was hit which may require a trip to the telescope.
3. Click the OVERRIDE ON button in domegui MANUAL tab. After this, the hardware doesn't care about the limits switches and you're free to move the telescope.
4. Click ENABLE then you can move the telescope back to its normal range of operation.
5. After the telescope is back in it normal range, click OVERRIDE OFF which makes the hardware aware of the limits again.
If a bright star is manually found and not slewed to by number, (usually after the scope has gotten lost), the telescope will not track as it does not know it has gone to a star. When you init the EL and AZ position of the scope to the star's position, you must enable the tracking by going to the dome gui, selecting the RA/DEC tab and hitting the [GO RA/DEC] button. The scope will track, but the pointing model may still be off. Try slewing to the same star and initing on it after it is locked in Tiptilt. This can be done in the dome with the computer at the telescope.
Disable the scope whenever its motion is outside of what it is supposed to do. Turn the powers off to the axes as well on the Power gui. The dome server is usually to blame and will need to be restarted.
To manually start the dome server:
1. Make sure the power to the drives is OFF.
2. Login to the relevant computer as root. For example, type “s1” or “ssh s1” to log on to S1.
3. Work out the process ID number (PID), either with the command
(s1:1001) tsockman get dome_S1
Name : dome_S1
Machine : s1.chara-array.org
PID : 29953
Commands : -1
Data : -1
Message : 4002
Restart : /usr/local/bin/dome_server -A33.7441 S1
or with
(s1:1003) ps aux | grep dome
theo 4473 0.0 0.0 61188 748 pts/3 S+ 10:45 0:00 grep dome
observe 29953 18.5 0.4 35596 9860 ? Sl Apr21 416:11 /usr/local/bin/dome_server -A33.7441 S
It can also be found by pulling up the LIST on SOCKMAN and selecting the relevant dome.
So in this case the PID is 29953.
4. Try and stop the server gracefully: kill -2 29953
5. You should then check that the server has indeed stopped:
[s1:600] tsockman get dome_S1
Name : dome_S1
Machine : s1.chara-array.org
PID : 15635
Commands : -1
Data : -1
Message : 2008
Restart : /usr/local/bin/dome_server -A41.0166 S1
If the socket manager still thinks it's running you will need to stop it forcefully: kill -9 29953; tsockman rm dome_S1
6. Restart the dome server by copying the command at the end of the /etc/rc.local file:
[s1:602] more /etc/rc.local
«< Press space bar or enter to scroll through file»>
#Run the dome server
/usr/local/bin/tsockman remove dome_S1
/usr/local/bin/dome_server -A41.0166 S1 &
(Note: the part of the command that saves information to /var/log/dome_S1.log has been removed.)
7. Turn the power to the drives back on.
8. Hit REOPEN and ENABLE on the domegtk, and type “otcs” in the telescope server.
You may have to reinitialize the scope on a bright star. If the powers were turned off quickly when the problem was noticed, the position of the scope should be retained and slewing to a bright star will get it in the finder. If not, you may need to go out to the telescope to find the bright star to reacquire the scopes position.
The NTP server has obsoleted this problem and fix as of 2014.
Sometimes it happens that a telescope receives the wrong position for a target or does not receive the commanded position at all. The commanded position is listed on the telescope server in the first column under TCS Az/El; the second column lists the actual position of the telescope. Try entering the star designation directly into the telescope server, ie. hd 123456. If it does not accept the number, try closing and restarting the telescope server and hitting repoen on Cosmic Debris and the telescope gui. Try entering the star into the server again. If that does not work, it is possible that something is wrong with the dome server. To restart the dome server follow these steps:
* DISABLE the telescope using either the telescope or dome GUI.
\ ==== Telescope is tracking poorly, overshooting in slew, oscillating. ====
This might mean that the gain for the tracking servo is wrong. Note that changing this gain can be dangerous, especially if you set it too high as that can cause the telescope to oscillated and damage the drives. Please only do this if you are very very sure that it is necessary. Symptoms of bad gain are: The scope over shoots the position while slewing. The star will be seen to move out of the window and may come back after a few seconds. This means the slewing gain is too low. The scope oscillates when tracking or after a slew. The star will be tracing an ellipse, figure eight or other looping shape. This means the tracking gain is too low. You can damp this out with the telescope or dome gui by disabling the scope, then re-enabling it. Adjust the gain upward and watch it on the next slew. In all cases if either gain is too high the scope will go into "Fog Horn" mode, which is bad. You always want to use the lowest gain that still allows the scope to work as best as possible. If the tiptilt tells you the scope is oscillating slowly, the gain may be too low. If it is oscillating quickly it may be too high. On 10-22-2016, the gain settings were: | Scope | AZ Slewing || EL Slewing || AZ Tracking || EL Tracking || Date Updated |
Gain | Fn | Gain | Fn | Gain | Fn | Gain | Fn | ||
S1 | 7 | 4 | 4 | 3 | 16 | 4 | 10 | 7 | 10-26-2017 |
S2 | 7 | 7 | 10 | 10 | 10-22-2016 | ||||
E1 | 7 | 7 | 13 | 10 | 10-22-2016 | ||||
E2 | 7 | 7 | 13 | 10 | 10-22-2016 | ||||
W1 | 13 | 10 | 13 | 10 | 10-22-2016 | ||||
W2 | 7 | 7 | 13 | 13 | 10-22-2016 |
Note that these values may change as the temperatures change rapidly. These are still being adjusted so this is by no means final. Be sure to set mode back to AUTO if changing the gains left it in Slewing or Tracking mode.
The GAIN controls the gain of the feedback between the encoder and the drive velocity. A high gain means a “stiffer” response, but can lead to oscillations or fog-horning if it's too high.
The Fn controls the maximum frequency of the servo response. A high Fn means higher frequencies are allowed through, which can mean correcting for faster problems but if too high can also lead to oscillations or fog-horning.
The software will not make changes to either of these quickly as that is a dangerous thing to do. There is NO POINT to clicking the up or down buttons more than once every few seconds. Indeed it is bad to do so as you will confuse the software. The change between slewing and tracking is also slow for similar reasons. This is why sometimes the “wrong” thing seems to change. It is a sign that you are trying to do things too quickly.
Slew and tracking mode work differently, mostly because the speeds are so different.
IN SLEWING MODE
- If the gain is too low you will overshoot the target.
- If the gain is too high it will fog-horn.
- If the Fn is too high it will also fog-horn, even at low gains.
You need to have the lowest possible gain and Fn in slew mode that doesn't overshoot the target. Fn in slew mode should almost never be higher than 4. If it is, please turn it back down to 4. If you think this is a problem please let Theo know, along with a detailed explanation of what happened.
IN TRACKING MODE
- If the gain is too low it will keep moving between slewing and tracking.
- If the gain is too high it will fog-horn.
- The same goes for Fn.
In tracking mode you want the highest gain and Fn that allows the telescope to track well without fog-horning. If it “oscillates”, which you will see in the green dots of tiptilt oscillating, try turning up the gain, and also try turning down the Fn.
Some final remarks:
- The gain is temperature dependent, so when the temperature changes these things will change, but more so for tracking.
- The tiptilt system almost never causes oscillations, it almost always shows you that the scope is oscillating. If the white dots are centered on tiptilt and the green dots are moving the tiptilt is doing it's job and correcting for scope motion.
- If a drive gets disabled at the end of a slew, the gain is too low. At low gain and low velocity the encoder signal changes very slowly or doesn't change at all. After 5 secs the software interprets this as a stall and disables the drive. The tricky part is that increasing the gain to avoid this situation might make the telescope to oscillate during the next slew. So the gain should be low (4 or even 1) during slewing but higher 7 or 10 when the telescope is basically at the target position.
At times the domes do not rotate, open or close, or otherwise behave. Some problems are simple and others are more complex.
Sometimes when observing, the dome will not follow the telescope during a slew. This can happen when the Autodome feature is not turned on. Click the ON button on the MAIN tab of the telescope gui to enable it. This may happen after a server restart so always check the dome position with the spycam during a slew after a server restart. Also make sure the target position of the dome matches the telescope's position. If not, it will insist on being in the wrong place. If it is not at the same AZ as the scope, manually move it until it is centered on the telescope in spycam 1. If the dome AZ does not read the same as the telescope AZ, enter the scope AZ in the position box of the DOME tab of appropriate dome server and hit the INIT POS button to tell it at what AZ it is.
If the dome does not turn at all, even with the manual controls on the telescope or dome guis, the control may be set to manual on the control box. This can happen if there was work done at the dome during the day. If the dome opens, but does not turn, check to see that control of the dome rotation is in the computer position and not manual on the dome rotation controller box just inside the door of the bunker.
If the dome won't open, try hitting the SLIT CLOSE button on the telescope gui first. It may be that there was a computer or server issue and the computer thinks the dome is open already and won't allow it to open again. Hit the SLIT OPEN button to see if it works now. If it still won't open, go to the bunker and look to see if the power switch is on to the dome. It will be up and red if on.
Also look to see if the power cable is connected to the computer box. If it's connected up high to the manual dome controls, the cable needs to be brought back to the computer box connector. Turn the power off first to the dome before disconnecting the power cable. Slide it onto the connector at the box and turn the collar to lock it in place. Turn the power back on and see if you can open the dome from the computer in the bunker.
If a dome will not close after observing, it may need to be closed manually at the bunker. Turn the power to the dome off at the switch, disconnect the cable from the computer control box and connect it to the manual control switches above. Turn on the power to the dome after connecting the cable and use the two controls to close the dropout first, then the slit. The dropout must be fully closed and the slit closed over it to be shut properly. Inform the staff that the dome did not function properly so someone can look at it in the morning.
The HUT servers control functions such as finder and acq exposure times and gains, heater and dehumidifier usage, and various AO functions. An observer may find that the camera settings do not display or are not adjustable. The HUT server may be the cause if it has quit. To see if it is the server, open the HUT gui for the desired telescope from the CHARA menu. If the camera settings are displayed and the settings can be changed from the gui, then the HUT server is ok. Restart the telescope server to reopen the connection to the HUT server and hit reopen on Cosmic Debris as well. If the gui is not functioning, the HUT server will need to be restarted. The HUT servers run on the computer at each telescope. Find the PID from Sockman for the server you want to shut down. Open a terminal and log into the correct telescope computer (for example, type “s1” to log on to S1). Use the command “ps aux | grep HUT” to find the process you need to shut down. The number should match the PID from Sockman. Kill the process by typing “kill -9 pid” where pid is the process number and remove the entry from Sockman with the REMOVE button on the gui or by command line. Restart the hut server using the new “bootlaunch_hut” command described in the section on Restarting Servers. If the server won't restart, a reboot of the power supply in the telescope bunker might be necessary. The power supply that controls the acquisition and finder cameras as well as their controllers is located on top of the computer rack in each bunker. The power supply has green readouts of volts and current. After turning the power off for 10 seconds and back on, try restarting the server from the computer in the bunker to see if it starts cleanly. If so, then restart the telescope server, reopen the connection to the telescope gui, and hit REOPEN on Cosmic Debris. Part of the HUT server also controls the AO table. If the AOB part of the HUT server doesn't work, then the power supply on the back of the AO table in the telescope dome might need recycling. This power supply controls the actuators at M2 and the AO table. The power supply box is a 6×9 inch aluminum box on the back of the AO table, behind the keyboard and monitor. Turn it off with the power button on the bottom edge of the box, wait 5 seconds and turn it back on. The HUT server should now restart cleanly. Restart the telescope server as well to make the connections to the telescope gui. Hit REOPEN in Cosmic Debris if you are observing to make all needed connections.
The tiptilt server controls the CCD based tiptilt detection system.
Before you start the tiptilt server, you must ensure that the power to the cooling system and the CCD iteslf is on. It is extremely important that the cooler be running before you turn on the CCD and is only turned off if you are sure the CCD is NOT running. You can start the server from the X windows menu or with the command xtiptilt.
Note that there are background counts and read noise to deal with. Whenever you change the frame rate, please ensure that the bias frame is OK. The server will attempt to load an old bias frame that should work, but if things are not working, try making a new bias frame by ensuring that the detector is in the dark and typing “mkbias” into the tiptilt server.
In the tiptilt GUI windows, the white dots represent the starlight while the green dots represent the motion applied to telescope's secondary mirror to keep the starlight centered. When tiptilt is locked the white dots will be brought to the center of the tiptilt window. The green dots should be mostly centered also. W2 and E2 telescopes have a small oscillation that show as back and forth plots of the green dots.
Is the CCD turned on? When the tiptilt server starts up it tries no more than five times to communicate with the CCD. If they all fail, it will give up. If this happens, try cycling the power to the CCD and try again. If this fails, connect to the tiptilt machine and type the command rtccdAPIDemo, which should return with no errors. Try this command a few times, but if it still fails, there is a more serious problem. Turn off the CCD and reboot the tiptilt computer. If it still fails, I am afraid you are in more serious trouble.
Note that it is never a good idea to reboot machines unless you are very very sure it is necessary. The only reason to reboot tiptilt, other than a lock up of some kind, is that the clock interrupt has failed. You can test this by running the command “testclock” on a tiptilt command line. If this says the clock is working do not reboot the machine.
Also note that cycling the power on the CCD can cause harm so be sure you need to do it before trying it. Also, it is important to wait for at least 20 seconds after turning off the power before turning it on again.
Sometimes the telescope server will not show that TT is running. It will show 0Hz for a signal rate for TT. Running TIPTILT COMM will not get it started while other scopes do show it starting. Close and restart any telescope servers that won't connect after two tries of TIPTILT COMM.
Note: There is more info in the software manual on this topic, but I wasn't sure if it was still relevant.
First check whether the clock itself is running and the other machines receive the clock signal. Look at the clock cards at the back of other computers in the rack. The clock cards have three LEDs, one yellow and two greens. If the computer is receiving the clock signal properly all three LEDs should blink, but at a different rate. If the LEDs on all the clock cards are solid then reboot the GPS computer. When the GPS computer is down, it is best to cycle the power also on the box right above the GPS computer.
If the clock appears to be working properly on other machines and not on the tiptilt now it is time to reboot tiptilt.
[There is a bug in the real time part of the CCD code. It is caused by the clock in the tiptilt system either not running at all or having been set to a time very different from the last time the CCD ran.]
For the time being the only solution is to reboot tiptilt, but do so from the lab. Power OFF the CCD, then reboot the tiptilt machine and go into the BIOS. Make sure that interrupt 11 has been set to ISA legacy, save the BIOS and reboot. When the clock card LEDs in the tiptilt machine indicate proper clock signal, turn the CCD back on and start the tiptilt server.
Also, sometimes Serial Port 3 grabs IRQ 11 which stops the clock from running. Since there is no serial port 2 it's safe to disable this in the BIOS. This problem normally comes up when there has been a power outage.
Sometimes syncing the clock can also cause this problem, but that should be fixed soon. If it does, exit the tiptilt server, log in as root, and reload the tiptilt model using the following commands:
/sbin/rmmod tiptilt_rt
/sgin/insmod /usr/local/modules/tiptilt_rt.o
Note that it is never a good idea to reboot machines unless you are very very sure it is necessary. The only reason to reboot tiptilt, other than a lock up of some kind, is that the clock interrupt has failed. You can test this by running the command “testclock” on a tiptilt command line. If this says the clock is working do not reboot the machine.
You will see the oscillation in the green dots of the tiptilt GUI windows. Sometimes you can also see the oscillation in the white starlight dots or as an elongation of the star when looking at the ACQ field while tiptilt is locked. Some scopes have an oscillation that has not yet been diagnosed. W2 is one that usually oscillates. A diagonal motion in the tiptilt box indicates an oscillation in one axis only, while a vertical/horizontal motion indicates an oscillation in both directions. Motion from the upper right to lower left corresponds to elevation axis while motion from the upper left to lower right corresponds to the azimuth axis. (I think you can check direction by typing sin into telescope server to send sine waves to the telescope.) There are a few ways you can try to correct the oscillation manually tuning the servo:
Try using a slower frame rate or increasing the NSUM. Also ensure that the acquistion is properly aligned with the laser. To change the frame rate, click the [EXP] button on the tiptilt GUI and enter a longer integration time. Remember to change “Tiptilt (mS)” on Cosmic Debris to keep the same exposure time when slewing to the next target.
The bias frame is bad. Get a new one or turn it off.
This usually happens if someone runs a “make clean” in the cvs tree but doesn't follow up with a “make install” on ople. To generate the run_ople file, follow these steps:
This happens most frequently with the E1 beam sampler. If you are doing alignments and are using E1, try to move it forward first to see if it dies. If it does, follow this procedure.
The most common cause for getting multiple copies of a server is using the socket manage RESTART button, which is flaky at best. Don't do this. If you need to restart a server you should do it manually.
1. Make sure you are logged into the right machine:
ssh ctrscrut
2. If you are not sure see if the socket manager will tell you. If it doesn't have a look in the file:
/ctrscrut/chara/etc/sock_manager/socket_manager.list
3. See if there are any ghosts running
ps aux | grep esp_server
Yes, it's hard to know which one it is with the esp servers. You can work out which ones are ghosts by typing the command
tsockman |grep ctrscrut
which will give you a list of the servers running on the machine you are interested in. Checking for non-matching PIDs will tell you which processes you need to stop.
4. Stop those processes:
kill -9 PID1 PID2 ….
5. Make sure there is no sign of it in the socket manager
tsockman rm BS
5. Restart the beam sampler servers (this starts both beam sampler servers BS1 and BS2):
bootlaunch_beamsamp
Cosmic Debris reports “Failed to request position of S1” when trying to set the beam order. This indicates that ople is no longer talking to the beam samplers. If the beam sampler server has been restarted recently, then the ople server will also need to be restarted to re-establish the connection.
The beam sample server runs on ctrscrut. The ople server tries to open a connection to the beam sampler when it starts. If the beam sampler is not there, or dies,
you need to restart the ople server as there is no command to reopen that connection.
To re-establish the VPN connection, follow these steps:
Check to see if Sockman is working. Click the [LIST] button on sockman. If the list doesn't come up, Sockman may be hung up. Follow the Sockman restart procedure in the text file on the desktop if it won't respond.
Hit [REOPEN] on the gui to see if it reconnects with its server. if that does not fix it, the server may be dead. From the LIST on Sockman, select the server suspected of being frozen. Ping it and if it reports back as being dead, see Server is frozen section below.
Telescope guis often freeze. Hit reopen on the gui to bring it back to life. Hitting [MOVE] on the telescope gui before the star has stopped moving can cause the gui to freeze. Avoid doing this. Close the dead one and open a new one to fix the problem.
Try quitting the server using CTRL-C and entering “Y”. If that doesn't work, try the following:
The following error message sometimes appears when starting the PAVO server:
“Error communicating with IFW. Could not read from IFW. Is the filter wheel plugged in and on?”
Most of the time, restarting the PAVO server will clear this error message and allow PAVO to communicate with the filter wheel. If restarting the server doesn't help, then check that the cables going into the small, black IFW box on the PAVO table and into the back of the PAVO computer are plugged in securely.
The command “dbadd” can be entered into a terminal window to look up the CHARA number for a star or to add a star to the CHARA database. To use dbadd, open a terminal window, and type “dbadd starname” where starname is the common name (e.g., Vega) or identifier of the star (e.g., IRC, HR, HD, SAO, FK5, HIP, GJ, or 2MASS designation). If the object is in the database, then it will return the CHARA number.
You can also look up different identifiers for the star by using the SIMBAD database: http://simbad.u-strasbg.fr/simbad/sim-fbasic
DBADD uses SIMBAD to look up the coordinates of the star and then searches to see if the star is already in the CHARA database. If the star is in the database, it will return the CHARA number. If the star is not in the CHARA database, it will ask if you want to add it and assign a CHARA number if you answer yes.
If an object is not in SIMBAD (such as a recently discovered nova), then you must enter the object manually using the instructions below.
Finding a star in the CHARA database
Here is an example of how to find the CHARA number of a star, nova, or AGN that is already in the CHARA database:
[ctrscrut:502] dbadd NGC 4151
Object “NGC 4151” found as CHARA number: 320263
Note: If the target information stored in the CHARA database does not match SIMBAD, then dbadd will provide the coordinates and magnitudes listed in SIMBAD, and it will also list the CHARA numbers of objects in the database located within 10 arcsec. Please check these nearby entries before adding a new star to the database.
Targets that are not in the CHARA database
If an object is not in the CHARA database, then you can use dbadd to query SIMBAD and add the star to the CHARA database. This might need to be done for faint stars, novae, and AGN. If the object is found in SIMBAD, then dbadd will return the target's coordinates, magnitudes, and spectral type and ask if this it the object for which you are looking. If you answer yes, then dbadd will issue a CHARA number and add the object to the database. Please check the target coordinates to make sure that they are correct before adding a new star to the database.
Here is an example of how to add an object to the CHARA database:
[ctrscrut:534] dbadd BD+41 3807
SIMBAD found this for “BD+41 3807”:
ID 2MASS_J20340850+4136592
CHARA 320414
2000.0
CAT8 2MASS_J20340850+4136592
RA 20 34 08.5148
DEC +41 36 59.408
PMRA -2.32
PMDEC -3.87
PAR 0.58
RVEL -27.50
VMAG 10.03
HMAG 6.23
KMAG 5.99
SP O5.5Ifc
END
Is the above the object you are looking for? [y/n] y
Added “BD+41 3807” to the database.
The object “BD+41 3807” has been added to the database as CHARA number 320414.
Targets that are not in the CHARA database or in SIMBAD
Some objects like recently discovered novae are not in SIMBAD. Entering dbadd <star designation> for a star not in the SIMBAD database returns the message “Simbad is unable to find an object matching <star designation>. Try using a different catalog designation, or use the ”-m“ switch to add the object manually.”
The command dbadd -m is used by entering the star name and coordinates in this format:
Usage: dbadd -m <name> <RA> <Dec>
<name>: Object ID (no spaces)
<RA> : XXhXXmXX.X or XXhXX.X (no spaces)
<Dec> : XXdXXmXX.X or XXdXX.X (no spaces)
There are cases where an object is not in SIMBAD and doesn't return a result in dbadd, but is in fact in the CHARA database. Novae and AGN's are the likely objects that cause this result. At times, objects have multiple entries and several CHARA numbers since the names can be so unique. A system will be developed to find these entries without knowing or having a conventional database designation.
Binary stars
Some binary stars have a common HD number with an A or B after them. These can cause problems as Cosmic Debris does not accept non numerical entries when filling in star designation. These stars are likely in CHARA's database but need to be searched in dbadd or on SIMBAD to get the CHARA number or another designation.
When a recognized identifier is entered, the HD number with A or B will usually display. Confirm that the coordinates, magnitudes and spectral type match the star desired. If they do not match, you may have the wrong star or the database may have the wrong info and the baseline solution will be affected. Offsets based on incorrect coordinates or misidentifications can move the fringes many thousands of microns away from the calculated position. This can happen when observing a dim companion (B) using the brighter (A) companion's coordinates. Inform the observers that noting and using the CHARA number will save time next time the target is observed.
Editing the database
If you find a mistake in the database, please send an email to Nils to have it corrected. Identify what you believe to be the error and what is the correct information.
To add an anchor to the wikipage, type the following where you want the anchor inserted (without the spaces between the symbols):
[ [ #AnchorName ] ]
Highlight the text you want to be a link to the anchor, click the link symbol above and select anchor. Select a page(such as Trouble Shooting) where the anchor is located and give the same name for the anchor.
Last updated 2017-04-12