Skip to content

Commit

Permalink
Fixing some lingering white-space issues with docs [ci skip]
Browse files Browse the repository at this point in the history
  • Loading branch information
manodeep committed Apr 25, 2017
1 parent 09d7aea commit 39febbc
Show file tree
Hide file tree
Showing 10 changed files with 29 additions and 0 deletions.
1 change: 1 addition & 0 deletions Corrfunc/io.py
Expand Up @@ -268,6 +268,7 @@ def read_catalog(filebase=None, return_dtype=np.float):
is searched for, and then the ascii file. End-users should always
supply the full filename.
"""

if filebase is None:
Expand Down
3 changes: 3 additions & 0 deletions Corrfunc/mocks/DDrppi_mocks.py
Expand Up @@ -46,6 +46,7 @@ def DDrppi_mocks(autocorr, cosmology, nthreads, pimax, binfile,
:math:`\\xi(r_p, \pi)` and :math:`wp(r_p)` respectively from the
pair counts.
Parameters
-----------
Expand Down Expand Up @@ -83,6 +84,7 @@ def DDrppi_mocks(autocorr, cosmology, nthreads, pimax, binfile,
.. note:: Only pairs with ``0 <= dz < pimax`` are counted (no equality).
binfile: string or an list/array of floats
For string input: filename specifying the ``rp`` bins for
``DDrppi_mocks``. The file should contain white-space separated values
Expand Down Expand Up @@ -172,6 +174,7 @@ def DDrppi_mocks(autocorr, cosmology, nthreads, pimax, binfile,
you need accurate ``rpavg`` values, then pass in double precision
arrays for the particle positions.
fast_divide: boolean (default false)
Boolean flag to replace the division in ``AVX`` implementation with an
approximate reciprocal, followed by a Newton-Raphson step. Improves
Expand Down
5 changes: 5 additions & 0 deletions Corrfunc/mocks/DDtheta_mocks.py
Expand Up @@ -39,6 +39,7 @@ def DDtheta_mocks(autocorr, nthreads, binfile,
:py:mod:`Corrfunc.utils.convert_3d_counts_to_cf` for computing
:math:`\\omega(\theta)` from the pair counts returned.
Parameters
-----------
Expand Down Expand Up @@ -117,6 +118,7 @@ def DDtheta_mocks(autocorr, nthreads, binfile,
at all. For very small angular separations, the brute-force method
might be the most numerically stable method.
verbose: boolean (default false)
Boolean flag to control output of informational messages
Expand All @@ -135,6 +137,7 @@ def DDtheta_mocks(autocorr, nthreads, binfile,
Use the keyword ``fast_acos`` if you can tolerate some loss of
precision.
fast_acos: boolean (default false)
Flag to use numerical approximation for the ``arccos`` - gives better
performance at the expense of some precision. Relevant only if
Expand All @@ -149,6 +152,7 @@ def DDtheta_mocks(autocorr, nthreads, binfile,
.. note:: Tests will fail if you run the tests with``fast_acos=True``.
(radec)_refine_factor: integer, default is (2,2); typically within [1-3]
Controls the refinement on the cell sizes. Can have up to a 20% impact
on runtime.
Expand All @@ -158,6 +162,7 @@ def DDtheta_mocks(autocorr, nthreads, binfile,
correspond to ``ra`` and ``dec`` (rather, than the usual three of
``(xyz)bin_refine_factor`` for all other correlation functions).
max_cells_per_dim: integer, default is 100, typical values in [50-300]
Controls the maximum number of cells per dimension. Total number of
cells can be up to (max_cells_per_dim)^3. Only increase if ``thetamax``
Expand Down
4 changes: 4 additions & 0 deletions Corrfunc/mocks/vpf_mocks.py
Expand Up @@ -65,6 +65,7 @@ def vpf_mocks(rmax, nbins, nspheres, numpN,
.. note:: p0 is the vpf
threshold_ngb: integer
Minimum number of random points needed in a ``rmax`` sphere such that it
is considered to be entirely within the mock footprint. The
Expand All @@ -85,6 +86,7 @@ def vpf_mocks(rmax, nbins, nspheres, numpN,
significantly longer to finish. However, subsequent runs can re-use
that centers file and will be faster.
cosmology: integer, required
Integer choice for setting cosmology. Valid values are 1->LasDamas
cosmology and 2->Planck cosmology. If you need arbitrary cosmology,
Expand Down Expand Up @@ -153,6 +155,7 @@ def vpf_mocks(rmax, nbins, nspheres, numpN,
``centers_file`` needs to be written out. In that case, the
RAND_RA, RAND_DEC, and RAND_CZ are used as random centers.
verbose: boolean (default false)
Boolean flag to control output of informational messages
Expand All @@ -170,6 +173,7 @@ def vpf_mocks(rmax, nbins, nspheres, numpN,
in all 3 dimensions, the defaults are different from the clustering
routines.
max_cells_per_dim: integer, default is 100, typical values in [50-300]
Controls the maximum number of cells per dimension. Total number of
cells can be up to (max_cells_per_dim)^3. Only increase if ``rmax`` is
Expand Down
2 changes: 2 additions & 0 deletions Corrfunc/theory/DD.py
Expand Up @@ -31,6 +31,7 @@ def DD(autocorr, nthreads, binfile, X1, Y1, Z1, weights1=None, periodic=True,
:py:mod:`Corrfunc.utils.convert_3d_counts_to_cf` for computing
for computing :math:`\\xi(r)` from the pair counts returned.
Parameters
-----------
Expand Down Expand Up @@ -93,6 +94,7 @@ def DD(autocorr, nthreads, binfile, X1, Y1, Z1, weights1=None, periodic=True,
If you need accurate ``ravg`` values, then pass in double precision
arrays for the particle positions.
(xyz)bin_refine_factor: integer, default is (2,2,1); typically within [1-3]
Controls the refinement on the cell sizes. Can have up to a 20% impact
on runtime.
Expand Down
2 changes: 2 additions & 0 deletions Corrfunc/theory/DDrppi.py
Expand Up @@ -60,6 +60,7 @@ def DDrppi(autocorr, nthreads, pimax, binfile, X1, Y1, Z1, weights1=None,
.. note:: Only pairs with ``0 <= dz < pimax`` are counted (no equality).
binfile: string or an list/array of floats
For string input: filename specifying the ``rp`` bins for
``DDrppi``. The file should contain white-space separated values
Expand Down Expand Up @@ -111,6 +112,7 @@ def DDrppi(autocorr, nthreads, pimax, binfile, X1, Y1, Z1, weights1=None,
you need accurate ``rpavg`` values, then pass in double precision
arrays for the particle positions.
(xyz)bin_refine_factor: integer, default is (2,2,1); typically within [1-3]
Controls the refinement on the cell sizes. Can have up to a 20% impact
on runtime.
Expand Down
2 changes: 2 additions & 0 deletions Corrfunc/theory/vpf.py
Expand Up @@ -62,6 +62,7 @@ def vpf(rmax, nbins, nspheres, numpN, seed,
.. note:: p0 is the vpf
seed: unsigned integer
Random number seed for the underlying GSL random number generator. Used
to draw centers of the spheres.
Expand Down Expand Up @@ -97,6 +98,7 @@ def vpf(rmax, nbins, nspheres, numpN, seed,
in all 3 dimensions, the defaults are different from the clustering
routines.
max_cells_per_dim: integer, default is 100, typical values in [50-300]
Controls the maximum number of cells per dimension. Total number of
cells can be up to (max_cells_per_dim)^3. Only increase if ``rmax`` is
Expand Down
6 changes: 6 additions & 0 deletions Corrfunc/theory/wp.py
Expand Up @@ -39,6 +39,7 @@ def find_fastest_wp_bin_refs(boxsize, pimax, nthreads, binfile, X, Y, Z,
.. note:: Only pairs with ``0 <= dz < pimax`` are counted (no equality).
nthreads: integer
Number of threads to use.
Expand Down Expand Up @@ -77,6 +78,7 @@ def find_fastest_wp_bin_refs(boxsize, pimax, nthreads, binfile, X, Y, Z,
you need accurate ``rpavg`` values, then pass in double precision
arrays for the particle positions.
max_cells_per_dim: integer, default is 100, typical values in [50-300]
Controls the maximum number of cells per dimension. Total number of
cells can be up to (max_cells_per_dim)^3. Only increase if ``rpmax`` is
Expand Down Expand Up @@ -153,6 +155,7 @@ def find_fastest_wp_bin_refs(boxsize, pimax, nthreads, binfile, X, Y, Z,
.. note:: Since the result might change depending on the computer, doctest
is skipped for this function.
"""
try:
from Corrfunc._countpairs import countpairs_wp as wp_extn
Expand Down Expand Up @@ -303,6 +306,7 @@ def wp(boxsize, pimax, nthreads, binfile, X, Y, Z,
added to the first bin => minimum number of pairs in the first bin
is the total number of particles.
Parameters
-----------
Expand All @@ -317,6 +321,7 @@ def wp(boxsize, pimax, nthreads, binfile, X, Y, Z,
.. note:: Only pairs with ``0 <= dz < pimax`` are counted (no equality).
nthreads: integer
Number of threads to use.
Expand Down Expand Up @@ -360,6 +365,7 @@ def wp(boxsize, pimax, nthreads, binfile, X, Y, Z,
you need accurate ``rpavg`` values, then pass in double precision
arrays for the particle positions.
(xyz)bin_refine_factor: integer, default is (2,2,1); typically within [1-3]
Controls the refinement on the cell sizes. Can have up to a 20% impact
on runtime.
Expand Down
2 changes: 2 additions & 0 deletions Corrfunc/theory/xi.py
Expand Up @@ -34,6 +34,7 @@ def xi(boxsize, nthreads, binfile, X, Y, Z,
added to the first bin => minimum number of pairs in the first bin
is the total number of particles.
Parameters
-----------
Expand Down Expand Up @@ -84,6 +85,7 @@ def xi(boxsize, nthreads, binfile, X, Y, Z,
you need accurate ``rpavg`` values, then pass in double precision
arrays for the particle positions.
(xyz)bin_refine_factor: integer, default is (2,2,1); typically within [1-3]
Controls the refinement on the cell sizes. Can have up to a 20% impact
on runtime.
Expand Down
2 changes: 2 additions & 0 deletions Corrfunc/utils.py
Expand Up @@ -667,10 +667,12 @@ def gridlink_sphere(thetamax,
num_ra_cells: numpy array, returned if ``return_num_ra_cells`` is set
A numpy array containing the number of RA cells per declination band
.. note:: If ``link_in_ra=False``, then there is effectively one RA bin
per DEC band. The 'ra_limit' field will show the range of allowed
RA values.
.. seealso:: :py:mod:`Corrfunc.mocks.DDtheta_mocks`
Example
Expand Down

0 comments on commit 39febbc

Please sign in to comment.