CosmoSimClass¶

class astroquery.cosmosim.CosmoSimClass[source]¶

Bases: 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. - EXECUTING,COMPLETED,PENDING,ERROR).
`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/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:

phaselist: A list of phase(s) of jobs to be checked on. If nothing provided, all are checked.
regexstring: 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.
sortbystring: 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:

checkalljobsResponse 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:

jobidstring: 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:

resultcontent 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:

jobidstring: The jobid of the sql query.
outputbool: 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:

phaselist: A list of job phases to be deleted. If nothing provided, all are deleted.
regexstring: 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:

jobidstring: 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).
outputbool: Print output of response(s) to the terminal

Returns:

resultlist: 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
filenamestr: If left blank, downloaded to the terminal. If specified, data is written out to file (directory can be included here).
formatstr: The format of the data to be downloaded. Options are 'csv', 'votable', 'votableB1', and 'votableB2'.
cachebool: Whether to cache the data. By default, this is set to True.

Returns:

headers, datalist, 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:

dbstring: The database to explore.
tablestring: The table to explore.
colstring: 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:

jobidstring: The jobid of the sql query.
outputbool: 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:

usernamestr, optional: Username to the CosmoSim database. If not given, it should be specified in the config file.
store_passwordbool, optional: Stores the password securely in your keyring. Default is False.
reenter_passwordbool, 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:

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

Returns:

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_stringstring: The sql query to be sent to the CosmoSim.org server.
tablenamestring: 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.
queuestring: The short/long queue option. Default is short.
mailstring: The user’s email address for receiving job completion alerts.
textstring: The user’s cell phone number for receiving job completion alerts.
cachebool: Whether to cache the query locally

Returns:

resultjobid: The jobid of the query

Navigation

CosmoSimClass¶