diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/caldb.rst b/Workshops/BasicDRAGONS-1hr/sphinx/caldb.rst index 2335aee..b2cb492 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/caldb.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/caldb.rst @@ -4,7 +4,7 @@ .. before we are too tired, let's tackle this one. -.. _caldb: +.. _basic1_caldb: ************************* Local calibration manager @@ -101,7 +101,7 @@ that you will not wipe the database accidentally. **The** ``init`` **is require only once.** If you already have the database created, maybe even populated, you can switch back to it simply by ensuring ``database_dir`` points to it. -.. _ex_caldb1: +.. _basic1_ex_caldb1: .. admonition:: Exercise - Caldb 1 @@ -111,7 +111,7 @@ you can switch back to it simply by ensuring ``database_dir`` points to it. Confirm with ``ls`` that a new ``cal_manager.db`` has been created. You can also use ``caldb config`` to confirm that the new database is active. - [:ref:`Solution `] + [:ref:`Solution `] Usage @@ -141,7 +141,7 @@ And finally, to delete information about one file from the database:: ``remove`` will only remove the entry in the database, it will not remove the file on disk. -.. _ex_caldb2: +.. _basic1_ex_caldb2: .. admonition:: Exercise - Caldb 2 @@ -154,5 +154,5 @@ the file on disk. for the demo) and list its content. Both the dark and the flat should now be listed. - [:ref:`Solution `] + [:ref:`Solution `] diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/customize_recipes.rst b/Workshops/BasicDRAGONS-1hr/sphinx/customize_recipes.rst index ec3ce24..11d22b1 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/customize_recipes.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/customize_recipes.rst @@ -2,7 +2,7 @@ .. include:: DRAGONSlinks.txt -.. _customize_recipes: +.. _basic1_customize_recipes: ***************** Customize Recipes @@ -94,7 +94,7 @@ name of our recipe library (``myNIRIrecipes``) and the name of the recipe The new intermediate outputs have the suffixes ``_flatCorrected`` and ``_skySubtracted``. -.. _ex_customrecipe1: +.. _basic1_ex_customrecipe1: .. admonition:: Exercise - Custom Recipe 1 @@ -104,5 +104,5 @@ The new intermediate outputs have the suffixes ``_flatCorrected`` and Hint: ``cat flats.lis`` to get the name of a flat to use with ``showrecipes`` to get the location and name of the NIRI flat recipe library. - [:ref:`Solution `] + [:ref:`Solution `] diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/demo_imaging.rst b/Workshops/BasicDRAGONS-1hr/sphinx/demo_imaging.rst index 0fa9767..43652e3 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/demo_imaging.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/demo_imaging.rst @@ -2,7 +2,7 @@ .. include:: DRAGONSlinks.txt -.. _demo_imaging: +.. _basic1_demo_imaging: ************ Demo imaging @@ -101,7 +101,7 @@ Create the master dark and add it to the calibration manager. The ``@`` character before the name of the input file is the "at-file" syntax. We will look into this later. -.. _demo_flat: +.. _basic1_demo_flat: **Flat** diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/explore_data.rst b/Workshops/BasicDRAGONS-1hr/sphinx/explore_data.rst index a6ffd73..5a842cf 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/explore_data.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/explore_data.rst @@ -2,7 +2,7 @@ .. include:: DRAGONSlinks.txt -.. _explore_data: +.. _basic1_explore_data: ************ diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/objectives.rst b/Workshops/BasicDRAGONS-1hr/sphinx/objectives.rst index 54d6930..99371d7 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/objectives.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/objectives.rst @@ -1,6 +1,6 @@ .. objectives.rst -.. _objectives: +.. _basic1_objectives: ******************* Learning Objectives diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/reduce.rst b/Workshops/BasicDRAGONS-1hr/sphinx/reduce.rst index 21a3ea8..a19a4f4 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/reduce.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/reduce.rst @@ -2,7 +2,7 @@ .. include:: DRAGONSlinks.txt -.. _reduce: +.. _basic1_reduce: **************** Using ``reduce`` @@ -50,7 +50,7 @@ The syntax to change the value of an input parameter is as follow:: reduce file.fits -p primitive:parameter=value -.. _ex_reduce1: +.. _basic1_ex_reduce1: .. admonition:: Exercise - "reduce" 1 @@ -61,9 +61,9 @@ The syntax to change the value of an input parameter is as follow:: Hint #1: ``cat flats.lis`` to get the name of a flat to use with ``showpars``. - Hint #2: See the :ref:`command used in the demo ` + Hint #2: See the :ref:`command used in the demo ` - [:ref:`Solution `] + [:ref:`Solution `] .. reduce @flats.lis -p normalizeFlat:scale=mean --suffix _exercise2 @@ -112,7 +112,7 @@ Another use of the ``-r`` option is to run personal recipes rather than the ones distributed with DRAGONS. We will show how that is done in the next chapter. -.. _ex_reduce2: +.. _basic1_ex_reduce2: .. admonition:: Exercise - "reduce" 2 @@ -123,7 +123,7 @@ chapter. the target fills the field-of-view of the science frames, the sky flat here will not be usable, but it's okay, we are just playing while learning. - [:ref:`Solution `] + [:ref:`Solution `] .. reduce @target.lis -r makeSkyFlat --suffix _skyflat @@ -142,7 +142,7 @@ Allowed values for "": dark, bias, flat, arc, standard. Eg:: reduce @mylist.lis --user_cal processed_arc:my_special_arc.fits -.. _ex_reduce3: +.. _basic1_ex_reduce3: .. admonition:: Exercise - "reduce" 3 @@ -155,7 +155,7 @@ Allowed values for "": dark, bias, flat, arc, standard. Eg:: Modify this command to allow the dark correction with the dark we used for the science frame, ``N20160102S0423_dark.fits``. - [:ref:`Solution `] + [:ref:`Solution `] .. reduce reduce @stdstar.lis -p addDQ:user_bpm=N20160102S0373_bpm.fits --user_cal processed_dark:N20160102S0423_dark.fits diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/resources.rst b/Workshops/BasicDRAGONS-1hr/sphinx/resources.rst index 151c585..43101c2 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/resources.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/resources.rst @@ -6,7 +6,7 @@ Recipe System User Manual -.. _resources: +.. _basic1_resources: ********* Resources diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/solutions.rst b/Workshops/BasicDRAGONS-1hr/sphinx/solutions.rst index 67b0d97..2199bc1 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/solutions.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/solutions.rst @@ -2,7 +2,7 @@ .. include:: DRAGONSlinks.txt -.. _solutions: +.. _basic1_solutions: ********************** Solutions to exercises @@ -11,10 +11,10 @@ Solutions to exercises Solutions to the Local calibration manager exercises ==================================================== -.. _solution_caldb1: +.. _basic1_solution_caldb1: -Solution to :ref:`Exercise - Caldb 1 ` -------------------------------------------------- +Solution to :ref:`Exercise - Caldb 1 ` +-------------------------------------------------------- The ``rsys.cfg`` file should look like this:: [calibs] @@ -36,10 +36,10 @@ The ``rsys.cfg`` file should look like this:: The 'standalone' flag is active, meaning that local calibrations will be used -.. _solution_caldb2: +.. _basic1_solution_caldb2: -Solution to :ref:`Exercise - Caldb 2 ` -------------------------------------------------- +Solution to :ref:`Exercise - Caldb 2 ` +-------------------------------------------------------- It is important do to successfully complete :ref:`Exercise - Caldb 1 ` before attempting Exercise 2. @@ -97,29 +97,29 @@ Confirm activation with ``caldb config``. Solutions to the ``reduce`` exercises ===================================== -.. _solution_reduce1: +.. _basic1_solution_reduce1: -Solution to :ref:`Exercise - "reduce" 1 ` ------------------------------------------------------ +Solution to :ref:`Exercise - "reduce" 1 ` +------------------------------------------------------------ :: reduce @flats.lis -p normalizeFlat:scale=mean --suffix _exercise1 -.. _solution_reduce2: +.. _basic1_solution_reduce2: -Solution to :ref:`Exercise - "reduce" 2 ` ------------------------------------------------------ +Solution to :ref:`Exercise - "reduce" 2 ` +------------------------------------------------------------ :: reduce @target.lis -r makeSkyFlat --suffix _skyflat -.. _solution_reduce3: +.. _basic1_solution_reduce3: -Solution to :ref:`Exercise - "reduce" 3 ` ------------------------------------------------------ +Solution to :ref:`Exercise - "reduce" 3 ` +------------------------------------------------------------ While it is not recommended to use a processed dark of the wrong exposure, here is how you would force DRAGONS to use the science's master dark @@ -133,10 +133,10 @@ on the flux standard from the demo. Solutions to the Customize recipes exercise =========================================== -.. _solution_customrecipe1: +.. _basic1_solution_customrecipe1: -Solution to :ref:`Exercise - Custom Recipe 1 ` ----------------------------------------------------------------- +Solution to :ref:`Exercise - Custom Recipe 1 ` +----------------------------------------------------------------------- :: @@ -174,10 +174,10 @@ Solution to :ref:`Exercise - Custom Recipe 1 ` Solutions to the Tools exercise =========================================== -.. _solution_tools1: +.. _basic1_solution_tools1: -Solution to :ref:`Exercise - Tools 1 ` -------------------------------------------------- +Solution to :ref:`Exercise - Tools 1 ` +-------------------------------------------------------- :: @@ -243,10 +243,10 @@ Solution to :ref:`Exercise - Tools 1 ` ../playdata/N20160103S0472.fits 1.001 blank 2016-01-03 -.. _solution_tools2: +.. _basic1_solution_tools2: -Solution to :ref:`Exercise - Tools 2 ` -------------------------------------------------- +Solution to :ref:`Exercise - Tools 2 ` +-------------------------------------------------------- :: diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/tools.rst b/Workshops/BasicDRAGONS-1hr/sphinx/tools.rst index 9009228..278f7d6 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/tools.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/tools.rst @@ -12,7 +12,7 @@ -.. _tools: +.. _basic1_tools: @@ -120,7 +120,7 @@ The syntax is:: The default is to print on the terminal. A comma-separate list can be produced with the ``--csv`` flag. -.. _ex_tools1: +.. _basic1_ex_tools1: .. admonition:: Exercise - Tools 1 @@ -128,7 +128,7 @@ produced with the ``--csv`` flag. observations in ``playdata``. Use the |descriptors| list from the |astrodatauser|. - [:ref:`Solution `] + [:ref:`Solution `] .. showd -d exposure_time,filter_name,ut_date ../playdata/*.fits @@ -199,7 +199,7 @@ the internal quotes used around strings. Finally, the expression can use the ``and`` and ``or`` logical operators. -.. _ex_tools2: +.. _basic1_ex_tools2: .. admonition:: Exercise - Tools 2 @@ -211,7 +211,7 @@ Finally, the expression can use the ``and`` and ``or`` logical operators. Descriptors: ``observation_type``, ``observation_class``, ``object``. - [:ref:`Solution `] + [:ref:`Solution `] .. dataselect ../playdata/*.fits --expr='observation_class=="science" and observation_type=="OBJECT"' | showd -d object .. dataselect ../playdata/*.fits --expr='observation_class=="partnerCal" and observation_type=="OBJECT"' | showd -d object diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/what_are_recipes_and_primitives.rst b/Workshops/BasicDRAGONS-1hr/sphinx/what_are_recipes_and_primitives.rst index 5d30649..00a9f2e 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/what_are_recipes_and_primitives.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/what_are_recipes_and_primitives.rst @@ -2,7 +2,7 @@ .. include:: DRAGONSlinks.txt -.. _recipes_and_primitives: +.. _basic1_recipes_and_primitives: ************************************************** What are Recipes, Recipe Libraries, and Primitives diff --git a/Workshops/BasicDRAGONS-1hr/sphinx/what_is_dragons.rst b/Workshops/BasicDRAGONS-1hr/sphinx/what_is_dragons.rst index 693b186..ce9b564 100644 --- a/Workshops/BasicDRAGONS-1hr/sphinx/what_is_dragons.rst +++ b/Workshops/BasicDRAGONS-1hr/sphinx/what_is_dragons.rst @@ -1,6 +1,6 @@ .. what_is_dragons.rst -.. _what_is_dragons: +.. _basic1_what_is_dragons: *************** What is DRAGONS