-
+<& docshead &>
Looking up data in YARRG
YARRG (Yet Another Revenue Research Gatherer) is a third-party tool
@@ -66,6 +51,11 @@ Hopefully you will be able to work it without too much help, but this
documentation page contains information about the database website
which you may not be able to divine from the online user interface.
+
+
+If this page is all too complicated for you, you may prefer to read
+the introduction instead.
+
Bookmarkable URLs
Mostly, you can bookmark the specific pages and queries. Select the
@@ -75,8 +65,8 @@ URL.
-(An exception to this is if you select the `Update' option from the
-`Trades for route' lookup; the list of (de)selected stalls is too long
+(An exception to this is if you select the "Update" option from the
+"Trades for route" lookup; the list of (de)selected stalls is too long
to fit in a URL.)
Dynamic confirmation of meaning of text entry boxes
@@ -84,7 +74,7 @@ to fit in a URL.)
If you have Javascript enabled, the various text entry boxes will be
annotated with a brief explanation of the system's interpretation of
your current entry string. To get the actual results updated, you
-must still hit `Go' or `Update'.
+must still hit "Go" or "Update".
Trades for route
@@ -102,7 +92,7 @@ archipelago, you must enter the archipelago name twice.
After getting the results, you can untick various trades individually,
-and select `Update' to get a new plan. The unticked trades will be
+and select "Update" to get a new plan. The unticked trades will be
excluded from the voyage plan (if any) and also from the totals.
@@ -188,6 +178,20 @@ You can enter the value in the box either as a percentage, or as a
fraction 1/
divisor, eg 1/2000 is the same as 0.05%; in each
case it is taken as the loss for each league of the voyage.
+
+
+If you select
Also be cautious about stalls' poe reserves,
+YARRG will calculate a minimum amount of poe that each stall has on
+hand (by looking at all the offers that stall is making), and never
+plan for you to sell goods at that stall for more than the available
+poe.
+
+
+
+Goods planned to be bought at the stall (which might boost the stall's
+poe reserves) are not considered, to avoid having to calculate the
+stall's cash reserves at various different times.
+
If you don't specify the amount of capital you have available to
@@ -206,5 +210,55 @@ them for 20 PoE each, and then buy 2000 beans at B for 10 PoE each and
sail them to C to sell for 20 PoE each even if such a trade would in
fact be possible. In practice this is unlikely to be a problem!
+
+
+In the Voyage Trading Plan, YARRG indicates after the commodity name
+where in the YPP commodity UI each commodity can be found. First
+comes the initial letter of the category:
+% my $dbh= dbw_connect('Midnight');
+% my $getclasses= $dbh->prepare(
+% "SELECT commodclass FROM commodclasses ORDER BY commodclass");
+% $getclasses->execute();
+<%
+ join '; ', map { $_->[0] =~ m/^./ or die; "
$&$'" }
+ @{ $getclasses->fetchall_arrayref() }
+%>.
+
+
+Then, if applicable, follows a number from 0 to
+9 indicating roughly where the commodity is in the
+list of commodities of the same class. The number indicates which
+tenth of the list is: 0 for the first (top) tenth,
+1 for the 2nd, and so on, up to 9
+for the final tenth.
+
+
+For example,
+
+
+
+indicates that Fine pink cloth can be found under Cloth,
+between 20% and 30% of the way down through the types of Cloth.
+If you mouseover that in a suitably equipped browser you should see the
+text:
+
+Fine pink cloth is under Cloth, commodity 14 of 55
+
+
+
+The position indicator digit isn't shown for very small
+categories.
+
+The exact location of the commodity in the actual game
+client may vary because YARRG only considers the list of all possible
+commodities, not the list of actual offers at the island in question.
+
+Also, not all commodities are always completely categorised or
+ordered; we are working to add the additional data
+