Solution Finder: Cover
Solution Finder’s Cover command outputs the probability of setting up/building a specified field (or multiple), given a specified pattern. This output is written in both the terminal and the specified log path.
|
|
|
|
|
|
Input Parameters
Specified Field(s) (--tetfu
, -t
): the fumen code(s) that sfinder begins working with. If not specified, the file field.txt
in the input
folder is used. Input multiple fumens for fields by separating the fumens with spaces.
- Mirror (
--mirror
,-m
): Whether or not to include the mirrors for all inputted fumens. The outputs will mark mirroredfumen
inputs asfumen#mirror
.- The default is
false
. --mirror true
- The default is
Patterns (--patterns
, -p
): Determines the queues checked by sfinder. Read more about this parameter here.
- Hold (
--hold
,-H
): Specify whether or not a hold slot is usable.- By default, it is
use
. -H use
or-H avoid
- By default, it is
- Drop (
--drop
,-d
): Specify what movements are usable.- By default, it uses
softdrop
.
- By default, it uses
Option | Harddrop | Softdrop | 90 spins | 180 spins | Must also do: |
harddrop | ✓ | ✗ | ✗ | ✗ | - |
softdrop | ✓ | ✓ | ✓ | ✗ | |
180 | ✓ | ✓ | ✓ | ✓ | |
t-softdrop | ✓ | T only | T only | ✗ | - |
tsz | Any T-spin | ||||
tsm | tss/tsd/tst (and/or minis) | ||||
tss | tss/tsd/tst | ||||
tsd | tsd/tst | ||||
tst | tst only |
- Last Softdrop (
--last-sd
,-l
): Allows the last nth pieces to use softdrop regardless of the value of--drop
.
Mode (--mode
, --M
): specifying the condition by which cover will return as successful or failed.
WIP
This section can be improved by showcasing the possible modes.
- Max Clear Line (
--clear-line
,-c
): Specify the number of line clears cover may use.- By default, it is
-1
, meaning there is no limit. --max-clearline 1
for a 4-line high perfect clear field may allow you to get that field’s quad clear chance.
- By default, it is
- Max Softdrop (
--max-softdrop
,-ms
): Specify how many times pieces can be softdropped in order to build a setup.- This setting is only enabled in conjunction with
--mode
- By default, it uses
-1
, no limit placed on softdrops. --max-softdrop 2
- This setting is only enabled in conjunction with
Starting B2B (--starting-b2b
, -sb
): specifying the number of B2B clears is required for a successful output.
- By default, it uses
0
, meaning no B2B is required. --starting-b2b 2
Kick table (--kicks
, -K
):
WIP
This section isn’t filled out yet.
Output Parameters
Priority (--priority
, -P
): Only one setup can be marked as O
for all the fumens provided. This will be the first setup that is buildable in the order of the fumens given in --tetfu
.
- By default, priority is
True
. --priority True
Failed Count (--failed-count
, -fc
): determines the number of failed queues displayed at the end of the output.
- By default, failed count is
100
. --failed-count -1
displays as many failed queues as possible.
Miscellaneous Parameters
Output Base (--output-base
, -o
): Specify the path data file output.
- By default, the path data is written into
output/path.csv
,path_minimal.html
, orpath_unique.html
(depending on your path command). --output-base output/tubpath.csv
Log path (--log-path
, -lp
): create a .txt file output from the output of the command.
- By default, the log path is
output/last_output.txt
. --log-path output/chances.txt
Specified Field from a file (--field-path
, -fp
): instead of defining the fumen code using --tetfu
, you can specify a .txt file that contains a fumen code instead.
- By default, the field path is
input/field.txt
. --field-path input/sdpc.txt
Patterns from a file (--patterns-path
, -pp
): instead of defining patterns using --patterns
, you can specify a .txt file that contains either the actual queues, or patterns.
- By default, the patterns path is
input/patterns.txt
. --patterns-path input/filteredqueue.txt
Summary
Input Parameters | ||
---|---|---|
Parameter | Shorthand | Default |
--tetfu | -t | null |
--patterns | -p | null |
--hold | -H | true |
--drop | -d | softdrop |
--max-clearline | -mc | -1 |
--max-softdrop | -ms | -1 |
--last-sd | -l | 0 |
--mirror | -m | false |
--kicks | -K | srs |
Output Parameters | ||
---|---|---|
Parameter | Shorthand | Default |
--priority | -P | false |
--mode | -M | normal |
--output-base | -o | output/cover.csv |
Miscellaneous Parameters | ||
---|---|---|
Parameter | Shorthand | Default |
--starting-b2b | -sb | 0 |
--log-path | -lp | output/last_output.txt |
--field-path | -fp | input/field.txt |
--patterns-path | -pp | input/patterns.txt |
Example Commands and Output
An example terminal output of the cover command.
|
|
Each item under success
represents one fumen entered under the --tetfu
parameter, in order. It contains the following:
33.33 %
: The percentage cover of the fumen.[1680/5040]
: The number of successful over total patterns of the fumen.http://fumen.zui.jp/?v115@vhFRQJUGJKJJvMJTNJGBJ
: A link to the fumen.
Furthermore, it tallies up the results as:
OR
: the amount of queues that can build at least one of the fumens.AND
: the amount of queues that can build all of the fumens.
An example CSV output of the cover command.
sequence | v115@vhFRQJU... | v115@vhFRQJP... |
---|---|---|
TILJSZO | X | O |
TILJSOZ | X | O |
TILJZSO | X | O |
TILJZOS | X | O |
5036 more lines... |
The CSV output lists the first column for the patterns used, and extra columns are allocated for every fumen in order.
X
: the fumen is not buildable for the equivalent pattern.O
: the fumen is buildable for the equivalent pattern.
Special Uses
- Cover’s output can be converted into an sfinder path output to be used to find custom minimals, such as Quad PC minimals or T-Spin minimals.