From 202e1c20b99f6f495d8918e3baa3e8ca4c47dce9 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:10:21 +0100 Subject: [PATCH 01/36] Update Introduction.rst --- docs/Introduction.rst | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index ced435b..36b1e14 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -3,13 +3,24 @@ Introduction ================ -Hey What up +carra2py is a simple python package for + -Installation ================ -Please +clone the repository: +*git clone git@github.com:RasmusBahbah/carra2py.git* + +change into the top-level directory +*cd carra2py* + +create python environement +*conda env create -f carra2py.yml* + +activate python environement +*conda activate carra2py* + Dependencies ================ -Siiiiiii +Python 3.5 or up From 34d95e535f46b0c692937c625925ecf24aa5b615 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:17:27 +0100 Subject: [PATCH 02/36] Update Introduction.rst --- docs/Introduction.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index 36b1e14..c0a9818 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -3,20 +3,25 @@ Introduction ================ -carra2py is a simple python package for - +carra2py is a simple python package for download, reproject and process albedo data for CARRA2 +Installation ================ + clone the repository: + *git clone git@github.com:RasmusBahbah/carra2py.git* change into the top-level directory + *cd carra2py* create python environement + *conda env create -f carra2py.yml* activate python environement + *conda activate carra2py* From 4877b247b2e01ad26e826a29147f7e6964ae5771 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:17:56 +0100 Subject: [PATCH 03/36] Update Introduction.rst --- docs/Introduction.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index c0a9818..f7aea56 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -8,19 +8,19 @@ carra2py is a simple python package for download, reproject and process albedo d Installation ================ -clone the repository: +Clone the repository: *git clone git@github.com:RasmusBahbah/carra2py.git* -change into the top-level directory +Change into the top-level directory: *cd carra2py* -create python environement +Create python environement: *conda env create -f carra2py.yml* -activate python environement +Activate python environement: *conda activate carra2py* From 02b999de44c5f421f30854a4b7aa7423a4a8435e Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:22:01 +0100 Subject: [PATCH 04/36] Update Introduction.rst --- docs/Introduction.rst | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index f7aea56..33dc226 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -8,21 +8,17 @@ carra2py is a simple python package for download, reproject and process albedo d Installation ================ -Clone the repository: +**Clone the repository:** + *git clone git@github.com:RasmusBahbah/carra2py.git* -*git clone git@github.com:RasmusBahbah/carra2py.git* +**Change into the top-level directory:** + *cd carra2py* -Change into the top-level directory: +**Create python environement:** + *conda env create -f carra2py.yml* -*cd carra2py* - -Create python environement: - -*conda env create -f carra2py.yml* - -Activate python environement: - -*conda activate carra2py* +**Activate python environement:** + *conda activate carra2py* Dependencies From d26fffdebb42a608d59ff45846ff14583e1b0355 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:22:28 +0100 Subject: [PATCH 05/36] Update Introduction.rst --- docs/Introduction.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index 33dc226..d95942d 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -9,7 +9,7 @@ Installation ================ **Clone the repository:** - *git clone git@github.com:RasmusBahbah/carra2py.git* + "*git clone git@github.com:RasmusBahbah/carra2py.git*" **Change into the top-level directory:** *cd carra2py* From 8f306bf51d77e6887c0a6cf2abe12810cbc62e54 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:22:36 +0100 Subject: [PATCH 06/36] Update Introduction.rst --- docs/Introduction.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index d95942d..dc7ff93 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -9,7 +9,7 @@ Installation ================ **Clone the repository:** - "*git clone git@github.com:RasmusBahbah/carra2py.git*" + ""*git clone git@github.com:RasmusBahbah/carra2py.git*"" **Change into the top-level directory:** *cd carra2py* From e2bbff11cda22e1afa30924bf860dda42d2221ec Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:23:08 +0100 Subject: [PATCH 07/36] Update Introduction.rst --- docs/Introduction.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index dc7ff93..77f4a5c 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -9,16 +9,16 @@ Installation ================ **Clone the repository:** - ""*git clone git@github.com:RasmusBahbah/carra2py.git*"" + ''*git clone git@github.com:RasmusBahbah/carra2py.git*'' **Change into the top-level directory:** - *cd carra2py* + ''*cd carra2py*'' **Create python environement:** - *conda env create -f carra2py.yml* + ''*conda env create -f carra2py.yml*'' **Activate python environement:** - *conda activate carra2py* + ''*conda activate carra2py*'' Dependencies From 1d62b8dc1449730e4d3a8bfaf28e56b2249e3892 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:25:51 +0100 Subject: [PATCH 08/36] Update Introduction.rst --- docs/Introduction.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index 77f4a5c..d915b3b 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -9,7 +9,7 @@ Installation ================ **Clone the repository:** - ''*git clone git@github.com:RasmusBahbah/carra2py.git*'' + ''git clone git@github.com:RasmusBahbah/carra2py.git'' **Change into the top-level directory:** ''*cd carra2py*'' From 953d2b344ea79acc44f9037a869b6162d02d70d6 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:27:12 +0100 Subject: [PATCH 09/36] Update Introduction.rst --- docs/Introduction.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index d915b3b..d75bae9 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -9,16 +9,16 @@ Installation ================ **Clone the repository:** - ''git clone git@github.com:RasmusBahbah/carra2py.git'' + ``git clone git@github.com:RasmusBahbah/carra2py.git`` **Change into the top-level directory:** - ''*cd carra2py*'' + ``cd carra2py*`` **Create python environement:** - ''*conda env create -f carra2py.yml*'' + ``*conda env create -f carra2py.yml*`` **Activate python environement:** - ''*conda activate carra2py*'' + ``*conda activate carra2py*`` Dependencies From abaf4de63ac3bcb7f719ed2e128059545e922d1f Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Mon, 16 Jan 2023 15:27:47 +0100 Subject: [PATCH 10/36] Update Introduction.rst --- docs/Introduction.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index d75bae9..ab5fb57 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -12,13 +12,13 @@ Installation ``git clone git@github.com:RasmusBahbah/carra2py.git`` **Change into the top-level directory:** - ``cd carra2py*`` + ``cd carra2py`` **Create python environement:** - ``*conda env create -f carra2py.yml*`` + ``conda env create -f carra2py.yml`` **Activate python environement:** - ``*conda activate carra2py*`` + ``conda activate carra2py`` Dependencies From 69a736913ed6d351cffa9dd97f789bca6b7d1aac Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:11:14 +0100 Subject: [PATCH 11/36] Update Introduction.rst --- docs/Introduction.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/Introduction.rst b/docs/Introduction.rst index ab5fb57..5701034 100644 --- a/docs/Introduction.rst +++ b/docs/Introduction.rst @@ -3,7 +3,9 @@ Introduction ================ -carra2py is a simple python package for download, reproject and process albedo data for CARRA2 +carra2py is a simple python package for downloading, reprojecting and processing albedo data for CARRA2 in the arctic region. +For now it includes the Advanced Very High Resolution Radiometer (AVHRR) dataset from 1984-present. + Installation ================ From 6c1980aeed2289797c0b0fd5806b637177d923dd Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:17:48 +0100 Subject: [PATCH 12/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index b9243fc..5949fed 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -8,15 +8,42 @@ Description of the carra2py modules and its methods. class carra2py.AVHRR(date): ================ +Parameter: date: str +---------------- + +the processed date, only in 'yyyymmdd' format + Methods: ---------------- AVHRR.get_data(polar=None) ~~~~~~~~~~~~~~~~ +Import the raw AVHRR data of the northern hempishere in native resolution of 5000 meters. + +**Parameter: polar: bool, optional:** + + {if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection.} + + +**Returns:  raw_lon or raw_x: (m,n) array of floats:** + Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. + + **raw_lat or raw_y: (m,n) array of floats:** +      Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. + +      **raw_alb: (m,n) array of floats:** +      Raw albedo data in native 5000 meter resolution + AVHRR.proc(raw_data=None, area=None, res=2500) ~~~~~~~~~~~~~~~~ +Reproject and Intepolate raw AVHRR data to ESPG:3413 and a better resolution. The data is also masked to 9 possible search areas in the arctic region + +**Parameter: raw_data: tuple** + + if None, the data for the processing wil come from get_data(), else, the user has tp input the data wants processed. the tuple needs to include (x,y,albedo) in that order, x and y is the data coordinates in EPSG:3413 with shape (m,n). Albedo is the raw albedo data from AVHRR in shape (m,n) + AVHRR.export_to_tif(polar=None) ~~~~~~~~~~~~~~~~ From 8efe793c024aeff2f8957ea9fa02b7a89ee6d614 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:33:04 +0100 Subject: [PATCH 13/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 5949fed..ac6dfc2 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -23,7 +23,7 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 **Parameter: polar: bool, optional:** - {if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection.} + if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. **Returns:  raw_lon or raw_x: (m,n) array of floats:** From 4bb5d819fc45796ce6e9e4b53300eda27d0e9467 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:34:00 +0100 Subject: [PATCH 14/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index ac6dfc2..eac4af6 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -22,19 +22,20 @@ AVHRR.get_data(polar=None) Import the raw AVHRR data of the northern hempishere in native resolution of 5000 meters. **Parameter: polar: bool, optional:** - + if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. - - + + **Returns:  raw_lon or raw_x: (m,n) array of floats:** + Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. - + **raw_lat or raw_y: (m,n) array of floats:**       Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. - +       **raw_alb: (m,n) array of floats:**       Raw albedo data in native 5000 meter resolution - + AVHRR.proc(raw_data=None, area=None, res=2500) ~~~~~~~~~~~~~~~~ From 27799748e34333669016936fa551927c381364e7 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:35:37 +0100 Subject: [PATCH 15/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index eac4af6..779c17f 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -26,7 +26,7 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. -**Returns:  raw_lon or raw_x: (m,n) array of floats:** + **Returns:  raw_lon or raw_x: (m,n) array of floats:** Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. @@ -35,16 +35,17 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500       **raw_alb: (m,n) array of floats:**       Raw albedo data in native 5000 meter resolution - + + AVHRR.proc(raw_data=None, area=None, res=2500) ~~~~~~~~~~~~~~~~ Reproject and Intepolate raw AVHRR data to ESPG:3413 and a better resolution. The data is also masked to 9 possible search areas in the arctic region **Parameter: raw_data: tuple** - + if None, the data for the processing wil come from get_data(), else, the user has tp input the data wants processed. the tuple needs to include (x,y,albedo) in that order, x and y is the data coordinates in EPSG:3413 with shape (m,n). Albedo is the raw albedo data from AVHRR in shape (m,n) - + AVHRR.export_to_tif(polar=None) ~~~~~~~~~~~~~~~~ From fde788dbb75ee28be847cc86b04222a2652ed995 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:37:15 +0100 Subject: [PATCH 16/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 779c17f..118cfdc 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -30,11 +30,13 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. - **raw_lat or raw_y: (m,n) array of floats:** -      Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. + **raw_lat or raw_y: (m,n) array of floats:** +      + Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. -      **raw_alb: (m,n) array of floats:** -      Raw albedo data in native 5000 meter resolution +      **raw_alb: (m,n) array of floats:** +      + Raw albedo data in native 5000 meter resolution AVHRR.proc(raw_data=None, area=None, res=2500) From 1a262ac88db735a58a546f8b77aff3c1c5ada3f0 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:37:51 +0100 Subject: [PATCH 17/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 118cfdc..2e070b1 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -28,15 +28,15 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 **Returns:  raw_lon or raw_x: (m,n) array of floats:** - Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. + Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. - **raw_lat or raw_y: (m,n) array of floats:** + **raw_lat or raw_y: (m,n) array of floats:**       - Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. + Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. -      **raw_alb: (m,n) array of floats:** +      **raw_alb: (m,n) array of floats:**       - Raw albedo data in native 5000 meter resolution + Raw albedo data in native 5000 meter resolution AVHRR.proc(raw_data=None, area=None, res=2500) From bc9430613b3a20c228cb3dee6137b6dd677f06ca Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:46:08 +0100 Subject: [PATCH 18/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 2e070b1..c4bc166 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -23,7 +23,7 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 **Parameter: polar: bool, optional:** - if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. + if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. **Returns:  raw_lon or raw_x: (m,n) array of floats:** From ea83e6dca25fd3c71b95ef9e521cdef2b6a5ac9b Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:52:22 +0100 Subject: [PATCH 19/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index c4bc166..17c63aa 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -22,18 +22,18 @@ AVHRR.get_data(polar=None) Import the raw AVHRR data of the northern hempishere in native resolution of 5000 meters. **Parameter: polar: bool, optional:** - + if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. - - + + **Returns:  raw_lon or raw_x: (m,n) array of floats:** - + Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. - + **raw_lat or raw_y: (m,n) array of floats:** -      +      Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. - +       **raw_alb: (m,n) array of floats:**       Raw albedo data in native 5000 meter resolution From b4d75b9b985c9fd0a3f3abe2b64bdb6a30f4b04c Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:53:13 +0100 Subject: [PATCH 20/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 17c63aa..f0e4ccc 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -35,10 +35,10 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True.       **raw_alb: (m,n) array of floats:** -      +      Raw albedo data in native 5000 meter resolution - - + + AVHRR.proc(raw_data=None, area=None, res=2500) ~~~~~~~~~~~~~~~~ From d8a51fb22bdd6a0c8cfad57c06a550610b33fe2e Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:54:02 +0100 Subject: [PATCH 21/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index f0e4ccc..2200962 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -26,7 +26,7 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. - **Returns:  raw_lon or raw_x: (m,n) array of floats:** +**Returns:  raw_lon or raw_x: (m,n) array of floats:** Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. From 9282e54236ad23fba516946a41725702d52250e5 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 10:55:56 +0100 Subject: [PATCH 22/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 2200962..50fec61 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -26,7 +26,7 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. -**Returns:  raw_lon or raw_x: (m,n) array of floats:** +**Returns:  raw_lon or raw_x: (m,n) array of floats:** Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. @@ -34,7 +34,7 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500       Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. -      **raw_alb: (m,n) array of floats:** + **raw_alb: (m,n) array of floats:**       Raw albedo data in native 5000 meter resolution From 3c913032daac91f1283bd50ded2bbdf2e20e882f Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 11:28:03 +0100 Subject: [PATCH 23/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 50fec61..d7bc82b 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -48,6 +48,19 @@ Reproject and Intepolate raw AVHRR data to ESPG:3413 and a better resolution. Th if None, the data for the processing wil come from get_data(), else, the user has tp input the data wants processed. the tuple needs to include (x,y,albedo) in that order, x and y is the data coordinates in EPSG:3413 with shape (m,n). Albedo is the raw albedo data from AVHRR in shape (m,n) + **area: str, or list:** + + if None, all areas in the arctic with glaciers are processed. Else, indicate which area or areas you want to process. + Areas included: [AlaskaYukon, Greenland, Iceland, NorthernArcticCanada, SoutherArcticCanada, Norway, SevernayaZemlya, NovayaZemlya, Svalbard] + + **res: int:** + + The resoultion of the output, there are three options, 1000,2500 or 5000 all in meters, the default is set to 2500 meters. + +**Returns:  output: dictionary of floats:** + + outputs a dictionary of the albedo at each area in the specifiec resolution + AVHRR.export_to_tif(polar=None) ~~~~~~~~~~~~~~~~ From 29243ec3c220f862f3eee75349ee49bc0223450f Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 11:55:14 +0100 Subject: [PATCH 24/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index d7bc82b..6398e01 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -57,9 +57,10 @@ Reproject and Intepolate raw AVHRR data to ESPG:3413 and a better resolution. Th The resoultion of the output, there are three options, 1000,2500 or 5000 all in meters, the default is set to 2500 meters. -**Returns:  output: dictionary of floats:** +**Returns:  output: dict of floats:** - outputs a dictionary of the albedo at each area in the specifiec resolution + outputs a dictionary of the albedo at each area in the specifiec resolution in EPSG:3413 projection. + The dictionary strutcture: output[area] = {"x" : x_coordinates, "y" : y_coordinates, "albedo" : albedo} AVHRR.export_to_tif(polar=None) ~~~~~~~~~~~~~~~~ From 01269c8c218a97f3cdbd22f6f0a691b985157a56 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 12:04:00 +0100 Subject: [PATCH 25/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 6398e01..98ca100 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -26,15 +26,15 @@ Import the raw AVHRR data of the northern hempishere in native resolution of 500 if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection. -**Returns:  raw_lon or raw_x: (m,n) array of floats:** +**Returns:  raw_lon or raw_x: (m,n) array of floats** Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. - **raw_lat or raw_y: (m,n) array of floats:** + **raw_lat or raw_y: (m,n) array of floats**       Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. - **raw_alb: (m,n) array of floats:** + **raw_alb: (m,n) array of floats**       Raw albedo data in native 5000 meter resolution @@ -48,23 +48,39 @@ Reproject and Intepolate raw AVHRR data to ESPG:3413 and a better resolution. Th if None, the data for the processing wil come from get_data(), else, the user has tp input the data wants processed. the tuple needs to include (x,y,albedo) in that order, x and y is the data coordinates in EPSG:3413 with shape (m,n). Albedo is the raw albedo data from AVHRR in shape (m,n) - **area: str, or list:** + **area: str, or list** if None, all areas in the arctic with glaciers are processed. Else, indicate which area or areas you want to process. Areas included: [AlaskaYukon, Greenland, Iceland, NorthernArcticCanada, SoutherArcticCanada, Norway, SevernayaZemlya, NovayaZemlya, Svalbard] - **res: int:** + **res: int** The resoultion of the output, there are three options, 1000,2500 or 5000 all in meters, the default is set to 2500 meters. -**Returns:  output: dict of floats:** +**Returns:  output: dict of floats** outputs a dictionary of the albedo at each area in the specifiec resolution in EPSG:3413 projection. The dictionary strutcture: output[area] = {"x" : x_coordinates, "y" : y_coordinates, "albedo" : albedo} AVHRR.export_to_tif(polar=None) ~~~~~~~~~~~~~~~~ +Export the processed data to tif files in ESPG:3413 + +**Parameter: output: dict** + + If None, the exported processed data will come from AVHRR.proc(raw_data=None, area=None, res=2500) with the default inputs. Else, + input the processed data you want to export, the input needs to be a dictionary with this format: + output[area] = {"x" : x_coordinates, "y" : y_coordinates, "albedo" : albedo} + + **path: str** + + if "default", the data will be exported to /output/"yyyymmdd", Else, specify the output folder. + +**Returns:  None** + + The method will not return anything + AVHRR.export_to_csv(polar=None) ~~~~~~~~~~~~~~~~ From a6be5848f6c69a250b5605305a09f773488ae222 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 12:06:06 +0100 Subject: [PATCH 26/36] Update carra2py methods.rst --- docs/carra2py methods.rst | 40 ++++++++++++++++++++++++++++++++++++--- 1 file changed, 37 insertions(+), 3 deletions(-) diff --git a/docs/carra2py methods.rst b/docs/carra2py methods.rst index 98ca100..ab3229e 100644 --- a/docs/carra2py methods.rst +++ b/docs/carra2py methods.rst @@ -62,7 +62,7 @@ Reproject and Intepolate raw AVHRR data to ESPG:3413 and a better resolution. Th outputs a dictionary of the albedo at each area in the specifiec resolution in EPSG:3413 projection. The dictionary strutcture: output[area] = {"x" : x_coordinates, "y" : y_coordinates, "albedo" : albedo} -AVHRR.export_to_tif(polar=None) +AVHRR.export_to_tif(output=None, path='default') ~~~~~~~~~~~~~~~~ Export the processed data to tif files in ESPG:3413 @@ -81,8 +81,42 @@ Export the processed data to tif files in ESPG:3413 The method will not return anything -AVHRR.export_to_csv(polar=None) +AVHRR.export_to_csv(output=None, path='default') ~~~~~~~~~~~~~~~~ -AVHRR.export_to_nc(polar=None) +Export the processed data to csv files in ESPG:3413, the format will be + + +**Parameter: output: dict** + + If None, the exported processed data will come from AVHRR.proc(raw_data=None, area=None, res=2500) with the default inputs. Else, + input the processed data you want to export, the input needs to be a dictionary with this format: + output[area] = {"x" : x_coordinates, "y" : y_coordinates, "albedo" : albedo} + + **path: str** + + if "default", the data will be exported to /output/"yyyymmdd", Else, specify the output folder. + +**Returns:  None** + + The method will not return anything + +AVHRR.export_to_nc(output=None, path='default') ~~~~~~~~~~~~~~~~ + +Export the processed data to netcdf4 files in ESPG:3413, the format will be + + +**Parameter: output: dict** + + If None, the exported processed data will come from AVHRR.proc(raw_data=None, area=None, res=2500) with the default inputs. Else, + input the processed data you want to export, the input needs to be a dictionary with this format: + output[area] = {"x" : x_coordinates, "y" : y_coordinates, "albedo" : albedo} + + **path: str** + + if "default", the data will be exported to /output/"yyyymmdd", Else, specify the output folder. + +**Returns:  None** + + The method will not return anything From dd7f1479d75739209ec574dc476ebcc9b8a36a69 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 12:09:02 +0100 Subject: [PATCH 27/36] Update README.md --- README.md | 52 ++-------------------------------------------------- 1 file changed, 2 insertions(+), 50 deletions(-) diff --git a/README.md b/README.md index 409ef1a..5e990c8 100644 --- a/README.md +++ b/README.md @@ -1,54 +1,6 @@ -https://carra2.readthedocs.io/en/latest/ - - -# Copernicus Arctic Re-Analysis project v2 Python (CARRA2PY). +# Copernicus Arctic Re-Analysis project v2 Python (carra2py). Sentinel-3, MODIS and AVHRR inputs assimilated into a state of the art numerical weather prediction system (HARMONIE) Advanced Very-High-Resolution Radiometer -# CARRA2 Input Module - -## class carra2.AVHRR(date): -### Parameter: date: str -the processed date, only in 'yyyymmdd' format - -### Methods: - -#### AVHRR.get_data(polar=None) - -Import the raw AVHRR data of the northern hempishere in native resolution of 5000 meters. - -#### Parameter: polar: bool, optional -      {if None or False the output will be in a EPSG:4326 projection, if True the output will be in a EPSG:3413 projection.} - -#### Returns:   raw_lon or raw_x: (m,n) array of floats: - -      Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. -####       raw_lat or raw_y: (m,n) array of floats: - -      Latitiude coordinates (EPSG:4326) of raw data if polar == None or False, y cooordinate (EPSG:3413) of raw data if polar == True. - -####       raw_alb: (m,n) array of floats: - -      Raw albedo data in native 5000 meter resolution - - -#### AVHRR.proc(raw_data=None, area=None, res=2500) - -Reproject and Intepolate raw AVHRR data to ESPG:3413 and a better resolution. -The data is also masked to 9 possible search areas in the arctic region - -#### Parameter: raw_data: tuple -      if None, the data for the processing wil come from get_data(), else, the user has tp input the data wants processed. the tuple needs to include (x,y,albedo) in that order, x and y is the data coordinates in EPSG:3413 with shape (m,n). Albedo is the raw albedo data from AVHRR in shape (m,n) - -####       area: str, list of str -      - -####       res: int - - -#### Returns:   data: dict: - -      Longitude coordinates (EPSG:4326) of raw data if polar == None or False, x cooordinates (EPSG:3413) of raw data if polar == True. - - +Documentation: https://carra2.readthedocs.io/en/latest/ From 075d48f361527ca3c1cbf0d9df6fcd897936554e Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 12:10:14 +0100 Subject: [PATCH 28/36] Update README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index 5e990c8..7c82a80 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,5 @@ # Copernicus Arctic Re-Analysis project v2 Python (carra2py). -Sentinel-3, MODIS and AVHRR inputs assimilated into a state of the art numerical weather prediction system (HARMONIE) -Advanced Very-High-Resolution Radiometer +Simple python module to download, reprpject and interpolate albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) Documentation: https://carra2.readthedocs.io/en/latest/ From 1bc7bbcc357a4f370cdb7a19e0df237b9b8eabec Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 12:10:43 +0100 Subject: [PATCH 29/36] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7c82a80..ce22a40 100644 --- a/README.md +++ b/README.md @@ -2,4 +2,4 @@ # Copernicus Arctic Re-Analysis project v2 Python (carra2py). Simple python module to download, reprpject and interpolate albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) -Documentation: https://carra2.readthedocs.io/en/latest/ +Documentation: (https://carra2.readthedocs.io/en/latest/index.html From b9d99259e39b57ee75fe5efb17bdff5468c61c49 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Tue, 17 Jan 2023 12:10:54 +0100 Subject: [PATCH 30/36] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ce22a40..e1453ff 100644 --- a/README.md +++ b/README.md @@ -2,4 +2,4 @@ # Copernicus Arctic Re-Analysis project v2 Python (carra2py). Simple python module to download, reprpject and interpolate albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) -Documentation: (https://carra2.readthedocs.io/en/latest/index.html +Documentation: https://carra2.readthedocs.io/en/latest/index.html From a8faf9824be413e167db8767bf1968271d653325 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Wed, 18 Jan 2023 09:49:15 +0100 Subject: [PATCH 31/36] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e1453ff..6bba8d9 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ # Copernicus Arctic Re-Analysis project v2 Python (carra2py). -Simple python module to download, reprpject and interpolate albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) +Simple python module for downloading, reprojecting and interpolating albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) Documentation: https://carra2.readthedocs.io/en/latest/index.html From 1829f7745ee11c4a6a9986ea4ff733d949d3e904 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Wed, 18 Jan 2023 10:00:34 +0100 Subject: [PATCH 32/36] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6bba8d9..6c91cf1 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ # Copernicus Arctic Re-Analysis project v2 Python (carra2py). -Simple python module for downloading, reprojecting and interpolating albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) +Simple python package for downloading, reprojecting and interpolating albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) Documentation: https://carra2.readthedocs.io/en/latest/index.html From 7aa3203c92001e39329c8f7f9d3adb952c2f9cfa Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Wed, 18 Jan 2023 10:08:15 +0100 Subject: [PATCH 33/36] Update README.md --- README.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6c91cf1..73c5a96 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,10 @@ # Copernicus Arctic Re-Analysis project v2 Python (carra2py). -Simple python package for downloading, reprojecting and interpolating albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2) +Simple python package for downloading, reprojecting and interpolating satellite albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2). +The latest version includes albedo data from the Advanced Very High Respolution Radiometer (AVHRR) satellite borne instrument in the period 1982 - present[1]. Documentation: https://carra2.readthedocs.io/en/latest/index.html + +## Referemces + +[1] Key, Jeffrey; Wang, Xuanji; Liu, Yinghui; and NOAA CDR Program (2019). NOAA Climate Data Record of AVHRR Polar Pathfinder Extended (APP-X), Version 2. [indicate subset used]. NOAA National Centers for Environmental Information. doi:10.25921/AE96-0E57 From 4cac30c72eaa43935bbbcabc61d3398ce36e26fc Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Wed, 18 Jan 2023 10:08:34 +0100 Subject: [PATCH 34/36] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 73c5a96..dc6b4f9 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,6 @@ The latest version includes albedo data from the Advanced Very High Respolution Documentation: https://carra2.readthedocs.io/en/latest/index.html -## Referemces +## References [1] Key, Jeffrey; Wang, Xuanji; Liu, Yinghui; and NOAA CDR Program (2019). NOAA Climate Data Record of AVHRR Polar Pathfinder Extended (APP-X), Version 2. [indicate subset used]. NOAA National Centers for Environmental Information. doi:10.25921/AE96-0E57 From f6ddcac34ad0f2fc0cd4c176aef5a04cfa5d8913 Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Wed, 18 Jan 2023 10:09:15 +0100 Subject: [PATCH 35/36] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index dc6b4f9..67675af 100644 --- a/README.md +++ b/README.md @@ -7,4 +7,4 @@ Documentation: https://carra2.readthedocs.io/en/latest/index.html ## References -[1] Key, Jeffrey; Wang, Xuanji; Liu, Yinghui; and NOAA CDR Program (2019). NOAA Climate Data Record of AVHRR Polar Pathfinder Extended (APP-X), Version 2. [indicate subset used]. NOAA National Centers for Environmental Information. doi:10.25921/AE96-0E57 +[1] Key, Jeffrey; Wang, Xuanji; Liu, Yinghui; and NOAA CDR Program (2019). NOAA Climate Data Record of AVHRR Polar Pathfinder Extended (APP-X), Version 2. NOAA National Centers for Environmental Information. doi:10.25921/AE96-0E57 From a5fe0c071a00f74c478080e465cc98987583506c Mon Sep 17 00:00:00 2001 From: Rasmus Bahbah Nielsen <114926145+RasmusBahbah@users.noreply.github.com> Date: Wed, 18 Jan 2023 10:10:10 +0100 Subject: [PATCH 36/36] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 67675af..5ad27d7 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Copernicus Arctic Re-Analysis project v2 Python (carra2py). -Simple python package for downloading, reprojecting and interpolating satellite albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2). +Simple python package for downloading, reprojecting, masking and interpolating satellite albedo data in the arctic region for the Copernicus Arctic Re-Analysis project v2 (CARRA2). The latest version includes albedo data from the Advanced Very High Respolution Radiometer (AVHRR) satellite borne instrument in the period 1982 - present[1]. Documentation: https://carra2.readthedocs.io/en/latest/index.html