การติดตั้ง Python - การติดตั้ง Conda


คุณติดตั้ง Earth Engine Python API ลงในเครื่องได้ผ่าน conda ซึ่งเป็นเครื่องมือจัดการแพ็กเกจและสภาพแวดล้อมของ Python Conda จะรวมอยู่ในชุดค่าผสมของ Anaconda และ Miniconda สำหรับการแจกจ่าย Python Anaconda เป็นแพลตฟอร์มการเขียนโปรแกรมด้านวิทยาศาสตร์ข้อมูลที่มีแพ็กเกจมากกว่า 1, 500 รายการ ส่วน Miniconda มีเพียง conda และแพ็กเกจที่ต้องพึ่งพาเท่านั้น ดิสทริบิวชัน Python เหล่านี้เหมาะสำหรับการติดตั้งและใช้งาน Earth Engine API หากคุณไม่คุ้นเคยกับระบบปฏิบัติการเหล่านี้ โปรดไปที่ลิงก์ของผลิตภัณฑ์เพื่อดูข้อมูลเพิ่มเติม

คู่มือนี้จะแนะนำคุณเกี่ยวกับสิ่งต่อไปนี้

  • ตรวจสอบการติดตั้ง conda ที่มีอยู่
  • การติดตั้ง conda ในเครื่อง
  • การติดตั้ง Earth Engine Python API
  • การตั้งค่าข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์
  • การทดสอบ API

ตรวจสอบการติดตั้ง conda

หากติดตั้ง conda ในระบบแล้ว ให้ข้ามไปที่ส่วนติดตั้ง API หากไม่แน่ใจว่าได้ติดตั้ง conda ไว้หรือไม่ ให้ยืนยันโดยป้อนคำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

conda --help

หากติดตั้ง conda แล้วและระบบได้ลงทะเบียนเส้นทางของระบบในตัวแปรสภาพแวดล้อม PATH เนื้อหาความช่วยเหลือของ conda ควรปรากฏในเทอร์มินัล หากเนื้อหาความช่วยเหลือปรากฏขึ้น ให้ข้ามไปที่ส่วนติดตั้ง API หากระบบไม่รู้จัก conda ผลลัพธ์จะแสดงเป็นข้อความประมาณว่าไม่พบ conda หรือระบบไม่รู้จักว่าเป็นคำสั่ง เป็นไปได้ว่าโปรแกรมจะอยู่ในระบบของคุณแต่ไม่ได้รับการลงทะเบียนในตัวแปรสภาพแวดล้อม PATH แม้ว่าจะเป็นเช่นนั้น แต่เพื่อความสอดคล้องกัน โปรดดำเนินการต่อในส่วนติดตั้ง conda เนื่องจากเราไม่สามารถแก้ไขการกำหนดค่าระบบที่เป็นไปได้ทั้งหมด ตราบใดที่โฟลเดอร์ "miniconda3" ไม่มีอยู่ในโฟลเดอร์หน้าแรก วิธีการติดตั้ง conda ต่อไปนี้จะสำเร็จ ดูข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่งการติดตั้งและลงทะเบียน conda ได้ที่หน้าการติดตั้ง Miniconda และการติดตั้ง Anaconda

ติดตั้ง conda

ในส่วนนี้ คุณจะดาวน์โหลดและติดตั้ง Miniconda ซึ่งจะทำหน้าที่เป็นแพลตฟอร์ม Python ในการเข้าถึง Earth Engine API ดังที่อธิบายไว้ข้างต้น คุณสามารถใช้ Miniconda หรือ Anaconda แต่เพื่อลดผลกระทบต่อระบบ คู่มือนี้จะอธิบายการติดตั้ง Miniconda โดยไม่มีการเปลี่ยนแปลงตัวแปรสภาพแวดล้อมของระบบ หากต้องการใช้ Anaconda โปรดดูวิธีการติดตั้งที่ระบุไว้ที่นี่ แล้วข้ามไปที่ส่วนติดตั้ง API

ติดตั้ง Miniconda

การดาวน์โหลดและติดตั้ง Miniconda ทําได้ 3 ขั้นตอนดังนี้

  1. ดาวน์โหลดโปรแกรมติดตั้ง Miniconda สำหรับ Python 3 เวอร์ชัน 64 บิตลงในไดเรกทอรีหน้าแรก
  2. เรียกใช้โปรแกรมติดตั้ง
  3. ลบโปรแกรมติดตั้ง

ทําตามขั้นตอนเหล่านี้โดยคัดลอกและวางบรรทัดต่อไปนี้ลงในอินเทอร์เฟซบรรทัดคําสั่งที่เหมาะสมสําหรับระบบของคุณ การติดตั้งจะเพิ่มโฟลเดอร์ชื่อ "miniconda3" ลงในไดเรกทอรีหน้าแรก

1. ดาวน์โหลดโปรแกรมติดตั้ง Miniconda ลงในไดเรกทอรีหน้าแรก

Linux

wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh

Mac

curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh

Windows

powershell -command "Invoke-WebRequest -Uri https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"

2. ติดตั้ง Miniconda โดยอัตโนมัติโดยยอมรับค่าเริ่มต้นในไดเรกทอรีหน้าแรก

Linux

bash ~/miniconda.sh -b

Mac

bash ~/miniconda.sh -b

Windows

start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3

3. นำโปรแกรมติดตั้ง Miniconda ออกจากไดเรกทอรีหน้าแรก

Linux

rm ~/miniconda.sh

Mac

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

ทดสอบการติดตั้ง Miniconda

พิมพ์เมนูความช่วยเหลือของคำสั่ง conda เพื่อทดสอบการติดตั้ง Miniconda เนื่องจากยังไม่ได้เพิ่ม Miniconda ลงในตัวแปรสภาพแวดล้อม PATH ของระบบ คุณจึงต้องเปิดใช้งาน conda สำหรับเซสชันนี้ก่อนโดยเรียกใช้คำสั่ง activate ตามเส้นทางระบบแบบเต็ม การทดสอบที่สำเร็จจะส่งผลให้เนื้อหาความช่วยเหลือของ conda ปรากฏในเทอร์มินัล เรียกใช้บรรทัดต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่งของระบบ

Linux

source $HOME/miniconda3/bin/activate
conda --help

Mac

source $HOME/miniconda3/bin/activate
conda --help

Windows

%UserProfile%\miniconda3\condabin\activate
conda --help

เพิ่ม Miniconda ลงในตัวแปร PATH

คุณอาจเพิ่มเส้นทางการติดตั้ง Miniconda ลงในตัวแปร PATH ของระบบได้ ซึ่งจะช่วยให้คุณโต้ตอบกับ conda ได้โดยเรียกใช้ conda ง่ายๆ โดยไม่ต้องเรียกใช้คำสั่ง activate ด้วยเส้นทางแบบเต็มก่อน วิธีการต่อไปนี้จะอธิบายการเพิ่มการติดตั้ง Miniconda ลงในตัวแปร PATH ของระบบ

Linux

เพิ่มเส้นทางต่อไปนี้ลงในตัวแปรสภาพแวดล้อม "PATH" โดยทําตามวิธีการ GUI หรือบรรทัดคําสั่งด้านล่าง

$HOME/miniconda3/bin

GUI

1. เปิดไฟล์ .bashrc ที่พบในไดเรกทอรี $HOME ในเครื่องมือแก้ไขข้อความ

xdg-open ~/.bashrc

2. คัดลอกและวางบรรทัดต่อไปนี้ที่ด้านล่างของไฟล์

# add path to conda
export PATH="$HOME/miniconda3/bin:$PATH"

3. บันทึกไฟล์และปิดเครื่องมือแก้ไขข้อความ

บรรทัดคำสั่ง

ป้อนคำสั่งต่อไปนี้ในเทอร์มินัลเพื่อเพิ่มเส้นทาง conda ต่อท้ายไฟล์ ~/.bashrc

printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc

Mac

เพิ่มเส้นทางต่อไปนี้ลงในตัวแปรสภาพแวดล้อม "PATH" โดยทําตามวิธีการ GUI หรือบรรทัดคําสั่งด้านล่าง

$HOME/miniconda3/bin

GUI

1. เปิดไฟล์ .bashrc ที่พบในไดเรกทอรี $HOME ในเครื่องมือแก้ไขข้อความ

touch ~/.bashrc; open -t ~/.bashrc

2. คัดลอกและวางบรรทัดต่อไปนี้ที่ด้านล่างของไฟล์

# add path to conda
export PATH="$HOME/miniconda3/bin:$PATH"

3. บันทึกไฟล์และปิดเครื่องมือแก้ไขข้อความ

บรรทัดคำสั่ง

ป้อนคำสั่งต่อไปนี้ในเทอร์มินัลเพื่อเพิ่มเส้นทาง conda ต่อท้ายไฟล์ ~/.bashrc

printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc

Windows

เพิ่มเส้นทางต่อไปนี้ลงในตัวแปรสภาพแวดล้อม "Path" โดยทำตามวิธีการ GUI หรือบรรทัดคำสั่งด้านล่าง

%UserProfile%\miniconda3\condabin

GUI

1. ป้อนบรรทัดต่อไปนี้ใน Command Prompt เพื่อเปิดกล่องโต้ตอบ "ตัวแปรสภาพแวดล้อม"

rundll32 sysdm.cpl,EditEnvironmentVariables

2. ดับเบิลคลิกตัวแปร "Path" ในส่วน "ผู้ใช้" เพื่อเลือกตัวแปรดังกล่าวสำหรับการแก้ไข

3. คลิกปุ่ม "แก้ไขข้อความ" ในหน้าต่างโต้ตอบ "แก้ไข" ใหม่เพื่อเปิดเครื่องมือแก้ไข

4. เพิ่มสตริงต่อไปนี้ที่ส่วนท้ายของค่าตัวแปร "Path" ที่มีอยู่ ตรวจสอบว่ามีเซมิโคลอน (;) อยู่รอบๆ รายการเพื่อแยกรายการนั้นออกจากรายการข้างเคียง

%UserProfile%\miniconda3\condabin;

5. คลิกปุ่ม "ตกลง" จนกว่าหน้าต่างโต้ตอบทั้งหมดจะปิดลง

บรรทัดคำสั่ง

ใช้คําสั่ง setx เพื่อเพิ่มเส้นทางต่อท้าย จาก Command Prompt ให้ป้อนข้อมูลต่อไปนี้

setx Path "%Path%%UserProfile%\miniconda3\condabin;"

เริ่มต้น conda

เริ่มต้น conda สำหรับการโต้ตอบกับเชลล์ เรียกใช้คำสั่งต่อไปนี้เพื่อดูข้อมูลเกี่ยวกับการเริ่มต้นใช้งานเชลล์ต่างๆ ทำตามวิธีการต่อๆ ไปซึ่งพิมพ์ลงในคอนโซลเมื่อป้อนคําสั่ง

conda init --help

หลังจากรีสตาร์ทอินเทอร์เฟซบรรทัดคำสั่งแล้ว คุณควรเปิดใช้งานสภาพแวดล้อม Conda พื้นฐานได้ด้วยคำสั่งต่อไปนี้

conda activate

ติดตั้ง API

Earth Engine Python API จะเผยแพร่เป็นแพ็กเกจ conda-forge ที่ https://anaconda.org/conda-forge/earthengine-api โดยติดตั้งด้วยคำสั่ง conda install อย่างไรก็ตาม ก่อนติดตั้ง ให้สร้างสภาพแวดล้อม conda สำหรับ Earth Engine โดยเฉพาะ การติดตั้ง Earth Engine API ลงในสภาพแวดล้อมของตัวเองจะช่วยให้มั่นใจได้ว่า API และแพ็กเกจที่เกี่ยวข้องจะไม่ก่อให้เกิดปัญหาเกี่ยวกับเวอร์ชันของสภาพแวดล้อมฐานหรือสภาพแวดล้อมอื่นๆ ที่คุณตั้งค่าไว้ก่อนหน้านี้ และในทางกลับกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการสภาพแวดล้อม Conda ได้ที่เว็บไซต์นี้

1. เปิดใช้งานสภาพแวดล้อม conda พื้นฐาน หากยังไม่ได้ดำเนินการ

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. สร้างสภาพแวดล้อมเสมือนของ conda สําหรับ Earth Engine API

conda create --name ee

ระบบจะขอให้คุณยืนยันการสร้างสภาพแวดล้อม ให้ดำเนินการดังกล่าว

3. เปิดใช้งานสภาพแวดล้อม conda ee

conda activate ee

4. ติดตั้ง API ในสภาพแวดล้อม conda ee ตรวจสอบว่า (ee) ปรากฏขึ้นที่จุดเริ่มต้นของบรรทัดคำสั่ง ซึ่งบ่งบอกว่าคุณกําลังทํางานจากสภาพแวดล้อม ee

conda install -c conda-forge earthengine-api

ระบบจะขอให้คุณยืนยันการติดตั้ง API และข้อกําหนดเบื้องต้น หลังจากยืนยันแล้ว conda จะดาวน์โหลดและติดตั้งข้อกำหนด หากทุกอย่างเรียบร้อยดี ตอนนี้คุณจะมีสภาพแวดล้อม conda ที่ชื่อ "ee" พร้อมข้อกําหนดทั้งหมดในการเข้าถึง API รวมถึงearthengine เครื่องมือบรรทัดคําสั่ง

รับข้อมูลเข้าสู่ระบบ

ก่อนใช้ Earth Engine API หรือเครื่องมือบรรทัดคำสั่ง earthengine คุณต้องดำเนินการตรวจสอบสิทธิ์แบบครั้งเดียวเพื่ออนุญาตให้เข้าถึง Earth Engine ในนามของบัญชี Google หากต้องการตรวจสอบสิทธิ์ ให้ใช้คำสั่ง authenticate จากเครื่องมือบรรทัดคำสั่ง earthengine

ในสภาพแวดล้อม conda ee ให้เรียกใช้คำสั่งต่อไปนี้และทำตามวิธีการที่พิมพ์ออกมา ระบบจะระบุ URL ที่สร้างรหัสการให้สิทธิ์เมื่อมีการตกลง คัดลอกรหัสการให้สิทธิ์และป้อนเป็นอินพุตบรรทัดคำสั่ง

earthengine authenticate

เมื่อป้อนรหัสการให้สิทธิ์ ระบบจะบันทึกโทเค็นการให้สิทธิ์ลงในไฟล์ข้อมูลเข้าสู่ระบบซึ่งดูได้ที่ด้านล่าง การใช้คำสั่ง ee.Initialize() ของ API และเครื่องมือบรรทัดคำสั่ง earthengine ในภายหลังจะค้นหาไฟล์นี้เพื่อตรวจสอบสิทธิ์ หากต้องการเพิกถอนการให้สิทธิ์ ให้ลบไฟล์ข้อมูลเข้าสู่ระบบ

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

การทดสอบ API

เรียกใช้สคริปต์ Python ง่ายๆ ที่พิมพ์ข้อมูลเมตาสำหรับชุดข้อมูล DEM เพื่อทดสอบการติดตั้ง API ซึ่งควรพิมพ์ออบเจ็กต์ JSON ไปยังคอนโซล

1. เริ่มโปรแกรมแปลภาษา python จากสภาพแวดล้อม conda ee

python

2. เรียกใช้บรรทัด Python ต่อไปนี้ทีละรายการเพื่อพิมพ์ข้อมูลเมตาของชุดข้อมูล DEM

import ee

# Initialize the Earth Engine module.
ee.Initialize()

# Print metadata for a DEM dataset.
print(ee.Image('USGS/SRTMGL1_003').getInfo())

การใช้ API ในภายหลัง

เมื่อใดก็ตามที่ต้องการใช้ Earth Engine API คุณต้องเปิดใช้งานสภาพแวดล้อม ee ของ conda ก่อน ขั้นตอนการเปิดใช้งานจะขึ้นอยู่กับว่า conda ได้ลงทะเบียนเพื่อใช้ในเชลล์หรือไม่ ทําตามวิธีการที่เกี่ยวข้องกับการติดตั้ง conda ด้านล่าง

Conda ไม่ได้ลงทะเบียน

คำสั่งเปิดใช้งานสภาพแวดล้อม ee ของ conda ต่อไปนี้จะถือว่ามีการติดตั้ง conda ตามวิธีการในส่วนติดตั้ง conda ด้านบน กล่าวคือ ระบบจะถือว่าเส้นทางการติดตั้งนั้นอิงตามขั้นตอนก่อนหน้า เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

Linux

source $HOME/miniconda3/bin/activate ee

Mac

source $HOME/miniconda3/bin/activate ee

Windows

%UserProfile%\miniconda3\condabin\activate ee

Conda ลงทะเบียนแล้ว

คำสั่งเปิดใช้งานสภาพแวดล้อม ee ของ conda ต่อไปนี้จะถือว่ามีการลงทะเบียน conda เพื่อใช้ในเชลล์หรือ Command Prompt ตามวิธีการในคู่มือนี้หรือด้วยวิธีอื่นๆ เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

conda activate ee

หลังจากเรียกใช้คําสั่งแล้ว คุณควรเห็น (ee) ที่ตอนต้นของบรรทัดคําสั่ง ซึ่งบ่งบอกว่าคุณกําลังทํางานจากสภาพแวดล้อม ee

ตอนนี้คุณพร้อมที่จะเริ่มโปรแกรมล่าม Python และเข้าถึง Earth Engine Python API แล้ว โปรดดูคำแนะนำทั่วไปเกี่ยวกับการใช้งาน Python API ในหน้าการติดตั้ง Python

การอัปเดต API

ใช้คำสั่ง conda update เพื่ออัปเดตสภาพแวดล้อม ee เป็น API เวอร์ชันล่าสุด อย่าลืมเปิดใช้งานสภาพแวดล้อม ee ของ conda ก่อน หากยังไม่ได้เปิดใช้งาน

conda update -c conda-forge earthengine-api

รับหมายเลขเวอร์ชันที่ติดตั้งอยู่ในขณะนี้ใน Python โดยการพิมพ์พร็อพเพอร์ตี้ ee library __version__ เริ่มโปรแกรมล่าม Python โดยป้อน python ในบรรทัดคำสั่งของสภาพแวดล้อม conda ee แล้วป้อนคำสั่งต่อไปนี้

import ee
print(ee.__version__)

การแชร์สภาพแวดล้อม ee

การแชร์สภาพแวดล้อม Python ของ conda กับผู้อื่นอาจเป็นประโยชน์เพื่อให้ได้ผลลัพธ์ที่ซ้ำกันและทำซ้ำได้ โดยเฉพาะเมื่อคุณติดตั้งแพ็กเกจ Python เพิ่มเติม Conda เป็นวิธีที่สะดวกสำหรับบุคคลอื่นในการจำลองสภาพแวดล้อมของคุณ

จากสภาพแวดล้อม conda ee ให้เรียกใช้คำสั่งต่อไปนี้เพื่อบันทึกไฟล์ YAML ชื่อ "ee-shared-env" ลงในไดเรกทอรีหลัก ซึ่งจะแสดงข้อกำหนดของสภาพแวดล้อม

Linux

conda env export > $HOME/ee-shared-env.yml

Mac

conda env export > $HOME/ee-shared-env.yml

Windows

conda env export > %UserProfile%\ee-shared-env.yml

แชร์ไฟล์ที่ได้ แล้วผู้รับจะจำลองสภาพแวดล้อมได้ด้วยการเรียกใช้คำสั่ง conda ต่อไปนี้

conda env create -f path-to-ee-shared-env.yml