CS Genome Logo
API docs by Redocly

CSGenome API (rolling-release)

Download OpenAPI specification:Download

GS Genome: csgenomevtteam@gmail.com URL: https://csgenome.org/ License: All Rights Reserved

This is the API for the CSGenome project at Virginia Tech

Processors

Processors

Visit the processor glossary for more information relevant terms https://csgenome.org/glossary#Processor

query Parameters
filter
string
Example: filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an AND filter

or_filter
string
Example: or_filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an OR filter

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

clock_speed
string
Examples:
  • clock_speed=3000,3500 - Separated By Comma
  • clock_speed=3500, - One Entry Blank

Clock speed is measured in megahertz. Clock speed range to filter by a range can be defined by separating two numbers with a comma. One of the entries can also be left blank

company
string
Example: company=Intel,AMD,ARM

Manufacturers to filter by in a comma separated list

page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Processor By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "relationships": {
    }
}

Benchmarks

Top 500 Benchmarks

query Parameters
page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

processors
boolean
Example: processors=true

Display processor data (default- False)

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Top 500 Benchmark By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Top 500 Ranks

query Parameters
by_date
boolean
Example: by_date=true

Show the publication dates which hold their ranks and systems

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Green 500 Benchmarks

query Parameters
page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Green 500 Benchmark By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Spec 1995 Benchmarks

query Parameters
page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

ontology
boolean
Example: ontology=true

Show ontology information for each benchmark

rate_speed
boolean
Example: rate_speed=true

Show rate speed information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Spec 2000 Benchmarks

query Parameters
page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

ontology
boolean
Example: ontology=true

Show ontology information for each benchmark

rate_speed
boolean
Example: rate_speed=true

Show rate speed information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Spec 2006 Benchmarks

query Parameters
page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

ontology
boolean
Example: ontology=true

Show ontology information for each benchmark

rate_speed
boolean
Example: rate_speed=true

Show rate speed information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Spec 2017 Benchmarks

query Parameters
page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

ontology
boolean
Example: ontology=true

Show ontology information for each benchmark

rate_speed
boolean
Example: rate_speed=true

Show rate speed information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Spec 1995 Benchmark By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Spec 2000 Benchmark By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Spec 2006 Benchmark By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Spec 2017 Benchmark By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Inserts a Spec2017 Benchmark entry into the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Updates a Spec2017 Benchmark entry in the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Deletes a Spec2017 Benchmark entry from the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

show_processors
boolean
Example: show_processors=true

Show processor information for each benchmark

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Systems

Systems

Visit the system glossary for more information relevant terms https://csgenome.org/glossary#System

query Parameters
page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

filter
string
Example: filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an AND filter

or_filter
string
Example: or_filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an OR filter

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Systems By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Inserts an Systems entry into the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Updates an Systems entry in the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Deletes an Systems entry from the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Genera

Hierarchy

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Genera

Visit the genera glossary for more information relevant terms https://csgenome.org/glossary#Microarchitecture

query Parameters
filter
string
Example: filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an AND filter

page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Genera By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

ISAs

ISAs

query Parameters
filter
string
Example: filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an AND filter

page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

ISAs By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

OntologyType

OntologyType

Visit the system glossary for more information relevant terms https://csgenome.org/glossary#Standard%20Name

query Parameters
filter
string
Example: filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an AND filter

or_filter
string
Example: or_filter=model:BlueGene,site:DOE

Comma separated list of key value pairs to filter on. Works as an OR filter

columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

page
integer <int32>
Example: page=1

Page of collection

limit
integer <int32>
Example: limit=100

Number of items to return (Default 50)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

OntologyType By ID

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Inserts an OntologyType entry into the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Updates an OntologyType entry in the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Deletes an OntologyType entry from the database

path Parameters
id
required
integer <int32>
Example: 1

Resource UID

query Parameters
columns
string
Example: columns=frequency,vdd_low,genera

Subset of columns to return as a comma-separated list

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}