AstroCC Coordinate Converter for Astronomy - Revision history

WikiSysop at 19:53, 17 March 2016

2016-03-17T19:53:20Z

WikiSysop at 19:50, 17 March 2016

2016-03-17T19:50:10Z

@@ Line 19: / Line 19: @@
 ==Installation==
-You may run AstroCC through your browser, or download a copy of AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc].  Depending on your applications and location, you may prefer to change the defaults on first use.  For example, by default the software opens to use the Simbad resolver in the US, but the one in France is better if you are in Europe. Select your location. When you exit and start AstroCC a second time, the defaults will be replaced by your new selections.
+You should  download a copy of the most recent AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc].  Depending on your applications and location, you may prefer to change the defaults on first use.  For example, by default the software opens to use the Simbad resolver in the US, but the one in France is better if you are in Europe. Select your location. When you exit and start AstroCC a second time, the defaults will be replaced by your new selections.
 '''Linux'''

John: /* Installation */

2012-03-07T03:55:19Z

Installation

← Older revision		Revision as of 03:55, 7 March 2012
Line 24:		Line 24:
	'''Browser'''		'''Browser'''

	~~First, if it does not work test whether you have a working recent version of Java installed:~~

	<center>[http://www.~~java~~.~~com~~/en/~~download~~/~~help~~/~~testvm~~.~~xml Java Browser Test~~]</center>		First, on most systems simply click the link to the "webstart" file on our server:

			<center>[http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp]</center>


			Second, if it does not work test whether you have a working recent version of Java installed:

	~~On most systems simply click the link to the "webstart" file on our server~~:		<center>[http://www.java.com/en/download/help/testvm.xml Java Browser Test]</center>

	~~<center>[http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp]</center>~~

	If your computer has the Java Run Time Environment installed, your browser should detect the file type and start a copy of AstroCC on your system. In some cases you may be asked what to use to run the program. Try "/usr/bin/javaws" on Linux systems that have the Sun version of Java installed. We have found that setting "javaws" as the application to open all files with an extension "jnlp" on systems that couple the file selection to the browser will make this automatic. Typically this is for OpenSuse vesions of Linux.		Third, if your computer has the Java Run Time Environment installed, your browser should detect the file type and start a copy of AstroCC on your system. In some cases you may be asked what to use to run the program. Try "/usr/bin/javaws" on Linux systems that have the Sun version of Java installed. We have found that setting "javaws" as the application to open all files with an extension "jnlp" on systems that couple the file selection to the browser will make this automatic. Typically this is for OpenSuse vesions of Linux.

	Google's Chrome browser will store the file by default rather than run it. After you have stored it, right click the file name at the bottom of the Google Chrome browser window, and select the check box that says "Always Open Files of This Type". After that, when you again try to run the software through the web it will start automatically.		Google's Chrome browser will store the file by default rather than run it. After you have stored it, right click the file name at the bottom of the Google Chrome browser window, and select the check box that says "Always Open Files of This Type". After that, when you again try to run the software through the web it will start automatically.

John: /* Installation */

2012-03-07T03:54:08Z

Installation

← Older revision		Revision as of 03:54, 7 March 2012
Line 34:		Line 34:

	If your computer has the Java Run Time Environment installed, your browser should detect the file type and start a copy of AstroCC on your system. In some cases you may be asked what to use to run the program. Try "/usr/bin/javaws" on Linux systems that have the Sun version of Java installed. We have found that setting "javaws" as the application to open all files with an extension "jnlp" on systems that couple the file selection to the browser will make this automatic. Typically this is for OpenSuse vesions of Linux.		If your computer has the Java Run Time Environment installed, your browser should detect the file type and start a copy of AstroCC on your system. In some cases you may be asked what to use to run the program. Try "/usr/bin/javaws" on Linux systems that have the Sun version of Java installed. We have found that setting "javaws" as the application to open all files with an extension "jnlp" on systems that couple the file selection to the browser will make this automatic. Typically this is for OpenSuse vesions of Linux.

			Google's Chrome browser will store the file by default rather than run it. After you have stored it, right click the file name at the bottom of the Google Chrome browser window, and select the check box that says "Always Open Files of This Type". After that, when you again try to run the software through the web it will start automatically.

John: /* Installation */

2012-03-07T03:49:40Z

Installation

← Older revision		Revision as of 03:49, 7 March 2012
Line 19:		Line 19:
	==Installation==		==Installation==

	You may run AstroCC through your browser, or download a copy of AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc]. Depending on your ~~uses~~ and location, you may prefer to change the defaults on first use. For example, by default the software opens to use the Simbad resolver in the US, but the one in France is better if you are in Europe. Select your ~~site~~. When you exit and start AstroCC a second time, the defaults will be replaced by your new selections.		You may run AstroCC through your browser, or download a copy of AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc]. Depending on your applications and location, you may prefer to change the defaults on first use. For example, by default the software opens to use the Simbad resolver in the US, but the one in France is better if you are in Europe. Select your location. When you exit and start AstroCC a second time, the defaults will be replaced by your new selections.

John: /* Installation */

2012-03-07T03:48:48Z

Installation

← Older revision		Revision as of 03:48, 7 March 2012
Line 19:		Line 19:
	==Installation==		==Installation==

	You may run AstroCC through your browser, or download a copy of AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc]. Depending on your uses and location, you may prefer to change the defaults on first use. For example, by default the software opens to use the Simbad resolver in the US, but the one in France is better if you are in Europe.		You may run AstroCC through your browser, or download a copy of AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc]. Depending on your uses and location, you may prefer to change the defaults on first use. For example, by default the software opens to use the Simbad resolver in the US, but the one in France is better if you are in Europe. Select your site. When you exit and start AstroCC a second time, the defaults will be replaced by your new selections.

John: /* Installation */

2012-03-07T03:47:37Z

Installation

← Older revision		Revision as of 03:47, 7 March 2012
Line 19:		Line 19:
	==Installation==		==Installation==

	You may run AstroCC through your browser, or download a copy of AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc].		You may run AstroCC through your browser, or download a copy of AstroCC.jar from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc]. Depending on your uses and location, you may prefer to change the defaults on first use. For example, by default the software opens to use the Simbad resolver in the US, but the one in France is better if you are in Europe.

John at 03:46, 7 March 2012

2012-03-07T03:46:15Z

← Older revision		Revision as of 03:46, 7 March 2012
Line 7:		Line 7:
	The current version of AstroCC ...		The current version of AstroCC ...

	*Uses Java and runs on any Linux, Mac, and Windows		*Uses Java and runs on any Linux, Mac, and Windows system
	*Accesses SIMBAD		*Accesses SIMBAD
	*Provides ephemerides for the Moon and major planets		*Provides ephemerides for the Moon and major planets

John: /* Installation */

2012-03-07T03:39:56Z

Installation

← Older revision		Revision as of 03:39, 7 March 2012
Line 23:		Line 23:

	'''Browser'''		'''Browser'''

			First, if it does not work test whether you have a working recent version of Java installed:

			<center>[http://www.java.com/en/download/help/testvm.xml Java Browser Test]</center>


	On most systems simply click the link to the "webstart" file on our server:		On most systems simply click the link to the "webstart" file on our server:
Line 28:		Line 33:
	<center>[http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp]</center>		<center>[http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp http://www.astro.louisville.edu/software/astrocc/astrocc.jnlp]</center>

	If your computer has the Java Run Time Environment installed, your browser should detect the file type and start a copy of AstroCC on your system. In some cases you may be asked what to use to run the program. Try "/usr/bin/javaws" on Linux systems that have the Sun version of Java installed.		If your computer has the Java Run Time Environment installed, your browser should detect the file type and start a copy of AstroCC on your system. In some cases you may be asked what to use to run the program. Try "/usr/bin/javaws" on Linux systems that have the Sun version of Java installed. We have found that setting "javaws" as the application to open all files with an extension "jnlp" on systems that couple the file selection to the browser will make this automatic. Typically this is for OpenSuse vesions of Linux.

John: /* Installation */

2012-03-07T03:35:46Z

Installation

← Older revision		Revision as of 03:35, 7 March 2012
Line 22:		Line 22:


	~~```~~Browser'''		'''Browser'''

	On most systems simply click the link to the "webstart" file on our server:		On most systems simply click the link to the "webstart" file on our server:

← Older revision		Revision as of 19:53, 17 March 2016
Line 39:		Line 39:

	AstroCC can be started in Windows by double-clicking the AstroCC.jar file		AstroCC can be started in Windows by double-clicking the AstroCC.jar file


	==Overview==		==Overview==
Line 57:		Line 58:

	[[File:Astrocc.jpg\|600px\|center]]		[[File:Astrocc.jpg\|600px\|center]]


	==Numbers, Bases, Formats, and Indicators==		==Numbers, Bases, Formats, and Indicators==
Line 63:		Line 65:

	RA and UT time must be entered in hours. All other coordinate numbers must be entered in degrees. Observatory latitude is in degrees (north positive) and observatory longitude is in degrees (east positive). Proper motion is in SIMBAD milli-arcsec per year (mas/yr) format. UT Date is in YYYY MM DD.DD format. Hour Angle (HA) is reported in the range -12:00:00 to 00:00:00 indicating sidereal hours until the object crosses the meridian and 00:00:00 to 12:00:00 indicating sidereal hours since the meridian crossing. All numbers except UT date can be entered in decimal format (i.e. dd.dddd) or in sexagesimal format (i.e. dd mm ss.ss). To facilitate cut and paste of coordinates from other sources, sexagesimal parsing is very lenient and treats any contiguous set of nonnumeric characters as a delimiter. For convenience, both coordinates of a pair can be typed (or cut/pasted) into one of the boxes of a pair in sexagesimal format. When <Enter> is pressed, the first coordinate will be automatically placed in the left-most box of the pair and the second coordinate will be placed in the right-most box. A decimal format number must be entered directly into its corresponding box.		RA and UT time must be entered in hours. All other coordinate numbers must be entered in degrees. Observatory latitude is in degrees (north positive) and observatory longitude is in degrees (east positive). Proper motion is in SIMBAD milli-arcsec per year (mas/yr) format. UT Date is in YYYY MM DD.DD format. Hour Angle (HA) is reported in the range -12:00:00 to 00:00:00 indicating sidereal hours until the object crosses the meridian and 00:00:00 to 12:00:00 indicating sidereal hours since the meridian crossing. All numbers except UT date can be entered in decimal format (i.e. dd.dddd) or in sexagesimal format (i.e. dd mm ss.ss). To facilitate cut and paste of coordinates from other sources, sexagesimal parsing is very lenient and treats any contiguous set of nonnumeric characters as a delimiter. For convenience, both coordinates of a pair can be typed (or cut/pasted) into one of the boxes of a pair in sexagesimal format. When <Enter> is pressed, the first coordinate will be automatically placed in the left-most box of the pair and the second coordinate will be placed in the right-most box. A decimal format number must be entered directly into its corresponding box.


	==Preferences==		==Preferences==

	Several options are provided under the Preferences pull-down menu at the top of the user window. After closing the program for the first time, a new file named “AstroCC_Prefs.txt” will be created. On Microsoft Windows computers, the file is saved in the same directory as the AstroCC.jar file (AstroCC should be installed in a directory with user write access). On Linux systems, the preferences file will be saved at each users /home/username/astrocc/AsctroCC_Prefs.txt. On an Apple Mac computer, the file is saved at user/home/Library/Preferences/AstroCC_Prefs.txt. This file will automatically reload on startup and allows preferences, leap seconds, and other settings to be maintained across sessions.		Several options are provided under the Preferences pull-down menu at the top of the user window. After closing the program for the first time, a new file named “AstroCC_Prefs.txt” will be created. On Microsoft Windows computers, the file is saved in the same directory as the AstroCC.jar file (AstroCC should be installed in a directory with user write access). On Linux systems, the preferences file will be saved at each users /home/username/astrocc/AsctroCC_Prefs.txt. On an Apple Mac computer, the file is saved at user/home/Library/Preferences/AstroCC_Prefs.txt. This file will automatically reload on startup and allows preferences, leap seconds, and other settings to be maintained across sessions.


	==Show coordinates in sexagesimal format==		==Show coordinates in sexagesimal format==
Line 72:		Line 76:
	*deselected – all coordinates are displayed in decimal format (i.e. dd.dddd or hh.hhhh)		*deselected – all coordinates are displayed in decimal format (i.e. dd.dddd or hh.hhhh)
	*selected - all coordinates are displayed in sexagesimal format (i.e. dd:mm:ss.ss or hh:mm:ss.ss)		*selected - all coordinates are displayed in sexagesimal format (i.e. dd:mm:ss.ss or hh:mm:ss.ss)


	==Use Harvard SIMBAD Server, deselect to use CDS Server==		==Use Harvard SIMBAD Server, deselect to use CDS Server==
Line 77:		Line 82:
	*deselected – use the SIMBAD server at the Centre de données astronomiques de Strasbourg (CDS), France		*deselected – use the SIMBAD server at the Centre de données astronomiques de Strasbourg (CDS), France
	*selected – use the SIMBAD server at Harvard		*selected – use the SIMBAD server at Harvard


	==Use Ohio State BJD Server, deselect to calculate internally==		==Use Ohio State BJD Server, deselect to calculate internally==
Line 82:		Line 88:
	*deselected – calculate BJD internally (slightly less accurate, but fast and requires no internet access)		*deselected – calculate BJD internally (slightly less accurate, but fast and requires no internet access)
	*selected – use the Ohio State server to calculate BJD (more accurate, but slower and requires internet connectivity)		*selected – use the Ohio State server to calculate BJD (more accurate, but slower and requires internet connectivity)


	==Use computer time zone, deselect to manually enter offset from UTC==		==Use computer time zone, deselect to manually enter offset from UTC==
Line 87:		Line 94:
	*deselected – enter offset from UTC in the Time Zone field		*deselected – enter offset from UTC in the Time Zone field
	*selected – use the time zone of the host computer’s internal clock		*selected – use the time zone of the host computer’s internal clock


	==Use 12-hour local clock format, deselect to use 24 hour format==		==Use 12-hour local clock format, deselect to use 24 hour format==
Line 92:		Line 100:
	*deselected – display Local time in 24-hour format		*deselected – display Local time in 24-hour format
	*selected – display Local time in 12-hour (AM/PM) format		*selected – display Local time in 12-hour (AM/PM) format


	==Show local twilight times, deselect for UTC format==		==Show local twilight times, deselect for UTC format==
Line 97:		Line 106:
	*deselected – display twilight times in Local format		*deselected – display twilight times in Local format
	*selected – display twilight times in UTC format		*selected – display twilight times in UTC format


	==Show tooltips==		==Show tooltips==
Line 104:		Line 114:
	*deselected – deactivates tooltip field specific help		*deselected – deactivates tooltip field specific help
	*selected – enables display of tooltips field specific help		*selected – enables display of tooltips field specific help


	==Include proper motion correction==		==Include proper motion correction==
Line 109:		Line 120:
	*deselected – do not include proper motion correction to Epoch of Interest coordinates		*deselected – do not include proper motion correction to Epoch of Interest coordinates
	*selected – include proper motion correction to Epoch of Interest coordinates		*selected – include proper motion correction to Epoch of Interest coordinates


	==Include precession correction==		==Include precession correction==
Line 114:		Line 126:
	*deselected – do not include precession correction to Epoch of Interest coordinates		*deselected – do not include precession correction to Epoch of Interest coordinates
	*selected – include proper motion correction to Epoch of Interest coordinates		*selected – include proper motion correction to Epoch of Interest coordinates


	==Include nutation correction==		==Include nutation correction==
Line 119:		Line 132:
	*deselected – do not include nutation correction to Epoch of Interest coordinates		*deselected – do not include nutation correction to Epoch of Interest coordinates
	*selected – include nutation correction to Epoch of Interest coordinates		*selected – include nutation correction to Epoch of Interest coordinates


	==Include stellar aberration correction==		==Include stellar aberration correction==
Line 124:		Line 138:
	*deselected – do not include nutation correction to Epoch of Interest coordinates		*deselected – do not include nutation correction to Epoch of Interest coordinates
	*selected – include nutation correction to Epoch of Interest coordinates		*selected – include nutation correction to Epoch of Interest coordinates


	==Include atmospheric refraction correction to altitude==		==Include atmospheric refraction correction to altitude==
Line 143:		Line 158:

	All numeric entries should be entered as decimal numbers (not sexagesimal). Latitude is in degrees (positive north). Longitude is in degrees (positive east). Altitude is in meters above mean sea level.		All numeric entries should be entered as decimal numbers (not sexagesimal). Latitude is in degrees (positive north). Longitude is in degrees (positive east). Altitude is in meters above mean sea level.


	==About==		==About==

	Help: Report problems to ~~karen_dot_collins_at_insightbb_dot_com~~.		Help: Report problems to karenacollins_at_outlook_com.

	Availability: AstroCC is open source software and is distributed under the terms of the GNU General Public License. It is available from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc].		Availability: AstroCC is open source software and is distributed under the terms of the GNU General Public License. It is available from [http://www.astro.louisville.edu/software/astrocc http://www.astro.louisville.edu/software/astrocc].

	Credits: Parts of AstroCC are based on XmTel, WCSTools, Nuvola icons, and ImageJ open source software packages. Solar system object coordinate calculations and internal HJD/BJD calculations are based on code adapted from JSkyCalc which was written by John Thorstensen of Dartmouth College. BJD values may also be retrieved from http://astroutils.astronomy.ohio-state.edu/time/utc2bjd.html which is based on Eastman et al. 2010. Coordinate data are obtained from SIMBAD. Leap second data is obtained from the U.S. Naval Observatory at http://maia.usno.navy.mil/ser7/tai-utc.dat. The observatory data were compiled from the ESO website at http://www.eso.org/~ndelmott/obs_sites.htm which credits the U.S. Naval Observatory and the H.M. Nautical Almanac Office. The lunar phase images are adapted from Lunar_libration_with_phase_Oct_2007.gif from Wikimedia Commons (submitted by Tom Ruen).		Credits: Parts of AstroCC are based on XmTel, WCSTools, Nuvola icons, and ImageJ open source software packages. Solar system object coordinate calculations and internal HJD/BJD calculations are based on code adapted from JSkyCalc which was written by John Thorstensen of Dartmouth College. BJD values may also be retrieved from http://astroutils.astronomy.ohio-state.edu/time/utc2bjd.html which is based on Eastman et al. 2010. Coordinate data are obtained from SIMBAD. Leap second data is obtained from the U.S. Naval Observatory at http://maia.usno.navy.mil/ser7/tai-utc.dat. The observatory data were compiled from the ESO website at http://www.eso.org/~ndelmott/obs_sites.htm which credits the U.S. Naval Observatory and the H.M. Nautical Almanac Office. The lunar phase images are adapted from Lunar_libration_with_phase_Oct_2007.gif from Wikimedia Commons (submitted by Tom Ruen). We gratefully acknowledge contributions from Cheolha (Pedro) Lee of Ball Aerospace.