Skip to content

Developers Content of this page is outdated to be revised

Jump to bottom
Lina Muryanto edited this page Jul 28, 2020 · 1 revision

Wiki ▸ Documentation ▸ Developers

Checkout developers source tree

1 Clone

git clone [email protected]:UV-CDAT/uvcdat.git

2 Setup developement environment

cd uvcdat
scripts/setup_for_development.sh

3 Commit

git fetch --all -p  
git checkout master  
git reset --hard origin/master  
git checkout -b your_branch_name

4 Add/Remove/Change and then Commit

git commit  
git push origin HEAD

5 Visit [UV-CDAT Github] (https://github.com/UV-CDAT/uvcdat/pulls) to create a pull request

Create release tarball

1 Make a directory for the building of UV-CDAT

mkdir /Users/williams13/work/uvcdata

2 Change directory to the newly created directory

cd /Users/williams13/work/uvcdata

3 Get the master source code from the Git repository

git clone –b release-2.1.0 git://github.com/UV-CDAT/uvcdat.git

4 Make a build directory to build UV-CDAT

mkdir build_uvcdat

5 Change directory to the newly created build directory

cd build_uvcdat

6 Make sure to remove the old 2.1.0 installation (the version you are building)

sudo rm –rf /usr/local/uvcdat/2.1.0

7 Choose which option to build in cmake/ccmake: DEFAULT or FULL

  • BASIC BUILD: Create the BASIC makefile from the Cmake command
sudo cmake -DCMAKE_INSTALL_PREFIX=/usr/local/uvcdat/2.1.0 -DCDAT_DOWNLOAD_SAMPLE_DATA=OFF ../uvcdat
  • FULL BUILD
sudo cmake -DCDAT_BUILD_MODE=ALL 
-DCMAKE_INSTALL_PREFIX=/usr/local/uvcdat/2.1.0 -DCDAT_DOWNLOAD_SAMPLE_DATA=OFF ../uvcdat

8 Make the installation

sudo make -j4

9 Make sure to remove all traces of any old UV-CDAT settings

rm $HOME/.uvcdat

10 Source the setup to make sure the environment variables are set properly

source /usr/local/uvcdat/2.1.0/bin/setup_runtime.sh

11 Verify that you are pointing to the newly created python in the /usr/local/uvcdat/2.1.0 subdirectory

which python

12 Run Python

python

13 Import vcs to create a new $HOME/.uvcdat for testing. Also remember to answer “yes” to the question

>>> import vcs   ### answer yes and exist python

14 Run Ctest to verify that UV-CDAT is installed properly

sudo ctest -j4 -D Experimental

15 If you do not get 100% tests passed, then report all errors to the team to fix the errors and stop the process. Do not proceed until ALL errors have been fixed, then proceed back to step 1

100% tests passed, 0 tests failed out of 342

16 Total Test time (real) = 595.29 sec

100% tests passed, 0 tests failed out of 342

17 Change directory up one level to the easily find the TARBALL.

cd ../

18 Create the TARBALL.

tar -czPvf UV-CDAT-2.1.0-Ubuntu-13.10-64bit.tar.gz /usr/local/uvcdat/2.1.0

19 If you do not have an admin account then you will not be able to upload the TARBALL

Using a browser (firefox), go to https://sourceforge.net/projects/cdat/ and login

20 Go to (or create) the release version number

Select “Files” in the tool bar, then select “Releases”, then “UV-CDAT”
If the release version number (e.g., 2.1.0) is not there, then add the release number (e.g., 2.1.0) folder by selecting the “Add Folder”. If the release version number is there, then select it

21 Upload TARBALL

Upload your TARBALL from your directory by selecting the “Add File” button.

Build options

There are more command options

Build issues

Visit Build Issues for more information

Clone this wiki locally