11.5.1.4. astroML.time_series.search_frequencies¶
-
astroML.time_series.
search_frequencies
(t, y, dy, LS_func=<function lomb_scargle>, LS_kwargs=None, initial_guess=25, limit_fractions=[0.04, 0.3, 0.9, 0.99], n_eval=10000, n_retry=5, n_save=50)[source]¶ Utility Routine to find the best frequencies
To find the best frequency with a Lomb-Scargle periodogram requires searching a large range of frequencies at a very fine resolution. This is an iterative routine that searches progressively finer grids to narrow-in on the best result.
- Parameters
- t: array_like
observed times
- y: array_like
observed fluxes or magnitudes
- dy: array_like
observed errors on y
- Returns
- omega_top, power_top: ndarrays
The saved values of omega and power. These will have size 1 + n_save * (1 + n_retry * len(limit_fractions)) as long as n_save > n_retry
- Other Parameters
- LS_funcfunction
Function used to perform Lomb-Scargle periodogram. The call signature should be LS_func(t, y, dy, omega, **kwargs) (Default is astroML.periodogram.lomb_scargle)
- LS_kwargsdict
dictionary of keyword arguments to pass to LS_func in addition to (t, y, dy, omega)
- initial_guessfloat
the initial guess of the best period
- limit_fractionsarray_like
the list of fractions to use when zooming in on peak possibilities. On the i^th iteration, with f_i = limit_fractions[i], the range probed around each candidate will be (candidate * f_i, candidate / f_i).
- n_evalinteger or list
The number of point to evaluate in the range on each iteration. If n_eval is a list, it should have the same length as limit_fractions.
- n_retryinteger or list
Number of top points to search on each iteration. If n_retry is a list, it should have the same length as limit_fractions.
- n_saveinteger or list
Number of evaluations to save on each iteration. If n_save is a list, it should have the same length as limit_fractions.