CosmoSimClass

class astroquery.cosmosim.CosmoSimClass[source]

Bases: astroquery.query.QueryWithLogin

Attributes Summary

QUERY_URL
SCHEMA_URL
TIMEOUT
USERNAME

Methods Summary

abort_job([jobid])
check_all_jobs([phase, regex, sortby]) Public function which builds a dictionary whose keys are each jobid for a given set of user credentials and whose values are the phase status (e.g.
check_job_status([jobid]) A public function which sends an http GET request for a given jobid, and checks the server status.
check_login_status() Public function which checks the status of a user login attempt.
completed_job_info([jobid, output]) A public function which sends an http GET request for a given jobid with phase COMPLETED.
delete_all_jobs([phase, regex]) A public function which deletes any/all jobs from the server in any phase and/or with its tablename matching any desired regular expression.
delete_job([jobid, squash]) A public function which deletes a stored job from the server in any phase.
download([jobid, filename, format, cache]) A public function to download data from a job with COMPLETED phase.
explore_db([db, table, col]) A public function which allows for the exploration of any simulation and its tables within the database.
general_job_info([jobid, output]) A public function which sends an http GET request for a given jobid in any phase.
login([username, password, store_password, …]) Login to the CosmoSim database.
logout([deletepw]) Public function which allows the user to logout of their cosmosim credentials.
run_sql_query(query_string[, tablename, …]) Public function which sends a POST request containing the sql query string.

Attributes Documentation

QUERY_URL = 'https://www.cosmosim.org/uws/query'
SCHEMA_URL = 'https://www.cosmosim.org/query/account/databases/json'
TIMEOUT = 60.0
USERNAME = ''

Methods Documentation

abort_job(jobid=None)[source]
check_all_jobs(phase=None, regex=None, sortby=None)[source]

Public function which builds a dictionary whose keys are each jobid for a given set of user credentials and whose values are the phase status (e.g. - EXECUTING,COMPLETED,PENDING,ERROR).

Parameters:
phase : list

A list of phase(s) of jobs to be checked on. If nothing provided, all are checked.

regex : string

A regular expression to match all tablenames to. Matching table names will be included. Note - Only tables/starttimes are associated with jobs which have phase COMPLETED.

sortby : string

An option to sort jobs (after phase and regex criteria have been taken into account) by either the execution start time (starttime), or by the table name ('tablename').

Returns:
checkalljobs : Response object

The requests response for the GET request for finding all existing jobs.

check_job_status(jobid=None)[source]

A public function which sends an http GET request for a given jobid, and checks the server status. If no jobid is provided, it uses the most recent query (if one exists).

Parameters:
jobid : string

The jobid of the sql query. If no jobid is given, it attempts to use the most recent job (if it exists in this session).

Returns:
result : content of Response object

The requests response phase

check_login_status()[source]

Public function which checks the status of a user login attempt.

completed_job_info(jobid=None, output=False)[source]

A public function which sends an http GET request for a given jobid with phase COMPLETED. If output is True, the function prints a dictionary to the screen, while always generating a global dictionary response_dict_current. If no jobid is provided, a visual of all responses with phase COMPLETED is generated.

Parameters:
jobid : string

The jobid of the sql query.

output : bool

Print output of response(s) to the terminal

delete_all_jobs(phase=None, regex=None)[source]

A public function which deletes any/all jobs from the server in any phase and/or with its tablename matching any desired regular expression.

Parameters:
phase : list

A list of job phases to be deleted. If nothing provided, all are deleted.

regex : string

A regular expression to match all tablenames to. Matching table names will be deleted.

delete_job(jobid=None, squash=None)[source]

A public function which deletes a stored job from the server in any phase. If no jobid is given, it attempts to use the most recent job (if it exists in this session). If jobid is specified, then it deletes the corresponding job, and if it happens to match the existing current job, that variable gets deleted.

Parameters:
jobid : string

The jobid of the sql query. If no jobid is given, it attempts to use the most recent job (if it exists in this session).

output : bool

Print output of response(s) to the terminal

Returns:
result : list

A list of response object(s)

download(jobid=None, filename=None, format=None, cache=True)[source]

A public function to download data from a job with COMPLETED phase.

Parameters:
jobid :

Completed jobid to be downloaded

filename : str

If left blank, downloaded to the terminal. If specified, data is written out to file (directory can be included here).

format : str

The format of the data to be downloaded. Options are 'csv', 'votable', 'votableB1', and 'votableB2'.

cache : bool

Whether to cache the data. By default, this is set to True.

Returns:
headers, data : list, list
explore_db(db=None, table=None, col=None)[source]

A public function which allows for the exploration of any simulation and its tables within the database. This function is meant to aid the user in constructing sql queries.

Parameters:
db : string

The database to explore.

table : string

The table to explore.

col : string

The column to explore.

general_job_info(jobid=None, output=False)[source]

A public function which sends an http GET request for a given jobid in any phase. If no jobid is provided, a summary of all jobs is generated.

Parameters:
jobid : string

The jobid of the sql query.

output : bool

Print output of response(s) to the terminal

login(username=None, password=None, store_password=False, reenter_password=False)

Login to the CosmoSim database.

Parameters:
username : str, optional

Username to the CosmoSim database. If not given, it should be specified in the config file.

store_password : bool, optional

Stores the password securely in your keyring. Default is False.

reenter_password : bool, optional

Asks for the password even if it is already stored in the keyring. This is the way to overwrite an already stored passwork on the keyring. Default is False.

logout(deletepw=False)[source]

Public function which allows the user to logout of their cosmosim credentials.

Parameters:
deletepw : bool

A hard logout - delete the password to the associated username from the keychain. The default is True.

run_sql_query(query_string, tablename=None, queue=None, mail=None, text=None, cache=True)[source]

Public function which sends a POST request containing the sql query string.

Parameters:
query_string : string

The sql query to be sent to the CosmoSim.org server.

tablename : string

The name of the table for which the query data will be stored under. If left blank or if it already exists, one will be generated automatically.

queue : string

The short/long queue option. Default is short.

mail : string

The user’s email address for receiving job completion alerts.

text : string

The user’s cell phone number for receiving job completion alerts.

cache : bool

Whether to cache the query locally

Returns:
result : jobid

The jobid of the query