Skip to content

Commit

Permalink
Merge pull request #5287 from ahmedhamidawan/update_history_tutorial
Browse files Browse the repository at this point in the history
Update history interface tutorial.md
  • Loading branch information
bgruening authored Sep 7, 2024
2 parents 398f9b8 + 43a39a0 commit 400dd51
Show file tree
Hide file tree
Showing 3 changed files with 8 additions and 6 deletions.
Binary file modified topics/galaxy-interface/images/history.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 3 additions & 2 deletions topics/galaxy-interface/tutorials/history/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ contributions:
- bebatut
- bgruening
- hexylena
- ahmedhamidawan
subtopic: histories

recordings:
Expand All @@ -44,7 +45,7 @@ recordings:

---

{% snippet faqs/gtn/galaxy_tested_with.md version="24.0" %}
{% snippet faqs/gtn/galaxy_tested_with.md version="24.1" %}

When data is uploaded from your computer or analysis is done on existing data using Galaxy, each output from those steps
generates a dataset. These datasets (and the output datasets from later analysis on them) are stored by Galaxy in
Expand All @@ -56,7 +57,7 @@ All users have one 'current' history, which can be thought of as **a workspace**
bioinformatics terms. Your current history is displayed in the right hand side of the main 'Analyze Data' Galaxy page in
what is called the history panel.

![Screenshot of the Galaxy UI with the toolbox, center panel, and history visible](../../images/history.svg "Galaxy History is simply the right panel of the interface. It lists all datasets uploaded or produced during an analysis. Galaxy was designed around history with the idea of <i>reproducibility</i> in mind!")
![Screenshot of the Galaxy UI with the toolbox, center panel, and history visible](../../images/history.png "Galaxy History is simply the right panel of the interface. It lists all datasets uploaded or produced during an analysis. Galaxy was designed around history with the idea of <i>reproducibility</i> in mind!")

The history panel displays output datasets in the order in which they were created, with the oldest/first shown at the
bottom. As new analyses are done and new output datasets are generated, the newest datasets are added to the top of the
Expand Down
9 changes: 5 additions & 4 deletions topics/galaxy-interface/tutorials/search/search.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,19 +16,20 @@ For example:

## Clearing a Search

You can clear a search and show all visible datasets by clicking the round 'X' button in the right of the search bar
You can clear a search and show all visible datasets by clicking the 'X' button in the right end of the search bar
or - while entering text in the search bar - hitting the escape key ('Esc').

# Advanced Searching

You can also specify dataset properties that you want to filter on. If you search with multiple properties, these are connected with ANDs, so datasets must match all provided attributes.
You can also specify dataset properties that you want to filter on. If you search with multiple properties, these are connected with ANDs, so datasets must match all provided attributes. Here are some examples of filters you can use:

Query | Results
----- | ------
`name:'FASTQC on'` | Any datasets with "FASTQC on" in the title, but avoids items which have "FASTQC on" in other fields like the description or annotation.
`extension:vcf` | Datasets with a specific format. Some formats are hierarchical, e.g. searching for `fastq` will find fastq files but also fastqsanger and fastqillumina files. You can see more formats in the upload dialogue.
`tag:experiment1 tag:to_publish` | for searching on (a partial) dataset tag. You can repeat to search for more tags.
`related:10` | A specific history item ID (based on the ordering in the history)
`state:error` | To show only datasets in a given state. Other options include `ok`, `running`, `paused`, and `new`.
`hid:4` | The specific item with history item ID 4 (based on the ordering in the history) (This is also a ranged filter, so `hid>4` will return all history items with ID greater than 4)
`related:10` | Datasets "related to" (inputs/outputs for) a dataset with specific history item ID (based on the ordering in the history)
`state:error` | To show only datasets in a given state. Other options include `ok`, `running`, `paused`, `new`, etc. (Click on the dropdown to see all options)

If you find normal searching is showing too many datasets, and not what you're looking for, try the advanced search! Just use the {% icon galaxy-advanced-search %} button next to the search field to show the advanced selector.

0 comments on commit 400dd51

Please sign in to comment.