pyTOPSScrape

A tool for scraping OPLIB opacities from the TOPS web form and converting them into a format more similar to that used by OPAL

Official Documentation

The TOPS webform provides access to some of the most up to date high temperature radiative opacities. However, entering compositions manually into a webpage can be a chore. Especially when one needs opacities for a variety of rescaled compositions as is often the case when working stellar evolution programs.

pyTOPSScrape aims to address this by providing a simple interface to query the TOPS webform for n tables rescaled from a base composition. Moreover, pyTOPSScrape can transform the parameterization of opacities from mass density and temperature to R and temperature. Additionally, pyTOPSScrape will automatically merge tables from rescaled compositions into a single table mimicking the form of high temperature opacity tables already used by the Dartmouth Stellar Evolution Program (DSEP).

The primary interface for pyTOPSScrape is a bash script included with the package an example use of which follows

generateTOPStables GS98.abun rescalings.dat -d ./rawOutput -o GS98.opac -j 20

Further examples and the data files needed to run them may be found in the examples directory of this repository.

In addition to this bash script pyTOPSScrape provides a programmatic interface made up of primarily the pyTOPSScrape.api.call and pyTOPSScrape.api.TOPS_2_OPAL functions. These can be called individually if you wish to implement your own custom converter function (In that case you would use call and then some custom function in place of TOPS_2_OPAL)

Install

Prerequisites

• python >= 3.8
• mechanize >= 0.4.5
• scipy >= 1.5.2
• tqdm >= 4.50.2
• beautifulsoup4 >= 4.8.2
• importlib_resources >= 5.2.0

pip

pyTOPSScrape is not yet available on pip but will be soon.

Source

git clone git@github.com:tboudreaux/pytopsscrape.git
cd pytopsscrape
python setup.py install