Editing Archive:Thera Scanning Quick Start Guide

{{archive}}

This is a beginner's Thera Scanning Guide intended to explain how to keep our [https://www.eve-scout.com/thera/ Thera Map] up-to-date using the [[ENG:Thera_Scan_Tool|Thera Scan Tool]]. The primary audience is newer scouts who are not experienced with the process.  Each scout has their own method, and what works for a very experienced scout will probably not work for a less experienced pilot.  

== Overview ==
# Join the in-game <code>EvE-Scout.TheraMap</code> chat channel
# Check and adjust your [[Thera_Scanning_Tripwire_Setup|Tripwire settings for Thera scanning]] 
# Use the [https://therascan.info/ Thera Scan Tool] to check the status of signatures in Thera
## Clear any expired signatures from Tripwire
## Map any new signatures, save the bookmarks to the in-game '''Signal Cartel \\ Thera''' folder, and then add them to Tripwire
# Have questions?  Ask away in the <code>#thera-scanning</code> [https://discord.gg/0qn6aJxK8iwEfiwF Discord] channel
# After you have added 5 or more Thera Wormhole Connections to the [https://www.eve-scout.com/ evescout.com] website, claim your free fitted covert ops ship by [https://forums.eve-scout.com/topic/7356/new-sc-member-try-thera-scanning-win-a-fitted-covert-ops-ship '''clicking here''']!  Program is courtesy of [https://evewho.com/character/2114254786 Tekufah].

== Tools of the Trade ==
=== Tripwire ===
* [https://tripwire.eve-apps.com/ Tripwire] is an open source wormhole mapping tool used by the [[TS:Thera_Scanning|EvE-Scout Thera Scanning Endeavor]] that allows our Thera Scanners to coordinate their efforts in documenting Thera's wormhole connections.  
* Please [[Thera_Scanning_Tripwire_Setup|'''click here''']] to see how to setup Tripwire for Thera Scanning.

=== Tripwire Bookmarklet ===
* A bookmark normally takes you to a new web page. A bookmarklet is a bookmark that runs javascript on the current page instead of taking you to a new page. 
* The Tripwire Bookmarklet greatly alleviates a lot of the copying and pasting required between the Thera Scan Tool and Tripwire.
* [https://gist.github.com/caseywatts/c0cec1f89ccdb8b469b1 Create a new bookmarklet] with the code below:  

  javascript:(()=>{$("[name=signatureID_Alpha]").on("paste",a=>{let b=a.originalEvent.clipboardData.getData("text");setTimeout(()=>{let a=b.match(/^(\w{3})-(\d{3}),([\w\d]{4}),([\w\d- ].+),(\w{3})-(\d{3}),([\w\d]{4}),(\d+)$/);a&&($("[aria-describedby=dialog-signature] [name=signatureType]").val("wormhole").selectmenu("refresh").trigger("selectmenuchange"),$("[aria-describedby=dialog-signature] [name=signatureID_Alpha]").val(a[1]),$("[aria-describedby=dialog-signature] [name=signatureID_Numeric]").val(a[2]),"K162"!=a[3]&&$("[aria-describedby=dialog-signature] [name=wormholeType]").val(a[3]).change(),$("[aria-describedby=dialog-signature] [name=leadsTo]").val(a[4]),$("[aria-describedby=dialog-signature] [name=signatureID2_Alpha]").val(a[5]),$("[aria-describedby=dialog-signature] [name=signatureID2_Numeric]").val(a[6]),"K162"!=a[7]&&$("[aria-describedby=dialog-signature] [name=wormholeType2]").val(a[7]).change(),$("#dialog-signature #durationPicker").val(60*(60*(+a[8]+1))).change())},0)});})()

''NOTE #1:'' The javascript is from the Help & About section of the [https://www.therascan.info/ Thera Scan Tool website].</br>
''NOTE #2:'' Usage of The Tripwire Bookmarklet is '''not mandatory''', and it might cause problems with some browsers.

* To use the Tripwire Bookmarklet:
# Login to Tripwire to scan Thera
# With the Tripwire window active, select the Tripwire Bookmarklet from your browser's bookmarks.  
# You need to do this once for each Thera Scanning session.

=== Thera Scan Tool ===
* The [https://www.therascan.info/ Thera Scan Tool] is a web-based program that helps to simplify and speed up the process of scanning and recording Thera signatures, while reducing typing errors. The tool makes it quick to see what signatures are expired or new, then makes updating them easier and more consistent in Tripwire. 
* [https://evewho.com/character/2113781815 Mzsbi Haev] created this tool as a gift to Signal Cartel.

== Thera Scanning Instructions ==

=== Preparation ===
* Be in Thera, undocked, and preferably cloaked at a safe in the scanning ship of your choice
* Online the shared in-game '''Signal Cartel \\ Thera''' bookmark folder
** A link is located in the Alliance chat MOTD
* Open the [https://www.therascan.info/ Thera Scan Tool]
* Open [https://tripwire.eve-apps.com/ Tripwire] properly configured for Thera Scanning (see above)
* Select the Tripwire Bookmarklet (see above)

=== Assess the Status of the Current Thera Map Using the Thera Scan Tool ===
This is accomplished by importing the current lists of Thera signatures from Tripwire and your Probe Scanner window into the Thera Scan Tool.

==== Import Signatures Tab ====
* Copy the current list of Thera signatures from Tripwire and paste them into the "Import Signatures" tab of the Thera Scan Tool.  
** Make sure that the Tripwire browser window is active, then press Ctrl-A to select all the signatures followed by Ctrl-C to copy them (Macs use Cmd-A, Cmd-C)
** In the Thera Scan Tool, press Ctrl-V to paste the Tripwire signatures into the Thera Scan Tool
* Copy the current list of in-game Cosmic Signatures from the Probe Scanner window and paste them into the "Import Signatures" tab of the Thera Scan Tool
** While in-game and undocked in Thera, open the Probe Scanner window, then press Ctrl-A to select all the Cosmic Signatures followed by Ctrl-C to copy them
** In the Thera Scan Tool, press Ctrl-V to paste the in-game Cosmic Signatures into the Thera Scan Tool
[[File:Import Signatures Thera Scan Tool.png|1200px]]

==== Scan Signatures Tab ====
* The "Scan Signatures" tab in the Thera Scan Tool will populate a table that cross-references the Tripwire and Probe Scanner data
** Expired signatures are highlighted in orange
** New signatures are highlighted in blue
[[File:Scan Signatures Thera Scan Tool.png|1200px]]

=== Clear the Expired Signatures ===
While it may seem counterintuitive at first, clearing expired signatures (highlighted in orange) should be prioritized over mapping new signatures.  This is because capsuleers will plan their routes into or out of Thera based on potentially dated information and non-existent wormhole connections.  So clear those expired sigs!

==== Claim the Signature in the In-game Chat Channel ====
* Announce that you're working on an expired signature by clicking the '-SIG...' link in the leftmost column of the "Scan Signatures" table in the Thera Scan Tool
** This copies it to your clipboard, so you can paste it (Ctrl-V) into the <code>EvE-Scout.TheraMap</code> chat channel to alert others that you are working on that particular signature.
[[File:Expired Signature Thera Scan Tool 2.png|300px]]

==== Confirm the Signature is Expired In-game ====
* Open the in-game Probe Scanner window and confirm that the expired signature ID is not listed (in this case "FSY-658")
[[File:Probe Scanner Expired Signature.png|300px]]

==== Delete the Expired Signature from Tripwire ====
* Select the expired signature from the list of signatures in Tripwire by left-clicking on it
* Select the "Trash Can" icon by left-clicking and the expired signature will be deleted from Tripwire, which will push the change to the [https://www.eve-scout.com/ evescout.com] website
[[File:Tripwire Trashcan Icon.png|500px]]
 
==== Report the Signature Deletion in the In-game Chat Channel ====
* Announce that you've deleted the expired signature in Tripwire by clicking the 'SIG--' link at the rightmost column of the "Scan Signatures" table in the Thera Scan Tool
** This copies it to your clipboard, so you can paste it (Ctrl-V) into the <code>EvE-Scout.TheraMap</code> chat channel to alert others that you've deleted that particular signature.
[[File:Expired Signature Icon Thera Scan Tool.png|75px]]

=== Map the New Signatures ===
New signatures need to be scanned down, mapped, and then added to Tripwire. Using the Thera Scan Tool to help manage your workflow, you will work from left to right for each New Signature highlighted in blue on the "Scan Signatures" table

==== Claim the Signature in the In-game Chat Channel ====
* Announce that you're working on the new signature by clicking the '+SIG...' link in the leftmost column of the "Scan Signatures" table in the Thera Scan Tool
** This copies it to your clipboard, so you can paste it (Ctrl-V) into the <code>EvE-Scout.TheraMap</code> chat channel to alert other Thera Scanners that you are working on that particular signature.
[[File:Claim New Signature 2.png|300px]]

==== Scan Down the Cosmic Signature ====
* Scan down the signature and assuming it's a wormhole, you're in business! 
** If it's a data, relic or gas site, copy the signature from your Probe Scanner window and paste it into Tripwire (so the next person doesn't have to scan it down again), then announce in <code>EvE-Scout.TheraMap</code> chat channel that the sig has been added, and move on to the next signature.

''NOTE:''  Teaching proper scanning techniques is beyond the scope of this guide. To learn more about scanning down Cosmic Signatures please see the [https://wiki.eveuniversity.org/Probe_scanning Probe Scanning] wiki page from EVE Uni and our Explorer's Handbook [[Scanning]] page (note a WIP).

==== Map the Signature ====
You will use the Thera Scan Tool to expedite your workflow moving from left to right along the row.

===== Enter the Thera-side Wormhole Type =====
* Warp to the wormhole
** Once you are on grid with the wormhole, look for it's [https://wiki.eveuniversity.org/Wormhole_attributes type] on your in-game Overview.  If it's not 'K162' (the default exit type), enter it into the Type column of the Thera Scan Tool.
[[File:Wormhole T405 Thera Side 2.png|500px]]

[[File:Thera Scan Tool Thera Side Type 2.png|500px]]
** Also, right click on the wormhole and select the "Show Info" option to discover if the wormhole's lifetime is end-of-life or if its mass is destabilized or critical.  This will be important later in the process.
[[File:Wormhole Show Info.png|500px]]

===== Enter the Far System Name ===== 
* Jump through the wormhole (assuming it's safe)
* Enter the far system's name into the Thera Scan Tool
** Right-click on the Current Solar System name in the game client (upper left of the screen), select Copy, and paste that into the Far system "Name" column.
[[File:Far system name.png|300px]]

[[File:Thera Scan Tool Far System Name 2.png|700px]]

===== Enter the Far System Signature =====
* Enter the far system's Signature ID into the Thera Scan Tool
** If there are multiple Cosmic Signatures in the far system, you will have to scan down which one you came in through.
** Launch your probes, click the "Center current formation on your ship" icon at 1 AU and you should be able to resolve the wormhole ID that you just came through.
[[File:Center current formation on your ship.png|400px]]
** Highlight the signature in the Probe Scanner window, copy it (Ctrl-C), and then paste it (Ctrl-V) into the first Far system "Signature" field in the Thera Scan Tool.
[[File:Far system signature.png|500px]]

[[File:Far system signature Thera Scan Tool 2.png|900px]]

===== Enter the Far System Wormhole Type =====
* Enter the far system's wormhole type.
** If the Thera-side type of this wormhole was a 'K162' exit, look at your Overview to find its Far System Type.
** If the Thera-side wormhole type was something else, this field will automatically populate with the K162 type.
[[File:Wormhole J Side.png|500px]]

[[File:Thera Scan Tool Far System Wormhole Type.png|900px]]
* You've just mapped your first signature!  Now, let's create some bookmarks to help share it with all of New Eden.

==== Create the Far System "In Bookmark" ====
Once all the fields in the Thera Scan Tool are filled in for the New Signature, "In bookmark" and "Out bookmark" labels will be generated by the tool.
[[File:Thera Scan Tool Completed.png|1225px]]
* Click the "In bookmark" label to copy it to your clipboard
[[File:Far system in bookmark.png|200px]]
* Right-click on the wormhole from your in-game Overview to save its exact location ('''this is important!''')
** Select 'Save Location...';
[[File:Save Wormhole from Overview.png|350px]]
* A "New Location" window for your in-game bookmark will pop up 
** Paste the "In Bookmark" into the Label field (Ctrl-V)
** Make sure the folder is set to: '''Signal Cartel \\ Thera'''
** Set the Expire time to "2 days"
** Click the "Submit" button
[[File:J space saved bookmark 2.png|300px]]

==== Create the Thera-side "Out Bookmark" ==== 
* Jump back through the wormhole to Thera
* In the Thera Scan Tool, click the "Out bookmark" label to copy it to your clipboard
[[File:Far system out bookmark.png|175px]]
* Repeat the exact same steps as above to bookmark the Thera-side of the wormhole
** Remember to right-click on the wormhole from your in-game Overview to save its exact location ('''this is important!''')
* It should look like this:
[[File:Thera side bookmark 2.png|300px]]

==== Copy the Completed Signature Info into Tripwire ====
'''IMPORTANT:'''  Never add signatures on Tripwire while in the Far System (physically or on the Tripwire page). Always add signatures while your character is physically in Thera and on the Thera Tripwire page because otherwise [https://www.eve-scout.com/ evescout.com] will show erroneous data.

* Assuming you've set up the bookmarklet (see above) for Tripwire, click on the "export" icon in the Thera Scan Tool for your New Signature
[[File:Export Icon.png|75px]]
* Go to Tripwire, click the + button (located in the upper left of the center pane) to add a new signature which will trigger a pop-up box
[[File:Tripwire Plus Icon.png|500px]]
* Paste (Ctrl-V) into the first field and all the fields should fill in like magic!
[[File:Tripwire Add New Signature Blank.png|350px]]
'''➡️'''
[[File:Tripwire New Signature.png|350px]]
* If the wormhole's life or mass was not stable, update those accordingly using the drop-down menus
* Click the "Add" button which will add the signature to Tripwire and push the change to the [https://www.eve-scout.com/ evescout.com] website

''NOTE:''  Double-check and make sure the length is set to 17 hours. If it is not, click on "hours" and then use your keyboard up and down arrows to adjust.

==== Report the Signature is Finished in the In-game Chat Channel ====
* Announce that you've added the new signature to Tripwire by clicking the 'SIG++' link at the rightmost column of the "Scan Signatures" table in the Thera Scan Tool
** This copies it to your clipboard, so you can paste it (Ctrl-V) into the <code>EvE-Scout.TheraMap</code> chat channel to alert others that you've completed that particular signature.
[[File:Signature Complete Icon 2.png|75px]]

=== Double-Check Yourself and Then Admire Your Work ===
* After submitting your signatures, always double-check yourself:
** Check your bookmarks using the Thera Scan Tool
** Check [https://www.eve-scout.com/ evescout.com] to make sure your sigs were properly pushed to the website
* If everything is ok, please take a moment to bask in the glow of a job well done.  Congrats!  Now get on with the next sig because Thera is an ever-changing and mysterious place that you are now a part of!

=== Feedback ===
Comments and suggestions are always welcome. Please post them here:
* <code>[https://discord.com/channels/152437634927427584/757523687137083403 #thera-scanning]</code> Discord channel