Sunnyportal py

Sunnyportal-py

وحدة Python للوصول إلى الأنظمة الكهروضوئية في Sunny Portal.

Sunnyportal2pvoutput

يمكن استخدام البرنامج النصي Sunnyportal2pvoutput لإرسال البيانات إلى PVOutput. ويستخدم ملف تكوين لتخزين بيانات الاعتماد الخاصة بـ Sunny Portal ومفتاح API ومعرف النظام لـ PVOutput.

كيفية الجري

1. استنساخ أو تنزيل المستودع.
2. أدخل الدليل وقم بتشغيل: PYTHONPATH=. ./bin/sunnyportal2pvoutput --dry-run sunnyportal.config
3. أدخل المعلومات المطلوبة وتأكد من أن البرنامج النصي قادر على الاتصال بـ Sunny Portal.
4. يتم حفظ المعلومات في Sunnyportal.config ويمكن تحريرها/حذفها إذا أخطأت في كتابة أي شيء.
5. بمجرد أن يعمل، استبدل --dry-run على سبيل المثال --output لتحميل بيانات الإخراج لآخر سبعة أيام إلى pvoutput أو --status لتحميل البيانات لليوم الحالي.
6. أضف --quiet لإسكات الإخراج.

$ PYTHONPATH=. ./bin/sunnyportal2pvoutput sunnyportal.config --help
usage: sunnyportal2pvoutput [-h] [-s] [-o] [-c] [-p DAYS_PAST] [-q] [-n] config

Connect Sunny Portal to PVoutput.org

positional arguments:
  config                Configuration file to use

optional arguments:
  -h, --help            show this help message and exit
  -s, --status          Report status(es)
  -o, --output          Report output(s)
  -c, --consumption     Report consumption
  -p DAYS_PAST, --days-past DAYS_PAST
                        number of DAYS in the past to go back -- default: 0 (today only)
  -q, --quiet           Silence output
  -n, --dry-run         Don ' t send any data

Sunnyportal2file

يمكن استخدام البرنامج النصي Sunnyportal2file لحفظ البيانات من Sunny Portal إلى ملف/قاعدة بيانات. ويستخدم نفس ملف التكوين كما في Sunnyportal2pvoutput لتخزين بيانات الاعتماد الخاصة بـ Sunny Portal. سيقوم باستخراج الحقول (الحد الأدنى والمتوسط ​​والحد الأقصى للإنتاج) المتوفرة بوحدة الواط كـ numpy.uint32 جنبًا إلى جنب مع الطوابع الزمنية المقابلة وتجميعها في pandas DataFrame الذي سيتم حفظه منه في ملف بالتنسيق المحدد. سيتم إنشاء ملف واحد لكل مصنع يمكن لحساب Sunny Portal الخاص بك الوصول إليه.

كيفية الجري

1. استنساخ أو تنزيل المستودع.
2. أدخل الدليل وقم بتشغيل: PYTHONPATH=. ./bin/sunnyportal2file sunnyportal.config --format csv (قم بتغيير --format إذا كنت تفضل تنسيقًا مختلفًا)
3. أدخل المعلومات المطلوبة وتأكد من إنشاء ملف بالتنسيق الذي حددته بالمحتوى المتوقع
4. بمجرد أن يعمل ذلك، يمكنك تحديد تاريخ بدء مختلف باستخدام --start-date، وتاريخ انتهاء باستخدام --end-date (كلاهما افتراضي إلى أمس)
5. إذا كان ملف البيانات موجودًا بالفعل، فسيتم فقط تنزيل البيانات الجديدة وإلحاقها بملف البيانات الذي تم إنشاؤه مسبقًا (يمكن تجاوز --start-date)
6. استخدم --include-filter إذا كنت تريد فقط تنزيل البيانات الخاصة بمصنع معين
7. أضف --quiet لإسكات الإخراج.

$ PYTHONPATH=. ./bin/sunnyportal2file -h
usage: sunnyportal2file [-h] -f {json,csv,pickle,feather,parquet,excel,sqlite} [-s START_DATE] [-e END_DATE] [-i INCLUDE_FILTER] [-q] config

Save information from Sunny Portal to file

positional arguments:
  config                Configuration file to use

optional arguments:
  -h, --help            show this help message and exit
  -f {json,csv,pickle,feather,parquet,excel,sqlite}, --format {json,csv,pickle,feather,parquet,excel,sqlite}
                        Format for which the data is to be saved
  -s START_DATE, --start-date START_DATE
                        The start date of data to be saved in the format YYYY-MM-DD (default yesterday)
  -e END_DATE, --end-date END_DATE
                        The end date of data to be saved in the format YYYY-MM-DD (default yesterday)
  -i INCLUDE_FILTER, --include-filter INCLUDE_FILTER
                        A string used to filter which plants to include (default includes all plants)
  -q, --quiet           Silence output