Znajdź środek ciężkości wielokąta


16

Z Wikipedii :

Środek ciężkości nie-przecinającego się zamkniętego wielokąta zdefiniowanego przez n wierzchołków ( x 0 , y 0 ), ( x 1 , y 1 ), ..., ( x n - 1 , y n − 1 ) to punkt ( C x , C y ), gdzie

Formula dla Centroid

i gdzie A jest obszarem podpisanym wielokąta,

Wzór na obszar wielokąta

W tych wzorach zakłada się, że wierzchołki są ponumerowane w kolejności ich występowania wzdłuż obwodu wielokąta. Ponadto zakłada się , że wierzchołek ( x n , y n ) jest taki sam jak ( x 0 , y 0 ), co oznacza, że i + 1 w ostatnim przypadku musi zapętlić się wokół i = 0 . Zauważ, że jeśli punkty są ponumerowane w kolejności zgodnej z ruchem wskazówek zegara, obszar A , obliczony jak powyżej, będzie miał znak ujemny; ale współrzędne środka ciężkości będą prawidłowe nawet w tym przypadku.


  • Biorąc pod uwagę listę wierzchołków w kolejności (zgodnie z ruchem wskazówek zegara lub przeciwnie do ruchu wskazówek zegara), znajdź środek ciężkości zamkniętego wielokąta zamkniętego reprezentowanego przez wierzchołki.
    • Jeśli to pomoże, możesz założyć, że dane wejściowe to tylko CW lub tylko CCW. Powiedz to w swojej odpowiedzi, jeśli tego potrzebujesz.
  • Współrzędne nie muszą być liczbami całkowitymi i mogą zawierać liczby ujemne.
  • Dane wejściowe zawsze będą prawidłowe i będą zawierać co najmniej trzy wierzchołki.
  • Dane wejściowe muszą być obsługiwane tylko w przypadku rodzimego typu danych zmiennoprzecinkowych w Twoim języku.
  • Możesz założyć, że liczby wejściowe zawsze będą zawierały przecinek dziesiętny.
  • Możesz założyć, że wejściowe liczby całkowite kończą się na .lub .0.
  • Możesz używać liczb zespolonych do wprowadzania danych.
  • Dane wyjściowe powinny być dokładne z dokładnością do jednej tysięcznej.

Przykłady

[(0.,0.), (1.,0.), (1.,1.), (0.,1.)]        -> (0.5, 0.5)
[(-15.21,0.8), (10.1,-0.3), (-0.07,23.55)]  -> -1.727 8.017
[(-39.00,-55.94), (-56.08,-4.73), (-72.64,12.12), (-31.04,53.58), (-30.36,28.29), (17.96,59.17), (0.00,0.00), (10.00,0.00), (20.00,0.00), (148.63,114.32), (8.06,-41.04), (-41.25,34.43)]   -> 5.80104769975, 15.0673812762

Aby zobaczyć każdy wielokąt na płaszczyźnie współrzędnych, wklej współrzędne bez nawiasów kwadratowych w menu „Edytuj” na tej stronie .

Potwierdziłem swoje wyniki za pomocą tego kalkulatora punktów wielokąta , który jest okropny. Nie mogłem znaleźć takiego, w którym można wprowadzić wszystkie wierzchołki naraz, lub który nie próbował wymazać twojego -znaku przy pierwszym wpisaniu. Opublikuję moje rozwiązanie Python do użytku po tym, jak ludzie będą mieli okazję odpowiedzieć.


Znacznie prostsza technika uśredniania wszystkich prac x i y dla pierwszych dwóch zbiorów, ale nie trzeciego. Zastanawiam się, co robi różnicę ...
ETHproductions

1
@ETHproductions Trzeci wielokąt nie jest wypukły.
JungHwan Min

1
@ETHproductions Jeśli przybliżasz okrąg wielokątem, możesz przesunąć średni punkt dowolnie blisko punktu na okręgu, używając większej liczby punktów blisko tego punktu, prawie nie wpływając na środek ciężkości i utrzymując wypukły wielokąt.
Christian Sievers,

2
@ETHproductions W rzeczywistości wypukłość nie jest powodem. Uśrednianie wszystkich xsi i ys umieszcza cały ciężar w wierzchołkach zamiast rozkładać je na ciele. Pierwszy przypadek działa, ponieważ jest regularny, więc obie metody kończą się w centrum symetrii. Drugi działa, ponieważ w przypadku trójkątów obie metody prowadzą do tego samego punktu.
Ton Hospel,

1
Czy możemy używać liczb zespolonych do operacji we / wy?
xnor

Odpowiedzi:


16

Galaretka , 25 24 22 21 18 bajtów

S×3÷@×"
ṙ-żµÆḊçS€S

Stosuje wzór przedstawiony w problemie.

Zaoszczędź 3 bajty z pomocą @ Jonathan Allan.

Wypróbuj online! lub Zweryfikuj wszystkie przypadki testowe.

Wyjaśnienie

S×3÷@×"  Helper link. Input: determinants on LHS, sum of pairs on RHS
S        Sum the determinants
 ×3      Multiply by 3
     ×"  Vectorized multiply between determinants and sums
   ÷@    Divide that by the determinant sum multipled by 3 and return

ṙ-żµÆḊçS€S  Main link. Input: 2d list of points
ṙ-          Rotate the list of points by 1 to the right
  ż         Interleave those with the original points
            This creates all overlapping slices of length 2
   µ        Start new monadic chain
    ÆḊ      Get the determinant of each slice
       S€   Get the sum of each slice (sum of pairs of points)
      ç     Call the helper link
         S  Sum and return

Możesz zastąpić ṁL‘$ṡ2przez ṙ1ż@lubżṙ1$
Jonathan Allan

@JonathanAllan Dzięki, również mogę się obracać, ṙ-żaby uniknąć wymiany i zaoszczędzić kolejny bajt
mile

Oh tak, oczywiście!
Jonathan Allan,

17

Mathematica, 23 bajty

RegionCentroid@*Polygon

Weź to , galaretka!

Edycja: Nie wystarczy pokonać Galaretkę ...

Wyjaśnienie

Polygon

Wygeneruj wielokąt z wierzchołkami we wskazanych punktach.

RegionCentroid

Znajdź środek ciężkości wielokąta.


2
Cóż, pokonałeś mnie, ale prawdopodobnie jest krótsza droga niż to, co mam, nie mam jeszcze pełnego zrozumienia Galaretki
mile

3
@miles aw ... :(
JungHwan Min

4

J, 29 bajtów

2+/@(+/\(*%3*1#.])-/ .*\)],{.

Stosuje wzór przedstawiony w problemie.

Stosowanie

   f =: 2+/@(+/\(*%3*1#.])-/ .*\)],{.
   f 0 0 , 1 0 , 1 1 ,: 0 1
0.5 0.5
   f _15.21 0.8 , 10.1 _0.3 ,: _0.07 23.55
_1.72667 8.01667
   f _39 _55.94 , _56.08 _4.73 , _72.64 12.12 , _31.04 53.58 , _30.36 28.29 , 17.96 59.17 , 0 0 , 10 0 , 20 0 , 148.63 114.32 , 8.06 _41.04 ,: _41.25 34.43
5.80105 15.0674

Wyjaśnienie

2+/@(+/\(*%3*1#.])-/ .*\)],{.  Input: 2d array of points P [[x1 y1] [x2 y2] ...]
                           {.  Head of P
                         ]     Get P
                          ,    Join, makes the end cycle back to the front
2                              The constant 2
2                      \       For each pair of points
                  -/ .*        Take the determinant
2    +/\                       Sum each pair of points
         *                     Multiply the sum of each pair by its determinant
          %                    Divide each by
             1#.]              The sum of the determinants
           3*                  Multiplied by 3
 +/@                           Sum and return

4

Maxima, 124 118 116 112 106 bajtów

f(l):=(l:endcons(l[1],l),l:sum([3,l[i-1]+l[i]]*determinant(matrix(l[i-1],l[i])),i,2,length(l)),l[2]/l[1]);

Nie mam doświadczenia z Maximą, więc wszelkie wskazówki są mile widziane.

Stosowanie:

(%i6) f([[-15.21,0.8], [10.1,-0.3], [-0.07,23.55]]);
(%o6)              [- 1.726666666666668, 8.016666666666668]

3

Rakieta 420 bajtów

(let*((lr list-ref)(getx(lambda(i)(lr(lr l i)0)))(gety(lambda(i)(lr(lr l i)1)))(n(length l))(j(λ(i)(if(= i(sub1 n))0(add1 i))))
(A(/(for/sum((i n))(-(*(getx i)(gety(j i)))(*(getx(j i))(gety i))))2))
(cx(/(for/sum((i n))(*(+(getx i)(getx(j i)))(-(*(getx i)(gety(j i)))(*(getx(j i))(gety i)))))(* 6 A)))
(cy(/(for/sum((i n))(*(+(gety i)(gety(j i)))(-(*(getx i)(gety(j i)))(*(getx(j i))(gety i)))))(* 6 A))))
(list cx cy))

Nie golfowany:

(define(f l)
  (let* ((lr list-ref)
         (getx (lambda(i)(lr (lr l i)0)))
         (gety (lambda(i)(lr (lr l i)1)))
         (n (length l))
         (j (lambda(i) (if (= i (sub1 n)) 0 (add1 i))))
         (A (/(for/sum ((i n))
                (-(* (getx i) (gety (j i)))
                  (* (getx (j i)) (gety i))))
              2))
         (cx (/(for/sum ((i n))
                 (*(+(getx i)(getx (j i)))
                   (-(*(getx i)(gety (j i)))
                     (*(getx (j i))(gety i)))))
               (* 6 A)))
         (cy (/(for/sum ((i n))
                 (*(+(gety i)(gety (j i)))
                   (-(*(getx i)(gety (j i)))
                     (*(getx (j i))(gety i)))))
               (* 6 A))))
    (list cx cy)))

Testowanie:

(f '[(-15.21 0.8)  (10.1 -0.3)  (-0.07 23.55)] ) 
(f '[(-39.00 -55.94)  (-56.08 -4.73)  (-72.64 12.12)  (-31.04 53.58) 
     (-30.36 28.29)  (17.96 59.17)  (0.00 0.00)  (10.00 0.00)  
     (20.00 0.00) (148.63 114.32)  (8.06 -41.04)  (-41.25 34.43)])

Wynik:

'(-1.7266666666666677 8.01666666666667)
'(5.8010476997538465 15.067381276150996)

3

R, 129 127 bajtów

function(l){s=sapply;x=s(l,`[`,1);y=s(l,`[`,2);X=c(x[-1],x[1]);Y=c(y[-1],y[1]);p=x*Y-X*y;c(sum((x+X)*p),sum((y+Y)*p))/sum(p)/3}

Nienazwana funkcja, która pobiera listę R krotek jako dane wejściowe. Nazwany odpowiednik można wywołać za pomocą np .:

f(list(c(-15.21,0.8),c(10.1,-0.3),c(-0.07,23.55)))

Nie golfił i wyjaśnił

f=function(l){s=sapply;                           # Alias for sapply
              x=s(l,`[`,1);                       # Split list of tuples into vector of first elements
              y=s(l,`[`,2);                       # =||= but for second element 
              X=c(x[-1],x[1]);                    # Generate a vector for x(i+1)
              Y=c(y[-1],y[1]);                    # Generate a vector for y(i+1)
              p=x*Y-X*y;                          # Calculate the outer product used in both A, Cx and Cy
              c(sum((x+X)*p),sum((y+Y)*p))/sum(p)/3    # See post for explanation
}

Ostatni krok ( c(sum((x+X)*p),sum((y+Y)*p))/sum(p)*2/6) to wektorowy sposób obliczania zarówno, jak Cxi Cy. Suma we wzorach dla Cxi Cyjest przechowywana w wektorze, a zatem dzielona przez „suma w A*2/6. Na przykład:

(SUMinCx, SUMinCy) / SUMinA / 3

, a następnie domyślnie wydrukowane.

Wypróbuj na skrzypcach R.


*2/6może prawdopodobnie być /3?
mbomb007,

@ mbomb007 To tak drobiazgowo oczywiste, że chyba przyłapałem się na graniu w golfa. / wzruszenie ramionami
Billywob,

Elegancki, podoba mi się twój sapplysposób radzenia sobie z tymi listami! Mogłoby tu być pole do gry w golfa, nie jestem pewien, jak elastyczny jest dozwolony wkład. Jeśli możesz wprowadzić tylko sekwencję współrzędnych, na przykład c(-15.21,0.8,10.1,-0.3,-0.07,23.55), możesz zapisać 17 bajtów, zastępując pierwsze wiersze swojej funkcji y=l[s<-seq(2,sum(1|l),2)];x=l[-s];. To znaczy ustawienie yna każdy element z indeksem nieparzystym li xna każdy element z indeksem nieparzystym.
rturnbull,

Jeszcze lepiej byłoby, gdybyśmy mogli wprowadzić macierz (lub tablicę), tak matrix(c(-15.21,0.8,10.1,-0.3,-0.07,23.55),2)jak wtedy, gdy początkiem twojej funkcji może być x=l[1,];y=l[2,];, co oszczędza 35 bajtów. (W takim przypadku macierz wejściowa może zostać przetransponowana x=l[,1];y=l[,2];). Oczywiście najłatwiejszym rozwiązaniem jest, jeśli punkty xi ysą po prostu wprowadzane jako osobne wektory function(x,y), ale nie sądzę, że jest to dozwolone ...
rturnbull

@rturnbull Zapytałem OP w komentarzach, a on konkretnie chciał listy krotek (bardzo niewygodne w R oczywiście), więc nie sądzę, aby podejście matrycowe było dozwolone. I nawet gdyby tak było, dane wejściowe musiałyby być częścią wektorową (tj. c(...)), A konwersja macierzy musiałaby zostać wykonana wewnątrz funkcji.
Billywob,

2

Python, 156 127 bajtów

def f(p):n=len(p);p=p+p[:1];i=s=0;exec'd=(p[i].conjugate()*p[i+1]).imag;s+=d;p[i]=(p[i]+p[i+1])*d;i+=1;'*n;print sum(p[:n])/s/3

Nie golfowany:

def f(points):
  n = len(points)
  points = points + [points[0]]
  determinantSum = 0
  for i in range(n):
    determinant = (points[i].conjugate() * points[i+1]).imag
    determinantSum += determinant
    points[i] = (points[i] + points[i+1]) * determinant
  print sum(points[:n]) / determinantSum / 3

Ideone to.

To bierze każdą parę punktów [x, y]jako liczbę zespoloną x + y*ji wysyła wynikowy centroid jako liczbę zespoloną w tym samym formacie.

Dla pary punktów [a, b]i [c, d]wartość a*d - b*cpotrzebną dla każdej pary punktów można obliczyć na podstawie wyznacznika macierzy

| a b |
| c d |

Stosując kompleks arytmetyki złożonych wartości a + b*ji c + d*jmoże być stosowany jako

conjugate(a + b*j) * (c + d*j)
(a - b*j) * (c + d*j)
(a*c + b*d) + (a*d - b*c)*j

Zauważ, że część urojona jest równoważna wyznacznikowi. Ponadto użycie wartości złożonych pozwala na łatwe zsumowanie punktów w innych operacjach.


2

R + sp (46 bajtów)

Zakłada, że sppakiet jest zainstalowany ( https://cran.r-project.org/web/packages/sp/ )

Pobiera listę wierzchołków (na przykład list(c(0.,0.), c(1.,0.), c(1.,1.), c(0.,1.)))

Wykorzystuje fakt, że „labpt” wielokąta jest środkiem ciężkości.

function(l)sp::Polygon(do.call(rbind,l))@labpt

2

JavaScript (ES6), 102

Proste wdrożenie formuły

l=>[...l,l[0]].map(([x,y],i)=>(i?(a+=w=t*y-x*u,X+=(t+x)*w,Y+=(u+y)*w):X=Y=a=0,t=x,u=y))&&[X/3/a,Y/3/a]

Test

f=
l=>[...l,l[0]].map(([x,y],i)=>(i?(a+=w=t*y-x*u,X+=(t+x)*w,Y+=(u+y)*w):X=Y=a=0,t=x,u=y))&&[X/3/a,Y/3/a]

function go()
{
  var c=[],cx,cy;
  // build coordinates array
  I.value.match(/-?[\d.]+/g).map((v,i)=>i&1?t[1]=+v:c.push(t=[+v]));
  console.log(c+''),
  [cx,cy]=f(c);
  O.textContent='CX:'+cx+' CY:'+cy;
  // try to display the polygon
  var mx=Math.max(...c.map(v=>v[0])),
    nx=Math.min(...c.map(v=>v[0])),
    my=Math.max(...c.map(v=>v[1])),
    ny=Math.min(...c.map(v=>v[1])),  
    dx=mx-nx, dy=my-ny,
    ctx=C.getContext("2d"),
    cw=C.width, ch=C.height,
    fx=(mx-nx)/cw, fy=(my-ny)/ch, fs=Math.max(fx,fy)
  C.width=cw
  ctx.setTransform(1,0,0,1,0,0);
  ctx.beginPath();
  c.forEach(([x,y],i)=>ctx.lineTo((x-nx)/fs,(y-ny)/fs));
  ctx.closePath();
  ctx.stroke();
  ctx.fillStyle='#ff0000';
  ctx.fillRect((cx-nx)/fs-2,(cy-ny)/fs-2,5,5);
}
go()
#I { width:90% }
#C { width:90%; height:200px;}
<input id=I value='[[-15.21,0.8], [10.1,-0.3], [-0.07,23.55]]'>
<button onclick='go()'>GO</button>
<pre id=O></pre>
<canvas id=C></canvas>


1

Python 2, 153 bajty

Nie używa liczb zespolonych.

P=input()
A=x=y=0;n=len(P)
for i in range(n):m=-~i%n;a=P[i][0];b=P[i][1];c=P[m][0];d=P[m][1];t=a*d-b*c;A+=t;x+=t*(a+c);y+=t*(b+d)
k=1/(3*A);print x*k,y*k

Wypróbuj online

Nie golfowany:

def centroid(P):
    A=x=y=0
    n=len(P)
    for i in range(n):
        m=-~i%n
        x0=P[i][0];y0=P[i][1]
        x1=P[m][0];y1=P[m][1]
        t = x0*y1 - y0*x1
        A += t/2.
        x += t * (x0 + x1)
        y += t * (y0 + y1)
    k = 1/(6*A)
    x *= k
    y *= k
    return x,y

1

Właściwie 45 40 39 bajtów

Wykorzystuje algorytm podobny do odpowiedzi „Galaretka mil” . Istnieje krótszy sposób obliczania wyznaczników przy użyciu iloczynu kropkowego, ale obecnie występuje błąd z produktem kropkowym Faktycznie nie działa z listami liczb zmiennoprzecinkowych. Sugestie dotyczące gry w golfa mile widziane. Wypróbuj online!

;\Z♂#;`i¥`M@`i│N@F*)F@N*-`M;Σ3*)♀*┬♂Σ♀/

Ungolfing

         Implicit input pts.
;\       Duplicate pts, rotate right.
Z        Zip rot_pts and pts together.
♂#       Convert the iterables inside the zip to lists
         (currently necessary due to a bug with duplicate)
;        Duplicate the zip.
`...`M   Get the sum each pair of points in the zip.
  i        Flatten the pair to the stack.
  ¥        Pairwise add the two coordinate vectors.
@        Swap with the other zip.
`...`M   Get the determinants of the zip.
  i│       Flatten to stack and duplicate entire stack.
           Stack: [a,b], [c,d], [a,b], [c,d]
  N@F*)    Push b*c and move it to BOS.
  F@N*     Push a*d.
  -        Get a*d-b*c.
;Σ3*)    Push 3 * sum(determinants) and move it to BOS.
♀*       Vector multiply the determinants and the sums.
┬        Transpose the coordinate pairs in the vector.
♂Σ       Sum the x's, then the y's.
♀/       Divide the x and y of this last coordinate pair by 3*sum(determinants).
         Implicit return.

Krótsza, niekonkurencyjna wersja

To kolejna 24-bajtowa wersja wykorzystująca liczby zespolone. Jest niekonkurencyjny, ponieważ opiera się na poprawkach błędów, które są późniejsze niż to wyzwanie. Wypróbuj online!

;\│¥)Z`iá*╫@X`M;Σ3*)♀*Σ/

Ungolfing

         Implicit input a list of complex numbers, pts.
;\       Duplicate pts, rotate right.
│        Duplicate stack. Stack: rot_pts, pts, rot_pts, pts.
¥)       Pairwise sum the two lists of points together and rotate to BOS.
Z        Zip rot_pts and pts together.
`...`M   Map the following function over the zipped points to get our determinants.
  i        Flatten the list of [a+b*i, c+d*i].
  á        Push the complex conjugate of a+bi, i.e. a-b*i.
  *        Multiply a-b*i by c+d*i, getting (a*c+b*d)+(a*d-b*c)*i.
           Our determinant is the imaginary part of this result.
  ╫@X      Push Re(z), Im(z) to the stack, and immediately discard Re(z).
           This map returns a list of these determinants.
;        Duplicate list_determinants.
Σ3*)     Push 3 * sum(list_determinants) and rotate that to BOS.
♀*Σ      Pairwise multiply the sums of pairs of points and the determinants and sum.
/        Divide that sum by 3*sum(list_determinants).
         Implicit return.

1

C ++ 14, 241 bajtów

struct P{float x;float y;};
#define S(N,T)auto N(P){return 0;}auto N(P a,P b,auto...V){return(T)*(a.x*b.y-b.x*a.y)+N(b,V...);}
S(A,1)S(X,a.x+b.x)S(Y,a.y+b.y)auto f(auto q,auto...p){auto a=A(q,p...,q)*3;return P{X(q,p...,q)/a,Y(q,p...,q)/a};}

Wyjście jest strukturą pomocnika P,

Nie golfowany:

 //helper struct
struct P{float x;float y;};

//Area, Cx and Cy are quite similar
#define S(N,T)\  //N is the function name, T is the term in the sum
auto N(P){return 0;} \   //end of recursion for only 1 element
auto N(P a,P b,auto...V){ \ //extract the first two elements
  return (T)*(a.x*b.y-b.x*a.y) //compute with a and b
         + N(b,V...); \        //recursion without first element
}

//instantiate the 3 formulas
S(A,1)
S(X,a.x+b.x)
S(Y,a.y+b.y)


auto f(auto q,auto...p){
  auto a=A(q,p...,q)*3; //q,p...,q appends the first element to the end
  return P{X(q,p...,q)/a,Y(q,p...,q)/a};
}

Stosowanie:

f(P{0.,0.}, P{1.,0.}, P{1.,1.}, P{0.,1.})
f(P{-15.21,0.8}, P{10.1,-0.3}, P{-0.07,23.55})

1

Clojure, 177 156 143 bajtów

Aktualizacja: Zamiast wywołania zwrotnego używam [a b c d 1]jako funkcji, a argumentem jest tylko lista indeksów tego wektora. 1jest używany jako wartość wartownika podczas obliczaniaA .

Aktualizacja 2: Brak wstępnego obliczania Aprzy letużyciu, (rest(cycle %))aby uzyskać przesunięcie wektorów wejściowych o jeden.

#(let[F(fn[I](apply +(map(fn[[a b][c d]](*(apply +(map[a b c d 1]I))(-(* a d)(* c b))))%(rest(cycle %)))))](for[i[[0 2][1 3]]](/(F i)(F[4])3)))

Orginalna wersja:

#(let[F(fn[L](apply +(map(fn[[a b][c d]](*(L[a b c d])(-(* a d)(* c b))))%(conj(subvec % 1)(% 0)))))A(*(F(fn[& l]1))3)](map F[(fn[v](/(+(v 0)(v 2))A))(fn[v](/(+(v 1)(v 3))A))]))

Na etapie mniej golfowym:

(def f (fn[v](let[F (fn[l](apply +(map
                                    (fn[[a b][c d]](*(l a b c d)(-(* a d)(* c b))))
                                    v
                                    (conj(subvec v 1)(v 0)))))
                  A (* (F(fn[& l] 1)) 3)]
                [(F (fn[a b c d](/(+ a c)A)))
                 (F (fn[a b c d](/(+ b d)A)))])))

Tworzy funkcję pomocnika, Fktóra implementuje sumowanie z dowolnym wywołaniem zwrotnym l. Dla Azwrotów zwrotnych stale 1, natomiast współrzędne X i Y mają swoje własne funkcje. (conj(subvec v 1)(v 0))upuszcza pierwszy element i dołącza do końca, dzięki czemu łatwo jest śledzić x_ii x_(i+1). Może jest jeszcze kilka powtórzeń do wyeliminowania, zwłaszcza w końcu (map F[....

Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.