Revit API’ye Python ile giriş: başlangıç araçları ve ilk iş akışı

Bu rehberde ne öğreneceksiniz?

Revit API’ye başlarken hedef, hemen kapsamlı bir eklenti geliştirmek değil; modeldeki elemanların nasıl bulunacağını, özelliklerin nasıl ele alınacağını ve değişikliklerin nasıl yönetileceğini anlamaktır. Autodesk’in başlangıç dersi, Revit API’ye ücretsiz araçlarla erişme yaklaşımını tanıtıyor. Dersin temel konuları arasında eleman filtreleri, işlemler (Transactions) ve kullanıcı arayüzü bulunuyor. Python araçlarını kaydetme ve kullanma da dersin öğrenme hedefleri arasında.

Bu rehber, bu başlıkları oda verileri üzerinden küçük bir çalışma düzenine dönüştürüyor. Oda; adı, numarası, kullanım türü ve bitiş bilgileri gibi proje verileriyle ilgili özellikleri incelemek için anlaşılır bir örnek. Buradaki amaç, belirli bir API çağrısı veya çalıştırılabilir kod tarifi vermek değil; kaynakların desteklediği araçları ve öğrenme sırasını açıklamak. Kaynaklarda belirtilmeyen sürüm, kurulum yolu veya kod örneği varsayılmıyor.

Gereksinimler ve araçlar

Autodesk University dersinde kullanılan araçlar RevitPythonShell, Revit Lookup ve pyRevit olarak sıralanıyor. Ders, katılımcılardan temel Revit bilgisi ve başlangıç düzeyinde Python bilgisi bekliyor. Revit API geliştirici sayfasına göre API, tekrarlanan görevleri otomatikleştirmeye ve Revit’in temel işlevlerini genişletmeye yönelik .NET tabanlı bir arayüz sunuyor.

Başlamadan önce şu noktaları kontrol edin:

• Kullanılan Revit kurulumu ve proje dosyası.

• Temel Revit kullanım bilgisi ve başlangıç düzeyinde Python bilgisi.

• RevitPythonShell, Revit Lookup ve pyRevit için kullanılan Revit sürümüyle ilgili kurulum ve uyumluluk bilgileri.

Başlangıç dersi belirli bir Revit sürümünü veya her aracın güncel uyumluluk koşullarını vermiyor. Bu nedenle kurulum öncesinde ilgili araçların belgelerini kontrol edin. Kaynaklarda hesap gereksinimleri de açıklanmadığından, belirli bir hesap koşulu olduğu varsayılmamalı.

Adım adım başlangıç akışı

1. Önce oda verisini Revit’te inceleyin. Bir oda seçip Properties paletindeki alanları gözden geçirin. Autodesk’in oda özellikleri belgesinde oda adı, numarası, kullanım türü, departman ve duvar, tavan, taban bitişleri gibi örnek özellikler listeleniyor. Alan ve çevre değerleri salt okunur; hacim de yalnızca hacim hesaplaması etkin olduğunda salt okunur olarak belirtiliyor. Bu ayrımı anlamak, hangi veriyi okuyacağınızı ve hangisinde değişiklik yapmayı hedeflediğinizi belirlemenize yardımcı olur.

2. İlk denemeyi elemanları bulma problemi olarak tanımlayın. Örneğin, projedeki oda elemanlarını belirli bir ölçüte göre ayırmayı öğrenmekle başlayın. Autodesk University dersi, RevitPythonShell ile elemanları toplama ve filtreleme konusunu temel öğrenme hedeflerinden biri olarak gösteriyor. Kod yazmadan önce hangi elemanların seçileceğini ve filtre koşulunun ne anlama geldiğini sade bir dille tarif edin. Kesin API çağrılarını ise Autodesk’in geliştirici rehberinden ve kod örneklerinden doğrulayın.

3. Revit Lookup’ı dersin araç listesinde tutun. Autodesk University kaynağı Revit Lookup’ı ders sırasında kullanılan araçlardan biri olarak anıyor; ancak sağlanan açıklama aracın işlevlerini veya kullanım adımlarını ayrıntılandırmıyor. Bu nedenle belirli bir inceleme işlevi ya da arayüz yolu varsaymadan, araca ilişkin kullanım bilgisini kendi belgelerinden kontrol edin. Böylece kaynakların doğrulamadığı bir özelliği öğrenme akışının kesin parçası gibi ele almamış olursunuz.

4. Model değişikliklerini Transactions başlığıyla birlikte öğrenin. Ders, RevitPythonShell üzerinden elemanlarda işlem gerçekleştirmeyi ana konular arasında sayıyor. Model verisini değiştiren denemelerden önce hedeflenen değişikliği küçük ve açık biçimde tanımlayın. Oda adı gibi bir bilgiyi değiştirmek ile alan gibi salt okunur bir değeri okumak aynı işlem değildir. Değişikliğin proje dosyasına etkisini kontrol etmeden geniş kapsamlı otomasyona geçmeyin. Kaynaklarda işlem başlatma ve sonlandırma için kesin bir kod örneği bulunmadığından, uygulanacak yöntemi ilgili API belgelerinden doğrulayın.

5. Bir Python aracını saklama ve yeniden kullanma hedefi belirleyin. Başlangıç dersinde Python araçlarını kaydetme ve kullanma da öğrenme hedefleri arasında. Önce tek bir görev için küçük bir deneme hazırlayın; ardından aynı işi yeniden kullanma ihtiyacını değerlendirin. pyRevit, dersin araç listesinde yer alıyor ancak kaynak metin belirli bir pyRevit komutu veya kullanım akışı sunmuyor. Kurulum ve uygulama ayrıntılarını bu aracın güncel belgelerinden kontrol edin.

6. Sonucu oda özellikleriyle karşılaştırın. API ile çalışırken elde ettiğiniz bilgileri Revit’te görünen oda özellikleriyle karşılaştırmak, okunan veriyi kontrol etmenize yardımcı olur. Autodesk belgesine göre oda numarası projede benzersiz olmalıdır; numara daha önce kullanılmışsa Revit uyarı verir, ancak devam etmeye izin verir. Test sırasında uyarı verilmesiyle işlemin tamamen engellenmesini birbirine karıştırmayın. Alan ve çevre salt okunur değerlerdir; hacim içinse salt okunur olma durumu hacim hesaplamasının etkin olmasına bağlıdır.

Sık karşılaşılan hatalar

• Sürümü varsaymak: Başlangıç dersi belirli bir Revit veya araç sürümü belirtmiyor. Kurulum ve uyumluluk bilgisini ayrıca doğrulayın.

• Her oda özelliğinin düzenlenebileceğini düşünmek: Alan ve çevre salt okunur. Hacim de yalnızca hacim hesaplaması etkin olduğunda salt okunur olarak tanımlanıyor. İşlemden önce özelliğin niteliğini kontrol edin.

• Filtreyi tanımlamadan kod yazmak: Önce hangi elemanların, hangi koşula göre seçileceğini belirleyin; ardından API belgeleri ve kod örnekleri üzerinden ilerleyin.

• Transactions konusunu atlamak: Modelde değişiklik hedefleyen denemelerde işlemler konusunu öğrenme planına dahil edin. Kesin uygulama yöntemini API belgelerinden doğrulayın.

• Araç adından, kaynakta belirtilmeyen işlevler çıkarmak: RevitPythonShell, Revit Lookup ve pyRevit dersin araçları arasında listeleniyor; ancak kaynak, her birinin bütün işlevlerini ve güncel kurulum adımlarını açıklamıyor.

Sonraki adımlar: mimarlık ve görselleştirme iş akışları

Bu başlangıç düzenini oda numarası, adı, kullanım türü ve bitiş bilgileri gibi proje verilerini anlamak için kullanabilirsiniz. Revit API sayfası otomasyonu, simülasyon ve inşaat gibi alanlarda yazılımın temel işlevlerini genişletme olanaklarından söz ediyor. Bu, tekrar eden veri işlerini araştırmak için bir yön gösteriyor; belirli bir otomasyonun her projede aynı sonucu vereceği anlamına gelmiyor.

Mimarlar ve iç mimarlar için öncelik, modeldeki verinin niteliğini ve hangi özelliklerin kullanılabilir olduğunu anlamak. BIM ve görselleştirme ekipleri ise ihtiyaç duydukları bilgilerin nasıl ele alınacağını küçük denemelerle değerlendirebilir. Daha büyük bir araca geçmeden önce kullanılan Revit sürümüyle araçların uyumluluğunu, değişikliklerin proje üzerindeki etkisini ve lisans koşullarını kontrol edin. Autodesk University dersi ücretsiz araçlarla API’ye erişim yaklaşımını anlatıyor; ancak bu ifade, tüm yazılım ve sürümlerin güncel lisans koşullarını açıklamıyor.

Kaynak ve lisans

Bu rehber, Autodesk’in Revit API geliştirici sayfası, Autodesk Revit 2025 yardımındaki oda örneği özellikleri belgesi ve Autodesk University’de yayımlanan “Revit Programming for Beginners: Easily Access the Revit API Using Free Tools” dersinden yararlanılarak Türkçeye uyarlanmıştır. Kaynak kayıtlarında lisans durumu “serbest” olarak belirtilmiştir; belirli bir Creative Commons lisansı bilgisi verilmediğinden açık lisans iddiasında bulunulmuyor.