# cython: boundscheck=False
# cython: debug=False
# cython: nonecheck=False
# cython: cdivision=True
# cython: wraparound=False
# cython: profile=False
# Third-party
import numpy as np
from ...potential import Hamiltonian, NullPotential, StaticFrame
from ...units import UnitSystem
from ...util import atleast_2d
from ...integrate.timespec import parse_time_specification
from .. import Orbit, PhaseSpacePosition
from .nbody import direct_nbody_dop853
__all__ = ['DirectNBody']
[docs]class DirectNBody:
def __init__(self, w0, particle_potentials, external_potential=None,
frame=None, units=None, save_all=True):
"""Perform orbit integration using direct N-body forces between
particles, optionally in an external background potential.
TODO: could add another option, like in other contexts, for
"extra_force" to support, e.g., dynamical friction
Parameters
----------
w0 : `~gala.dynamics.PhaseSpacePosition`
The particle initial conditions.
partcle_potentials : list
List of potential objects to add mass or mass distributions to the
particles. Use ``None`` to treat particles as test particles.
external_potential : `~gala.potential.PotentialBase` subclass instance (optional)
The background or external potential to integrate the particle
orbits in.
frame : :class:`~gala.potential.frame.FrameBase` subclass (optional)
The reference frame to perform integratiosn in.
units : `~gala.units.UnitSystem` (optional)
Set of non-reducable units that specify (at minimum) the
length, mass, time, and angle units.
save_all : bool (optional)
Save the full orbits of each particle. If ``False``, only returns
the final phase-space positions of each particle.
"""
if not isinstance(w0, PhaseSpacePosition):
raise TypeError("Initial conditions `w0` must be a "
"gala.dynamics.PhaseSpacePosition object, "
"not '{}'".format(w0.__class__.__name__))
if len(w0.shape) > 0:
if w0.shape[0] != len(particle_potentials):
raise ValueError("The number of initial conditions in `w0` must"
" match the number of particle potentials "
"passed in with `particle_potentials`.")
# TODO: this is a MAJOR HACK
if w0.shape[0] > 65536: # see MAX_NBODY in _nbody.pyx
raise NotImplementedError("We currently only support direct "
"N-body integration for <= 65536 "
"particles.")
# First, figure out how to get units - first place to check is the arg
if units is None:
# Next, check the particle potentials
for pp in particle_potentials:
if pp is not None:
units = pp.units
break
# If units is still none, and external_potential is defined, use that:
if units is None and external_potential is not None:
units = external_potential.units
# Now, if units are still None, raise an error!
if units is None:
raise ValueError("Could not determine units from input! You must "
"either (1) pass in the unit system with `units`,"
"(2) set the units on one of the "
"particle_potentials, OR (3) pass in an "
"`external_potential` with valid units.")
if not isinstance(units, UnitSystem):
units = UnitSystem(units)
# Now that we have the unit system, enforce that all potentials are in
# that system:
_particle_potentials = []
for pp in particle_potentials:
if pp is None:
pp = NullPotential(units=units)
else:
pp = pp.replace_units(units)
_particle_potentials.append(pp)
if external_potential is None:
external_potential = NullPotential(units=units)
else:
external_potential = external_potential.replace_units(units)
if frame is None:
frame = StaticFrame(units)
self.units = units
self.external_potential = external_potential
self.frame = frame
self.particle_potentials = _particle_potentials
self.save_all = save_all
self.H = Hamiltonian(self.external_potential,
frame=self.frame)
if not self.H.c_enabled:
raise ValueError("Input potential must be C-enabled: one or more "
"components in the input external potential are "
"Python-only.")
self.w0 = w0
@property
def w0(self):
return self._w0
@w0.setter
def w0(self, value):
self._w0 = value
self._cache_w0()
def _cache_w0(self):
# cache the position and velocity / prepare the initial conditions
self._pos = atleast_2d(self.w0.xyz.decompose(self.units).value,
insert_axis=1)
self._vel = atleast_2d(self.w0.v_xyz.decompose(self.units).value,
insert_axis=1)
self._c_w0 = np.ascontiguousarray(np.vstack((self._pos, self._vel)).T)
def __repr__(self):
if self.w0.shape:
return "<{} bodies={}>".format(self.__class__.__name__,
self.w0.shape[0])
else:
return "<{} bodies=1>".format(self.__class__.__name__)
[docs] def integrate_orbit(self, **time_spec):
"""
Integrate the initial conditions in the combined external potential
plus N-body forces.
This integration uses the `~gala.integrate.DOPRI853Integrator`.
Parameters
----------
**time_spec
Specification of how long to integrate. See documentation
for `~gala.integrate.parse_time_specification`.
Returns
-------
orbit : `~gala.dynamics.Orbit`
The orbits of the particles.
"""
# Prepare the time-stepping array
t = parse_time_specification(self.units, **time_spec)
ws = direct_nbody_dop853(self._c_w0, t, self.H,
self.particle_potentials,
save_all=self.save_all)
if self.save_all:
pos = np.rollaxis(np.array(ws[..., :3]), axis=2)
vel = np.rollaxis(np.array(ws[..., 3:]), axis=2)
orbits = Orbit(
pos=pos * self.units['length'],
vel=vel * self.units['length'] / self.units['time'],
t=t * self.units['time'],
hamiltonian=self.H)
else:
pos = np.array(ws[..., :3]).T
vel = np.array(ws[..., 3:]).T
orbits = PhaseSpacePosition(
pos=pos * self.units['length'],
vel=vel * self.units['length'] / self.units['time'],
frame=self.frame)
return orbits