CSGenome API (1.0)

Download OpenAPI specification:Download

This is the API for the CSGenome project at Virginia Tech

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

200
default

Content type

application/json

{"data": [{"uid": 0,
"codename": "string",
"technology_id": 0,
"on_cache": { },
"off_cache": { },
"processor_genus": "string",
"manufacturer": "string",
"model": "string",
"date": "string",
"clock_speed": 0,
"max_clock_speed": 0,
"number_cores": 0,
"threads_per_core": 0,
"tdp": 0,
"bus_width": 0,
"transistors": 0,
"die_size": 0,
"vdd_low": 0,
"vdd_high": 0,
"note": "string"
}
],
"links": {"next": "string",
"prev": "string",
"first": "string",
"last": "string"
}
}

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

200
default

Content type

application/json

{"data": {"uid": 0,
"codename": "string",
"technology_id": 0,
"on_cache": { },
"off_cache": { },
"processor_genus": "string",
"manufacturer": "string",
"model": "string",
"date": "string",
"clock_speed": 0,
"max_clock_speed": 0,
"number_cores": 0,
"threads_per_core": 0,
"tdp": 0,
"bus_width": 0,
"transistors": 0,
"die_size": 0,
"vdd_low": 0,
"vdd_high": 0,
"note": "string"
},
"relationships": {"siblings": [{"uid": 0,
"genus": "string",
"model": "string",
"codename": "string",
"manufacturer": "string"
}
],
"parents": [{"uid": 0,
"genus": "string",
"model": "string",
"codename": "string",
"manufacturer": "string"
}
],
"children": [{"uid": 0,
"genus": "string",
"model": "string",
"codename": "string",
"manufacturer": "string"
}
]
}
}

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

200
default

Content type

application/json

{"data": [{"uid": 0,
"information_source": "string",
"benchmark_type": "string",
"top_500_rank": 0,
"top_500_first_appearance": 0,
"top_500_first_rank": 0,
"top_500_previous_rank": 0,
"install_year": "string",
"publication_date": "string",
"n_max": 0,
"n_half": 0,
"r_max": 0,
"r_peak": 0,
"hpcg": 0,
"power": 0,
"power_measured_size": 0,
"power_source": "string",
"mflops_per_watt": 0,
"note": "string",
"system": {"system_family": "string",
"system_manufacturer": "string",
"architecture": "string",
"application": "string",
"country": "string",
"region": "string",
"continent": "string",
"segment": "string",
"uid": 0,
"moniker": "string",
"system_model": "string",
"computer": "string",
"site": "string",
"system_address": "string",
"latitude": 0,
"longitude": 0
}
}
],
"links": {"next": "string",
"prev": "string",
"first": "string",
"last": "string"
}
}

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

200
default

Content type

application/json

{"data": {"uid": 0,
"information_source": "string",
"benchmark_type": "string",
"top_500_rank": 0,
"top_500_first_appearance": 0,
"top_500_first_rank": 0,
"top_500_previous_rank": 0,
"install_year": "string",
"publication_date": "string",
"n_max": 0,
"n_half": 0,
"r_max": 0,
"r_peak": 0,
"hpcg": 0,
"power": 0,
"power_measured_size": 0,
"power_source": "string",
"mflops_per_watt": 0,
"note": "string",
"system": {"system_family": "string",
"system_manufacturer": "string",
"architecture": "string",
"application": "string",
"country": "string",
"region": "string",
"continent": "string",
"segment": "string",
"uid": 0,
"moniker": "string",
"system_model": "string",
"computer": "string",
"site": "string",
"system_address": "string",
"latitude": 0,
"longitude": 0
}
}
}

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

200
default

Content type

application/json

{"data": [{"uid": 0,
"architecture": "string",
"computer": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"manufacturer": "string",
"moniker": "string",
"n_max": 0,
"n_half": 0,
"r_max": 0,
"r_peak": 0,
"site": "string",
"ranks": {"2012/06/01": [0
],
"2016/06/01": [0
],
"2014/06/01": [0
],
"2015/06/01": [0
],
"2019/06/01": [0
],
"2014/11/01": [0
],
"2018/11/01": [0
],
"2012/11/01": [0
],
"2019/11/01": [0
],
"2013/06/01": [0
],
"2017/11/01": [0
],
"2015/11/01": [0
],
"2018/06/01": [0
],
"2017/06/01": [0
],
"2013/11/01": [0
],
"2016/11/01": [0
]
}
}
]
}

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

200
default

Content type

application/json

{"data": [{"benchmark_type": "string",
"efficency": "string",
"green_500_previous_rank": 0,
"green_500_rank": 0,
"information_source": "string",
"install_year": "string",
"measured_cores": 0,
"mflops_per_watt": 0,
"n_max": 0,
"note": "string",
"power": 0,
"power_efficency": 0,
"power_quality_level": 0,
"power_source": "string",
"publication_date": "string",
"r_max": 0,
"r_peak": 0,
"submission_type": "string",
"system": {"system_family": "string",
"system_manufacturer": "string",
"architecture": "string",
"application": "string",
"country": "string",
"region": "string",
"continent": "string",
"segment": "string",
"uid": 0,
"moniker": "string",
"system_model": "string",
"computer": "string",
"site": "string",
"system_address": "string",
"latitude": 0,
"longitude": 0
},
"top500_rank": 0,
"top500_cores": 0,
"uid": 0
}
],
"links": {"next": "string",
"prev": "string",
"first": "string",
"last": "string"
}
}

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

200
default

Content type

application/json

{"data": {"benchmark_type": "string",
"efficency": "string",
"green_500_previous_rank": 0,
"green_500_rank": 0,
"information_source": "string",
"install_year": "string",
"measured_cores": 0,
"mflops_per_watt": 0,
"n_max": 0,
"note": "string",
"power": 0,
"power_efficency": 0,
"power_quality_level": 0,
"power_source": "string",
"publication_date": "string",
"r_max": 0,
"r_peak": 0,
"submission_type": "string",
"system": {"system_family": "string",
"system_manufacturer": "string",
"architecture": "string",
"application": "string",
"country": "string",
"region": "string",
"continent": "string",
"segment": "string",
"uid": 0,
"moniker": "string",
"system_model": "string",
"computer": "string",
"site": "string",
"system_address": "string",
"latitude": 0,
"longitude": 0
},
"top500_rank": 0,
"top500_cores": 0,
"uid": 0
}
}

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

200
default

Content type

application/json

{"data": [{"microbenchmarks": {"base_applu_110": 0,
"base_apsi_141": 0,
"base_compress_129": 0,
"base_fpppp_145": 0,
"base_gcc_126": 0,
"base_go_099": 0,
"base_hydro2d_104": 0,
"base_ijpeg_132": 0,
"base_li_130": 0,
"base_m88ksim_124": 0,
"base_mgrid_107": 0,
"base_perl_134": 0,
"base_su2cor_103": 0,
"base_swim_102": 0,
"base_tomcatv_101": 0,
"base_turb3d_125": 0,
"base_vortex_147": 0,
"base_wave5_146": 0,
"peak_applu_110": 0,
"peak_apsi_141": 0,
"peak_compress_129": 0,
"peak_fpppp_145": 0,
"peak_gcc_126": 0,
"peak_go_099": 0,
"peak_hydro2d_104": 0,
"peak_ijpeg_132": 0,
"peak_li_130": 0,
"peak_m88ksim_124": 0,
"peak_mgrid_107": 0,
"peak_perl_134": 0,
"peak_su2cor_103": 0,
"peak_swim_102": 0,
"peak_tomcatv_101": 0,
"peak_turb3d_125": 0,
"peak_vortex_147": 0,
"peak_wave5_146": 0
},
"accepted_memory": "string",
"base_floating_point_rate": 0,
"base_floating_point_speed": 0,
"base_integer_rate": 0,
"base_integer_speed": 0,
"benchmark_type": "string",
"compiler": "string",
"date": "string",
"disk_subsystem": "string",
"file_system": 0,
"fpu": 0,
"information_source": "string",
"kernel": "string",
"kernel_extensions": "string",
"l1_cache_unspecified": "string",
"l2_cache_unspecified": "string",
"l3_cache_unspecified": "string",
"note": "string",
"other_cache": "string",
"other_hardware": "string",
"other_software": 0,