fix broken links on new website (#1538)

Author: michaeldeistler

docs/advanced_tutorials.rst

@@ -6,22 +6,74 @@ Advanced tutorials
 
 Our advanced tutorials provide a detailed explanation of different methods. These
 tutorials are meant as further reading for power-users (or users who are particularly
-interested in a particular feature of `sbi`), but they should not be required to
-successfully run `sbi`. If you are looking for brief answers to specific questions,
+interested in a particular feature of ``sbi``), but they should not be required to
+successfully run ``sbi``. If you are looking for brief answers to specific questions,
 check our `how-to guide <https://sbi.readthedocs.io/en/latest/how_to_guide.html>`_.
 
+.. toctree::
+   :maxdepth: 1
+
+
+Prior and simulator
+-------------------
+
 .. toctree::
    :maxdepth: 1
 
    advanced_tutorials/06_restriction_estimator.ipynb
-   advanced_tutorials/10_diagnostics_posterior_predictive_checks.ipynb
-   advanced_tutorials/11_diagnostics_simulation_based_calibration.ipynb
+
+Neural nets
+-----------
+
+.. toctree::
+   :maxdepth: 1
+
+   advanced_tutorials/04_embedding_networks.ipynb
+   advanced_tutorials/03_density_estimators.ipynb
    advanced_tutorials/12_iid_data_and_permutation_invariant_embeddings.ipynb
-   advanced_tutorials/18_training_interface.ipynb
    advanced_tutorials/19_flowmatching_and_scorematching.ipynb
    advanced_tutorials/20_score_based_methods_new_features.ipynb
-   advanced_tutorials/21_diagnostics_misspecification_checks.ipynb
+
+
+Training
+--------
+
+.. toctree::
+   :maxdepth: 1
+
+   advanced_tutorials/18_training_interface.ipynb
+   advanced_tutorials/02_multiround_inference.ipynb
+
+
+Sampling
+--------
+
+.. toctree::
+   :maxdepth: 1
+
    advanced_tutorials/15_importance_sampled_posteriors.ipynb
+
+
+
+Diagnostics
+-----------
+
+.. toctree::
+   :maxdepth: 1
+
+   advanced_tutorials/10_diagnostics_posterior_predictive_checks.ipynb
+   advanced_tutorials/11_diagnostics_simulation_based_calibration.ipynb
+   advanced_tutorials/13_diagnostics_lc2st.ipynb
+   advanced_tutorials/21_diagnostics_misspecification_checks.ipynb
    advanced_tutorials/14_mcmc_diagnostics_with_arviz.ipynb
+
+
+Visualization
+-------------
+
+.. toctree::
+   :maxdepth: 1
+
+   advanced_tutorials/05_conditional_distributions.ipynb
    advanced_tutorials/17_plotting_functionality.ipynb
    advanced_tutorials/07_sensitivity_analysis.ipynb

docs/advanced_tutorials/11_diagnostics_simulation_based_calibration.ipynb

@@ -10,7 +10,7 @@
     "the estimator should be made subject to several **diagnostic tests**. This needs to be\n",
     "performed before being used for inference given the actual observed data. _Posterior\n",
     "Predictive Checks_ (see [10_diagnostics_posterior_predictive_checks\n",
-    "tutorial](http://localhost:8000/tutorials/10_diagnostics_posterior_predictive_checks.html)) provide one way to \"critique\" a trained\n",
+    "tutorial](https://sbi.readthedocs.io/en/latest/advanced_tutorials/10_diagnostics_posterior_predictive_checks.html)) provide one way to \"critique\" a trained\n",
     "estimator based on its predictive performance. Another important approach to such\n",
     "diagnostics is simulation-based calibration as developed by [Cook et al,\n",
     "2006](https://www.tandfonline.com/doi/abs/10.1198/106186006X136976) and [Talts et al,\n",

docs/advanced_tutorials/13_diagnostics_lc2st.ipynb

@@ -9,9 +9,9 @@
     "\n",
     " After a density estimator has been trained with simulated data to obtain a posterior, the estimator should be made subject to several diagnostic tests. This diagnostic should be performed before the posterior is used for inference given the actual observed data. \n",
     "    \n",
-    "*Posterior Predictive Checks* (see [tutorial 10](https://sbi.readthedocs.io/en/latest/tutorials/10_diagnostics_posterior_predictive_checks.html)) provide one way to \"critique\" a trained estimator via its predictive performance. \n",
+    "*Posterior Predictive Checks* (see [this tutorial](https://sbi.readthedocs.io/en/latest/advanced_tutorials/10_diagnostics_posterior_predictive_checks.html)) provide one way to \"critique\" a trained estimator via its predictive performance. \n",
     "    \n",
-    "Another approach is *Simulation-Based Calibration* (SBC, see [tutorial 11](https://sbi.readthedocs.io/en/latest/tutorials/11_diagnostics_simulation_based_calibration.html)). SBC evaluates whether the estimated posterior is balanced, i.e., neither over-confident nor under-confident. These checks are performed ***in expectation (on average) over the observation space***, i.e. they are performed on a set of $(\\theta,x)$ pairs sampled from the joint distribution over simulator parameters $\\theta$ and corresponding observations $x$. As such, SBC is a ***global validation method*** that can be viewed as a necessary condition (but not sufficient) for a valid inference algorithm: If SBC checks fail, this tells you that your inference is invalid. If SBC checks pass, *this is no guarantee that the posterior estimation is working*.\n",
+    "Another approach is *Simulation-Based Calibration* (SBC, see [this tutorial](https://sbi.readthedocs.io/en/latest/advanced_tutorials/11_diagnostics_simulation_based_calibration.html)). SBC evaluates whether the estimated posterior is balanced, i.e., neither over-confident nor under-confident. These checks are performed ***in expectation (on average) over the observation space***, i.e. they are performed on a set of $(\\theta,x)$ pairs sampled from the joint distribution over simulator parameters $\\theta$ and corresponding observations $x$. As such, SBC is a ***global validation method*** that can be viewed as a necessary condition (but not sufficient) for a valid inference algorithm: If SBC checks fail, this tells you that your inference is invalid. If SBC checks pass, *this is no guarantee that the posterior estimation is working*.\n",
     "\n",
     "**Local Classifier Two-Sample Tests** ($\\ell$-C2ST) as developed by [Linhart et al, 2023](https://arxiv.org/abs/2306.03580) present a new ***local validation method*** that allows to evaluate the correctness of the posterior estimator ***at a fixed observation***, i.e. they work on a single $(\\theta,x)$ pair. They provide necessary *and sufficient* conditions for the validity of the SBI algorithm, as well as easy-to-interpret qualitative and quantitative diagnostics. \n",
     "    \n",