From e918b1cf7f9e2cfe4a7ac69287e234caec68543b Mon Sep 17 00:00:00 2001 From: smithis7 Date: Fri, 27 Nov 2020 15:23:36 -0500 Subject: [PATCH 1/7] restructuring docs except for using tardis section --- docs/index.rst | 16 +-- docs/physics/new_plasma.rst | 7 ++ docs/physics/old_physics.rst | 17 ++++ docs/team_and_governance/governance.rst | 40 ++++++++ docs/team_and_governance/index.rst | 8 ++ docs/team_and_governance/team.rst | 128 ++++++++++++++++++++++++ 6 files changed, 209 insertions(+), 7 deletions(-) create mode 100644 docs/physics/old_physics.rst create mode 100644 docs/team_and_governance/governance.rst create mode 100644 docs/team_and_governance/index.rst create mode 100644 docs/team_and_governance/team.rst diff --git a/docs/index.rst b/docs/index.rst index 62b92c4e393..7be36db8d50 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -57,17 +57,20 @@ Mission Statement :caption: Using TARDIS :hidden: - - running/index + components/index + gui/index + interaction/index .. toctree:: :maxdepth: 2 :caption: The Physics of TARDIS :hidden: - - Physics overview - physics/plasma/index + + physics/montecarlo/index + physics/new_plasma + physics/old_physics + .. toctree:: :maxdepth: 2 @@ -91,8 +94,7 @@ Mission Statement :caption: Team & Credits :hidden: - team - governance + team_and_governance/index credits Code of Conduct diff --git a/docs/physics/new_plasma.rst b/docs/physics/new_plasma.rst index d15117b5944..305ee29e321 100644 --- a/docs/physics/new_plasma.rst +++ b/docs/physics/new_plasma.rst @@ -39,3 +39,10 @@ If the necessary Python modules (`PyGraphviz `_ a Updating the Plasma ------------------- During each iteration of the main code, TARDIS updates the plasma using the `update_radiationfield` function. This requires, at minimum, new values for `t_rad` (the radiation temperature), `w` (the dilution factor) and `j_blues` (the intensity in the blue part of each line). + + + +.. toctree:: + :maxdepth: 2 + + plasma/index diff --git a/docs/physics/old_physics.rst b/docs/physics/old_physics.rst new file mode 100644 index 00000000000..37da2c34d34 --- /dev/null +++ b/docs/physics/old_physics.rst @@ -0,0 +1,17 @@ +********************* +Old Physics Section of the TARDIS Docu (Outdated) +********************* + +.. note:: + The following entries reflects the physics section of the old TARDIS + documentation. Even though this section of the documentation is partly + outdated, many basic concepts are still applicable to the current TARDIS + version. + + +.. toctree:: + :hidden: + :caption: + physical_quantities + montecarlo_old + plasma/index \ No newline at end of file diff --git a/docs/team_and_governance/governance.rst b/docs/team_and_governance/governance.rst new file mode 100644 index 00000000000..a308ce261ca --- /dev/null +++ b/docs/team_and_governance/governance.rst @@ -0,0 +1,40 @@ +.. _governance: + +********** +Governance +********** + +The development of TARDIS and associated software tools are helped through several coordination roles fulfilled by community members (see :ref:`team`). There are several governance rules to ensure scientific excellence, continuity, and transparency. The TARDIS community has matured substantially in recent years and we will revisit these rules as the community evolves. + +Rules for TARDIS-core +--------------------- + +New members of TARDIS-core are nominated by current members. All members of TARDIS-core can vote on nominated candidates, who require a 2/3 majority in their favour in order to be approved. + +Rules for terms +--------------- + +The rule for all roles will be as follows (with the exception of the PI). A single term is limited in time but the number of subsequent terms is not limited. The term limit for all terms is 3 years and is renewable once for another 3 years and then has to be advertised to the wider community. + +Every member of TARDIS-core is allowed to vote and the election will follow an anonymous rank voting system. If this results in a tie the PI will facilitate a discussion with a subsequent run-off election. + +For 6 months the previous position holder will act in an advisory role to the new position holder. + +**Term rules for the PI:** The selection of the PI will follow a similar process with the difference that their terms are 5 years (renewable once for another 5 years). A re-election for the role of PI is advertised in TARDIS-core and will be selected from members of this group (unless the group decides on an outsider with 2/3 majority). + + +Science Decisions +----------------- + +Decisions that concern implementation details for TARDIS and related projects that pertain to science questions should be discussed within the TARDIS core team. + + +Software Decisions +------------------ + +Decisions about software architecture and design should take into account consistency over the TARDIS code-base and best-practices. The final decision (after discussion with the rest of the team) rests with the software architect (veto-able by a 2/3 majority). + +Financial Decisions +------------------- + +Financial decisions can only be made by the PI but they have to inform TARDIS-core with a reasonable lead time to allow them to raise any objections. The TARDIS-core can veto decisions with a 2/3 majority. diff --git a/docs/team_and_governance/index.rst b/docs/team_and_governance/index.rst new file mode 100644 index 00000000000..15fd92acd50 --- /dev/null +++ b/docs/team_and_governance/index.rst @@ -0,0 +1,8 @@ +************** +Team and Governance +************** + +.. toctree:: + :maxdepth: 2 + team + governance diff --git a/docs/team_and_governance/team.rst b/docs/team_and_governance/team.rst new file mode 100644 index 00000000000..5deee9f72c2 --- /dev/null +++ b/docs/team_and_governance/team.rst @@ -0,0 +1,128 @@ +.. _team: + +**** +Team +**** + +TARDIS is developed by a multidisciplinary team. We adhere to our +`code of conduct `_. + +The development of TARDIS and associated software tools are made possible through several coordination roles fulfilled by community members. This encompasses a broad scope of responsibilities ranging from direct package development to communication, distribution, and managerial activities. + +The roles and their description can be found here: + +* **Principal Investigator** + - Wolfgang Kerzendorf +* **TARDIS CORE** [alphabetical] + - Yssavo Camacho-Neves, Andreas Flörs, Alice Harpole, Vytautas Jancauskas, Wolfgang Kerzendorf (founder), Luke Shingles, Stuart Sim (founder), Christian Vogl, Marc Williamson +* **TARDIS GSoC Coordinators (2020)** + Yssavo Camacho-Neves, Alice Harpole, Wolfgang Kerzendorf, Marc Williamson +* **TARDIS GSoC Mentors (2020)** + - Alice Harpole, Andreas Flörs, Christian Vogl, Fionntan Callan, James Gillanders, Luciano G Silvestri, Stuart Sim, Wolfgang Kerzendorf, Yssavo Camacho-Neves, Andrew Fullard, Arjun Savel, Brian Cherinka, Jack O'Brien, Lindsey Kwok, Luke Shingles, Marc Williamson, Mark Magee, Michael Moltenbrey, Vytautas Jancauskas +* **Ombudsperson** + - Michael Zingale (contact info on https://zingale.github.io/) +* **Software Architect** + - Alice Harpole +* **Issues / Pull Request** + - Andreas Flörs +* **Continuous Integration / Deployment / Testing** + - Christian Vogl +* **Funding / Financial** + - Marc Williamson +* **Science / Science Meeting / Publications** + - Yssavo Camacho-Neves +* **Diversity, Equity, and Inclusion** + - Wolfgang Kerzendorf + + +**Principal Investigator** + +- Guides the scientific and the educational activities of TARDIS +- Advised by TARDIS Core + +**TARDIS Core** + +- Team that oversees the activities and sets the goals for the TARDIS Collaboration +- Identifies science opportunities that match TARDIS capabilities or coordinates the addition of capabilities +- Identifies education opportunities such as workshops, lecture development, and outreach opportunities + +**TARDIS GSoC Coordinators (2020)** + +- Coordinate participation of TARDIS in the Google Summer of Code + +**TARDIS GSoC Mentors (2020)** + +- Mentors for Google Summer of Code students + +**Ombudsperson** + +- Designated person appointed to address the concerns of community members and to uphold the code of conduct +- Solicit and provide anonymized feedback to the TARDIS CORE team +- Assist the TARDIS CORE team with violations of the code of conduct or other ethical concerns +- **Specifically selected as not being part of the TARDIS collaboration** + +**Software Architect** + +- Ensure overall design pattern throughout TARDIS +- Coordinate restructure and rewriting efforts +- Identify and communicate new technologies relevant to TARDIS + +**Issues / Pull Request** + +- Monitor open PRs and issues +- Monitor reviewing is taking place +- Close abandoned PRs / Issues + +**Continuous Integration / Deployment / Testing** + +- Inform team of break in any of the CI/CD pipelines +- Delegate code maintenance and bug removal +- Identify new technologies for CI/CD + +**Funding / Financial** + +- Manage budget for TARDIS +- Ensure financial transparency +- Coordinating with funding organizations +- Securing funding for parts of the project via discussions and proposals to funding agencies + +**Science / Science Meeting / Publications** + +- Coordinating work for weekly science meeting +- Finding publications and collecting TARDIS models +- Citation guide + +**Diversity, Equity, and Inclusion** + +- Identify opportunities to use TARDIS to engage members of underrepresented minorities (URM) to coding/STEM +- Identify papers about engaging URM in coding / science + +TARDIS Alumni +============= + +The present version of TARDIS would not have been possible if not for the work of these individuals. + + +Past TARDIS Core Members +--------------------------- + + * Aoife Boyle + * Michael Klauser + * Stefan Lietzau + * Markus Kromer + * Ulrich Noebauer + +Current and Former GSoC and SOCIS Students +------------------------------------------ + + * Aoife Boyle (GSoC 2015) + * Tomas Bylund (SOCIS 2016) + * Karan Desai (GSoC 2016) + * Vaibhav Gupta (GSoC 2017) + * Vytautas Jancauskas (GSoC 2015, 2014) + * Stefan Lietzau (GSoC 2017) + * Mikhail Mishin (GSoC 2016) + * Fotis Tsamis (GSoC 2016) + * Ezequiel Passaro (GSoC 2019, 2020) + * Jaladh Singhal (GSoC 2019, 2020) + * Jordi Eguren Brown (GSoC 2020) From 324cf53bdd34e2d19cc5431ac484b042a1bc3c95 Mon Sep 17 00:00:00 2001 From: smithis7 Date: Fri, 27 Nov 2020 15:44:22 -0500 Subject: [PATCH 2/7] fixing old_physics --- docs/physics/old_physics.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/physics/old_physics.rst b/docs/physics/old_physics.rst index 37da2c34d34..78bf5834795 100644 --- a/docs/physics/old_physics.rst +++ b/docs/physics/old_physics.rst @@ -10,8 +10,6 @@ Old Physics Section of the TARDIS Docu (Outdated) .. toctree:: - :hidden: - :caption: physical_quantities montecarlo_old plasma/index \ No newline at end of file From 25e74ab8f88469f287696a215f574f12c0487763 Mon Sep 17 00:00:00 2001 From: smithis7 Date: Fri, 27 Nov 2020 16:07:10 -0500 Subject: [PATCH 3/7] adding alumni section and other team and governance corrections --- docs/team_and_governance/alumni.rst | 30 +++++++++++++++++++++++++++++ docs/team_and_governance/index.rst | 5 ++--- docs/team_and_governance/team.rst | 30 ----------------------------- 3 files changed, 32 insertions(+), 33 deletions(-) create mode 100644 docs/team_and_governance/alumni.rst diff --git a/docs/team_and_governance/alumni.rst b/docs/team_and_governance/alumni.rst new file mode 100644 index 00000000000..c5f3c6251e3 --- /dev/null +++ b/docs/team_and_governance/alumni.rst @@ -0,0 +1,30 @@ +************** +TARDIS Alumni +************** + +The present version of TARDIS would not have been possible if not for the work of these individuals. + + +Past TARDIS Core Members +--------------------------- + + * Aoife Boyle + * Michael Klauser + * Stefan Lietzau + * Markus Kromer + * Ulrich Noebauer + +Current and Former GSoC and SOCIS Students +------------------------------------------ + + * Aoife Boyle (GSoC 2015) + * Tomas Bylund (SOCIS 2016) + * Karan Desai (GSoC 2016) + * Vaibhav Gupta (GSoC 2017) + * Vytautas Jancauskas (GSoC 2015, 2014) + * Stefan Lietzau (GSoC 2017) + * Mikhail Mishin (GSoC 2016) + * Fotis Tsamis (GSoC 2016) + * Ezequiel Passaro (GSoC 2019, 2020) + * Jaladh Singhal (GSoC 2019, 2020) + * Jordi Eguren Brown (GSoC 2020) \ No newline at end of file diff --git a/docs/team_and_governance/index.rst b/docs/team_and_governance/index.rst index 15fd92acd50..695403f595d 100644 --- a/docs/team_and_governance/index.rst +++ b/docs/team_and_governance/index.rst @@ -1,8 +1,7 @@ -************** +******************** Team and Governance -************** +******************** .. toctree:: - :maxdepth: 2 team governance diff --git a/docs/team_and_governance/team.rst b/docs/team_and_governance/team.rst index 5deee9f72c2..d90d55e8fa2 100644 --- a/docs/team_and_governance/team.rst +++ b/docs/team_and_governance/team.rst @@ -96,33 +96,3 @@ The roles and their description can be found here: - Identify opportunities to use TARDIS to engage members of underrepresented minorities (URM) to coding/STEM - Identify papers about engaging URM in coding / science - -TARDIS Alumni -============= - -The present version of TARDIS would not have been possible if not for the work of these individuals. - - -Past TARDIS Core Members ---------------------------- - - * Aoife Boyle - * Michael Klauser - * Stefan Lietzau - * Markus Kromer - * Ulrich Noebauer - -Current and Former GSoC and SOCIS Students ------------------------------------------- - - * Aoife Boyle (GSoC 2015) - * Tomas Bylund (SOCIS 2016) - * Karan Desai (GSoC 2016) - * Vaibhav Gupta (GSoC 2017) - * Vytautas Jancauskas (GSoC 2015, 2014) - * Stefan Lietzau (GSoC 2017) - * Mikhail Mishin (GSoC 2016) - * Fotis Tsamis (GSoC 2016) - * Ezequiel Passaro (GSoC 2019, 2020) - * Jaladh Singhal (GSoC 2019, 2020) - * Jordi Eguren Brown (GSoC 2020) From 726a6e68e29c7feac689a8d69d37c45715cf6315 Mon Sep 17 00:00:00 2001 From: smithis7 Date: Sun, 29 Nov 2020 15:07:59 -0500 Subject: [PATCH 4/7] adding team_and_governance index file --- docs/team_and_governance/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/team_and_governance/index.rst b/docs/team_and_governance/index.rst index 695403f595d..c5b99b1fe87 100644 --- a/docs/team_and_governance/index.rst +++ b/docs/team_and_governance/index.rst @@ -4,4 +4,5 @@ Team and Governance .. toctree:: team + alumni governance From d673b768fe0b5d09749505ed395017c480d7d890 Mon Sep 17 00:00:00 2001 From: smithis7 Date: Mon, 30 Nov 2020 21:00:07 -0500 Subject: [PATCH 5/7] restructuring components and GUI subsections --- docs/running/components.rst | 17 +++++++++++++++++ docs/running/gui.rst | 8 +++----- docs/running/tardis_widgets/index.rst | 8 +++++--- 3 files changed, 25 insertions(+), 8 deletions(-) create mode 100644 docs/running/components.rst diff --git a/docs/running/components.rst b/docs/running/components.rst new file mode 100644 index 00000000000..8d6fdb8b0ab --- /dev/null +++ b/docs/running/components.rst @@ -0,0 +1,17 @@ +*********** +Components +*********** + +The TARDIS code needs three components to calculate spectra: + + +.. toctree:: + :maxdepth: 1 + + ../models/index + ../configuration/index + ../atomic/atomic_data + + +A quick start guide to run TARDIS can be found +`here <../quickstart/quickstart.ipynb>`_. \ No newline at end of file diff --git a/docs/running/gui.rst b/docs/running/gui.rst index 2691aef01b1..992fb7ffa42 100644 --- a/docs/running/gui.rst +++ b/docs/running/gui.rst @@ -1,8 +1,6 @@ -.. _gui: - -************************ -Graphical User Interface -************************ +************************************* +Old Graphical User Interface Section +************************************* TARDIS uses the `PyQt5 framework `_ for its cross-platform interface. diff --git a/docs/running/tardis_widgets/index.rst b/docs/running/tardis_widgets/index.rst index 7fd797ca741..fe1e3ac0ccc 100644 --- a/docs/running/tardis_widgets/index.rst +++ b/docs/running/tardis_widgets/index.rst @@ -1,6 +1,8 @@ -************** -TARDIS Widgets -************** +.. _gui: + +************************* +Graphical User Interface +************************* A collection of widgets (simple GUIs) that makes it easier for you to explore the simulation data within Jupyter Notebooks. From d281ba76e31a36e8f2e2340e8f04ae10bc354346 Mon Sep 17 00:00:00 2001 From: smithis7 Date: Mon, 30 Nov 2020 21:18:21 -0500 Subject: [PATCH 6/7] restructuring additional interactivity section and changing the order of components --- docs/index.rst | 6 +++--- docs/running/components.rst | 4 ++-- docs/running/interaction/index.rst | 10 +++++++--- 3 files changed, 12 insertions(+), 8 deletions(-) diff --git a/docs/index.rst b/docs/index.rst index 7be36db8d50..138b0c1f141 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -57,9 +57,9 @@ Mission Statement :caption: Using TARDIS :hidden: - components/index - gui/index - interaction/index + running/components + running/tardis_widgets/index + running/interaction/index .. toctree:: diff --git a/docs/running/components.rst b/docs/running/components.rst index 8d6fdb8b0ab..a9330fa36ec 100644 --- a/docs/running/components.rst +++ b/docs/running/components.rst @@ -7,9 +7,9 @@ The TARDIS code needs three components to calculate spectra: .. toctree:: :maxdepth: 1 - - ../models/index + ../configuration/index + ../models/index ../atomic/atomic_data diff --git a/docs/running/interaction/index.rst b/docs/running/interaction/index.rst index 26ae386cb15..8d749e3f835 100644 --- a/docs/running/interaction/index.rst +++ b/docs/running/interaction/index.rst @@ -1,5 +1,5 @@ -Interacting with TARDIS -======================= +Additional Interactivity +========================= To get more information from each run of TARDIS, one can run it interactively and have full access to the model properties (as described in :ref:`physical_quantities`). @@ -7,9 +7,13 @@ have full access to the model properties (as described in :ref:`physical_quantit .. toctree:: :maxdepth: 1 - access + + ../commandline callback_example + ../converters/index Custom_TARDIS_Model_Tutorial + ../gui + access init_trad_bug integrator isotope_pd_subclass From eef9c1b9a42765e120d930ca465cd29df0483543 Mon Sep 17 00:00:00 2001 From: smithis7 Date: Thu, 3 Dec 2020 10:14:36 -0500 Subject: [PATCH 7/7] adding andrew to tardis core --- docs/team_and_governance/team.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/team_and_governance/team.rst b/docs/team_and_governance/team.rst index d90d55e8fa2..5aa754bb92f 100644 --- a/docs/team_and_governance/team.rst +++ b/docs/team_and_governance/team.rst @@ -14,7 +14,7 @@ The roles and their description can be found here: * **Principal Investigator** - Wolfgang Kerzendorf * **TARDIS CORE** [alphabetical] - - Yssavo Camacho-Neves, Andreas Flörs, Alice Harpole, Vytautas Jancauskas, Wolfgang Kerzendorf (founder), Luke Shingles, Stuart Sim (founder), Christian Vogl, Marc Williamson + - Yssavo Camacho-Neves, Andreas Flörs, Andrew Fullard, Alice Harpole, Vytautas Jancauskas, Wolfgang Kerzendorf (founder), Luke Shingles, Stuart Sim (founder), Christian Vogl, Marc Williamson * **TARDIS GSoC Coordinators (2020)** Yssavo Camacho-Neves, Alice Harpole, Wolfgang Kerzendorf, Marc Williamson * **TARDIS GSoC Mentors (2020)**