'How to' Library

• Change Detection
• Crop Classification using Pixxel's Fireflies
• Crop Bioparameters
• Water Quality Index
• Image clustering
• Principal Component Analysis

To perform analytics on the FF images, follow the below steps

1. Select the image you want to analyse by searching for its Image ID on the Explore page or by choosing it from the Catalog.

2. Draw the AOI for the required area and click Save. 

3. Click the Insights icon (fourth icon on the right).

4. Select the insight you want to run and choose the saved AOI from the list. 

5. Once the model has finished processing, you will be able to view the results.

Note: Please note that creating the assets and running the insights takes 25 to 45 minutes.

To keep track of the order status and capture attempts, follow the below steps 

1. Click the Order Desk icon (third icon) on the left panel.
2. Open the Placed Orders tab and select the order you want to view.
3. Please note: order status will be available only for orders that are 'In progress'. To understand the statutes, you can check this help article: link

4. Navigate to the Status tab under Task Parameters. 

   

5. Click In Progress to view: Capture attempts | Failure reasons | Capture history | Image thumbnails

   

    

We continuously improve the quality of our imagery by applying processing updates. You can check the latest processing level of any image by following these steps:

1. Open the Catalog (second icon on the left panel).
2. Select the image you want to check.
3. Click the three-dot menu (⋮) and select View More Info.
4. Under Image Info, open the Version tab.

5. The Version tab displays the latest processing level applied to your imagery

   Attaching the documentation for ease of search: Link 

Process: Reach out to the customer success team at support@pixxel.space to activate your demo org.

Here are the following features you can explore:

Order Desk 

1. Work with tokens 
2. Check out the Order Desk parameters
3. Play around with Order desk API 

Aurora 

1. Visualization—Composite, Index, Bands
2. Workflow building with Model Marketplace
3. Insight generation 
4. View Spectral Signature 
5. Split-compare features

You can join an Aurora organization in two ways:

• Using an email invitation
• Joining directly through the Aurora interface

Follow the steps below based on the method available to you.

Option 1: Join via Email Invitation (Recommended)

If you’ve received an invitation email, this is the quickest way to join.

Step 1: Open the Invitation Email
Look for an email that includes an invitation to join an organization.

Step 2: Click “Accept Invitation”
This will automatically redirect you to Aurora.

Step 3: Complete the Joining Process
You’ll be taken to the screen where you can confirm and join the workspace.

Option 2: Join Through the Aurora Interface

If you prefer joining from within Aurora when you already have a workspace, follow these steps:

Step 1: Log in to Aurora
Use your credentials to sign in.

Step 2: Open the Organization Menu
Click on the Organization Logo located at the top-left corner of the dashboard.

Step 3: Select “Create or Join an Organization”
Choose this option from the dropdown.

Step 4: Click “Join”
Confirm that you want to join an existing workspace (same interface as Step 3 in the Email flow).

This guide walks you through the process of creating your Aurora account and setting up your organisation.

1. Visit Aurora

2. Enter the email address you want to register/ Use your google account to sign up

Click Continue with Email

3. Enter the OTP sent to your email ID:

Submit OTP to continue

4. Create Organisation

5. Enter your basic details and create your workspace

On clicking on "Create" you will enter the explore page of Aurora.

1. Visit Aurora

2. Enter the email address you want to register/ Use your google account to sign up

Click Continue with Email

3. Enter the OTP sent to your email ID:

Submit OTP to continue

You will enter the explore page of Aurora.

Pixxel's hyperspectral imaging satellites provide valuable Earth observation data with detailed spectral information. Here's a step-by-step guide on how to explore and access these images through the platform.

Getting Started with Pixxel Constellations

To begin exploring Pixxel's hyperspectral imagery:

1. Navigate to the Explore page on the platform
2. Look for the Heatmap icon in the tools panel on the right side of the screen

3. You can select any one or all satellites simultaneously by checking the corresponding boxes in the Heatmap panel.

Exploring Available Imagery

Once you've selected your preferred satellites:

1. Zoom out to a global view to see all available image locations
2. Red pins on the world map indicate locations where Pixxel imagery is available
3. Each pin represents a specific image capture from one of the Pixxel satellites

Viewing Image Details

To examine a specific image:

1. Click on a red pin of interest on the map
2. The selected area will be displayed with its boundaries outlined.

Accessing Full Image Data

To request access to the full hyperspectral image:

1. On the image preview panel, click the three-dot menu (⋮) and then select “View more information.”

1. Hover over the Image ID field and copy the Image ID from the highlighted value.

2. Share this ID with your contact person at Pixxel to gain access to the full hyperspectral dataset

Pixxel sends essential emails like OTPs, account alerts, and order updates. If you're on a corporate or institutional network, these may get filtered unless whitelisted.

Follow the steps below to whitelist our emails

Step 1: Ask Your IT Team to Whitelist the Following:

Domain to Whitelist:
pixxel.space

IP Address:

• 66.249.80.0/20
• 66.102.0.0/21
• 72.14.192.0/18
• 74.125.0.0/16
• 108.177.8.0/21
• 173.194.0.0/16
• 209.85.128.0/17
• 216.58.192.0/19
• 216.239.32.0/19
• 172.217.0.0/19
• 172.217.32.0/20
• 172.217.128.0/19
• 172.217.160.0/20
• 172.217.192.0/19
• 172.253.56.0/21
• 172.253.112.0/20

Email Addresses to Whitelist:

• @pixxel.space
• @stripe.com
• support@pixxel.space
• no-reply@pixxel.space

If you're using a personal email (like Gmail or Outlook), you may also want to mark Pixxel emails as "Not Spam" and add the above addresses to your contact list.

Step 2: Sign Up on the Pixxel Platform

Once whitelisting is complete:

1. Go to Aurora - Sign up page.
2. Fill out the signup form
3. Enter the OTP sent to your email to log in

Step 3: Check for Emails

If you do not see an email from Pixxel, try the following:

• Check your Spam, Junk, or Promotions folders
• Search your inbox for pixxel.space
• Confirm with your IT team that the domain and email addresses were successfully whitelisted

Why This Is Important

Our platform relies on timely email delivery for user authentication, tasking updates, and satellite capture confirmations. Missing these emails may impact your ability to access your account or monitor your AOIs effectively.

Need Help?

If you're still experiencing issues receiving emails, please contact us at:
support@pixxel.space

We're happy to help you troubleshoot further.

Aurora uses Personal Access Tokens (PATs) to authenticate API requests.

PATs provide secure, user-specific access to Aurora APIs based on your Aurora permissions.

Important: New Service Accounts can no longer be created in Aurora. Existing Service Accounts are being deprecated. If you currently use a Service Account, migrate your integration to a Personal Access Token (PAT).

Before You Begin

To create a PAT, you need:

• An active Aurora account
• Access to an Aurora organization/workspace
• The appropriate permissions for the resources you want to access through the API

Your PAT cannot provide more permissions than your Aurora account already has.

Step 1: Open Personal Access Tokens

Log in to Aurora.

Open your profile/account menu and navigate to Personal Access Tokens.

Here you can view and manage the PATs you have created.

Step 2: Create a Personal Access Token

Select Create Personal Access Token.

Enter a name for your token. We recommend using a descriptive name that identifies the application, integration, or environment where the token will be used.

Examples:

• Development
• Production Integration
• Analytics Script

Step 3: Configure Your Token

Select the appropriate scope for the token.

The scopes available to you depend on your Aurora role and existing permissions.

A PAT cannot grant permissions beyond those already assigned to your Aurora account.

Where applicable, select whether the token should apply to all accessible projects or specific projects.

Tip: Use the minimum permissions required for your integration.

Step 4: Configure Token Expiration

Select an expiration period for your PAT, where available.

We recommend setting an expiration appropriate for the application or integration using the token.

Using an expiration date limits the lifetime of the credential and makes credential management easier.

Step 5: Create and Copy Your PAT

Select Create to generate the token.

Aurora will display the token value.

Copy the token immediately and store it securely.

⚠️ Important: The token value is displayed only once. You cannot view the token again after leaving this screen. If you lose the token, you must revoke it and create a new one.

Step 6: Store Your PAT Securely

Do not:

• Share your PAT with other users.
• Commit it to GitHub or another source-control repository.
• Include it directly in publicly accessible code.
• Send it through unsecured communication channels.

For applications and scripts, store your PAT using an environment variable or secrets manager.

For example:

export AURORA_API_TOKEN="YOUR_PERSONAL_ACCESS_TOKEN"

Step 7: Authenticate an API Request

Use your PAT to authenticate requests to the Aurora API.

Include the PAT in the Authorization header as a Bearer token:

curl -X GET "https://api.pixxel.space/v0/bandsets" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"

Replace YOUR_PERSONAL_ACCESS_TOKEN with the PAT you generated in Aurora.

Step 8: Test Your PAT

You can use the Bandsets endpoint to verify that your authentication is working:

curl -X GET "https://api.pixxel.space/v0/bandsets" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"

If your PAT is valid and has the required permissions, the API should return a successful response.

A successful 200 OK response confirms that your PAT is valid for the requested endpoint.

Troubleshooting

I receive a 401 or 403 response

Check the following:

• Your PAT was copied correctly.
• The Authorization header is correctly configured.
• Your PAT has not expired.
• Your PAT has not been revoked.
• Your Aurora account has permission to access the requested resource.
• The PAT scope is appropriate for the endpoint you're testing.

I lost my PAT

PATs are displayed only once when they are created.

If you no longer have the token value:

1. Go to Personal Access Tokens.
2. Revoke the lost token.
3. Create a new PAT.
4. Update your application or integration with the new token.

I need access to another project

A PAT cannot increase your Aurora permissions.

If you need access to another project, ask your Aurora organization administrator to grant your user account the required access.

Once your permissions have been updated, you can create a PAT with the applicable scope.

Managing Your Personal Access Tokens

From the Personal Access Tokens page, you can:

• Create additional PATs.
• View token metadata, including creation and expiration dates.
• Revoke tokens that are no longer required.
• Replace tokens when credentials need to be rotated.

Revoked and expired tokens can no longer be used to authenticate API requests.

Security Best Practices

For secure API access:

• Use separate PATs for different applications or environments.
• Use expiration dates where appropriate.
• Store PATs in environment variables or a secrets manager.
• Never commit PATs to source control.
• Revoke a PAT immediately if you believe it has been exposed.
• Rotate credentials periodically.

This guide walks you through the process of switching organizations in your Aurora dashboard.

1. Visit Aurora.

2. Click the top-left icon to view all organizations linked to your account.

3. Select any organization that you would like to work with. 

To view the available subscription plans in Aurora:

1. Click on your email address in the top-left corner of the screen to open the dropdown menu

Select "Organization settings"

2. In the left sidebar menu, click on "Plans"

Alternatively
Click on the upgrade Icon on the left

Here you'll find three subscription tiers:

• Standard Plan 
• Professional Plan - Includes Analytics and 150 free tokens
• Enterprise Plan  - Includes Advanced features and 300 free tokens

Each paid plan offers monthly and yearly billing options, with a 10% discount when you choose annual billing.

For more information about billing and invoices, you can contact support@pixxel.space

Note: Both Professional and Enterprise plans include a 30-day free trial period and unlimited wallet recharge options.

1 min Video Tutorial -

What are tokens:

Tokens are Pixxel's virtual currency used to purchase imagery, perform visualisations, and create workflows on the Aurora platform.

Note: 1$- 1 Token

Checking and adding tokens:

Checking Token Balance

1. Navigate to "Tokens" in the organisation menu

Your available tokens are displayed prominently with a pink diamond icon and a numerical value next to it

Adding New Tokens

Click the "Add tokens" button in the top right of the Tokens page

Select the desired quantity (starts at $1.00)

Once the payment is completed, the tokens will reflect on the token section.

In this guide, you'll learn how to view and manage your billing information and invoices.

Accessing Billing Information

1. Navigate to "Organization" in the sidebar

2. Select "Billing" from the menu options

3. View your billing dashboard

4. Click on "View Invoice"

Note: The invoice number is present here. Choose between downloading the invoice or downloading the receipt.

Note: For additional support or questions, contact support@pixxel.space

1. To navigate the 'Explore' page, please click on this link.
2. To learn how to search a specific location and draw/upload an AOI, please click on this link  
3. To learn how to search and select imagery, please click on this link
4. To learn how to navigate AOI info and available scenes, please click on this link
    

In this guide, you'll learn how to upload Area of Interest (AOI) files to visualize and analyze specific geographic regions in our platform.

How to Upload Files

1. Navigate to the "Explore" section

2. Click the "Upload AOI" button in the top right corner

Note: Supported File Formats The platform accepts the following file formats:

• GeoJSON
• KML
• KMZ
• Zipped SHP files
• Single SHP files

You will receive an error like this if you upload the wrong file:

3. Select your file from your local system

4. Wait for the file to process and appear on the map

Note: When defining your Area of Interest (AOI), keep in mind the following size restrictions:

• Maximum AOI size is 5000 km²
• Attempting to exceed this limit will trigger an "Area Limit Reached!" warning
• You will need to either:
  • Reduce your selected area to stay within limits
  • Click "Upgrade Plan" for larger area analysis capabilities
• AOI with holes (donuts) are not supported.
• Only WGS84 [EPSG:4326] projection is supported