Skip to content

Commit

Permalink
Reorganize tests and screenshot outputs for multiple workflow runs
Browse files Browse the repository at this point in the history
  • Loading branch information
garrettmflynn committed Mar 28, 2024
1 parent 322a2a2 commit b591c6a
Show file tree
Hide file tree
Showing 47 changed files with 670 additions and 560 deletions.
File renamed without changes
File renamed without changes
Binary file added docs/assets/tutorials/home-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 docs/assets/tutorials/single/format-options.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 docs/assets/tutorials/single/formats-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
Binary file added docs/assets/tutorials/single/inspect-page.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 docs/assets/tutorials/single/interface-added.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 docs/assets/tutorials/single/metadata-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 docs/assets/tutorials/single/preview-page.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 docs/assets/tutorials/single/search-behavior.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 docs/assets/tutorials/single/sourcedata-page.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 docs/assets/tutorials/single/valid-name.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 docs/assets/tutorials/single/workflow-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/tutorials/dataset.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ To get you started as quickly as possible, we’ve created a way to generate thi

Navigate to the **Settings** page using the main sidebar. Then press the **Generate** button in the top-right corner to initiate the dataset creation.

.. figure:: ./screenshots/dataset-creation.png
.. figure:: ../assets/tutorials/dataset-creation.png
:align: center
:alt: Dataset Creation Screen

Expand Down
Binary file removed docs/tutorials/screenshots/all-interfaces-added.png
Binary file not shown.
Binary file not shown.
Binary file removed docs/tutorials/screenshots/format-options.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/formats-page.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/home-page-complete.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/home-page.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/inspect-page.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/interface-added.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/metadata-open.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/metadata-page.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/preview-page.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/search-behavior.png
Diff not rendered.
Diff not rendered.
Binary file removed docs/tutorials/screenshots/sourcedata-page.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/valid-name.png
Diff not rendered.
Binary file removed docs/tutorials/screenshots/workflow-page.png
Diff not rendered.
42 changes: 26 additions & 16 deletions docs/tutorials/single_session.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ As a researcher, you’ve just completed an experimental session and you’d lik

Upon launching the GUIDE, you'll begin on the Conversions page. If you’re opening the application for the first time, there should be no pipelines listed on this page.

.. figure:: ./screenshots/home-page.png
.. figure:: ../assets/tutorials/home-page.png
:align: center
:alt: Home page

Expand All @@ -28,14 +28,14 @@ The Project Setup page will have you define two pieces of information about your

You’ll notice that the name property has a red asterisk next to it, which identifies it as a required property.

.. figure:: ./screenshots/info-page.png
.. figure:: ../assets/tutorials/single/info-page.png
:align: center
:alt: Project Setup page with no name (invalid)


After specifying a unique project name, the colored background and error message will disappear, allowing you to advance to the next page.

.. figure:: ./screenshots/valid-name.png
.. figure:: ../assets/tutorials/single/valid-name.png
:align: center
:alt: Project Setup page with valid name

Expand All @@ -45,7 +45,7 @@ On this page, you’ll specify the type of **workflow** you’d like to follow f

Since this is a single-session workflow, you’ll need to specify a **Subject ID** and **Session ID** to identify the data you’ll be converting.

.. figure:: ./screenshots/workflow-page.png
.. figure:: ../assets/tutorials/single/workflow-page.png
:align: center
:alt: Workflow page

Expand All @@ -55,33 +55,33 @@ Data Formats
^^^^^^^^^^^^
Next, you’ll specify the data formats you’re working with on the Data Formats page. The GUIDE supports 40+ total neurophysiology formats. A full registry of available formats is available here.

.. figure:: ./screenshots/formats-page.png
.. figure:: ../assets/tutorials/single/formats-page.png
:align: center
:alt: Date Formats page

The tutorial we're working with uses the SpikeGLX and Phy formats, a common output for NeuroPixel recordings and subsequent spike sorting. To specify that your pipeline will handle these files, you’ll press the “Add Format” button.

.. figure:: ./screenshots/format-options.png
.. figure:: ../assets/tutorials/single/format-options.png
:align: center
:alt: Format pop-up on the Data Formats page

Then, select the relevant formats—in this case, **SpikeGLX Recording** and **Phy Sorting**—from the pop-up list. Use the search bar to filter for the format you need.


.. figure:: ./screenshots/search-behavior.png
.. figure:: ../assets/tutorials/single/search-behavior.png
:align: center
:alt: Searching for SpikeGLX in the format pop-up

The selected formats will then display above the button.


.. figure:: ./screenshots/interface-added.png
.. figure:: ../assets/tutorials/single/interface-added.png
:align: center
:alt: Data Formats page with SpikeGLX Recording added to the list

Advance to the next page when you have **SpikeGLX Recording** and **Phy Sorting** selected.

.. figure:: ./screenshots/all-interfaces-added.png
.. figure:: ../assets/tutorials/single/all-interfaces-added.png
:align: center
:alt: Data Formats page with both SpikeGLX Recording and Phy Sorting added to the list

Expand All @@ -92,7 +92,7 @@ Source Data Information
^^^^^^^^^^^^^^^^^^^^^^^
On this page, specify the relevant **.bin** (Spikeglx) file and **phy** folder so that the GUIDE can find this source data to complete the conversion.

.. figure:: ./screenshots/sourcedata-page-specified.png
.. figure:: ../assets/tutorials/single/sourcedata-page-specified.png
:align: center
:alt: Source Data page with source locations specified

Expand All @@ -103,20 +103,30 @@ The file metadata page is a great opportunity to add rich annotations to the fil

The General Metadata for the GUIDE has already been specified because the Session Start Time was automatically extracted from the SpikeGLX source data.

.. figure:: ./screenshots/metadata-page.png
.. figure:: ../assets/tutorials/single/metadata-nwbfile.png
:align: center
:alt: Metadata page with invalid Subject information


However, we still need to add the Subject information—as noted by the red accents around that item. Let’s say that our subject is a male mouse with an age of P30D.

.. figure:: ./screenshots/metadata-open.png
.. figure:: ../assets/tutorials/single/metadata-subject-complete.png
:align: center
:alt: Metadata page with valid Subject information

The status of the Subject information will update in real-time as you fill out the form.

After you press the Next button, you’ll be presented with a progress bar that indicates how many files are left to run a stub conversion on.

This dataset will also have **Ecephys** metadata extracted from the SpikeGLX source data.

.. figure:: ../assets/tutorials/single/metadata-ecephys.png
:align: center
:alt: Ecephys metadata extracted from the SpikeGLX source data


Let's leave this as-is and advance to the next page.

As you advance, you’ll trigger a stub conversion and be shown a progress bar that indicates how many files are left.

File Conversion
---------------
Expand All @@ -126,7 +136,7 @@ Inspector Report

The Inspector Report page allows you to validate the generated stub NWB files against the latest Best Practices and determine whether you’ve provided all the metadata for your files. Using the internal sidebar, you can scope the displayed errors by a particular subject or session.

.. figure:: ./screenshots/inspect-page.png
.. figure:: ../assets/tutorials/single/inspect-page.png
:align: center
:alt: NWB Inspector report

Expand All @@ -138,7 +148,7 @@ Conversion Preview
On the Conversion Preview, Neurosift allows you to explore the structure of the NWB file and ensure your data matches your expectations.


.. figure:: ./screenshots/preview-page.png
.. figure:: ../assets/tutorials/single/preview-page.png
:align: center
:alt: Neurosift preview visualization

Expand All @@ -149,7 +159,7 @@ Conversion Review

Congratulations on finishing your first conversion of neurophysiology files using the NWB GUIDE!

.. figure:: ./screenshots/conversion-results-page.png
.. figure:: ../assets/tutorials/single/conversion-results-page.png
:align: center
:alt: Conversion results page with a list of converted files

Expand Down
1 change: 1 addition & 0 deletions src/renderer/assets/css/global.css
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ html {
overflow: hidden; /* Prevents rubber-band scrolling of the whole "page" */
color: var(--color);
background-color: #fff; /* To cover OSes with no default background color */

}

body {
Expand Down
Loading

0 comments on commit b591c6a

Please sign in to comment.