Skip to content
Commits on Source (5)
Show whitespace changes
Inline Side-by-side
.appveyor.yml 0 → 100644
View file @ 5503cefd
# Based on https://packaging.python.org/guides/supporting-windows-using-appveyor/
# and https://github.com/Anaconda-Platform/anaconda-project/blob/master/appveyor.yml
environment:
matrix:
# For Miniconda versions available on Appveyor, see
# https://www.appveyor.com/docs/windows-images-software/#miniconda
- MINICONDA: C:\Miniconda
- MINICONDA: C:\Miniconda-x64
- MINICONDA: C:\Miniconda3
- MINICONDA: C:\Miniconda3-x64
install:
# conda 4.5.11 seems to expect that this directory exists already
- mkdir C:\Users\appveyor\.conda
- call %MINICONDA%\Scripts\activate.bat
# The safety checks are simply intended to ensure that there is enough disk space
# and the user has the necessary permissions to make environment changes. In a CI
# environment these are not necessary and slow things down noticeably on Windows.
- conda config --set always_yes yes --set changeps1 no --set auto_update_conda no --set safety_checks disabled
- conda install -q conda numpy hdf4 nose
- conda info -a
# We need wheel installed to build wheels
- pip install wheel
build: off
test_script:
# Put your test command here.
- set LIBRARY_DIRS=%MINICONDA%\Library\bin;%MINICONDA%\Library\lib
- set INCLUDE_DIRS=%MINICONDA%\Library\include
- python setup.py nosetests -v
- python examples\runall.py
after_test:
# This step builds your wheels.
- python setup.py bdist_wheel
artifacts:
# bdist_wheel puts your built wheel in the dist directory
- path: dist\*
#on_success:
# You can use this step to upload your artifacts to a public website.
# See Appveyor's documentation for more details. Or you can simply
# access your wheels from the Appveyor "artifacts" tab for your build.
.gitignore
View file @ 5503cefd
*.pyc
build/
dist/
python_hdf4.egg-info/
pyhdf.egg-info/
doc/_build/
pyhdf/_hdfext*.so
examples/*/*.hdf
.travis.yml
View file @ 5503cefd
language: python
python:
- "2.6"
- "2.7"
- "3.2"
- "3.3"
- "3.4"
# command to install dependencies
install: "sudo apt-get install libhdf4-dev"
matrix:
include:
- os: linux
python: "2.6"
- os: linux
python: "2.7"
- os: linux
python: "3.3"
- os: linux
python: "3.4"
- os: linux
python: "3.5"
- os: linux
python: "3.6"
- os: osx
language: generic
env: PYHDF_PYTHON_VERSION="2.7"
- os: osx
language: generic
env: PYHDF_PYTHON_VERSION="3.7"
addons:
apt:
packages:
- libhdf4-dev
before_install:
- if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then source ./.travis/install_osx_miniconda.bash; fi
# command to run tests
script:
- ./runexamples.sh
- nosetests -v
- python setup.py nosetests -v
- python examples/runall.py
notifications:
email:
recipients:
......
.travis/install_osx_miniconda.bash 0 → 100755
View file @ 5503cefd
#!/bin/bash
# We do this conditionally because it saves us some downloading if the
# version is the same.
if [[ "$PYHDF_PYTHON_VERSION" == "2.7" ]]; then
curl https://repo.anaconda.com/miniconda/Miniconda2-latest-MacOSX-x86_64.sh > miniconda.sh;
else
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh > miniconda.sh;
fi
bash miniconda.sh -b -p $HOME/miniconda
export PATH="$HOME/miniconda/bin:$PATH"
hash -r
conda config --set always_yes yes --set changeps1 no
conda update -q conda
# Useful for debugging any issues with conda
conda info -a
conda create -q -n test-environment python=$PYHDF_PYTHON_VERSION numpy hdf4 nose
source activate test-environment
export LIBRARY_DIRS=$CONDA_PREFIX/lib
export INCLUDE_DIRS=$CONDA_PREFIX/include
AUTHORS
View file @ 5503cefd
bmagill1250 <Snake$1986Friend>
Andre Gosselin <Andre.Gosselin@dfo-mpo.gc.ca>
@bmagill1250
@dmarth
Fazlul Shahriar <fshahriar@gmail.com>
HDF-EOS Tools Informatoin Center <eoshelp@hdfgroup.org>
H. Joe Lee <hyoklee@hdfgroup.org>
Travis E. Oliphant <teoliphant@gmail.com>
CHANGES deleted 100644 → 0
View file @ 5dbacac5
# $Id: CHANGES,v 1.9 2008-08-05 00:20:43 gosselin_a Exp $
# $Log: not supported by cvs2svn $
# Revision 1.8 2008/06/30 02:41:44 gosselin_a
# Preleminary check-in of changes leading to the 0.8 revision.
# - switch to numpy, Numeric now unsupported
# - better documentation of the compression features
# - some bug fixes
#
# Revision 1.7 2005/07/14 01:36:40 gosselin_a
# pyhdf-0.7-3
# Ported to HDF4.2r1.
# Support for SZIP compression on SDS datasets.
# All classes are now 'new-style' classes, deriving from 'object'.
# Update documentation.
#
# Revision 1.6 2004/08/02 17:04:38 gosselin
# pyhdf-0.7-2
#
# Revision 1.4 2004/08/02 15:29:52 gosselin
# pyhdf-0.7-1
#
# Revision 1.3 2004/08/02 15:16:38 gosselin
# pyhdf 0.6-1
#
# Revision 1.2 2004/08/02 15:05:39 gosselin
# pyhdf-0.5.2
#
# Revision 1.1 2004/08/02 14:45:56 gosselin
# Initial revision
#
List of changes to 'pyhdf' since the initial release.
pyhdf-0.8-3
-----------
October 2, 2008
- Regenerated the SWIG files with SWIG 1.3.33 in order to work correctly on
some 64-bit systems.
- Fixed HDF4Error to properly handle its arguments.
- Use the full HDF4 headers in the extension module so as not to rely on
implicit declarations. This appears to fix some bugs on 64-bit platforms.
pyhdf-0.8-2
-----------
August 18, 2008
- Removed ODL parser including examples and aster examples. These are now
in scikits.rsformats.
pyhdf-0.8-1
-----------
August 4 2008
- Numeric replaced with NumPy as underlying numerical package.
Support for the now phased out 'Numeric' package has been dropped.
- Parser for ODL (Object Description Language) added
(courtesy of Enthought Inc).
- The swig interface file is now part of the distribution.
- Fixed bug in the 'setscale()' method of an SDim instance.
- Users working with a debian-based linux distro reported problems with
the HDF SDgetcompress() / SDsetcompress() compression-related functions.
The cause seems to be related to the use of an HDF library whose version
predates 4.2r1. Debian appears very slow moving to the most
recent HDF release. To avoid depriving debian users of the use of pyhdf,
macro 'NOCOMPRESS' can be set inside 'setup.py'. This will transform
functions SDsetcompress() and SDgetcompress() into no-ops which
will return -1 (HDF error code) if called.
- Examples of the use of the HDF compression functionnalities have been
completely reworked. See directory 'examples/compress' for details.
pyhdf-0.7-3
-----------
July 13 2005
Interim release.
- The main motivation for this release is to benefit from HDF-4.2r1 bug fixes and
optionally the SZIP compression method allowed by HDF4.2 on SDS datasets.
- To use this release, you need to install HDF4.2r1. It will *NOT* work over
HDF4.1. To compress datasets using SZIP, szip 2.0 library must also be installed,
and your HDF installation must have been compiled with the szip option enabled.
- Conversely, pyhdf versions preceeding 0.7-3 will *NOT* work over HDF4.2.
Only pyhdf-0.7-3 will work with HDF4.2.
- Added new compression type SDC.COMP_SZIP, and defined new constants SDC.COMP_SZIP_EC
and SDC.COMP_SZIP_NN to configure the behavior of SZIP.
- Updated methods SDS.sdsetcompress() and SDS.getcompress() to allow compression using
SZIP compression, and inquire about SZIP compression configuration.
- All classes are now of "new-style" type (eg they derive from calss 'object').
- Updated documentation.
pyhdf-0.7-2
-----------
June 9 2004
Bug fix release.
- Do not strip trailing NULL at end of string attributes.
- Single-valued attributes were incorrectly processed in the set()
method of the SDAttr class.
- The following feature was not correctly documented.
When attributes are accessed using the "dot" notation, it is important
to be able to differentiate between true python attributes and
HDF attributes. For ex., if 'sds' is an HDF SD instance and one writes
'sds.x = "abcd" ', should attribute 'x' be considered as an HDF attribute and
its value written in the HDF file, or as a python attribute and stored in the
'sds' object dictionnary ?
To solve that problem, an attribute is considered a python attribute if it
starts with an '_', and as an HDF attribute otherwise. Note that this only
applies when using the "dot" notation (or the getattr()/setattr() equivalent
functions). If one needs to define an HDF attribute whose name starts with a
'_' (eg: '_FillValue'), allocate an SDAttr instance and use its get()/set()
methods.
Ex.:
sds = SD('myfile.hdf').select('mydataset')
sds._FillValue = -999 # wrong: _FillValue not stored in the HDF dataset
sds.attr('_FillValue').set(SDC.FLOAT32, -999.0) # good!
pyhdf-0.7-1
-----------
December 16 2003
- Implementation of the V (vgroup) API.
pyhdf-0.6-1
-----------
December 3 2003
-Implementation of the VS (vdata) API.
-Added support for unsigned integer types UINT16 and UINT32 inside
the SD API. Version 22 of Numeric must however be installed
(see comments inside `setup.py' for a way to remove support for
unsigned integers and compile with a lower version number of Numeric).
-Improved documentation.
-Bug fixes (thanks to Richard.Andrews@esands.com)
pyhdf-0.5-2
-----------
August 3 2003
-After starting the implementation of another HDF API, it
was found that the idea of having on C extension module
per HDF API was not a good one. It made difficult the sharing
of HDF data structures between the C extension modules.
It was thus decided to have just one C extension module
shared between all the python modules.
-The new C extension module is named "_hdfext". The SD python
module has been modified to import "_hdfext" instead of "_sdext".
-A new "error" module has been added.
pyhdf-0.5-1
-----------
July 31 2003
-Initial release.
LICENSE
View file @ 5503cefd
The MIT License (MIT)
Copyright (c) 2014 The Python-HDF4 Authors
Copyright (c) 2019 The pyhdf Authors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
......
MANIFEST deleted 100644 → 0
View file @ 5dbacac5
CHANGES
doc/pyhdf.HDF.html
doc/pyhdf.HDF.txt
doc/pyhdf.SD.html
doc/pyhdf.SD.txt
doc/pyhdf.V.html
doc/pyhdf.V.txt
doc/pyhdf.VS.html
doc/pyhdf.VS.txt
examples/compress/README_compress.txt
examples/compress/test-compress.py
examples/hdfstruct/hdfstruct.py
examples/hdfstruct/README_hdfstruct.txt
examples/inventory/inventory_1-1.py
examples/inventory/inventory_1-2.py
examples/inventory/inventory_1-3.py
examples/inventory/inventory_1-4.py
examples/inventory/inventory_1-5.py
examples/inventory/README_inventory.txt
examples/txttohdf/depth.txt
examples/txttohdf/README_txttohdf.txt
examples/txttohdf/temp.txt
examples/txttohdf/txttohdf.py
examples/vgroup/README_vgroup.txt
examples/vgroup/vgread.py
examples/vgroup/vgwrite.py
INSTALL
pyhdf/__init__.py
pyhdf/error.py
pyhdf/hdfext.i
pyhdf/hdfext.py
pyhdf/hdfext_wrap.c
pyhdf/HC.py
pyhdf/HDF.py
pyhdf/SD.py
pyhdf/VS.py
pyhdf/V.py
README
setup.cfg
setup.py
MANIFEST.in 0 → 100644
View file @ 5503cefd
include README.md
include LICENSE
include AUTHORS
include pyhdf/hdfext.i
recursive-include examples *
recursive-include doc *
prune doc/_build
Makefile 0 → 100644
View file @ 5503cefd
PYTHON = python
.PHONY: all
all: build
.PHONY: build
build:
make -C pyhdf build
$(PYTHON) setup.py build
.PHONY: install
install: build
$(PYTHON) setup.py install
.PHONY: builddoc
.ONESHELL:
builddoc:
export PYTHONPATH=$(shell pwd)
$(PYTHON) setup.py build_ext --inplace
make -C doc clean
make -C doc html
@echo
@echo doc index is doc/_build/html/index.html
.PHONY: clean
clean:
rm -rf build/ dist/ pyhdf.egg-info examples/*/*.hdf
make -C pyhdf clean
make -C doc clean
.PHONY: dist
dist:
$(PYTHON) setup.py sdist
@echo Upload to test site:
@echo $(PYTHON) -m twine upload --repository-url https://test.pypi.org/legacy/ dist/*
@echo Upload to PyPI:
@echo $(PYTHON) -m twine upload dist/*
README.md 0 → 100644
View file @ 5503cefd
[![Build Status](https://travis-ci.org/fhs/pyhdf.svg?branch=master)](https://travis-ci.org/fhs/pyhdf)
[![Build status](https://ci.appveyor.com/api/projects/status/4a8pf8vo8nrjgxol/branch/master?svg=true)](https://ci.appveyor.com/project/fhs/pyhdf/branch/master)
[![Anaconda-Server Badge](https://anaconda.org/conda-forge/pyhdf/badges/version.svg)](https://anaconda.org/conda-forge/pyhdf)
# pyhdf
pyhdf is a python wrapper around the NCSA HDF version 4 library.
The SD (Scientific Dataset), VS (Vdata) and V (Vgroup) API's
are currently implemented. NetCDF files can also be
read and modified. It supports both Python 2 and Python 3.
*Note:* The sourceforge pyhdf
[website](http://pysclint.sourceforge.net/pyhdf/) and
[project](https://sourceforge.net/projects/pysclint/) are out-of-date.
The original author of pyhdf have abandoned the project and it is
currently maintained in [github](https://github.com/fhs/pyhdf).
Version 0.9.x was called
[python-hdf4](https://pypi.org/project/python-hdf4/)
in PyPI because at that time we didn't have
[access](https://github.com/pypa/warehouse/issues/5157) to the
[pyhdf package](https://pypi.org/project/pyhdf/) in PyPI. For version
0.10.0 and onward, please install `pyhdf` instead of `python-hdf4`.
## Installation
See [pyhdf installation instructions](http://fhs.github.io/pyhdf/install.html)
or [doc/install.rst](doc/install.rst).
## Documentation
See [pyhdf documentation](http://fhs.github.io/pyhdf/).
Additional documentation on the HDF4 format can be found in the
[HDF4 Support Page](https://portal.hdfgroup.org/display/HDF4/HDF4).
## Examples
Example python programs using the pyhdf package
can be found inside the [examples/](examples/) subdirectory.
README.rst deleted 100644 → 0
View file @ 5dbacac5
.. image:: https://travis-ci.org/fhs/python-hdf4.svg?branch=master
:target: https://travis-ci.org/fhs/python-hdf4
Overview
========
Python-HDF4 is a fork of pyhdf_ with some improvements:
- Various bug fixes: removes use of deprecated numpy API, python 2.7 compatibility, etc.
- Adds support for Python 3, while keeping compatibility with Python 2.
- Sphinx documentation
Python-HDF4 is a python wrapper around the NCSA HDF version 4 library.
The SD (Scientific Dataset), VS (Vdata) and V (Vgroup) API's
are currently implemented. NetCDF files can also be
read and modified.
.. _pyhdf: http://pysclint.sourceforge.net/pyhdf/
Installation
============
To install, see http://fhs.github.io/python-hdf4/install.html
or file `doc/install.rst <doc/install.rst>`_.
Documentation
=============
For documentation, see http://fhs.github.io/python-hdf4/
Additional documentation on the HDF4 format can be
found in the User Guide:
http://www.hdfgroup.org/release4/doc/UsrGuide_html/UG_Top.html
Examples
========
Example python programs using the pyhdf package
can be found inside the examples/ subdirectory.
README_pyhdf deleted 100644 → 0
View file @ 5dbacac5
# $Id: README,v 1.7 2008-08-05 00:20:43 gosselin_a Exp $
# $Log: not supported by cvs2svn $
# Revision 1.6 2008/06/30 02:41:44 gosselin_a
# Preleminary check-in of changes leading to the 0.8 revision.
# - switch to numpy, Numeric now unsupported
# - better documentation of the compression features
# - some bug fixes
#
# Revision 1.5 2004/08/02 17:04:38 gosselin
# pyhdf-0.7-2
#
# Revision 1.3 2004/08/02 15:29:52 gosselin
# pyhdf-0.7-1
#
# Revision 1.2 2004/08/02 15:16:38 gosselin
# pyhdf 0.6-1
#
# Revision 1.1 2004/08/02 14:45:56 gosselin
# Initial revision
#
Author: Andre Gosselin
Maurice Lamontagne Institute
Fisheries and Oceans Department
Government of Canada
Mont-Joli, Canada
Andre.Gosselin@dfo-mpo.gc.ca
Maintainer: Enthought, Inc.
Austin, TX
enthought-dev@mail.enthought.com
Latest version: 0.8-3
Date: October 2 2008
pyhdf is a python wrapper around the NCSA HDF version 4 library.
The SD (Scientific Dataset), VS (Vdata) and V (Vgroup) API's
are currently implemented. netCDF files can also be
read and modified.
Functionality of version 0.8 is same as 0.7-3, but it uses
NumPy package rather than Numeric.
INSTALLATION:
To install, see file INSTALL.
DOCUMENTATION:
For documentation, see the doc/ subdirectory:
-pyhdf.HDF.txt text format
-pyhdf.HDF.html html format
-pyhdf.SD.txt text format
-pyhdf.SD.html html format
-pyhdf.VS.txt text format
-pyhdf.VS.html html format
-pyhdf.V.txt text format
-pyhdf.V.html html format
Additional documentation on the HDF4 format can be
found in the User Guide:
http://hdf.ncsa.uiuc.edu/training/HDFtraining/UsersGuide/
EXAMPLES:
Example python programs using the pyhdf package
can be found inside the examples/ subdirectory.
FINAL NOTES:
Please report all bugs and problems to the maintainer at the
address given above. Author can also be contacted.
debian/changelog
View file @ 5503cefd
python-hdf4 (0.9.2-2) UNRELEASED; urgency=medium
python-hdf4 (0.10.1-1) unstable; urgency=medium
* Team upload.
[ Bas Couwenberg ]
* Update gbp.conf to use --source-only-changes by default.
-- Bas Couwenberg <sebastic@debian.org> Sun, 07 Jul 2019 09:58:30 +0200
[ Antonio Valentino ]
* New upstream release.
* Update debian/copyright file.
-- Antonio Valentino <antonio.valentino@tiscali.it> Wed, 10 Jul 2019 05:51:58 +0000
python-hdf4 (0.9.2-1) unstable; urgency=medium
......
debian/copyright
View file @ 5503cefd
......@@ -4,7 +4,7 @@ Upstream-Contact: Andre Gosselin et al.
Source: https://github.com/fhs/python-hdf4
Files: *
Copyright: 2014 The Python-HDF4 Authors
Copyright: 2014-2019 The pyhdf4 Authors
License: Expat
Files: pyhdf/six.py
......
doc/Makefile
View file @ 5503cefd
......@@ -85,17 +85,17 @@ qthelp:
@echo
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/python-hdf4.qhcp"
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/pyhdf.qhcp"
@echo "To view the help file:"
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/python-hdf4.qhc"
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/pyhdf.qhc"
devhelp:
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
@echo
@echo "Build finished."
@echo "To view the help file:"
@echo "# mkdir -p $$HOME/.local/share/devhelp/python-hdf4"
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/python-hdf4"
@echo "# mkdir -p $$HOME/.local/share/devhelp/pyhdf"
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/pyhdf"
@echo "# devhelp"
epub:
......
doc/conf.py
View file @ 5503cefd
# -*- coding: utf-8 -*-
#
# python-hdf4 documentation build configuration file, created by
# pyhdf documentation build configuration file, created by
# sphinx-quickstart2 on Sun Jul 27 02:07:57 2014.
#
# This file is execfile()d with the current directory set to its
......@@ -46,17 +46,17 @@ source_suffix = '.rst'
master_doc = 'index'
# General information about the project.
project = u'python-hdf4'
copyright = u'2014, python-hdf4 authors'
project = u'pyhdf'
copyright = u'2019, pyhdf authors'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
version = '0.9'
version = '0.10'
# The full version, including alpha/beta/rc tags.
release = '0.9'
release = '0.10.1'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
......@@ -179,7 +179,7 @@ html_static_path = ['_static']
#html_file_suffix = None
# Output file base name for HTML help builder.
htmlhelp_basename = 'python-hdf4doc'
htmlhelp_basename = 'pyhdfdoc'
# -- Options for LaTeX output ---------------------------------------------
......@@ -199,8 +199,8 @@ latex_elements = {
# (source start file, target name, title,
# author, documentclass [howto, manual, or own class]).
latex_documents = [
('index', 'python-hdf4.tex', u'python-hdf4 Documentation',
u'python-hdf4 authors', 'manual'),
('index', 'pyhdf.tex', u'pyhdf Documentation',
u'pyhdf authors', 'manual'),
]
# The name of an image file (relative to this directory) to place at the top of
......@@ -229,8 +229,8 @@ latex_documents = [
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
('index', 'python-hdf4', u'python-hdf4 Documentation',
[u'python-hdf4 authors'], 1)
('index', 'pyhdf', u'pyhdf Documentation',
[u'pyhdf authors'], 1)
]
# If true, show URL addresses after external links.
......@@ -243,8 +243,8 @@ man_pages = [
# (source start file, target name, title, author,
# dir menu entry, description, category)
texinfo_documents = [
('index', 'python-hdf4', u'python-hdf4 Documentation',
u'python-hdf4 authors', 'python-hdf4', 'One line description of project.',
('index', 'pyhdf', u'pyhdf Documentation',
u'pyhdf authors', 'pyhdf', 'One line description of project.',
'Miscellaneous'),
]
......
doc/index.rst
View file @ 5503cefd
.. python-hdf4 documentation master file, created by
.. pyhdf documentation master file, created by
sphinx-quickstart2 on Sun Jul 27 02:07:57 2014.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Welcome to python-hdf4's documentation!
Welcome to pyhdf's documentation!
=======================================
Python-HDF4 is a python wrapper around the NCSA HDF version 4 library. The SD
pyhdf is a python wrapper around the NCSA HDF version 4 library. The SD
(Scientific Dataset), VS (Vdata) and V (Vgroup) API's are currently
implemented. NetCDF files can also be read and modified.
Python-HDF4 is a fork of `pyhdf <http://pysclint.sourceforge.net/pyhdf/>`_.
Development for this library happens in github:
https://github.com/fhs/python-hdf4/
https://github.com/fhs/pyhdf/
Contents:
......
doc/install.rst
View file @ 5503cefd
......@@ -2,30 +2,45 @@
Installation
============
Python-HDF4 supports installation on Python 2 and Python 3. Please open an
pyhdf supports installation on Python 2 and Python 3. Please open an
issue here if you encounter any problems during installation:
https://github.com/fhs/python-hdf4/issues
https://github.com/fhs/pyhdf/issues
The source code of the latest release of Python-HDF4 can be obtained from
either of these two location:
The recommended method of installing
pyhdf is to use conda. See the `Conda user guide
<https://conda.io/projects/conda/en/latest/user-guide/getting-started.html>`_
on how to install conda and activate your conda environment.
Once you're in the conda environment, install `pyhdf from conda-forge
<https://anaconda.org/conda-forge/pyhdf>`_::
conda install -c conda-forge pyhdf
* PyPi / the cheeseshop: https://pypi.python.org/pypi/python-hdf4
* Github: https://github.com/fhs/python-hdf4/releases
If you don't want to use conda, the instructions below describes how you
can compile pyhdf from source.
Download the source
-------------------
The source code of the latest release of pyhdf can be obtained from
either of these two location:
* PyPi / the cheeseshop: https://pypi.python.org/pypi/pyhdf
* Github: https://github.com/fhs/pyhdf/releases
Requirements
------------
The following packages are required to build and install Python-HDF4:
The following packages are required to build and install pyhdf:
- `Python <http://www.python.org>`_:
Python 2.6 or newer for Python 2, or Python 3.2 or newer for Python 3.
- `NumPy <http://www.scipy.org>`_
- `HDF4 libraries <http://www.hdfgroup.org/release4/obtain.html>`_ (to use
- `NumPy <http://www.numpy.org/>`_
- `HDF4 libraries <https://portal.hdfgroup.org/display/support/Download+HDF4>`_ (to use
their HDF4 binaries, you will also need szip, available from the same page)
- Compiler suite e.g. `GCC <http://gcc.gnu.org>`_.
On Windows, you can use `Mingw32 compiler <http://www.mingw.org>`_ or Visual
Studio .NET 2003.
On Windows, you need to use a `compatible Visual C++ compiler
<https://wiki.python.org/moin/WindowsCompilers>`_.
- `zlib <http://www.zlib.net/>`_
- `libjpeg <http://www.ijg.org/>`_
......@@ -34,26 +49,10 @@ all the requirements for Python 3 using this command::
apt-get install build-essential python3-dev python3-numpy libhdf4-dev -y
OS X users can obtain jpeg libraries `here
<http://ethan.tira-thompson.com/Mac%20OS%20X%20Ports.html>`_.
Installing from the Cheeseshop
------------------------------
To install Python-HDF4 from The Python Package Index (Cheeseshop), open a
command prompt and type::
pip install python-hdf4
On Debian based systems, you can obtain the ``pip`` command by running::
apt-get install python-pip -y
Installing from the source archive
----------------------------------
1. Go to the Python-HDF4 source directory.
1. Go to the pyhdf source directory.
2. If your HDF4 libraries or include files reside in directories
that are not searched by default on your system, the installation script
......@@ -108,49 +107,6 @@ script should display the file structure. This is a handy tool to have
around when you want to explore the contents of any HDF4 file.
Quick install for Windows Users
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Download the complete HDF4 binary package from the link given
below. These packages include all libraries needed to compile
Python-HDF4. There are two binary packages to choose from depending on
whether or not you want to compile Python-HDF4 with SZIP encoding enabled
or disabled. There are different licensing implications for each
choice (see `the HDF page
<http://hdfgroup.com/doc_resource/SZIP/>`_ for more details on the
licensing of SZIP).
- `HDF4 with encoding enabled <http://pysclint.sourceforge.net/pyhdf/hdf4-all-enc.zip>`_
- `HDF4 with encoding disabled <http://pysclint.sourceforge.net/pyhdf/hdf4-all-noenc.zip>`_
2. Unzip the selected package into a directory of your choice (e.g. ``C:\HDF4``).
3. Go to the Python-HDF4 source directory.
4. Build the package in one of the two following ways:
* Set the HDF4 environment variable to the directory where you unpacked the
binary and (e.g. ``C:\HDF4``). Then run the following::
python setup.py build
* Run ``python setup.py build --hdf4 <directory of unzipped package>`` where
``<directory of unzipped package>`` is the location where you unzipped the
downloaded HDF4 binary (e.g. ``C:\HDF4``).
*NOTE*: If you are using the mingw32 compiler and are using the
standard Python binary distribution, then you need to specify -c
mingw32 on the command line as well.
5. To install Python-HDF4 or build a binary distribution (bdist_msi,
bdist_wininst, bdist_egg, etc.), run one of the following commands::
python setup.py install
python setup.py bdist_msi
python setup.py bdist_wininst
python setup.py bdist_egg
Further notes
-------------
......@@ -173,9 +129,8 @@ capability.
Getting an SZIP enabled HDF library may require compiling the library
from source with the "--with-szlib" configuration option. Note that
you *must* install SZIP in a separate step. For more details, see the
`NCSA hdf site <http://hdf.ncsa.uiuc.edu/doc_resource/SZIP/>`_.
Source code and binaries are `available for download
<ftp://ftp.hdfgroup.org/lib-external/szip/>`_.
`HDF Group site
<https://portal.hdfgroup.org/display/HDF5/Szip+Compression+in+HDF+Products>`_.
In case your HDF library was compiled with SZIP support and you abide by the
szip licensing terms, set the environment variable ``SZIP`` to ``1``.
......
doc/make.bat
View file @ 5503cefd
......@@ -115,9 +115,9 @@ if "%1" == "qthelp" (
echo.
echo.Build finished; now you can run "qcollectiongenerator" with the ^
.qhcp project file in %BUILDDIR%/qthelp, like this:
echo.^> qcollectiongenerator %BUILDDIR%\qthelp\python-hdf4.qhcp
echo.^> qcollectiongenerator %BUILDDIR%\qthelp\pyhdf.qhcp
echo.To view the help file:
echo.^> assistant -collectionFile %BUILDDIR%\qthelp\python-hdf4.ghc
echo.^> assistant -collectionFile %BUILDDIR%\qthelp\pyhdf.ghc
goto end
)
......