Python ATLAS Metadata Interface (pyAMI) for ATLAS
Project description
pyAMI 5 is a major upgrade of the AMI python client. The command line syntax has been rationalized, with improved help functions. The code has been split into a core layer and an experiment specific layer. This documentation is specific for the ATLAS layer.
pyAMI is available in the ATLAS software release and also installed centrally on LXPLUS (CVFMS and AFS). pyAMI can be installed standalone on a laptop. Instructions are given below for Linux, OSX and Windows.
A few examples
List runs for 2012 in a period or multiple periods:
ami list runs --year 12 --data-periods A B
List AOD datasets matching a pattern:
ami list datasets --type AOD data14_cos%
Display dataset information:
ami show dataset info data13_2p76TeV.00219364.physics_MinBias.merge.NTUP_HI.f519_m1313
Display dataset provenance:
ami show dataset prov data13_2p76TeV.00219364.physics_MinBias.merge.NTUP_HI.f519_m1313
List the files in a dataset:
ami list files -LHC data13_2p76TeV.00219364.physics_MinBias.merge.NTUP_HI.f519_m1313
LXPLUS (CVMFS and AFS)
pyAMI is installed centrally on LXPLUS at CERN. To begin using pyAMI simply:
export ATLAS_LOCAL_ROOT_BASE=/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase source $ATLAS_LOCAL_ROOT_BASE/user/atlasLocalSetup.sh localSetupPyAMI
pyAMI is also available through AFS:
source /afs/cern.ch/atlas/software/tools/pyAMI/setup.sh
Standalone installation
pyAMI 5 is compatible with Python 2.6, 2.7 and 3.X.
Automatic installation for LINUX and MAC OSX
Automatically install the latest version of pyAMI with pip:
pip install --user pyAMI_atlas
or with easy_install (deprecated):
easy_install --user pyAMI_atlas
Omit the --user for a system-wide installation (requires root privileges). Add ${HOME}/.local/bin to your ${PATH} if using --user and if it is not there already (put this in your .bashrc):
# For LINUX export PATH=${HOME}/.local/bin${PATH:+:$PATH} # For MAC OSX export PATH=${HOME}/Library/Python/2.7/bin${PATH:+:$PATH}
Execute the post-install script:
ami_atlas_post_install
To upgrade an existing installation with pip:
pip install --upgrade pyAMI_core pip install --upgrade pyAMI_atlas ami_atlas_post_install
or with easy_install (deprecated):
easy_install --upgrade pyAMI_core easy_install --upgrade pyAMI_atlas ami_atlas_post_install
Automatic installation for WINDOWS
Install Python 2.7.X
python.exe should be in C:\Python27. You must adjust your paths in the Windows environment. If you do not know how to do this follow the instructions here www.java.com/en/download/help/path.xml. Add to the path:
C:\PYTHON27;C:\PYTHON27\Scripts
Download and install pip (for easy installation of dependences):
python get-pip.py
Install pyAMI:
pip install pyAMI_atlas
Execute the post-install script:
ami_atlas_post_install
To upgrade an existing installation:
pip install --upgrade pyAMI_core pip install --upgrade pyAMI_atlas ami_atlas_post_install
Authentication
VOMS authentication is supported:
voms-proxy-init -voms atlas
If gLite is not available, the alternative option is to connect with your username and password. You can set up an encrypted configuration file by running:
ami auth
You will only need to do this once since your credentials are stored in ~/.pyami/pyami.cfg for later use. If your credentials change just run ami auth again. If you would like to keep your pyAMI configuration in a directory other than ~/.pyami then set the environment variable PYAMI_CONFIG_DIR.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pyAMI_atlas-5.0.3.1.tar.gz
.
File metadata
- Download URL: pyAMI_atlas-5.0.3.1.tar.gz
- Upload date:
- Size: 25.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 921af4388e6b149adfff1ec84eea1dd9adaad3a92cdd5822239a603df0d21ea8 |
|
MD5 | 0f03fcaef77eba925f4feacfc89d4272 |
|
BLAKE2b-256 | ef20ec8a8e849f3d239273a1144c629e2413a7f7eb6cd638781c2389f85ca5d5 |