API: Interface de Progração
DR4 Help
 Archive Intro
 Table Descriptions
 Schema Browser
 Glossary
 Algorithms
 Introduction to SQL
 Form Query User Guide
 Query Limits
 How To
 FAQ
 API
 sdssQA
 Download
 SkyServer Sites
 SkyServer Traffic Page
 Web Browsers
 Contact Help Desk

Muitas das ferramentas desse site  podem ser chamadas como um programa ou podem ser incluídas no seu próprio website ou páginas de tutoriais. A URL pode ser construída para páginas tipo ASP fornecendo os parâmetros das buscas diretamente por meio de strings (como se fossem links). Alguns exemplos são fornecidos abaixo:

Obtenha Imagens

Obter Campos

http://cas.sdss.org/dr4/pt/get/frameByRCFZ.asp?R=1140&C=1&F=120&Z=1 
onde R é o Run, C é o CamCol e  Z é o nível de Zoom , ou
 http://cas.sdss.org/dr4/pt/get/frameById.asp?id=582093452159090688&zoom=10 
onde  id é o fieldId.


Obter Espectros

http://cas.sdss.org/dr4/pt/get/specByPF.asp?P=75094092966526976&F=25  
onde  P é a Plate e  F é a Fiber, ou
http://cas.sdss.org/dr4/pt/get/specById.asp?ID=75657058065580032 
onde ID é o SpecObjId.


Obter o Céu em Movimento

http://cas.sdss.org/dr4/pt/tools/scroll/camcol.asp?R=1140&C=1&Z=2 
Onde R é o número de Run  , C é o  CamCol e Z é o nível de Zoom.


Acesso Completo aos Espectros

Existe um abrangente web site onde é possível ter acesso aos detalhes dor espectros do SDSS e outros mapeamentos (2dF). Você também pode  fazer o upload do seus próprios espectros.

http://skyservice.pha.jhu.edu/devel/wave/

Esse site tem também um interface  SOAP que está detalhada na sua página de documentação.

Busca

Radial

http://cas.sdss.org/dr4/pt/tools/search/x_radial.asp?
ra=180&dec=-0.2&radius=3&format=csv&topnum=20 
Onde ra é a Ascensão Reta em graus, dec is Declinação em graus, radius é o raio de busca em minutos de arco, format é o formato do retorno da busca,que pode ser csv, html, or xml, topnum é o número de linhas do retorno. Se você quiser todas as linhas, defina entries=all instead.

parâmetros adicionais podem ser passados para restringir a faixa de busca. Para cada banda (x uma das r, i, u,g,z)  check_x,min_x and max_x may podem ser especificados. Portanto, adicionando parâmetros ao que vimos acima nos podemos restringir os resultados às linhas com banda u entre 20 e 22 como segue:

http://cas.sdss.org/dr4/pt/tools/search/x_radial.asp?
ra=180&dec=-0.2&radius=3&format=xml&topnum=20&check_u=u&min_u=20&max_u=22 

Os mesmo parâmetros devem ser usados enviando-os por meio do método POST. Os nomes nos formulários de busca são os mesmos usados com o método GET.


Retangular

http://cas.sdss.org/dr4/pt/tools/search/x_rect.asp?
min_ra=180.1&max_ra=180.2&min_dec=-0.1&max_dec=0.01&format=xml&topnum=20 
onde min_ra,min_dec em graus é um canto da imagem, max_ra,max_dec é o outro canto, format é o formato de retorno que pode ser csv, html, ou xml, topnum é o numero de linhas que retornará. Se você quiser todas as linhas , defina entries=all instead.

Os mesmo parâmetros devem ser usados enviando-os por meio do método POST. Os nomes nos formulários de busca são os mesmos usados com o método GET.


SQL

http://cas.sdss.org/dr4/pt/tools/search/x_sql.asp?
format=xml&cmd=select top 10 * from galaxy  
Onde cmd é o comando SQl para executar e format é o formato de retorno que pode ser csv, html, ou xml. O comando pode ser colocado como um código URL, de preferência.
    &cmd=SELECT+TOP+10+*+FROM+Galaxy+WHERE+r%3C17

Os mesmo parâmetros devem ser usados enviando-os por meio do método POST. Os valores dos parâmetros no método POST podem estar no formato texto, eles não necessitam estar codificados. Os nomes nos formulários de busca são os mesmos usados com o método GET.


CasAccess

CASAccess fornece uma interface de Serviço Web para buscas de Dados SDSS. Exemplos de clientes e as informações podem ser achadas em:
http://skyservice.pha.jhu.edu/develop/vo/casclient.aspx

Um exemplo de busca através do método http GET pode ser como o que é visto abaixo:

http://voservices.net/CasService/ws_v1_0/CasService.asmx/GetVoTable?
sqlcmd=select+top+10+ra%2Cdec%2Cr%2Ci%2Cu%2Cg%2Cz+from+galaxy

Ferramentas Visuais

Recortar Imagem

Esse é um Serviço Web que retorna uma imagem JPEG centrada em  (ra,dec), de tamanho (height x width) possuindo uma escala arbitraria  (scale). Várias opções de desenho podem ser especificadas (opt). A imagem  "recortada" pode ser chamada usando SOAP ou por meio de uma interface HTTP, usando os métodos GET ou POST. Ela também pode ser incluída em uma página através de uma URL em uma aba IMG.

Para maiores informações sobre o cliente Java SOAP veja a  página ImgCutOut DIME .
A  página ImgCutout por si só contem informações sobre como construir url's. Um exemplo:

http://skyservice.pha.jhu.edu/DR4/ImgCutout/getjpeg.aspx
ra=224.5941&dec=-1.09&width=512&height=512&opt=OG 
onde  ra é a Ascensão Reta em graus, dec é a declinação em graus,
scale é a escala da imagem em segundos de arcos por pixel, 0.4 é o padrão.
opt  é um conjunto de caracteres para trabalhar  e escrever sobre a imagem, os respectivos códigos são:
    Código Efeito sobre a imagem
    GGrid
    LLabel
    PPhotoObjs
    SSpecObjs
    TTargetObjs
    OOutline
    BBoundingBox
    FFields
    MMasks
    QPlates
    IInvertImage

Finding Chart

A página , construída sobre o serviço de Recortar Imagens, cria uma Finding Chart, centrada em um local específico e com uma escala específica. Finding Charts devidamente formatados podem ser enviados a uma impressora. As cores da  imagem impressa estão sempre invertidas para melhor impressão.

Você pode pular diretamente para um local em particular com a ferramenta de navegação usando:

http://cas.sdss.org/dr4/pt/tools/chart/navi.asp?ra=184.9511&dec=-0.8754&opt=GO
onde ra é a Ascensão Reta em graus, dec é a Declinação em graus,
scale é a escala da imagem em segundos de arco por pixel, 0.4 é o padrão
opt é um conjunto de caracteres, como listado acima para o serviço de Recortar Imagens.


Navegação

A página, construída a partir do serviço de Recortar Imagens, fornece fácil navegação na vizinhança de um dado ponto do céu. É possível mover-se clicando no campo da imagem ou sobre objetos individuais. Uma lista curta sobre as propriedades básicas e uma imagem ampliada (thumbnail) do objeto mais próximo do ponto selecionado são mostrados.

Você pode pular diretamente para um local em particular com a ferramenta de navegação usando:

http://cas.sdss.org/dr4/pt/tools/chart/navi.asp?ra=184.9511&dec=-0.8754&opt=GO
onde ra é a Ascensão Reta em graus, dec é a Declinação em graus,
scale é a escala da imagem em segundos de arco por pixel, 0.4 é o padrão
opt é um conjunto de caracteres, como listado acima.


ImgList (Lista de Imagens)

Essa página, construída a partir do  serviço Recortar Imagens, pode gerar  thumbnails das imagens do SDSS baseados na lista de posição dos objetos definida pelo usuário.  As imagens possuem links para as outras ferramentas. A lista também pode ser especificada como uma busca (query). A página pode ser chamada através do método HTTP POST.
Você precisará de um formulário como o que segue abaixo:
<form action="http://cas.sdss.org/dr4/pt/tools/chart/showlist.asp"
method="post">
<TEXTAREA name="paste">
    ra     dec  
159.815 -0.655
161.051  0.152
161.739  0.893
164.090 -0.889
</TEXTAREA>
<input type="submit">
</form>
Basicamente você deve colocar no servidor um campo chamado "paste" que contem a lista de thumbnails que você necessita.


Explorando

A ferramenta Explorando contem o sumário de um objeto, e links interativos, além das propriedades detalhadas, como seu espectro e vizinhança, etc.
http://cas.sdss.org/dr4/pt/tools/explore/obj.asp?id=582377467576058089
onde id é a objId, ou
http://cas.sdss.org/dr4/pt/tools/explore/obj.asp?ra=180.6&dec=0.2
onde ra é a Ascensão Reta em graus, dec é a declinação em graus, ou
http://cas.sdss.org/dr4/pt/tools/explore/obj.asp?sid=75094093008470016
onde sid é a SpecObjId, ou
http://cas.sdss.org/dr4/pt/tools/explore/obj.asp?plate=266&fiber=100
onde plate é a placa e fiber é a  fiberid.

Gráficos de Densidade

Você pode solicitar gráficos de densidade codificados em cores diferentes, nas buscas, usando esse serviço web SOAP. Veja:
http://skyservice.pha.jhu.edu/devel/DensityMap

Cross-identification

Upload (Nova versão para o DR3)

Você deve usar os métodos POST ou GET numa asp - a forma básica para isso é a seguinte:

<form method="post" ENCTYPE="multipart/form-data" 
	action="http://cas.sdss.org/dr4/pt/tools/crossid/x_upload.asp">
<input name="search" value="n"> 
<input name="radius" value="0.5"> 
<input name="firstcol" value="1"> 
<textarea name="paste">  name  ra   dec
  A1 180.0 -1.2
  A2 181.0 -0.5
  A3 179.2 +0.5
</textarea>
<textarea name="uquery"> SELECT 
   p.objID, p.ra, p.dec, 
   dbo.fPhotoTypeN(p.type) as type,
   p.modelMag_u, p.modelMag_g, p.modelMag_r, p.modelMag_i, p.modelMag_z 
FROM #x x, #upload u, PhotoTag p
WHERE u.up_id = x.up_id and x.objID=p.objID 
ORDER BY x.up_id
</textarea>
<input type="File" name="upload">
<input name="format" value="xml"> 
<input type="submit" >
</form>
	
Valores válidos para a busca são
  • 'a'  para todos os objetos na vizinhança,
  • 'm' para objetos primários na vizinhança,
  • 'n' para o objeto mais próximo,
  • 'p' para os objetos primários mais próximos, e
  • 'i'  para retornar os objetos  fornecendo uma lista de SDSS IDs (de 5 partes).
O parâmetro radius é um valor de ponto flutuante (float value) especificado em minutos de arco.
O parâmetro firstcol é o numero de colunas no arquivo  paste ou upload  que precede as colunas de entrada (ra,dec ou 5-part SDSS id) (input columns).
Os valores válidos para format são csv, xml, ou html.

Isso também pode ser submetido através do método GET (exemplo padrão para a página crossid):

http://cas.sdss.org/dr4/pt/tools/crossid/x_upload.asp?search=p&radius=0.5&firstcol=1&paste=++name
+ra+dec%0D%0A+A1+195.0++2.5%0D%0A+A2+194.5+2.6%0D%0A+A3+193.964+%2B2.8%0D%0A+A4
+-90+-90%0D%0A%09%09&upload=&uquery=SELECT+%0D%0A+p.objID%2C+p.ra%2C+p.dec%2C+%0D%0A+
dbo.fPhotoTypeN%28p.type%29+as+type%2C%0D%0A++p.modelMag_u%2C+p.modelMag_g%2C
+p.modelMag_r%2C+p.modelMag_i%2C+p.modelMag_z+%0D%0AFROM+%23x+x%2C+%23upload+u
%2C+PhotoTag+p%0D%0AWHERE+u.up_id+%3D+x.up_id+and+x.objID%3Dp.objID+and+p.mode
%3D1+%0D%0AORDER+BY+x.up_id%0D%0A%09%09&format=html

Upload (old pre-DR3 version)

Você pode ENDEREÇAR (método POST) ou PEGAR (método GET) numa asp - a estrutura básica é o seguinte:

 <form method="post" ENCTYPE="multipart/form-data" 
	action="http://cas.sdss.org/dr4/pt/tools/crossid/x_upload.asp">
<input name="search" value="n"> 
<input name="qclass" value="a"> 
<input name="radius" value="0.5"> 
<input name="qselect" value="t"> 
<input type="File" name="upload">
<textarea name="paste">  name  ra   dec
  A1 180.0 -1.2
  A2 181.0 -0.5
  A3 179.2 +0.5
</textarea>
<input name="format" value="xml"> 
<input type="submit" >
</form>
	
Valores válidos para search são  'a' para todos ou 'n' para os mais próximos
Valores válidos para  qclass são 'a' para todos dá photoPrimary, 'g' para Galáxias e 's' para Estrelas .
Valores válidos para qselect  são 'c' para somente contagem, 'u' URL do obj, 't' muito pequeno (ra,dec,id,type,url), 's' pequeno  (>10), 'm' médio (>20> e 'l' grande (>300>).
Valores validos para  format são csv,xml, ou html.

Isso pode ser feito através do método GET:

http://cas.sdss.org/dr4/pt/tools/crossid/x_upload.asp?
search=n&qclass=a&radius=0.5&qselect=t&
paste=name ra dec%0D%0AA1 180.0 -1.2%0D%0A A2 181.0 -0.5%0D%0A A3 179.2 0.5
&format=xml

SpecList

Você deve  ENDEREÇAR (método POST)  para essa página como:

<form method="post" enctype="multipart/form-data" 
	action="http://cas.sdss.org/dr4/pt/tools/crossid/x_speclist.asp">
<TEXTAREA name="paste" >
 plate  mjd fiber
 272  51941 368
 287  52023 582
 288  52000 446
</TEXTAREA> 
<INPUT TYPE="File" NAME="upload">
<TEXTAREA name="uquery" >
	SELECT s.ra, s.dec FROM #upload u, SpecObj s
    WHERE u.up_plate=s.plate
      and u.up_mjd=s.mjd
      and u.up_fiber=s.fiberid
</TEXTAREA> 
<INPUT name="format" value="xml"> 
<INPUT type="submit" target="api">
</form>