Release v2.0.1-beta

GeoscienceAustralia · Jun 9, 2023 · 38eb615 · 38eb615
1 parent 8ef7616
commit 38eb615
Show file tree

Hide file tree

Showing 229 changed files with 6,708 additions and 8,764 deletions.
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
diff --git a/.gitignore b/.gitignore
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,10 +3,18 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
-# [2.0.0] 2023-05-18
+# [2.0.1] 2023-06-09
 ### Added
 ### Changed
-Many changes for v2.0, will be fully documented with v2.1 ...
+Unified User and Network operation modes (One Observation Model & Filter)
+More GNSS constellations – Full Multi-Constellation capability (Ex SBAS)
+Better internal frequency indexing (complete Multi-Frequency capability)
+UnDifferenced / UnCombined (UDUC) processing (v1 was Combined IF only)
+CPP integrated and coupled Precise Orbit Determination (POD) capability
+More robust data handling in filter cycle slip and outlier detection and removal
+Complete RTCM3 phase 1 and Phase 2 message decoding and encoding
+SLR data handling fully implemented
+Model & Performance improvements
 ### Fixed
 ### Deprecated
 ### Removed

diff --git a/Docs/GinanEDA_AWS_EC2_Instruction_v1.1.txt b/Docs/GinanEDA_AWS_EC2_Instruction_v1.1.txt
@@ -0,0 +1,131 @@
+=== Instructions to setup GinanEDA with AWS EC2 server ===
+	Modified from Mark's (Ron's) and Simon's (DM via Discord) instructions
+
+
+=== 1st time only ===
+
+1. Create a key pair using EC2
+	Go to https://console.aws.amazon.com/ec2/
+	Go to 'Key Pairs' (under left pane, 'Network & Security')
+	'Create key pair' (top right, orange)
+		Name: your choice
+		Key pair type: 'RSA'
+		Private key file format: '.pem'
+		'Create key pair'
+	The private key (.pem file) will download locally through your browser - save this somewhere safe (e.g. ~/.ssh/mark_isg.pem)
+
+
+2. Get public key
+	Open a terminal on your local machine:
+	$ cd ~/.ssh
+	$ chmod 600 mark_isg.pem
+	$ ssh-keygen -y -f mark_isg.pem > mark_isg.pub
+	$ cat mark_isg.pub
+	^ This is your public key
+	Note: do not move the private key to a Windows partition (if you are on WSL) as the permissions will be altered so that the connection cannot be established
+
+
+
+=== For each server ===
+
+3. On the EC2 instance, append your public key to ~/.ssh/authorized_keys
+	$ vim ~/.ssh/authorized_keys
+
+
+
+4. Change security settings for the EC2 instance
+	Go to https://console.aws.amazon.com/ec2/
+	Go to 'Security Groups' (under left pane, 'Network & Security')
+	Search for the name of your EC2 server
+	'Inbound rules', 'Edit inbound rules'
+	'Add rule'
+		Type: SSH
+		Source: Anywhere-IPv4
+		'Save rules'
+	Note: need to double check 'Inbound rules' to make sure the added rule is saved
+
+5. Find the EC2's Public DNS
+	Go to https://ap-southeast-2.console.aws.amazon.com/cloud9/home#
+	Select the server, click 'View details', 'Go To Instance'
+	Click the Instance ID link (blue text)
+	Copy the Public IPv4 DNS (e.g. "ec2-13-55-168-85.ap-southeast-2.compute.amazonaws.com")
+	Note: this will change each time the server shuts down. To avoid this, see section on elastic IPs below
+
+
+
+=== On local machine - 1st time only ===
+
+6. SSH into the EC2 instance
+	Make sure you can SSH from your local machine into your EC2 instance:
+	$ ssh -i "~/.ssh/mark_isg.pem" [email protected]
+	For elastic IPs:
+	$ ssh -i "~/.ssh/mark_isg.pem" [email protected]
+	Once you know you can access your server, just exit SSH:
+	$ exit
+
+
+=== every time you use ===
+
+7. Create a tunnel between the remote and local machines
+	On your local machine, create a tunnel for port 8080 on the remote machine to 8081 on the local machine:
+	$ ssh -fN -i ~/.ssh/mark_isg.pem -L 8081:localhost:8080 [email protected]
+	For elastic IPs:
+	$ ssh -fN -i ~/.ssh/mark_isg.pem -L 8081:localhost:8080 [email protected]
+	Note: you don't have to run this command again during a short period of time
+
+
+8. SSH into your EC2 instance from your local machine (see step 6)
+
+
+9. Start the EDA on your remote machine via SSH
+	Run scripts/GinanEDA/index.py under your Ginan directory 
+	$ python3 /data/acs/ginan/scripts/GinanEDA/index.py
+	Note: you may need to 'pip3 install' some of the dependencies for the first time, just follow the prompts shown on the terminal
+
+
+10. View the EDA on a web browser
+	On you local machine, open a browser and go to http://127.0.0.1:8081/dbinfo
+	Now you can run your test and view the results with GinanEDA on a web browser
+
+
+
+=== Optional ===
+
+11. Create / re-use an elastic IP & associate with EC2 instance
+	Go to https://ap-southeast-2.console.aws.amazon.com/ec2/v2/home?region=ap-southeast-2#Addresses
+	'Allocate Elastic IP Address' (top right, orange)
+		'Allocate'
+		Copy down the allocated IP address
+	'Actions' (top right), 'Associate Elastic IP address'
+		Resource type: 'Instance'
+		Instance: search for the name of your EC2 server
+		'Associate'
+	This IP address can now be used instead of the Public DNS
+
+
+12. Find the EC2's elastic IP address
+	Go to https://ap-southeast-2.console.aws.amazon.com/cloud9/home#
+	Select the server, click 'View details', 'Go To Instance'
+	Click the Instance ID link (blue text)
+	Copy the Public IPv4 address (e.g. "13.55.168.85")
+
+
+13. Establish a tunnel between the remote and local machines automatically with an elastic IP
+	On your local machine, check your .bashrc file and verify it sources ~/.bash_aliases
+	$ vim ~/.bashrc
+	Check if following lines exist
+
+if [ -f ~/.bash_aliases ]; then
+    . ~/.bash_aliases
+fi
+
+	If not, add them to your .bashrc file
+	Create .bash_aliases if it does not exist under your home directory
+	$ touch ~/.bash_aliases
+	Add the command line in step 7 to .bash_aliases, i.e.
+
+ssh -fN -i ~/.ssh/mark_isg.pem -L 8081:localhost:8080 [email protected]
+
+	Now every time you open your terminal on your local machine, the tunnel will be established automatically
+	Note: you may need to switch to non-login shell if you use WSL:
+	$ bash
diff --git a/Docs/css/general.css b/Docs/css/general.css
@@ -48,6 +48,15 @@ img.image-fluid {
     scroll-margin-top: 100px;
       margin-top: 1rem;
   }
+
+  h6
+  {
+    display:inline;
+  }
+  h6+p
+  {
+    display:inline;
+  }
   img
   {
 

diff --git a/Docs/favicons/apple-touch-icon-114x114.png b/Docs/favicons/apple-touch-icon-114x114.png
diff --git a/Docs/favicons/apple-touch-icon-120x120.png b/Docs/favicons/apple-touch-icon-120x120.png
diff --git a/Docs/favicons/apple-touch-icon-144x144.png b/Docs/favicons/apple-touch-icon-144x144.png
diff --git a/Docs/favicons/apple-touch-icon-152x152.png b/Docs/favicons/apple-touch-icon-152x152.png
diff --git a/Docs/favicons/apple-touch-icon-57x57.png b/Docs/favicons/apple-touch-icon-57x57.png
diff --git a/Docs/favicons/apple-touch-icon-60x60.png b/Docs/favicons/apple-touch-icon-60x60.png
diff --git a/Docs/favicons/apple-touch-icon-72x72.png b/Docs/favicons/apple-touch-icon-72x72.png
diff --git a/Docs/favicons/apple-touch-icon-76x76.png b/Docs/favicons/apple-touch-icon-76x76.png
diff --git a/Docs/favicons/favicon-128.png b/Docs/favicons/favicon-128.png
diff --git a/Docs/favicons/favicon-16x16.png b/Docs/favicons/favicon-16x16.png
diff --git a/Docs/favicons/favicon-196x196.png b/Docs/favicons/favicon-196x196.png
diff --git a/Docs/favicons/favicon-32x32.png b/Docs/favicons/favicon-32x32.png
diff --git a/Docs/favicons/favicon-96x96.png b/Docs/favicons/favicon-96x96.png
diff --git a/Docs/favicons/mstile-144x144.png b/Docs/favicons/mstile-144x144.png
diff --git a/Docs/favicons/mstile-150x150.png b/Docs/favicons/mstile-150x150.png
diff --git a/Docs/favicons/mstile-310x150.png b/Docs/favicons/mstile-310x150.png
diff --git a/Docs/favicons/mstile-310x310.png b/Docs/favicons/mstile-310x310.png
diff --git a/Docs/favicons/mstile-70x70.png b/Docs/favicons/mstile-70x70.png
diff --git a/Docs/images/Atmosphere-75pc.png b/Docs/images/Atmosphere-75pc.png
diff --git a/Docs/images/BasicPosCalcs-75pcv01.png b/Docs/images/BasicPosCalcs-75pcv01.png
diff --git a/Docs/images/CORSNetwork-75pc.png b/Docs/images/CORSNetwork-75pc.png
diff --git a/Docs/images/CalculateAPosition-75pc.png b/Docs/images/CalculateAPosition-75pc.png
diff --git a/Docs/images/DefiningOrbitPosition-75pc.png b/Docs/images/DefiningOrbitPosition-75pc.png
diff --git a/Docs/images/GNSSComponents1-75pc.png b/Docs/images/GNSSComponents1-75pc.png
diff --git a/Docs/images/GNSSConstellations-75pc.png b/Docs/images/GNSSConstellations-75pc.png
diff --git a/Docs/images/GNSSFrontSlide20210618v01.png b/Docs/images/GNSSFrontSlide20210618v01.png
diff --git a/Docs/images/GNSSLandscapeMiniv05.png b/Docs/images/GNSSLandscapeMiniv05.png
diff --git a/Docs/images/GNSSPositions-75pc.png b/Docs/images/GNSSPositions-75pc.png
diff --git a/Docs/images/GNSSSatelliteInSpace-75pc.png b/Docs/images/GNSSSatelliteInSpace-75pc.png
diff --git a/Docs/images/GPS_signal_modulation_scheme.png b/Docs/images/GPS_signal_modulation_scheme.png
diff --git a/Docs/images/Galileo_Space_Segment-16pc.png b/Docs/images/Galileo_Space_Segment-16pc.png
diff --git a/Docs/images/GinanLogo273.png b/Docs/images/GinanLogo273.png
diff --git a/Docs/images/GinanLogo60.png b/Docs/images/GinanLogo60.png
diff --git a/Docs/images/GinanLogo819.png b/Docs/images/GinanLogo819.png
diff --git a/Docs/images/GinanLogo91.png b/Docs/images/GinanLogo91.png
diff --git a/Docs/images/GinanProjectOverviewFrontSlide20210902v01.png b/Docs/images/GinanProjectOverviewFrontSlide20210902v01.png
diff --git a/Docs/images/GinanTechnologyFrontSlide20210902v01.png b/Docs/images/GinanTechnologyFrontSlide20210902v01.png
diff --git a/Docs/images/ICRF-75pc.png b/Docs/images/ICRF-75pc.png
diff --git a/Docs/images/ITRF-75pc.png b/Docs/images/ITRF-75pc.png
diff --git a/Docs/images/LatLongH-75pc.png b/Docs/images/LatLongH-75pc.png
diff --git a/Docs/images/LibraryBooksStrip.png b/Docs/images/LibraryBooksStrip.png
diff --git a/Docs/images/Multipath-780px.png b/Docs/images/Multipath-780px.png
diff --git a/Docs/images/PALogoB.png b/Docs/images/PALogoB.png
diff --git a/Docs/images/PPPFrontSlide20210625v01.png b/Docs/images/PPPFrontSlide20210625v01.png
diff --git a/Docs/images/PositionOnEarth-75pc.png b/Docs/images/PositionOnEarth-75pc.png
diff --git a/Docs/images/Pseudorange-75pc.png b/Docs/images/Pseudorange-75pc.png
diff --git a/Docs/images/RTKDGNSS-75pc.png b/Docs/images/RTKDGNSS-75pc.png
diff --git a/Docs/images/ReferenceFramesFrontSlide20210618v01.png b/Docs/images/ReferenceFramesFrontSlide20210618v01.png
diff --git a/Docs/images/SP3-dQuickReferenceFrontSlidev01.png b/Docs/images/SP3-dQuickReferenceFrontSlidev01.png
diff --git a/Docs/images/SPSFrontSlide20210623v01.png b/Docs/images/SPSFrontSlide20210623v01.png
diff --git a/Docs/images/SouthernCross.png b/Docs/images/SouthernCross.png
diff --git a/Docs/images/SpeedOfLight-75pc.png b/Docs/images/SpeedOfLight-75pc.png
diff --git a/Docs/images/WardamanCountry.png b/Docs/images/WardamanCountry.png
diff --git a/Docs/images/www-959px.png b/Docs/images/www-959px.png