You are viewing a plain text version of this content. The canonical link for it is here.

Posted to dev@sis.apache.org by Martin Desruisseaux <ma...@geomatys.com> on 2015/03/25 15:04:15 UTC

Would like advice on a class name

Hello all

We committed recently a class named "UnitaryProjection" [1], but I'm
unsure about this class name since I have not seen this name used
elsewhere. "UnitaryProjection" is the base class of all map projections,
except that it performs its calculation on a unit sphere or an ellipsoid
having a semi-major axis length of 1. The name "Unitary" tries to
emphases that.

We could rename "UnitaryProjection" as "MapProjection", but I'm afraid
that someone seeing "MapProjection" would expect a class performing the
whole map projection process, which is not the case: scale factor, false
easting/northing, conversions from degrees to radians, etc. are done
outside of "UnitaryProjection".

What would peoples prefer?

1) Keep the "UnitaryProjection" name for making clear that this class
does not apply scale factor, etc.
2) Rename as "MapProjection" and hope that the javadoc [1] is
sufficiently clear.
3) Rename into something else ("NormalizedProjection" ?)


    Martin


[1]
https://builds.apache.org/job/sis-dev/javadoc/org/apache/sis/referencing/operation/projection/UnitaryProjection.html

Re: Would like advice on a class name

Posted by Martin Desruisseaux <ma...@geomatys.com>.

Thanks Chris. I went away and renamed "UnitaryProjection" as
"NormalizedProjection". Also added a little bit of MathML:

https://builds.apache.org/job/sis-dev/javadoc/org/apache/sis/referencing/operation/projection/NormalizedProjection.html

    Martin


Le 26/03/15 07:36, Mattmann, Chris A (3980) a écrit :
> I like option #3 :)

Re: Would like advice on a class name

Posted by "Mattmann, Chris A (3980)" <ch...@jpl.nasa.gov>.

I like option #3 :)

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Chris Mattmann, Ph.D.
Chief Architect
Instrument Software and Science Data Systems Section (398)
NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA
Office: 168-519, Mailstop: 168-527
Email: chris.a.mattmann@nasa.gov
WWW:  http://sunset.usc.edu/~mattmann/
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Adjunct Associate Professor, Computer Science Department
University of Southern California, Los Angeles, CA 90089 USA
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++






-----Original Message-----
From: Martin Desruisseaux <ma...@geomatys.com>
Organization: Geomatys
Reply-To: "dev@sis.apache.org" <de...@sis.apache.org>
Date: Wednesday, March 25, 2015 at 7:04 AM
To: Apache SIS <de...@sis.apache.org>
Subject: Would like advice on a class name

>Hello all
>
>We committed recently a class named "UnitaryProjection" [1], but I'm
>unsure about this class name since I have not seen this name used
>elsewhere. "UnitaryProjection" is the base class of all map projections,
>except that it performs its calculation on a unit sphere or an ellipsoid
>having a semi-major axis length of 1. The name "Unitary" tries to
>emphases that.
>
>We could rename "UnitaryProjection" as "MapProjection", but I'm afraid
>that someone seeing "MapProjection" would expect a class performing the
>whole map projection process, which is not the case: scale factor, false
>easting/northing, conversions from degrees to radians, etc. are done
>outside of "UnitaryProjection".
>
>What would peoples prefer?
>
>1) Keep the "UnitaryProjection" name for making clear that this class
>does not apply scale factor, etc.
>2) Rename as "MapProjection" and hope that the javadoc [1] is
>sufficiently clear.
>3) Rename into something else ("NormalizedProjection" ?)
>
>
>    Martin
>
>
>[1]
>https://builds.apache.org/job/sis-dev/javadoc/org/apache/sis/referencing/o
>peration/projection/UnitaryProjection.html