برخی توابع کتابخانه pyeviews که از این کتابخانه برای تعامل با نرم‌افزار EViews استفاده می‌شود. در زیر به توضیح چند تابع می‌پردازم:

  1. GetEViewsApp:

    • وظیفه: ایجاد یک شیء EViews COM با ویژگی‌های مشخص شده.
    • پارامترها:
      • version: نسخه‌ی EViews مورد نظر برای استفاده.
      • instance: نوع نمونه‌ی نرم‌افزار EViews.
      • showwindow: نمایش یا عدم نمایش پنجره‌ی EViews.
    • خروجی: یک شیء نرم‌افزار EViews.
  2. PutPythonAsWF:

    • وظیفه: ارسال داده‌ها از Python به EViews.
    • پارامترها:
      • object: داده‌ی مورد نظر برای ارسال.
      • app: شیء EViews.
      • newwf: ساخت صفحه‌ی جدید در یک workfile موجود یا ساخت یک workfile جدید.
    • خروجی: داده در EViews.
  3. GetWFAsPython:

    • وظیفه: استخراج داده از EViews به Python.
    • پارامترها:
      • app: شیء EViews.
      • wfname: نام workfile در EViews.
      • pagename: نام صفحه در workfile.
      • namefilter: فیلتر نام برای استخراج سری‌ها.
    • خروجی: یک DataFrame پانداس.
  4. Run:

    • وظیفه: اجرای یک دستور EViews از طریق Python.
    • پارامترها:
      • command: دستور مورد نظر.
      • app: شیء EViews.
  5. Get:

    • وظیفه: دریافت یک داده خاص از EViews.
    • پارامترها:
      • objname: نام داده مورد نظر در EViews.
      • app: شیء EViews.
    • خروجی: رشته‌ی متنی.
  6. Cleanup:

    • وظیفه: آزاد کردن حافظه مرتبط با فرآیند COM.
    • پارامترها:
      app: شیء EViews.


نکته:

به طور خلاصه، می‌توان از فرآیند پنج مرحله‌ای به شرح زیر پیروی کرد:

1. وارد کردن داده‌ها به EViews از Python:
- با استفاده از تابع `PutPythonAsWF` می‌توانید داده‌های پایتون را به صورت یک workfile در EViews برگردانید. این تابع می‌تواند با انواع مختلف از داده‌ها، از جمله pandas DataFrame یا numpy array، کار کند.

مثال:


import pyeviews
import pandas as pd

# فرض کنید df داده‌ها را در فرمت پاندا در اختیار دارد
df = pd.read_csv("your_data.csv")

app = pyeviews.GetEViewsApp()
pyeviews.PutPythonAsWF(df, app=app)




2. *اجرای عملیات خاصی در EViews از طریق cmd*:
- با استفاده از تابع `Run`، شما می‌توانید دستورات EViews را مستقیماً از درون پایتون اجرا کنید. به عنوان مثال، اگر می‌خواهید یک تخمین GMM انجام دهید، می‌توانید دستور مربوطه را با استفاده از این تابع بنویسید.

مثال:


cmd = """
equation eq1.gmm(d, i=2) I_t c Q_t
"""
pyeviews.Run(cmd, app=app)





3. **استخراج نتایج و ذخیره آنها در Python**:
- با استفاده از تابع `GetWFAsPython` می‌توانید داده‌هایی که در EViews پردازش شده‌اند را به صورت یک pandas DataFrame در پایتون بازیابی کنید.

مثال:


results = pyeviews.GetWFAsPython(app=app, wfname='untitled', pagename='default', namefilter='eq1')
print(results)




4. **پایان دادن به کار با EViews**:
- زمانی که با EViews کارتان تمام شد، با استفاده از تابع `Cleanup` می‌توانید منابع را آزاد کنید. این مرحله مهم است تا جلوی نشت حافظه را بگیرید و مطمئن شوید که منابع سیستم به درستی مدیریت می‌شوند.

مثال:


pyeviews.Cleanup(app=app)




5. **ادامه کار با نتایج در پایتون**:
- پس از بازیابی داده‌ها در پایتون، می‌توانید از کتابخانه‌های معروف و محبوب پایتون مانند pandas، numpy، matplotlib، و غیره برای تجزیه و تحلیل داده‌ها، مصورسازی نتایج و هر نوع پردازش دیگر استفاده کنید.

در کل، `pyeviews` یک ابزار قدرتمند برای تعامل با EViews از درون محیط پایتون است و امکان انجام چرخه کامل تحلیل اقتصادسنجی را با استفاده از هر دو برنامه فراهم می‌کند.