diff --git a/rejected-for-now.txt b/rejected-for-now.txt deleted file mode 100644 index daeaf68..0000000 --- a/rejected-for-now.txt +++ /dev/null @@ -1,95 +0,0 @@ -[For the following function, we have to think hard whether going through -the tangential plane is what we'd like to do; it should go in with -a bunch of other astrometric functions] - -\subsubsection{ivo\_apply\_pm(long, lat, pmlong, pmlat, epochDist)} - -Returns a POINT for the position an object at \texttt{ra}, -\texttt{dec} will be at after \texttt{epochDist} Julian years if its proper -motion is \texttt{prma}, \texttt{pmdec}. Positions must be in degrees, -proper motions are expected in degrees/year. The proper motions must be -given in the tangential plane (i.e., the simple derivative has been -``divided by $cos(\delta)$''). - -Note that this is an operation of spherical geometry, i.e., the function -would work as well with non-equatorial coordinates \emph{and} proper -motions. However, you cannot, of course, mix galactic coordinates with -equatorial proper motions. - -\begin{description} -\item[Parameters] - -\begin{args} - \arg long (REAL) -- longitude of the spherical position, in degrees. - \arg lat (REAL) -- latitude of the spherical position, in degrees. - \arg pmlong (REAL) -- proper motion in longitude in the - tangential plane (i.e., the simple derivative has been divided by - cos(lat)), in degrees per time unit. - \arg pmlat (REAL) -- proper motion in latitude, in degrees per time - unit. - \arg epochDist (REAL) -- propagate the object this many time units. -\end{args} - -\item[Return type] \texttt{POINT} - -\item[Source] This document. -\end{description} - -\begin{examples} -\example \verb|ivo_apply_pm(30, 15, 0, 0.1, 20)| -\becomes \verb|[30, 16.9991882802]| -\done as a 2-array with \xmlel{xtype}=\emph{point}; note that the -latitude here is not 17 because of the gnomonic projection. - -\example \verb|ivo_apply_pm(30, 60, 0.1, 0, 20)| -\becomes \verb|[33.993520433, 59.93965025567]| -\done as a 2-array with \xmlel{xtype}=\emph{point}; note that the motion -along the longitude is a lot longer than time times proper motion -because of latitude effects. -\end{examples} - -Note that this is a minimal, restricted form of ``applying proper -motions''. A full, physically valid treatment requires an object's -distance and radial velocity to reconstruct the actual space motion. -Later versions of this specification may include extensions to this -function supporting this. - -The five-parameter function discussed here should be implemented using -calculations in the tangential plane; the result of the function should -be $$G\big((\mu_l, \mu_b), (l, b)\big),$$ where $G(\vec d, \vec p)$ is the -gnomonic projection of the tangential plane coordinate $\vec d$ and the -tangent point $\vec b$, $l$ and $b$ are \verb|long| and \verb|lat|, -repectively, and $\mu_l$ and $\mu_b$ are \verb|pmlong| and \verb|pmlat|, -respectively. - - - - -[This function may be a good idea in a world with interval-valued -columns; as long as we don't have many of those, it's probably -dispensable] - -\subsubsection{ivo\_interval\_has(value, interval)} - -The function returns 1 if the interval \texttt{interval} contains -\texttt{val}, 0 otherwise. Both limits are always included in -\texttt{interval}. - -\begin{description} -\item[Parameters] - -\begin{args} - \arg value (NUMERIC) -- a value to test for interval membership. - \arg interval (INTERVAL) -- the interval to test against. There are no - guarantees that whatever is put here can be a part of a select list or - that any other operation is possible on it (i.e., the implementation - of the UDF does not mean that some sort of interval is available as a - type in the underlying database engine). -\end{args} - -\item[Return type] \texttt{INTEGER} - -\item[Source] Originally proposed by the roadmap for STC discovery -\citep{note:regstc}; standardised in this document. -\end{description} - diff --git a/udf-catalogue.tex b/udf-catalogue.tex index d9bfd1d..ebcf6a0 100644 --- a/udf-catalogue.tex +++ b/udf-catalogue.tex @@ -384,41 +384,6 @@ \subsubsection{ivo\_epoch\_prop\_pos(ra, dec, parallax, pmra, pmdec,\\ \becomes an error. \end{examples} - -\subsubsection{ivo\_epoch\_prop(ra, dec, parallax, pmra, pmdec, - radial\_velocity, ref\_epoch, out\_epoch)} - -This is epoch\_prop\_pos as described in Sect.~\ref{epoch_prop_pos}, -except it returns a full parameter set at out\_epoch. - -\begin{description} -\item[Parameters] - As for epoch\_prop\_pos. - -\item[Return type] REAL[6], consisting of the longitude and latitude in -degrees, the parallax in mas, the proper motion in longitude and -latitude in mas/yr, and the radial velocity in km/s. As in the input -parameters, the proper motion in longitude is given for the tangential -plane (``has ${\textrm cos}(\delta)$ applied''). - - -\item[Source] This document, version 1.1 -\end{description} - -\begin{examples} -\example \begin{lstlisting} -ivo_epoch_prop(7.606083572, 11.79044105, 125, - 300, -428.8, 52.51, 2016.0, 1992.25) -\end{lstlisting} -\becomes [7.6040614046279735, 11.793270382827929, 125.01993165584682,\\ -300.09877325973605, -428.934593565712, 52.50880381775256] -\example \begin{lstlisting} -ivo_epoch_prop(7.606083572, 11.79044105, 125, - NULL, NULL, NULL, 2016.0, 1992.25) -\end{lstlisting} -\becomes [7.606083572000001, 11.79044105, 125.0, 0.0, 0.0, 0.0] -\end{examples} - \subsubsection{ivo\_geom\_transform(from\_sys, to\_sys, geo)} Transforms ADQL geometries (i.e., at least values of type \verb|POINT|, @@ -1007,7 +972,7 @@ \section{Changes from Previous Versions} \subsection{Changes from EN-1.1} \begin{itemize} -\item Added \verb|ivo_epoch_prop| and \verb|ivo_geom_transform| +\item Added \verb|ivo_geom_transform| as astrometry function (gavo, esa) \item Added \verb|ivo_simbadpoint| as convenience function (gavo, esa) \item Added \verb|ivo_normal_random| as a statistics function (gavo, esa)