[WIP] Frames

.appveyor/install_numpy.py → .appveyor/install_numpy_scipy.py

@@ -10,15 +10,14 @@
 from six.moves.urllib.request import urlretrieve
 
 
-def download_numpy_wheel():
-    base_url = os.getenv('NUMPY_URL')
+def download_wheel(name, version):
+    base_url = os.getenv('WHEEL_URL')
     if base_url is None:
-        raise ValueError('NUMPY_URL environment variable is missing.')
+        raise ValueError('WHEEL_URL environment variable is missing.')
 
-    version = '1.10.4+mkl'
     py = 'cp{0[0]}{0[1]}'.format(sys.version_info)
     if py not in {'cp27', 'cp34', 'cp35'}:
-        print('NumPy wheel not available for {}'.format(py))
+        print('{} wheel not available for {}'.format(name, py))
         return None
 
     bits = struct.calcsize('P') * 8
@@ -29,26 +28,38 @@ def download_numpy_wheel():
     else:
         raise ValueError("Couldn't determine 32/64 bits.")
 
-    filename = 'numpy-{}-{}-none-{}.whl'.format(version, py, arch)
+    filename = '{}-{}-{}-none-{}.whl'.format(name, version, py, arch)
 
-    directory = 'astrodynamics-numpy-wheels'
-    os.mkdir(directory)
+    directory = 'astrodynamics-wheels'
+    try:
+        os.mkdir(directory)
+    except OSError:
+        pass
 
     filepath = os.path.join(directory, filename)
     url = base_url + filename
 
-    # Disable SSL. Shouldn't do this ever. This is just a script.
-    ssl._create_default_https_context = ssl._create_unverified_context
     urlretrieve(url, filepath)
     return filepath
 
 
 def install_numpy():
-    filepath = download_numpy_wheel()
+    filepath = download_wheel('numpy', '1.10.4+mkl')
     if filepath:
         pip.main(['install', filepath])
     else:
         pip.main(['install', 'numpy'])
 
+
+def install_scipy():
+    filepath = download_wheel('scipy', '0.17.0')
+    if filepath:
+        pip.main(['install', filepath])
+    else:
+        pip.main(['install', 'scipy'])
+
 if __name__ == '__main__':
+    # Disable SSL. Shouldn't do this ever. This is just a script.
+    ssl._create_default_https_context = ssl._create_unverified_context
     install_numpy()
+    install_scipy()

.travis.yml

@@ -5,6 +5,16 @@ cache:
     - $HOME/.cache/pip
     # OS X cache not yet enabled: https://github.com/travis-ci/travis-ci/issues/4011
     - $HOME/Library/Caches/pip
+addons:
+  apt:
+    packages:
+    - libatlas-dev
+    - libatlas-base-dev
+    - liblapack-dev
+    - gfortran
+env:
+  global:
+    - TOX_TESTENV_PASSENV=CI
 matrix:
   include:
     - python: 2.7
@@ -24,6 +34,10 @@ matrix:
       addons:
         apt:
           packages:
+            - libatlas-dev
+            - libatlas-base-dev
+            - liblapack-dev
+            - gfortran
             - libenchant-dev
             - graphviz
     - language: generic

.travis/install.sh

@@ -22,12 +22,12 @@ if [[ "$(uname -s)" == 'Darwin' ]]; then
             pyenv global 3.3.6
             ;;
         py34)
-            pyenv install 3.4.3
-            pyenv global 3.4.3
+            pyenv install 3.4.4
+            pyenv global 3.4.4
             ;;
         py35)
-            pyenv install 3.5.0
-            pyenv global 3.5.0
+            pyenv install 3.5.1
+            pyenv global 3.5.1
             ;;
     esac
     pyenv rehash
@@ -38,4 +38,9 @@ fi
 
 python -m virtualenv ~/.venv
 source ~/.venv/bin/activate
-pip install tox codecov
+pip install -U tox codecov setuptools wheel
+
+# Build wheels for cache, but do it here so pip output prevents Travis timing out.
+# We install numpy since it has to be installed before we can build scipy wheel.
+pip install numpy
+pip install scipy

appveyor.yml

@@ -7,7 +7,7 @@ environment:
     # /E:ON and /V:ON options are not enabled in the batch script intepreter
     # See: http://stackoverflow.com/a/13751649/163740
     BUILD: "cmd /E:ON /V:ON /C .\\.appveyor\\build.cmd"
-    NUMPY_URL:
+    WHEEL_URL:
       secure: drCgBIMN3vdVjPRXNyiBAHa4g9VeRmnylFuhd7aUUA7XYhA8FfyJ5bHdXtzkFhgT6GzUSXqp19RcXW6DOX9eow==
 
   matrix:
@@ -41,7 +41,7 @@ install:
   - python -m virtualenv C:\projects\venv
   - C:\projects\venv\Scripts\activate.bat
   - pip install -U codecov coverage setuptools six wheel
-  - "%BUILD% python .appveyor\\install_numpy.py"
+  - "%BUILD% python .appveyor\\install_numpy_scipy.py"
   - "%BUILD% pip install .[test]"
 
 build: off

dev-requirements.txt

@@ -0,0 +1,18 @@
+-e .[test]
+doc8
+flake8
+flake8-coding
+flake8-future-import
+isort
+pep8-naming
+plumbum>=1.6.0
+pyenchant
+pytest-cov
+shovel
+sphinx>=1.4.0
+sphinx_rtd_theme
+sphinxcontrib-spelling
+tabulate
+tox
+twine
+watchdog

docs/astrodynamics-docs.py

@@ -1,7 +1,7 @@
 # coding: utf-8
 # This file is dual licensed under the terms of the Apache License, Version
-# 2.0, and the BSD License. See the LICENSE file in the root of this repository
-# for complete details.
+# 2.0, and the BSD License. See the licenses/CRYPTOGRAPHY.txt file in this
+# repository for complete details.
 #
 # This file is adapted from cryptography-docs.py by the The Cryptography
 # Developers.

docs/conf.py

@@ -41,6 +41,8 @@
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
+    'sphinx.ext.autosectionlabel',
+    'sphinx.ext.doctest',
     'sphinx.ext.inheritance_diagram',
     'sphinx.ext.intersphinx',
     'sphinx.ext.mathjax',

docs/development/getting-started.rst

@@ -4,15 +4,15 @@ Getting started
 
 Working on ``astrodynamics`` requires the installation of some
 development dependencies. These can be installed in a `virtualenv`_
-using `pip`_ with the ``dev`` extras. You should install
-``astrodynamics`` in ``editable`` mode.
+using `pip`_ with the ``dev-requirements.txt`` file. This installs the
+dependencies and installs ``astrodynamics`` in editable mode.
 
 For example:
 
 .. code-block:: console
 
     $ # Create a virtualenv and activate it
-    $ pip install --editable .[dev]
+    $ pip install -r dev-requirements.txt
 
 You are now ready to run the tests and build the documentation.
 

docs/module.rst

@@ -7,4 +7,7 @@ Module Reference
 
   modules/bodies/index
   modules/constants
+  modules/frames/index
+  modules/lowlevel/index
+  modules/rotation
   modules/utils/index

docs/modules/constants.rst

@@ -136,4 +136,4 @@ WGS84_MU                           WGS84 geocentric gravitational constant
 WGS84_ANGULAR_VELOCITY             WGS84 nominal earth mean angular velocity        World Geodetic System 1984
 =================================  ===============================================  ===============================================================
 
-.. _`license`: https://raw.githubusercontent.com/python-astrodynamics/astrodynamics/master/licenses/ASTROPY_LICENSE.txt
+.. _`license`: https://raw.githubusercontent.com/python-astrodynamics/astrodynamics/master/licenses/ASTROPY.txt

docs/modules/frames/frame.rst

@@ -0,0 +1,7 @@
+********************
+Frame Implementation
+********************
+
+.. automodule:: astrodynamics.frames.frame
+    :members:
+    :show-inheritance:

docs/modules/frames/index.rst

@@ -0,0 +1,11 @@
+******
+Frames
+******
+
+.. py:module:: astrodynamics.frames
+
+.. toctree::
+    :maxdepth: 2
+
+    frame
+    mod

docs/modules/frames/mod.rst

@@ -0,0 +1,7 @@
+**************************
+Mean Equinox of Date Frame
+**************************
+
+.. automodule:: astrodynamics.frames.mod
+    :members:
+    :show-inheritance:

docs/modules/lowlevel/index.rst

@@ -0,0 +1,8 @@
+*********
+Low Level
+*********
+
+.. py:module:: astrodynamics.frames
+
+.. toctree::
+   :maxdepth: 2

docs/modules/rotation.rst

@@ -0,0 +1,58 @@
+*********
+Rotations
+*********
+
+.. currentmodule:: astrodynamics.rotation
+
+.. autoclass:: astrodynamics.rotation.Rotation
+   :members: __init__, from_axis_angle, from_matrix, from_euler_angles, angle,
+             get_axis, get_angles, matrix, apply_to, compose, distance_to
+   :show-inheritance:
+
+.. autoclass:: astrodynamics.rotation.RotationOrder
+   :members:
+   :show-inheritance:
+
+Rotation Convention
+===================
+
+Vector Operator
+---------------
+
+Pass ``convention='vector'`` to use the semantics of a vector operator.
+According to this convention, the rotation moves vectors with respect to a fixed
+reference frame.
+
+This means that if we define rotation r is a 90 degrees rotation around the Z
+axis, the image of vector I would be J, the image of vector J would be -I, the
+image of vector K would be K, and the image of vector with coordinates (1, 2, 3)
+would be vector (-2, 1, 3). This means that the vector rotates counterclockwise.
+
+The difference with the frame transform convention is only the semantics of the
+sign of the angle. It is always possible to create or use a rotation using
+either convention to really represent a rotation that would have been best
+created or used with the other convention, by changing accordingly the sign of
+the rotation angle.
+
+Frame Transform
+---------------
+
+Pass ``convention='frame'`` to use the semantics of a frame conversion.
+
+According to this convention, the rotation considered vectors to be fixed, but
+their coordinates change as they are converted from an initial frame to a
+destination frame rotated with respect to the initial frame.
+
+This means that if we define rotation r is a 90 degrees rotation around the Z
+axis, the image of vector I would be -J, the image of vector J would be I, the
+image of vector K would be K, and the image of vector with coordinates (1, 2, 3)
+would be vector (2, -1, 3). This means that the coordinates of the vector
+rotates clockwise, because they are expressed with respect to a destination
+frame that is rotated counterclockwise.
+
+The difference with vector operator convention is only the semantics of the sign
+of the angle. It is always possible to create or use a rotation using either
+convention to really represent a rotation that would have been best created or
+used with the other convention, by changing accordingly the sign of the rotation
+angle.
+