The goal is to provide an easy way to extract in python custom data set in the annote field of a bib file.
BibdataManagement library is stored in IPESE pypi server located on https://ipese-internal.epfl.ch/registry/pypi. and https://pypi.org/project/bibdatamanagement/
To include the library in your projects, do the following in requirements.txt:
bibdatamanagement >= 0.6.0
Otherwise, the package can be installed by using a pip command.
pip install bibdatamanagement
The package is designed to extract data in a specific format. The initial development was made for technologies parameter used to model it.
+- ENTRY # row_key:set: general description of tech
param1 = min:value1:max [unit1] # short_name: a comment about the param and its value
param2 = value2 [unit2]
+- /ENTRY
Where the fields described as follows:
| Fields | Description | Mandatory |
|---|---|---|
| ENTRY | The name of the tech to which the parameters belong | True |
| row_key | An identifier | False |
| set | Use to retrieve all values from a user (e.g. all values for scenario_oil) | False |
| general_description | A comment on the tech or on the paper | False |
| param | Name of the parameter characterised | False |
| value | Value of the parameter | True |
| min | Minimal value that the parameter can have | False |
| max | Maximal value that the parameter can have | False |
| unit | Unit of the parameter | True |
The minimal information to provide is the +- ENTRY +- /ENTRY. The fields after the # are optional, as well as
the min and max values.
Nb: spaces in the key/value line are for readability but are not required
The minimal workflow to access the data in the .bib is the following.
from bibdata_management.bibdata_management import BibDataManagement
bib_file = 'your_path/your_file.bib'
bibdata = BibDataManagement(bib_file)
df_bib = bibdata.get_data(tech_name='YOUR_ENTRY', set_name='YOUR_SET')
One can also add a .csv file that contains the default value for parameters description (short name, long name, description).
bibdata = BibDataManagement(bib_file, 'your_default_file.csv')
More information on the fields and the methods is available in the documentation website
All suggestions or implementation must be tracked with dedicated issues and reported at the project GitHub
If you want to make the format evolve or implement a new python function, create an issue before anything else.
FAQs
Package to read .bib file annotations and retrieve values from it
We found that bibdatamanagement demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.