Differences

This shows you the differences between two versions of the page.

--- creating_cases_using_pattern_search [2024/02/19 13:58]
chris CCUPS
+++ creating_cases_using_pattern_search [2024/02/29 18:04] (current)
chris
@@ Line 1: / Line 1: @@
-===== Creating Cases with Pattern Search =====
+===== Creating (Multiple) Cases with Pattern Search =====
-Sometimes you may need to create a case that has slides in different folders, or find a large number of examples of a particular stain, indication, or filetype.
+Sometimes you may need to create many Cases from WSIs that aren't in their own subfolder, or create a Case that has slides across several different folders, or find a large number of examples of a particular stain, indication, or filetype.
 That's where Pattern Search can make your life a lot easier by eliminating the manual searching through all your directories to add them one by one.\\
@@ Line 9: / Line 9: @@
 Then click the "Create Multiple" button.
-{{ :add_multiple_cases_1.png?800 |}}
+{{ :add_multiple_cases_1.png?600 |}}
-==== Running the pattern search =====
+==== Running a pattern search =====
   - First click the 'Pattern Search' tab at the top of the page
@@ Line 20: / Line 20: @@
   - When you're happy with the results, click Create. If you want to add/remove files you can edit the case after creation.
-{{ :pattern search 1.png?800 |}}
+{{ :pattern search 1.png?600 |}}
-==== Pattern Search Behaviour and how to use 'Regular Expression' in a Search ====
+===== Pattern Search Behaviour and how to use 'Regular Expression' in a Search =====
-If you don't include any special characters, the pattern you type in will be matched against any files containing it. E.g. searching for 'S' will pull up all files containing the letter 'S'.
+Regular expressions, often abbreviated as regex or regexp, are powerful tools for pattern matching and text manipulation. They provide a concise and flexible way to describe, search, and manipulate strings.
-Regular expression or 'regex' is a series of commands you can use to make very specific searches.
+==== Adding Every File as it's Own Case ====
+.*
+That's all you need. The '.' matches any character except for a new line, and the '*' says the preceeding character can be matched 0 or more times.\\
+In the screenshot below, you can see this search makes a new case for every WSI file in the directory.
+{{ :pattern search 3.png?600 |}}
+Here are some examples of how .* behaves in a regex pattern:
+abc.*def: This pattern would match strings that start with "abc" and are followed by any sequence of characters, eventually ending with "def". For example, it would match "abc123def" or "abcxyzdef".
+.*\d+.*: This pattern would match strings that contain one or more digits anywhere in the string. The .* before and after \d+ allows for any characters before and after the digit(s).
+In the screenshot below you can see that '.*-' matches only files that have a '-' in their name
+{{ :pattern search 5.png?600 |}}
+==== Adding Similarly Named Files into Cases ====
+What about if you have file(s) named in a similar way?
+We can use some simple commands to sort these into cases.
+Here you can see that typing '.' matches all files starting with the same character into a Case.
+{{ :pattern search 4.png?600 |}}
+If you have files with different names, but each case shares the first 4 letters or numbers, you can type '....' to group them together.
+Another way to search and group together files into Cases is using [].\\
+Any search terms you put within the [] will be searched for.\\
+In the example below, we use ^[\d\w]* to find the starting pattern of each filename until it is interrupted by a special character e.g. '(' or '.'
+{{ :pattern search 6.png?600 |}}
+You can also chain several of these blocks together, for example:\\
+^[\d\w]+-[\d\w]+-[\d\w] would find all files with three strings of alphanumeric characters, each separated by a '-'
+==== Finding Many Files for a Single Case ====
+You can use pattern search like a regular search engine to find 'files' in your selected folder\\
 Some examples include:
@@ Line 33: / Line 75: @@
 Using ^CF to match any string starting with 'CF' \\
 Using ? to indicate subexpressions in your pattern, e.g. "fish(er)?" matches "fish" or "fisher".
-You can learn more about regex with online guides including:
-https://www.microfocus.com/documentation/relativity/relativity1216/reldbdsn/GUID-7C2DF185-41A1-4448-81E7-3252AA8DEBB3.html
 In the screenshot below you can see the $ regex [1] has been used to select only .svs files across many subfolders [2]
-{{ :pattern search 2.png?800 |}}
+{{ :pattern search 2.png?600 |}}
+==== Full Explanation of Regular Expression Syntax ====
+Here are some key concepts and syntax:
+. Literal Characters:\\
+Most characters in a regular expression match themselves literally. \\
+For example, the regular expression abc will match the string "abc" in the input.
+. Metacharacters:
+	• Certain characters have special meanings in regular expressions and are called metacharacters. Some common ones include:
+		○ . (dot): Matches any single character except a newline.
+		○ *: Matches 0 or more occurrences of the preceding character or group.
+		○ +: Matches 1 or more occurrences of the preceding character or group.
+		○ ?: Matches 0 or 1 occurrence of the preceding character or group.
+		○ ^: Anchors the regex at the beginning of the line.
+		○ $: Anchors the regex at the end of the line.
+. Character Classes:
+	• [ ]: Defines a character class. For example, [aeiou] matches any vowel.
+	• [^ ]: Negates a character class. For example, [^0-9] matches any non-digit character.
+. Quantifiers:
+	• {n}: Matches exactly n occurrences of the preceding character or group.
+	• {n,}: Matches n or more occurrences.
+	• {n,m}: Matches between n and m occurrences.
+. Grouping and Capturing:
+	• ( ): Groups expressions together. Also used for capturing portions of the matched text.
+. Anchors:
+	• \b: Word boundary anchor.
+	• \B: Non-word boundary anchor.
+	• ^ and $: Anchors for the start and end of a line, respectively.
+. Escape Characters:
+	• \: Escapes a metacharacter, allowing it to be treated as a literal character. For example, \. matches a literal dot.
+. Modifiers:
+	• i: Case-insensitive matching.
+	• g: Global matching (find all matches rather than stopping after the first match).
+. Special Sequences:
+	• \d: Matches any digit (equivalent to [0-9]).
+	• \w: Matches any word character (alphanumeric + underscore).
+	• \s: Matches any whitespace character.
+. Lookaheads and Lookbehinds:
+	• (?=...): Positive lookahead assertion.
+	• (?!...): Negative lookahead assertion.
+	• (?<=...): Positive lookbehind assertion.
+	• (?<!...): Negative lookbehind assertion.
+Regular expressions are supported in many programming languages (e.g., Python, JavaScript, Java) and text editors. They are incredibly versatile but can also become complex. Practice and experimentation are key to mastering regex. Online regex testers, such as regex101 or RegExr, can help you test and visualize your regular expressions.

Pathotrainer

User Tools

Site Tools

Differences

Page Tools