Skip to content

Commit

Permalink
deploy: cdba9f5
Browse files Browse the repository at this point in the history
  • Loading branch information
schmiedc committed Feb 9, 2024
1 parent 0dc7cbc commit c2b5e85
Show file tree
Hide file tree
Showing 7 changed files with 63 additions and 27 deletions.
Binary file added _images/ImageFormat_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added _images/ImageFormat_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added _images/ImageFormat_4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added _images/ImageFormat_5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
26 changes: 18 additions & 8 deletions _sources/format.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,27 @@
Light microscopy images in publications can rapidly communicate useful details if they are prepared to be information dense, clean and containing the most important information/metadata the audience needs to see at a glance. A set of simple processing rules can focus the audience’s attention to the most relevant parts that are crucial for understanding the experiment and/or results. Consult the steps below to start your journey to create understandable and reproducible figures.

```{note}
````{dropdown} <img src="images_icons/ImageFormat_1.png" height="25px"> Focus on relevant content
````{dropdown} <img src="images_icons/ImageFormat_1.png" height="25px"> Focus on relevant content
- Crop empty/irrelevant pixels to focus the audience’s attention. Rotate images where required, ideally in 90 degree increments. Resize images to fit the intended panel size.
´´´´
- <img src="images_icons/blank.png" height="25px"> Separate individual images
````
````{dropdown} <img src="images_icons/ImageFormat_2.png" height="25px"> Separate individual images
- A border between individual images makes distinction easier reducing the risk of confusion and mix up bot for the author and the audience.
- <img src="images_icons/blank.png" height="25px"> Show example image used for quantifications
- Provide context and a dash of accountability by complementing a graph of results with one of the quantified images.
- <img src="images_icons/blank.png" height="25px"> Indicate position of zoom-view/inset in full-view/original image
- When the big picture is as important as the small details, show both. An indication of the position of the detailed image that must be highlighted to the audience is a valuable tool.
- <img src="images_icons/blank.png" height="25px"> Show images of the range of described phenotype
````
````{dropdown} <img src="images_icons/ImageFormat_3.png" height="25px"> Show example image used for quantifications
- Provide context and a dash of accountability by complementing a graph of results with one of the quantified images.
````
````{dropdown} <img src="images_icons/ImageFormat_4.png" height="25px"> Indicate position of zoom-view/inset in full-view/original image
- When the big picture is as important as the small details, show both. An indication of the position of the detailed image that must be highlighted to the audience is a valuable tool.
````
````{dropdown} <img src="images_icons/ImageFormat_5.png" height="25px"> Show images of the range of described phenotype
- As tempting as it may be to cherry pick the image that shows the nicest or most representative case, show the audience a flavor of everything: the good, the bad and the ugly.
````
```

<!--Notes which will not be shown on the actual page-->
62 changes: 44 additions & 18 deletions format.html
Original file line number Diff line number Diff line change
Expand Up @@ -397,38 +397,64 @@ <h1>Image format<a class="headerlink" href="#image-format" title="Permalink to t
<p class="admonition-title">Note</p>
<details class="sd-sphinx-override sd-dropdown sd-card sd-mb-3">
<summary class="sd-summary-title sd-card-header">
<a class="reference internal" href="_images/ImageFormat_1.png"><img alt="_images/ImageFormat_1.png" src="_images/ImageFormat_1.png" style="height: 25px;" /></a> Focus on relevant content<div class="sd-summary-down docutils">
<a class="reference internal" href="_images/ImageFormat_1.png"><img alt="_images/ImageFormat_1.png" src="_images/ImageFormat_1.png" style="height: 25px;" /></a> Focus on relevant content<div class="sd-summary-down docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
<div class="sd-summary-up docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
</summary><div class="sd-summary-content sd-card-body docutils">
<ul class="simple">
<li><p class="sd-card-text">Crop empty/irrelevant pixels to focus the audience’s attention. Rotate images where required, ideally in 90 degree increments. Resize images to fit the intended panel size.</p></li>
</ul>
</div>
</details></div>
<details class="sd-sphinx-override sd-dropdown sd-card sd-mb-3">
<summary class="sd-summary-title sd-card-header">
<a class="reference internal" href="_images/ImageFormat_2.png"><img alt="_images/ImageFormat_2.png" src="_images/ImageFormat_2.png" style="height: 25px;" /></a> Separate individual images<div class="sd-summary-down docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
<div class="sd-summary-up docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
</summary><div class="sd-summary-content sd-card-body docutils">
<ul class="simple">
<li><p class="sd-card-text">Crop empty/irrelevant pixels to focus the audience’s attention. Rotate images where required, ideally in 90 degree increments. Resize images to fit the intended panel size.
´´´´</p></li>
<li><p class="sd-card-text"><a class="reference internal" href="_images/blank.png"><img alt="_images/blank.png" src="_images/blank.png" style="height: 25px;" /></a> Separate individual images</p>
<ul>
<li><p class="sd-card-text">A border between individual images makes distinction easier reducing the risk of confusion and mix up bot for the author and the audience.</p></li>
</ul>
</li>
<li><p class="sd-card-text"><a class="reference internal" href="_images/blank.png"><img alt="_images/blank.png" src="_images/blank.png" style="height: 25px;" /></a> Show example image used for quantifications</p>
<ul>
</div>
</details><details class="sd-sphinx-override sd-dropdown sd-card sd-mb-3">
<summary class="sd-summary-title sd-card-header">
<a class="reference internal" href="_images/ImageFormat_3.png"><img alt="_images/ImageFormat_3.png" src="_images/ImageFormat_3.png" style="height: 25px;" /></a> Show example image used for quantifications<div class="sd-summary-down docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
<div class="sd-summary-up docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
</summary><div class="sd-summary-content sd-card-body docutils">
<ul class="simple">
<li><p class="sd-card-text">Provide context and a dash of accountability by complementing a graph of results with one of the quantified images.</p></li>
</ul>
</li>
<li><p class="sd-card-text"><a class="reference internal" href="_images/blank.png"><img alt="_images/blank.png" src="_images/blank.png" style="height: 25px;" /></a> Indicate position of zoom-view/inset in full-view/original image</p>
<ul>
</div>
</details><details class="sd-sphinx-override sd-dropdown sd-card sd-mb-3">
<summary class="sd-summary-title sd-card-header">
<a class="reference internal" href="_images/ImageFormat_4.png"><img alt="_images/ImageFormat_4.png" src="_images/ImageFormat_4.png" style="height: 25px;" /></a> Indicate position of zoom-view/inset in full-view/original image<div class="sd-summary-down docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
<div class="sd-summary-up docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
</summary><div class="sd-summary-content sd-card-body docutils">
<ul class="simple">
<li><p class="sd-card-text">When the big picture is as important as the small details, show both. An indication of the position of the detailed image that must be highlighted to the audience is a valuable tool.</p></li>
</ul>
</li>
<li><p class="sd-card-text"><a class="reference internal" href="_images/blank.png"><img alt="_images/blank.png" src="_images/blank.png" style="height: 25px;" /></a> Show images of the range of described phenotype</p>
<ul>
</div>
</details><details class="sd-sphinx-override sd-dropdown sd-card sd-mb-3">
<summary class="sd-summary-title sd-card-header">
<a class="reference internal" href="_images/ImageFormat_5.png"><img alt="_images/ImageFormat_5.png" src="_images/ImageFormat_5.png" style="height: 25px;" /></a> Show images of the range of described phenotype<div class="sd-summary-down docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-down" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M5.22 8.72a.75.75 0 000 1.06l6.25 6.25a.75.75 0 001.06 0l6.25-6.25a.75.75 0 00-1.06-1.06L12 14.44 6.28 8.72a.75.75 0 00-1.06 0z"></path></svg></div>
<div class="sd-summary-up docutils">
<svg version="1.1" width="1.5em" height="1.5em" class="sd-octicon sd-octicon-chevron-up" viewBox="0 0 24 24" aria-hidden="true"><path fill-rule="evenodd" d="M18.78 15.28a.75.75 0 000-1.06l-6.25-6.25a.75.75 0 00-1.06 0l-6.25 6.25a.75.75 0 101.06 1.06L12 9.56l5.72 5.72a.75.75 0 001.06 0z"></path></svg></div>
</summary><div class="sd-summary-content sd-card-body docutils">
<ul class="simple">
<li><p class="sd-card-text">As tempting as it may be to cherry pick the image that shows the nicest or most representative case, show the audience a flavor of everything: the good, the bad and the ugly.</p></li>
</ul>
</li>
</ul>
</div>
</details></div>
<!--Notes which will not be shown on the actual page-->
</details><div class="highlight-default notranslate"><div class="highlight"><pre><span></span>
&lt;!--Notes which will not be shown on the actual page--&gt;
</pre></div>
</div>
</section>

<script type="text/x-thebe-config">
Expand Down
Loading

0 comments on commit c2b5e85

Please sign in to comment.