The table below lists the supported and unsupported commands in PersephoneShell. For commands with simple syntax refer to the Syntax column. For commands with more complex syntax you can also click the command's name in the Command column for more information.

Supported and Unsupported Commands in PersephoneShell

Command

Description

Syntax

Comments

Add

Add object(s) to the Persephone database.

add <target> -c controlFile [-t] [-v] [-d] [-f]

A target is required. Valid targets: organism, sequence(s), map(s), annotation(s), marker(s), alignment(s),  synteny, mapsettreenode, expression, variant(s), quantitative, tracktreenode, qtl(s), ortholog(s) or ontology.

Analyze

A helper command that analyzes the data without affecting the database

analyze <db|fasta>


Backup

Backup the entire data set

backup [-t]

Create a backup copy of the database and the files in the file system which are a part of the entire Persephone data set.

Cleanup

Remove temporary files in various directories

cleanup <target> [-t] [-f]

Targets: vcf_temp_folder,  sequence_storage,  blast_folder,  temp_blast_folder

Clear

Clear screen.

clear

 

Color

Change the interface colors

color

Adjust the colors for text elements, such as WarningColor, PromptColor, etc.

Delete

Delete object(s) from the database.

delete <target> <id|path> [-v | -d | (-t | -f)]

A target is required. Valid targets: mapsettreenode, tracktreenode, organism, mapset, run, map, storage, alignment_run

Edit

Edit selected object

edit <target> <id|path> [-v|-d| (-t | -f)]

A target is required. Valid targets: mapsettreenode, tracktreenode.

Export

Export DNA or protein sequences for building BLAST libraries

export <dna|protein> <all|id|path>


Help

Display a list of commands.

help [command [target]]

Typing 'help' with the name of a command will give description of the corresponding command. Add the command's target to get more details, e.g.:

help add sequence

History

Display a list of commands that has been entered.

history

 

Init

Initializes the Persephone database schema.

init [-v | -d]

See Initializing the Schema for more information.

Install

Install various packages, such as NCBI BLAST, DIAMOND, etc.

install <blast|diamond|swissprot>


List

Lists one or more objects in the Persephone database.

list <target> [-p pattern] [-l] [-i N] [-r] [-t N]

A target is required. Valid targets: organisms, mapsets, chromosomes, maps, sequences, tracktree, tracks, studies, qtls, mapsettree, annot_methods, mapping_methods, alignment_runs, runs, marker_types, track_types, map_types, ontology, xref_db.

Printmapping

Print two columns with values for each map to be used in map matching

printmapping <id|path> <column1> <column2>

Helps building the section [MapMatching]

Quit (Exit)

Exit PersephoneShell.

quit
or
exit

 

Restore

Restore the system from a backup copy.

restore [-t]

A copy of the data saved by the command backup can be restored by this command. You can use the restore to move the data between different back ends.

Searchindex

Synchronize or rebuild the search index

searchindex <verb> [id|path]

Verbs: sync, rebuild, set_auto, set_manual

Update

Updates the data stored in the old format, taking advantage of the new format

update <target> [<id|path>] [-d] [-t]

Targets: 

quantitative. The old data for quantitative tracks will be processed to enable using the new format (populating an extra column in the database).

gc_content. Rebuild GC histograms and store them in the new, more compact format.

 

Tip

For most commands if you enter it without any parameters it will display the correct syntax.

Auto Completing Commands and Command Parameters

You can auto complete commands by entering one or more characters and then pressing the Tab key. In addition, you can auto complete targets, file paths, map set paths, and track paths just by pressing the Tab key and scrolling through all the possible choices. See Auto Completing Commands and Command Parameters for more information.

Optional Command Parameters

Several PersephoneShell commands support optional parameters to help you view, test, and debug commands. These parameters are described below. Please refer to the specific command section (e.g., Add) to see which parameters (if any) are supported.

Debug Parameter (-d and --debugMode)

PersephoneShell displays any error and relevant options in a user-friendly format. However, using either the –d or --debugMode parameter will show application messages the developers at Persephone Software, LLC. can use to quickly diagnose problems. Please send debug reports to us http://persephonesoft.com/contact so we can help you analyze the issue.

The following is an example of using the debug parameter with the add command.

PS> add synteny -c add_hg19_mm10_gff.ini -d

Verbose Parameter (-v or --verboseMode)

You can use either the -v or --verboseMode parameter on some commands to display detailed messages in real time as the command executes. If a command executes successfully but in a way you did not expect, for example, you can use the verbose parameter to see how and why it performed as it did.

The following is an example of using the verbose parameter with the add command.

PS> add synteny -c add_hg19_mm10_gff.ini -v

 

Note

Sometimes, if you use the verbose parameter you cannot use the test parameter (described below).

Test Parameter (-t)

You can use the test parameter (-t) to put a command in the test mode, where a set of checklist items is validated, and the results are printed as "passed" or "failed". Any failed item will produce an exception in normal mode. This can help you narrow down any issues you may be having with a command.

The following is an example of using the test parameter with the add command.

PS> add synteny -c add_hg19_mm10_gff.ini -t

 

Note

It is very common (and recommended) to run a command in the test mode first and then, if the test succeeds, run it with the verbose parameter.