Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for Spectral Element Decomposition Plot #1438

Merged
merged 11 commits into from
Feb 11, 2021

Conversation

jaladh-singhal
Copy link
Member

@jaladh-singhal jaladh-singhal commented Jan 29, 2021

Added notebook in gui docs demonstrating use of sdec_plot module. And restructured gui doc index to incorporate both tools and widgets.

How Has This Been Tested?

  • Testing pipeline
  • Reference Data Comparison following these instructions
  • Other (please describe)

Doc builds correctly

Screenshots (if appropriate):

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • None of the above (please describe)

Checklist:

  • My code follows the code style of this project
  • My change requires a change to the documentation
  • I have updated the documentation accordingly
  • I have built the documentation on my fork following these instructions
  • I have assigned and requested two reviewers for this pull request

@codecov
Copy link

codecov bot commented Jan 29, 2021

Codecov Report

Merging #1438 (8d0eab1) into master (7f31e2b) will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##           master    #1438   +/-   ##
=======================================
  Coverage   71.13%   71.13%           
=======================================
  Files          67       67           
  Lines        5523     5523           
=======================================
  Hits         3929     3929           
  Misses       1594     1594           

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7f31e2b...b1232fd. Read the comment docs.

@jaladh-singhal jaladh-singhal marked this pull request as draft January 29, 2021 18:18
@jaladh-singhal jaladh-singhal marked this pull request as ready for review February 5, 2021 14:08
@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:46Z
----------------------------------------------------------------

It would be best to define your abbreviation to SDEC here and then from here on out only use SDEC in the text; e.g. Spectral element DEComposition (SDEC) Plot or similar.

Can you embed the url to the paper cited here?

It is a spectral diagnostic plot similar... - drop the plural on diagnostic


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:47Z
----------------------------------------------------------------

Just use SDEC

... to produce a/an SDEC Plot


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:48Z
----------------------------------------------------------------

Can just use SDEC throughout


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:48Z
----------------------------------------------------------------

... to get a highly...

use SDEC


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:49Z
----------------------------------------------------------------

...SDEC plot is produced from the virtual packet population...


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:50Z
----------------------------------------------------------------

the real packet population


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:51Z
----------------------------------------------------------------

You can plot in units of flux on the Y-axis of the SDEC plot, by specifying the distance parameter. It should be a quantity with unit length e.g. m, Mpc, etc. and must be a positive value. By default, distance=None plots luminosity on the Y-axis.


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:51Z
----------------------------------------------------------------

distance: ...flux instead of luminosity

figsize: (10,7) - this has changed, right?


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:52Z
----------------------------------------------------------------

can just use SDEC here

...are specific to the plotting library. We can reproduce all the plots above...


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:53Z
----------------------------------------------------------------

*luminosity


@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-05T17:18:53Z
----------------------------------------------------------------

This hdf_plotter object is similar to the plotter object we used above, so you can use each plotting method demonstrated above with this too.


Copy link
Member

@jamesgillanders jamesgillanders left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is very nicely presented @jaladh-singhal - very nice notebook! Although I appear to have loads of comments, they are mostly small grammatical corrections to the wording in certain parts. Happy for this to be merged when these have been addressed

@review-notebook-app
Copy link

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-08T12:45:12Z
----------------------------------------------------------------

The units on y-axis don't look right - the ^{2} isn't rendering as a superscript 2. Put inside a set of $$ and it should work


Copy link
Member

@jamesgillanders jamesgillanders left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Corrections look good @jaladh-singhal. I had one final thing I noticed for the y-axis flux label, but apart from that it looks perfect!

@jaladh-singhal
Copy link
Member Author

View / edit / reply to this conversation on ReviewNB

jamesgillanders commented on 2021-02-08T12:45:12Z
----------------------------------------------------------------

The units on y-axis don't look right - the ^{2} isn't rendering as a superscript 2. Put inside a set of $$ and it should work


@jamesgillanders yes I noticed that but didn't correct that intentionally because #1446 is going to correct it anyway and it's kinda irrelevant to this doc PR.

@jamesgillanders
Copy link
Member

View / edit / reply to this conversation on ReviewNB
jamesgillanders commented on 2021-02-08T12:45:12Z

The units on y-axis don't look right - the ^{2} isn't rendering as a superscript 2. Put inside a set of $$ and it should work

@jamesgillanders yes I noticed that but didn't correct that intentionally because #1446 is going to correct it anyway and it's kinda irrelevant to this doc PR.

Alright, I didn't realise that. Everything else is fine so I will approve now

@ycamacho
Copy link
Contributor

Looks great! Happy to merge.

@ycamacho ycamacho merged commit b9ab7c8 into tardis-sn:master Feb 11, 2021
atharva-2001 pushed a commit to atharva-2001/tardis that referenced this pull request Oct 1, 2021
…1438)

* Restructured gui index to incoprorte viz tools

* Added notebook to demo SEDec plot

* Added notebook demonstrating SEDec plot

* Renamed SEDec to SDEC

* Added distance option & additional options usage

* Changed ref link name in index

* Added gif to demo notebook

* Increase matplotlib plot size

* Fixed inconsistency in docstring

* Made grammatical edits in notebook & hid warnings

* Fixed top level heading from ## to #
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants