:py:mod:`ysoisochrone.utils`
============================

.. py:module:: ysoisochrone.utils

.. autodoc2-docstring:: ysoisochrone.utils
   :allowtitles:

Module Contents
---------------

Functions
~~~~~~~~~

.. list-table::
   :class: autosummary longtable
   :align: left

   * - :py:obj:`unc_log10 <ysoisochrone.utils.unc_log10>`
     - .. autodoc2-docstring:: ysoisochrone.utils.unc_log10
          :summary:
   * - :py:obj:`unc_linear_from_log <ysoisochrone.utils.unc_linear_from_log>`
     - .. autodoc2-docstring:: ysoisochrone.utils.unc_linear_from_log
          :summary:
   * - :py:obj:`assign_unc_teff <ysoisochrone.utils.assign_unc_teff>`
     - .. autodoc2-docstring:: ysoisochrone.utils.assign_unc_teff
          :summary:
   * - :py:obj:`assign_unc_lumi <ysoisochrone.utils.assign_unc_lumi>`
     - .. autodoc2-docstring:: ysoisochrone.utils.assign_unc_lumi
          :summary:
   * - :py:obj:`get_likelihood_p2016 <ysoisochrone.utils.get_likelihood_p2016>`
     - .. autodoc2-docstring:: ysoisochrone.utils.get_likelihood_p2016
          :summary:
   * - :py:obj:`_normalize_pdf <ysoisochrone.utils._normalize_pdf>`
     - .. autodoc2-docstring:: ysoisochrone.utils._normalize_pdf
          :summary:
   * - :py:obj:`_eval_1d_prior_on_grid <ysoisochrone.utils._eval_1d_prior_on_grid>`
     - .. autodoc2-docstring:: ysoisochrone.utils._eval_1d_prior_on_grid
          :summary:
   * - :py:obj:`download_file_simple <ysoisochrone.utils.download_file_simple>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_file_simple
          :summary:
   * - :py:obj:`download_file <ysoisochrone.utils.download_file>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_file
          :summary:
   * - :py:obj:`extract_tarball <ysoisochrone.utils.extract_tarball>`
     - .. autodoc2-docstring:: ysoisochrone.utils.extract_tarball
          :summary:
   * - :py:obj:`load_builtin_matrix <ysoisochrone.utils.load_builtin_matrix>`
     - .. autodoc2-docstring:: ysoisochrone.utils.load_builtin_matrix
          :summary:
   * - :py:obj:`download_baraffe_tracks <ysoisochrone.utils.download_baraffe_tracks>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_baraffe_tracks
          :summary:
   * - :py:obj:`read_baraffe_file <ysoisochrone.utils.read_baraffe_file>`
     - .. autodoc2-docstring:: ysoisochrone.utils.read_baraffe_file
          :summary:
   * - :py:obj:`download_feiden_trk_tracks <ysoisochrone.utils.download_feiden_trk_tracks>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_feiden_trk_tracks
          :summary:
   * - :py:obj:`read_feiden_trk_file <ysoisochrone.utils.read_feiden_trk_file>`
     - .. autodoc2-docstring:: ysoisochrone.utils.read_feiden_trk_file
          :summary:
   * - :py:obj:`download_feiden_iso_tracks <ysoisochrone.utils.download_feiden_iso_tracks>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_feiden_iso_tracks
          :summary:
   * - :py:obj:`read_feiden_iso_file <ysoisochrone.utils.read_feiden_iso_file>`
     - .. autodoc2-docstring:: ysoisochrone.utils.read_feiden_iso_file
          :summary:
   * - :py:obj:`download_parsec_v1p2_tracks <ysoisochrone.utils.download_parsec_v1p2_tracks>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_parsec_v1p2_tracks
          :summary:
   * - :py:obj:`read_parsec_v1p2_dat_file <ysoisochrone.utils.read_parsec_v1p2_dat_file>`
     - .. autodoc2-docstring:: ysoisochrone.utils.read_parsec_v1p2_dat_file
          :summary:
   * - :py:obj:`download_parsec_v2p0_tracks <ysoisochrone.utils.download_parsec_v2p0_tracks>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_parsec_v2p0_tracks
          :summary:
   * - :py:obj:`read_parsec_v2p0_tab_file <ysoisochrone.utils.read_parsec_v2p0_tab_file>`
     - .. autodoc2-docstring:: ysoisochrone.utils.read_parsec_v2p0_tab_file
          :summary:
   * - :py:obj:`download_mist_v1p2_eep_tracks <ysoisochrone.utils.download_mist_v1p2_eep_tracks>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_mist_v1p2_eep_tracks
          :summary:
   * - :py:obj:`download_mist_v1p2_iso_tracks <ysoisochrone.utils.download_mist_v1p2_iso_tracks>`
     - .. autodoc2-docstring:: ysoisochrone.utils.download_mist_v1p2_iso_tracks
          :summary:
   * - :py:obj:`read_mist_v1p2_iso_file <ysoisochrone.utils.read_mist_v1p2_iso_file>`
     - .. autodoc2-docstring:: ysoisochrone.utils.read_mist_v1p2_iso_file
          :summary:
   * - :py:obj:`create_meshgrid_legacy <ysoisochrone.utils.create_meshgrid_legacy>`
     - .. autodoc2-docstring:: ysoisochrone.utils.create_meshgrid_legacy
          :summary:
   * - :py:obj:`create_meshgrid <ysoisochrone.utils.create_meshgrid>`
     - .. autodoc2-docstring:: ysoisochrone.utils.create_meshgrid
          :summary:
   * - :py:obj:`save_as_mat <ysoisochrone.utils.save_as_mat>`
     - .. autodoc2-docstring:: ysoisochrone.utils.save_as_mat
          :summary:
   * - :py:obj:`compare_grids <ysoisochrone.utils.compare_grids>`
     - .. autodoc2-docstring:: ysoisochrone.utils.compare_grids
          :summary:
   * - :py:obj:`find_zams_index <ysoisochrone.utils.find_zams_index>`
     - .. autodoc2-docstring:: ysoisochrone.utils.find_zams_index
          :summary:
   * - :py:obj:`find_zams_curve <ysoisochrone.utils.find_zams_curve>`
     - .. autodoc2-docstring:: ysoisochrone.utils.find_zams_curve
          :summary:

API
~~~

.. py:function:: unc_log10(x, err_x)
   :canonical: ysoisochrone.utils.unc_log10

   .. autodoc2-docstring:: ysoisochrone.utils.unc_log10

.. py:function:: unc_linear_from_log(log_value, log_uncertainty)
   :canonical: ysoisochrone.utils.unc_linear_from_log

   .. autodoc2-docstring:: ysoisochrone.utils.unc_linear_from_log

.. py:function:: assign_unc_teff(teff_ar, sigma_logT_set=None)
   :canonical: ysoisochrone.utils.assign_unc_teff

   .. autodoc2-docstring:: ysoisochrone.utils.assign_unc_teff

.. py:function:: assign_unc_lumi(lumi_ar, sigma_logL_set=None)
   :canonical: ysoisochrone.utils.assign_unc_lumi

   .. autodoc2-docstring:: ysoisochrone.utils.assign_unc_lumi

.. py:function:: get_likelihood_p2016(logtlogl_dummy, c_logT, c_logL, sigma_logT, sigma_logL)
   :canonical: ysoisochrone.utils.get_likelihood_p2016

   .. autodoc2-docstring:: ysoisochrone.utils.get_likelihood_p2016

.. py:function:: _normalize_pdf(arr, method='maxone')
   :canonical: ysoisochrone.utils._normalize_pdf

   .. autodoc2-docstring:: ysoisochrone.utils._normalize_pdf

.. py:function:: _eval_1d_prior_on_grid(prior_spec, x_grid, normalize='maxone', name='prior')
   :canonical: ysoisochrone.utils._eval_1d_prior_on_grid

   .. autodoc2-docstring:: ysoisochrone.utils._eval_1d_prior_on_grid

.. py:function:: download_file_simple(url, save_path)
   :canonical: ysoisochrone.utils.download_file_simple

   .. autodoc2-docstring:: ysoisochrone.utils.download_file_simple

.. py:function:: download_file(url, save_path)
   :canonical: ysoisochrone.utils.download_file

   .. autodoc2-docstring:: ysoisochrone.utils.download_file

.. py:function:: extract_tarball(tar_file_path, extract_dir)
   :canonical: ysoisochrone.utils.extract_tarball

   .. autodoc2-docstring:: ysoisochrone.utils.extract_tarball

.. py:function:: load_builtin_matrix(filename)
   :canonical: ysoisochrone.utils.load_builtin_matrix

   .. autodoc2-docstring:: ysoisochrone.utils.load_builtin_matrix

.. py:function:: download_baraffe_tracks(save_dir='isochrones_data')
   :canonical: ysoisochrone.utils.download_baraffe_tracks

   .. autodoc2-docstring:: ysoisochrone.utils.download_baraffe_tracks

.. py:function:: read_baraffe_file(file_path)
   :canonical: ysoisochrone.utils.read_baraffe_file

   .. autodoc2-docstring:: ysoisochrone.utils.read_baraffe_file

.. py:function:: download_feiden_trk_tracks(save_dir='isochrones_data', download_original_trks=False)
   :canonical: ysoisochrone.utils.download_feiden_trk_tracks

   .. autodoc2-docstring:: ysoisochrone.utils.download_feiden_trk_tracks

.. py:function:: read_feiden_trk_file(feiden_dir)
   :canonical: ysoisochrone.utils.read_feiden_trk_file

   .. autodoc2-docstring:: ysoisochrone.utils.read_feiden_trk_file

.. py:function:: download_feiden_iso_tracks(save_dir='isochrones_data')
   :canonical: ysoisochrone.utils.download_feiden_iso_tracks

   .. autodoc2-docstring:: ysoisochrone.utils.download_feiden_iso_tracks

.. py:function:: read_feiden_iso_file(feiden_dir)
   :canonical: ysoisochrone.utils.read_feiden_iso_file

   .. autodoc2-docstring:: ysoisochrone.utils.read_feiden_iso_file

.. py:function:: download_parsec_v1p2_tracks(save_dir='isochrones_data')
   :canonical: ysoisochrone.utils.download_parsec_v1p2_tracks

   .. autodoc2-docstring:: ysoisochrone.utils.download_parsec_v1p2_tracks

.. py:function:: read_parsec_v1p2_dat_file(parsec_dir)
   :canonical: ysoisochrone.utils.read_parsec_v1p2_dat_file

   .. autodoc2-docstring:: ysoisochrone.utils.read_parsec_v1p2_dat_file

.. py:function:: download_parsec_v2p0_tracks(save_dir='isochrones_data')
   :canonical: ysoisochrone.utils.download_parsec_v2p0_tracks

   .. autodoc2-docstring:: ysoisochrone.utils.download_parsec_v2p0_tracks

.. py:function:: read_parsec_v2p0_tab_file(parsec_dir)
   :canonical: ysoisochrone.utils.read_parsec_v2p0_tab_file

   .. autodoc2-docstring:: ysoisochrone.utils.read_parsec_v2p0_tab_file

.. py:function:: download_mist_v1p2_eep_tracks(save_dir='isochrones_data')
   :canonical: ysoisochrone.utils.download_mist_v1p2_eep_tracks

   .. autodoc2-docstring:: ysoisochrone.utils.download_mist_v1p2_eep_tracks

.. py:function:: download_mist_v1p2_iso_tracks(save_dir='isochrones_data')
   :canonical: ysoisochrone.utils.download_mist_v1p2_iso_tracks

   .. autodoc2-docstring:: ysoisochrone.utils.download_mist_v1p2_iso_tracks

.. py:function:: read_mist_v1p2_iso_file(mist_iso_file)
   :canonical: ysoisochrone.utils.read_mist_v1p2_iso_file

   .. autodoc2-docstring:: ysoisochrone.utils.read_mist_v1p2_iso_file

.. py:function:: create_meshgrid_legacy(data_points, min_age=0.5, max_age=50.0, min_mass=0.015, max_mass=1.4, interpolation_method='linear')
   :canonical: ysoisochrone.utils.create_meshgrid_legacy

   .. autodoc2-docstring:: ysoisochrone.utils.create_meshgrid_legacy

.. py:function:: create_meshgrid(data_points, min_age=0.5, max_age=1000.0, min_mass=0.0, max_mass=7.5, interpolation_method='linear')
   :canonical: ysoisochrone.utils.create_meshgrid

   .. autodoc2-docstring:: ysoisochrone.utils.create_meshgrid

.. py:function:: save_as_mat(masses, log_age, logtlogl, save_path)
   :canonical: ysoisochrone.utils.save_as_mat

   .. autodoc2-docstring:: ysoisochrone.utils.save_as_mat

.. py:function:: compare_grids(loaded_data_py, loaded_data_idl, gridnames=['Python', 'IDL'], plot=True)
   :canonical: ysoisochrone.utils.compare_grids

   .. autodoc2-docstring:: ysoisochrone.utils.compare_grids

.. py:function:: find_zams_index(teff_track, lum_track, age_track, massive_stars=True, log_age_max_preset=8.5, last_point=False)
   :canonical: ysoisochrone.utils.find_zams_index

   .. autodoc2-docstring:: ysoisochrone.utils.find_zams_index

.. py:function:: find_zams_curve(isochrone)
   :canonical: ysoisochrone.utils.find_zams_curve

   .. autodoc2-docstring:: ysoisochrone.utils.find_zams_curve