See Software Bisque Featured on PBS!
 
Tbisque
 


Adding objects
User-Defined Data

Background information

TheSky has many ways to add stellar and non-stellar data. If the data exists as a standard ASCII text file it can easily be compiled into a compatible Sky Database file (SDB) using the Database Compiler. Or objects and/or coordinates (Equatorial/Horizon) can also easily be added using the option Data| User-Defined Data.

User Defined-Data

To access the User Defined Data use Data | User Defined Data. Manually adding objects here is easy. Simply enter the coordinates (Equatorial RA/DEC or Horizon Alt/Az) manually or you can choose to snap to the nearest existing object by using CONTROL+LEFT Mouse click to add entries.

Choose the options here

Pick Data Class and Object Type

More details regarding the User-Defined Data can be found in TheSky's documentation.

Manually adding a set of coordinates - Equatorial or Horizon

If you wish to simply type in the coordinates rather than using the "Snap To:" option press the "Add Entry" button. A BLANK record is created. Now for entry number 1 just enter the coordinates here. Select Equatorial or Horizon accordingly.

Record 1

Precess if necessary!

Precessing coordinates

If the input coordinates are Epoch 1950 (or other than Epoch 2000 you can use the "Precess" Button to have them automatically refined to Epoch 2000 coordinates. This EPOCH is then used when compiling the data into and SDB file.

 

The Label field can be used for comments. For example let's say entry 1 is a Gamma Ray Burst. Add a label Gamma Ray Burst in the Label field. Then enter a magnitude if you have one. The default 30 is used for non existent magnitudes. See example below.

Object 1 Gamma Ray Burst 18 mag.

RA/DEC entered manually!

Reality check - Did I enter the data correctly!?

A nice handy feature here is the "CENTER" button on the User-Defined Data dialog. After "adding" a set of coordinates these can be spot checked by going directly to them in TheSky display. Just press Center and you are taken there. See below.

User-Defined object #1 - Gamma Ray Burst

Note the Label entered here!

And there you have it. A newly added object to TheSky.

Wait I don't see the object?

Make sure the Object Type (Reference Point in example) is set to "Visible". Use View | Display Explorer as shown below. Type in Reference Point and you are taken directly there.

Display Explorer

Check it!

And, make sure the "Visible" option is also checked in the User-Defined Data dialog. Upper left corner.

Is Visible checked here?!

Visible must be checked

How do I save the object(s)?

When TheSky document is saved (File Save or File Save As) the User-Defined Data is also saved. You should give it a name that reflects the objects! Or better yet, export the data to an ASCII text file for easy compiling.

Export the data to a text file

The data will be saved in an ASCII text file for easy compiling by using the EXPORT feature.

Export text using Browse!

Choose file name and folder then EXPORT!

Browse | Save As using default SDBs folder

Give it a name here then Save

Sample Exported data - Ready to Compile into an SDB!

;Copyright, Software Bisque, Inc.
>LABEL 1,30
>ALIAS 19,35
>RAHOURS 37,47
>SEARCH 1,30 <-------------------Add this in order to SEARCH the data!
>DECDEGREES 49,60
>CATALOG CLASS=OBJECTS
>LOADMEMORY
>IDENTIFIER Gamma Objects <------Enter a unique Name here!
>OBJECT TYPE 55 <----------------Object Type Reference Point 55
;My Gamma <----------------------This is the COMMENT entered above!
   1                                 2.03944444  33.52583333 18.00 Gamma Ray Burst

Now this ASCII text file named "GAMMA.TXT" is ready to be compiled automatically into a compatible Sky Database file (an SDB) to be searched, labeled, slewed to, and so on. Cool!

Defining the "Find" field for searching

NOTE: Before you can Search your data (Edit | Find) a Find field needs to be specified! There are two ways to accomplish this. First you can "ADD" the Search field in the above header text. Make a new entry.

>SEARCH 1,30

See the above denoting the newly added >SEARCH entry to the header.

 

Or at the point of compiling the data you can DEFINE the search field. To compile the text into an SDB use Data | Import | Browse and located the file name (gamma.txt) in the SDBs folder.

 

On the Import Dialog use the "Define Fields..." button as highlighted below.

Define a "Search" Field here

Create Search Field - then Compile

Define Fields

Highlight columns dragging mouse - then press Find

NOTE: The "Find" field has been assigned to columns 68-81 as shown in the highlighted Columns Section. You can use a SHIFT+Left Mouse Click to see what columns are assigned to what fields.

Left Mouse Click+SHIFT on RA Hours button

Columns 37-47 are highlighted for you

I prefer to ALWAYS add the SEARCH field into the header text! This way it can always be recompiled without being concerned.

Edit  | Find your data

Expand Sky Databases (SDBs)

The individual entries are now shown under the SDB name Gamma Objects.

 

NOTE: Another handy feature is the ability to scroll a list of objects by choosing the Frame Object and/or Object Information. Placing checks here will automatically center the object in the field and also you can have the Object Information dialog shown. Nice!

Can I have different object types in one SDB?

Certainly. The Messier object labels are an example. Because the Messier objects are nebulae, clusters, and galaxies they were compiled as object type "Mixed Deep Sky". This allows them all to be disabled at once.

 

Mixing object types can become confusing depending on the data. Better to use an SDB for a single object type whenever possible.

 

Snapping to Objects - Star Example

Adding existing objects to a list is quite simple. Let's say you have a list of stars with Extra Solar Planets around them. Or a list of alignment stars you want to use and be able to easily identify. Just use the Snap To: Nearest Star as shown here.

Snapping to stars!

Find Star and CONTROL+Left Mouse Click

Snapping to nearest Star Arcturus example

Ready to start Snapping
(CONTROL+Left Mouse Click on stars)

Data from

Arcturus by snapping to

Arcturus example - Snapped to
(CONTROL+Left Mouse Click on star)

See coordinates stamped above

Yep works equally well for Non-Stellar objects as well. Making custom datasets using TheSky is FUN and easy!

 

Now just add the Search field then compile the data into and SDB file.