|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcds.astro.Coo
cds.astro.AstroCoo
This class defines the spherical coordinates used in Astronomy. It associates the coordinates on the sphere (defined in the Coo class) with the system (Astroframe) in which they are expressed. It also includes the accuracy (number of digits) in which the coordinates are expressed, and the epoch of the position.
The typical usage of the AstroCoo class consists in:
Astroframe
,
Astroformat
,
Serialized FormField Summary | |
static byte |
ARCMIN
Definitions of Precisions for the angles |
static byte |
ARCSEC
Definitions of Precisions for the angles |
static byte |
DEG
Definitions of Precisions for the angles |
protected byte |
dlat
The precision (number of decimals+1) of the latitude |
protected byte |
dlon
The precision (number of decimals+1) of the longitude |
static short |
EDIT_2
Editing option to separate the 2 components by a blank |
static short |
EDIT_FRAME
Editing option to insert the name of the frame |
static short |
EDIT_FULL
Editing option to show all decimals |
protected short |
editing
The editing option includes basic options described in Astroformat , plus the EDIT_FRAME, EDIT_FULL and EDIT_2 options. |
double |
epoch
Epoch (Jyr) of the position |
protected byte |
formRA
How RA was entered, see Astroformat |
Astroframe |
frame
The associated frame |
static byte |
MAS
Definitions of Precisions for the angles |
static byte |
NONE
Definitions of Precisions for the angles |
protected byte |
precision
The precision is 0=unknown, 1=DEG, 3=ARCMIN, 5=ARCSEC, 8=MAS, etc . |
Fields inherited from class cds.astro.Coo |
ed, lat, lon, Umatrix3, x, y, z |
Constructor Summary | |
AstroCoo()
Create the default ICRS AstroCoo |
|
AstroCoo(Astroframe frame)
Create an AstroCoo object: specify just frame, equinox, precision. |
|
AstroCoo(Astroframe frame,
AstroCoo coo)
Create an AstroCoo object from an existing one. |
|
AstroCoo(Astroframe frame,
Coo coo)
Create an AstroCoo object with a known position. |
|
AstroCoo(Astroframe frame,
Coo coo,
double epoch)
Create an AstroCoo object with a known position + Epoch |
|
AstroCoo(Astroframe frame,
double lon,
double lat)
Create an AstroCoo object with a known position. |
|
AstroCoo(Astroframe frame,
double lon,
double lat,
double epoch)
Create an AstroCoo object with a known position at given epoch. |
|
AstroCoo(Astroframe frame,
java.lang.String text)
Create an AstroCoo object from a position (Epoch) |
Method Summary | |
void |
convertFrom(AstroCoo coo)
Transform the celestial position given in the argument into its own frame. |
void |
convertTo(Astroframe new_frame)
Transform the position into another frame. |
void |
dump(java.lang.String title)
Dump the contents of an AstroCoo. |
java.lang.StringBuffer |
edit(java.lang.StringBuffer buf,
java.lang.String options)
Customized edition of Coordinates to a StringBuffer, with a specified width of the edited position. |
boolean |
equals(java.lang.Object o)
Compare 2 coordinates. |
static java.lang.String |
explain(int editing)
Explain the editing option of the coordinate |
int |
getEditing()
Get the defaut editing option. |
Astroframe |
getFrame()
Get an explicit designation of the frame |
byte |
getLatPrec()
Acces a la precision sur la longitude |
byte |
getLonPrec()
Acces a la precision sur la latitude |
static int |
getOptions(java.lang.String text)
Convert the String of options into an integer |
int |
getPrecision()
Get the precision of the current value |
int |
parse(java.lang.String txt,
int offset)
Parsing method: interpret a String. |
boolean |
parsing(Parsing txt)
Interpret the string and convert to Coo + Epoch. |
void |
set(AstroCoo coo)
Set a position from an ezxisting one (copy). |
void |
set(Coo coo,
double epoch)
Set position + epoch. |
void |
set(java.lang.String text)
Set a position from a text which may contain position and Epoch. |
void |
setEditing(int edit_option)
Change the default way of edition |
void |
setEpoch(double epoch)
Change the Epoch of the data |
void |
setPrecision(int precision)
Change the precision of the data |
java.lang.String |
toString()
Default edition: use what's stored |
java.lang.String |
toString(java.lang.String options)
Customized edition of Coordinates to a String |
Methods inherited from class cds.astro.Coo |
add, add, copyAngles, copyUvector, dist, dist, edit, edit, eulerMatrix, getLat, getLon, localMatrix, localMatrix, moveMatrix, normalize, normalize, parsing, rotate_1, rotate, rotateVector_1, rotateVector, set, set, set, set, set, setEquatorial, sub, sub, toString, toString |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
public Astroframe frame
public double epoch
protected byte dlon
protected byte dlat
protected byte precision
protected byte formRA
Astroformat
protected short editing
Astroformat
, plus the EDIT_FRAME, EDIT_FULL and EDIT_2 options.
It can be changed via the setEditing(int)
method.
public static final byte NONE
public static final byte DEG
public static final byte ARCMIN
public static final byte ARCSEC
public static final byte MAS
public static final short EDIT_FRAME
public static final short EDIT_FULL
public static final short EDIT_2
Constructor Detail |
public AstroCoo()
public AstroCoo(Astroframe frame)
frame
- one of the possible Astroframespublic AstroCoo(Astroframe frame, double lon, double lat)
frame
- one of the possible Astroframeslon
- Longitude of the position (degrees)lat
- Latitude of the position (degrees)public AstroCoo(Astroframe frame, Coo coo)
frame
- one of the possible Astroframescoo
- the position.public AstroCoo(Astroframe frame, AstroCoo coo)
frame
- one of the possible Astroframescoo
- the position in some other frame.public AstroCoo(Astroframe frame, Coo coo, double epoch)
frame
- one of the possible Astroframescoo
- the position.epoch
- Epoch of the position, in Jyr (see Astrotime)public AstroCoo(Astroframe frame, double lon, double lat, double epoch)
frame
- one of the possible Astroframeslon
- Longitude of the position (degrees)lat
- Latitude of the position (degrees)epoch
- Epoch of the position, in Jyr (see Astrotime)public AstroCoo(Astroframe frame, java.lang.String text) throws java.text.ParseException
frame
- one of the possible Astroframestext
- Text with position, possibly followed by an epoch.
Valid texts are e.g.
"12 34 12.45 -42 12 76.4 J1991.25" or
"12 34 12.45 -42 12 76.4 (J1991.25)"Method Detail |
public static final java.lang.String explain(int editing)
public boolean parsing(Parsing txt)
txt
- to interpret as a Parsing object "12 34.5 -72 54 J1991.25"
public int parse(java.lang.String txt, int offset)
parse
in class Coo
txt
- to interpret.offset
- starting position in text
public void set(AstroCoo coo)
coo
- the AstroCoo to opy.public void set(java.lang.String text) throws java.text.ParseException
set
in class Coo
text
- Longitude + latitude in text
java.text.ParseException
- when the string is not interpretablepublic void set(Coo coo, double epoch)
coo
- the lon+latepoch
- the epoch.public void setPrecision(int precision)
precision
- integer number, typically one of the values NONE (0),
DEG (1), ARCMIN (3), ARCSEC (5), MAS (8);
use ARCSEC+1 for 0.1arcsec, MAS-1 for 10mas, etc...public void setEditing(int edit_option)
edit_option
- A mixture of Astroformat
options,
and EDIT_FRAME EDIT_FULL.public void setEpoch(double epoch)
epoch
- the epoch of the coordinatespublic final Astroframe getFrame()
public final int getPrecision()
public byte getLonPrec()
public byte getLatPrec()
public final int getEditing()
public void dump(java.lang.String title)
dump
in class Coo
title
- A title to precede the dumppublic boolean equals(java.lang.Object o)
equals
in class Coo
o
- Objet a comparer.
public static int getOptions(java.lang.String text) throws java.text.ParseException
text
- List of options:d = edit in Decimal s = edit in Sexagesimal : = separate sexagesimal parts with the colon f = edit also the frame (system+equinox) F = edit in full precision (ignore the precision of the system)
java.text.ParseException
public java.lang.StringBuffer edit(java.lang.StringBuffer buf, java.lang.String options) throws java.text.ParseException
buf
- the buffer filled with the edited positionoptions
- a string with the option letters defined in editing_options
java.text.ParseException
public java.lang.String toString(java.lang.String options) throws java.text.ParseException
options
- a string with the option letters (see edit)
java.text.ParseException
getOptions(java.lang.String)
public java.lang.String toString()
toString
in class Coo
public void convertTo(Astroframe new_frame)
new_frame
- The frame of the resulting position.public void convertFrom(AstroCoo coo)
coo
- Position expressed in some other frame (not modified)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |