Sunteți pe pagina 1din 208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

TOPCATFerramentaparaoperaesemcatlogosetabelas
Verso4.1

StarlinkUsurioNota253
MarkTaylor
07demarode2014

Contedo
Abstrato
1Introduo
2GuiadeIncioRpido
Tabela3Aparente
3.1SubconjuntosRow
3.1.1DefinindoSubconjuntos
3.2OrderRow
3.3conjuntodecolunas
Tabela4I/O
4.1FormatosdeMesa
4.1.1Formatosdeentradasuportados
4.1.1.1FITS
4.1.1.2FITSorientadaaColuna
4.1.1.3VOTable
4.1.1.4CDF
4.1.1.5ASCII
4.1.1.6IPAC
http://127.0.0.1:2525/doc/sun253/sun253.html

1/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

4.1.1.7valoresseparadosporvrgula
4.1.1.8TabelaSeparadoTab
4.1.1.9ConsultasdebancodedadosSQL
4.1.1.10MundoDataCenter
4.1.2Formatosdesadasuportados
4.1.2.1FITS
4.1.2.2FITSorientadaaColuna
4.1.2.3VOTable
4.1.2.4ASCII
4.1.2.5Texto
4.1.2.6valoresseparadosporvrgula
4.1.2.7IPAC
4.1.2.8TabelaSeparadoTab
4.1.2.9tabelasSQL
4.1.2.10HTML
4.1.2.11LaTeX
4.1.2.12MirageFormat
Formatospersonalizados4.1.3E/S
4.2LocaisdeMesa
5juntaseosJogos
5.1AconcatenaodeTabelas
5.2linhascoincidentesentretabelas
5.3linhascorrespondentesemumatabela
5.4JogosMultiObjetos
5,5PlotagemresultadaPartida
5.6NotassobreMatching
5.7Correspondnciacomumatabelaremota
6ObservatrioVirtualdeAcesso
6.1ORegistro
Servios6.2DadosdeAcesso
7Sintaxedeexpressesalgbricas
7.1Referenciandovaloresdeclulas
7.2ReferenciamentoRowsubconjuntoBandeiras
7.3ReferenciandoParmetrosTabela
7.4ValoresNulos
7.5Operadores
7.6Funes
7.6.1NotaTcnica
7,7Mtodosdeinstncia
7,8Exemplos
7.9Adiodefunesdefinidaspelousurio
8AesdeAtivao
8.1FunesdeAtivao
9InteroperabilidadeFerramenta
9.1controleSAMP
9.2controlePLSTICO
9.3MensagensdeTransmisso
9.4Mensagensrecebidas
10InvocandoTOPCAT
10.1TOPCATArgumentosdelinhadecomando
10.2OpesJava
10.2.1ClassePath
10.2.2Tamanhodamemria
10.2.3Propriedadesdosistema
10.3JDBCConfigurao
10.4Dicasparatabelasgrandes
10,5Exemplos
ATOPCATdoWindows
A.1Caractersticascomunsdejanela
A.1.1Barra
MenusA.1.2
JTablesA.1.3
SelectorColunaA.1.4
JaneladeControleA.2
ListaTabelaA.2.1
PainelA.2.2Propriedadestabelaatual
MemoryMonitorA.2.3
A.2.4PaineldeSAMP
A.2.5ToolbarButtons
ItensdomenuA.2.6
A.3TableViewdoWindows
JanelaDadosA.3.1
A.3.2ParmetrosJanela
ColunasA.3.3Janela
http://127.0.0.1:2525/doc/sun253/sun253.html

2/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.3.4SubconjuntosJanela
A.3.5EstatsticasJanela
A.4PlotdoWindows
DiferenasA.4.1doantigoestilodeplotagemdoWindows
A.4.2JanelaViso
A.4.2.1Navegao
ControlescamadaA.4.2.2dadosdatabela
A.4.2.3DefinioSubconjuntosporRegio
A.4.2.4LotejanelaExport
A.4.3controlesfixos
A.4.3.1Machados
A.4.3.2Legenda
A.4.3.3AuxAxis
ControlesA.4.4Camada
A.4.4.1ControledePosioCamada
A.4.4.2ParPosiocamadadecontrole
A.4.4.3HistogramaControledeCamada
A.4.4.4Spectrogramcamadadecontrole
A.4.4.5FunodeControledeCamada
FormasA.4.5Lote
A.4.5.1MarkForm
A.4.5.2TamanhoForm
A.4.5.3VectorForm
BaresA.4.5.4errodeforma
A.4.5.5EllipseForm
A.4.5.6LinhaForm
A.4.5.7formulriodetextoRtulo
A.4.5.8ContourForm
A.4.5.9ParMarcasForm
A.4.5.10ParLigaoForm
A.4.6ModosShading
ModoPlanoA.4.6.1
A.4.6.2modotransparente
ModoAutoA.4.6.3
ModoA.4.6.4Densidade
ModoAuxA.4.6.5
JanelaLoteA.4.7Histograma
A.4.7.1HistogramaNavegao
A.4.7.2HistogramaEixosdecontrole
BaresA.4.7.3Controle
A.4.8Planejaneladeplotagem
A.4.8.1PlanodeNavegao
A.4.8.2PlaneEixosdecontrole
JanelaLoteA.4.9Sky
A.4.9.1SkyNavegao
A.4.9.2SkyEixosdecontrole
A.4.10Cubejaneladeplotagem
A.4.10.1CubeNavigation
A.4.10.2CubeEixosdecontrole
A.4.11Spherejaneladeplotagem
A.4.11.1NavigationSphere
A.4.11.2SphereEixosdecontrole
JanelaLoteA.4.12Tempo
A.4.12.1Tempodenavegao
A.4.12.2TempoEixosdecontrole
A.5OldestilodeplotagemdoWindows
A.5.1Caractersticascomuns
A.5.1.1DatasetSeletores
A.5.1.2AxisConfigurationandZooming
BaresA5.1.3erro
EtiquetasA.5.1.4Ponto
A.5.1.5AuxiliarMachados
A.5.1.6DefinioSubconjuntosporRegio
A.5.1.7ExportadoresGrficos
A.5.2Histograma(modaantiga)
A.5.2.1HistogramaStyleEditor
A.5.32DPlot(modaantiga)
EstiloA.5.3.1Loteeditor
A.5.4Stackedenredo(modaantiga)
A.5.4.1EditordeLinhasEstilo
A.5.53DPlot(modaantiga)
A.5.5.13DEditordeestilodeplotagem
A.5.6SphericalPlot(modaantiga)
A.5.7DensidadeMap(modaantiga)
http://127.0.0.1:2525/doc/sun253/sun253.html

3/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

EstiloA.5.7.1Densidadeeditor
JanelaA.6Carga
A.6.1FileStoreNavegador
NavegadorA.6.2Sistema
HierarquiaA.6.3Navegador
A.6.3.1Navegao
PesquisasTabelaA.6.3.2
A.6.4SQLQuery
A.6.5ConePesquisa
A.6.6SIAConsulta
A.6.7SSAConsulta
A.6.8TAPConsulta
A.6.9vizirCatlogodeServiodeConsulta
A.6.10GAVOMilnioDatabaseQuery
A.6.11BastiTeoriadeconsultadebancodedados
TabelasA.6.12Exemplo
A.7SalvarJanela
PainelA.7.1contedo
A.7.1.1TabelaAtual
VriastabelasA.7.1.2
A.7.1.3Session
PainelA.7.2Destino
A.7.2.1DigiteLocalizao
II.A.7.2.2FileStoreNavegador
NavegadorA.7.2.3Sistema
A.7.2.4SQLDilogodesada
A.8jogodoWindows
A.8.1Caractersticascomuns
A.8.1.1correspondemaoscritrios
A.8.1.2Colunacaixasdeseleo
A.8.1.3Sintonia
A.8.2ParJogoJanela
LinhasdesadaA.8.2.1SelectorBox
A.8.3JogoInternoJanela
A.8.3.1JogoInternoBoxAo
A.8.4JanelamltiplaJogo
A.8.4.1MltiplaAoBoxJogo
A.9VOacessoadadosdoWindows
A.9.1Caractersticascomuns
A.9.1.1PaineldeConsultadeRegistro
A.9.1.2nicoposicionalPesquisaPanel
A.9.1.3mltiplaposicionalPesquisaPanel
A.9.2ConePesquisa
A.9.3simplesdeacessoaImagem(SIA)Consulta
AcessoespectralA.9.4Simples(SSA)Consulta
A.9.5mltiplaConePesquisa
A.9.6mltiplaSIAConsulta
A.9.7mltiplaSSAConsulta
A.9.8TabelaAccessProtocol(TAP)Consulta
GuiaA.9.8.1Selecionarservio
A.9.8.2DigiteguiaConsulta
A.9.8.3guiaTrabalhosCorrendo
GuiaA.9.8.4resumodotrabalho
A.10OtherWindows
A.10.1concatenaoJanela
JanelaAtivaoA.10.2
AplicaesVisualizadorA.10.2.1Imagem
OsespectadoresA.10.2.2Spectrum
A.10.2.3NavegadoresWeb
A.10.3SAMPJanela
A.10.4AjudaJanela
A.10.5novajanelaParameter
A.10.6JanelaColunasinttico
JanelaA.10.7SkyCoordenadas
A.10.8AlgbricasubconjuntoJanela
A.10.9FunesdisponveisJanela
A.10.10LogJanela
FunesBalgbricas
FunesB.1Gerais
TrigDegreesB.1.1
B.1.2Tempos
B.1.3Matemtica
ConversesB.1.4
B.1.5Formatos
http://127.0.0.1:2525/doc/sun253/sun253.html

4/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

B.1.6Aritmtica
B.1.7CoordsRadians
B.1.8Cobertura
B.1.9Tilings
B.1.10Distncias
B.1.11Arrays
B.1.12Cordas
B.1.13fundentes
B.1.14KCorrections
B.1.15CoordsDegrees
FunesB.2Activation
B.2.1SDSS
B.2.2Navegadores
B.2.3SuperCosmos
B.2.4Mgc
B.2.5Sog
B.2.6BasicImageDisplay
B.2.7TwoQZ
ImagemB.2.8
SadaB.2.9
B.2.10Sistema
CNotassobreoRelease
C.1Agradecimentos
HistricodeversesC.2

Abstrato
TOPCATumvisualizadorgrficointerativoeeditordedadostabulares.Elefoiprojetadoparausocomtabelasastronmicas,taiscomo
catlogosdeobjetos,masnorestritaaaplicaesastronmicas.Elacompreendeumnmerodediferentesformatosdeastronomicamente
importantes,eoutrosformatospodemseradicionados.Eleprojetadoparalidarbemcomgrandesmesasummilhodelinhasporcemcolunas
nodeverepresentarumproblema,mesmocomamemriamodestoerecursosdaCPU.
Eleofereceumavariedadedemaneirasparavisualizareanalisarosdados,incluindoumnavegadorparaosdadosdaclulaemsi,os
telespectadoresparainformaessobreatabelaemetadadosdecoluna,ferramentasparaunirtabelasusandoalgoritmoscorrespondentes
flexveis,edevisualizao,incluindohistogramas,2e3grficosdedispersodimensionais,emapasdedensidade.Usandoumpoderosoe
extensveldelinguagemdeexpressonovascolunasbaseadosemJavapodemserdefinidosesubconjuntosdelinhasselecionadasparaa
anliseemseparado.Seleodeumalinhapodeserconfiguradoparaacionarumaao,porexemplo,exibirumaimagemdoobjetode
catlogoemumvisualizadorexterno.Osdadosdatabelaemetadadospodemsereditadoseatabelamodificadaresultantepodeserescritoem
umaamplagamadeformatosdesada.
Umasriedeopesestodisponveisparaocarregamentodedadosdefontesexternas,incluindoservios(VO)ObservatrioVirtual,
proporcionando,assim,umaportadeentradaparamuitosarquivosremotosdedadosastronmicos.Elatambmpodeinteroperarcomoutras
ferramentasdedesktopusandooprotocoloSAMP.
TOPCATescritoempuroJavaeestdisponvelsobalicenaGNUGeneralPublicLicense.Suasinstalaesdeprocessamentodemesa
subjacentessofornecidosporSTIL,aStarlinkTabelasInfrastructureLibrary.

1Introduo
TOPCATumprogramagrficointerativoquepodeexaminar,analisar,combinar,editareescrevertabelas.Umatabela,grossomodo,algo
comcolunaselinhascadacolunacontmobjetosdomesmotipo(porexemplo,nmerosdepontoflutuante)ecadalinhatemumaentradapara
cadaumadascolunas(apesardealgumasentradaspodemserembranco).Umexemploastronmicocomumdeumamesaumcatlogode
objeto.
TOPCATpodelernastabelasemumasriedeformatosdevriasfontes,permitemquevocinspecioneemanipullosdevriasmaneiras,e
sevoctivereditadolosopcionalmenteescrevlosnoestadomodificadoparausoposterior,novamenteemumavariedadedeformatos.Aqui
estumresumodesuasprincipaiscapacidades:
DadosVer/editartabelaemumnavegadorderolagem
Ver/editarmetadadosdetabela(parmetros)
Ver/editarmetadadosdecoluna(nomesdascolunas,asunidades,UCDs...)
Reordemeesconder/revelarcolunas
Inserircolunas'sintticos'definidospelaexpressoalgbrica
Classificarlinhassobreosvaloresdeumadeterminadacoluna
Definirsubconjuntosdelinhadevriosmodos,incluindoalgebricamenteegraficamente
Tracecolunasunscontraosoutrosem1,2e3dimenses,distinguindodiferentessubconjuntos
Calcularasestatsticassobrecadacolunaparaalgumasoutodasaslinhas
Desencadearumaaoconfigurvel(visualizaoporexemploimagemdoobjeto),quandoumacolunaselecionado
Realizecorrespondnciaflexveldelinhasnamesmaouemdiferentestabelas
Concatenaraslinhasdetabelasexistentesparacriarnovos
Adquirirtabelasdeserviosweb,filestoresexternosououtrasfontespersonalizveis
http://127.0.0.1:2525/doc/sun253/sun253.html

5/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

RealizarconsultassimplesemltiplasaosserviosObservatrioVirtual
InteroperarcomoutrasferramentasdedesktopusandoSAMP
Escrevertabelasmodificadasemformatooriginaloudiferente
Umesforoconsiderveltemidoparafazlofuncionarcomgrandesmesasalgunsmilhesdelinhasecentenasdecolunasgeralmente
bastanteadministrvel.
Aidiageraldoprogramabastantesimples.Aqualquermomento,eletemumalistadetabelasquesabesobreestessoexibidosnajanelade
controlequeaprimeiracoisaquevocvquandovociniciaroprograma.Vocpodeadicionarlistadecarregartabelas,ouporalgumas
aesquecriamnovastabelasapartirdosjexistentes.Quandovocselecionaumatabelanalista,clicandosobreela,vocpodever
informaesgeraissobreelenajaneladecontrole,evoctambmpodeabrirmaisespecializadosvistajanelasquepermitemquevoc
inspecionelomaisdetalhadamenteoueditlo.Algumasdasaesquevocpodetomar,comoalteraraatualordemdeclassificao,Row
subconjuntoouconjuntodecolunasalteraraTabelaaparente,queumavisodatabelausadaparacoisascomosalvlaerealizarjogosde
linha.Asalteraesfeitasnomodificardiretamenteastabelasemdisco(ouondequerqueveio),massevocdesejasalvarasalteraesque
vocfez,vocpodeescreveratabelamodificada(s)paraumnovolocal.
Ocorpoprincipaldestedocumentoexplicaessasidiaserecursosdeformamaisdetalhada,eApndiceAdumadescriocompletadetodas
asjanelasqueformamaaplicao.Enquantooprogramaestsendoexecutado,estedocumentoestdisponvelatravsdosistemadeajuda
onlineclicandonaAjuda( botodabarradeferramentas)emqualquerjanelairaparecerumnavegadordeajudaabertonapginaque
descreveessajanela.Estedocumentofortementehiperlinks,entovocpodeacharquemaisfcildeleremseuformulrioHTMLdoque
nopapel.
NotciasrecentessobreoprogramapodemserencontradasnapginawebTOPCAT.ElefoiinicialmentedesenvolvidonombitodaStarlink
agoraterminadaeprojetosAstroGride,posteriormente,foiapoiadoporPPARCeSTFCconselhosdoReinoUnidodepesquisa,vrios
projetosEuroVOe7PQ,GAVOeESA.AsinstalaesdetratamentodetabelasubjacentessofornecidospeloStarlinkTabelas
InfrastructureLibrarySTIL,queestdocumentadocommaisdetalhesnoSUN/252.OsoftwareescritoemJavapuro,edeveserexecutado
emqualquerplataformaJ2SEverso1.5ouposterior.Issootornaaltamenteporttil,umavezqueelepodeserexecutadoemqualquermquina
quetemumainstalaodoJavaadequado,queestdisponvelparaMSWindows,MacOSXeamaioriadossaboresdeUnix,entreoutros.
AlgumasdasaplicaesexternasespectadorelefalaqueconfiaremcdigonoJavanoentantoassimumaouduasinstalaes,comoa
exibiodeespectros,podeestarausenteemalgunscasos.TOPCATestdisponvelsobostermosdaGNUGeneralPublicLicense.

2GuiadeIncioRpido
EstemanualtemcomoobjetivodartutorialdetalhadoedocumentaodereferncianamaioriadosaspectosderecursosdoTOPCAT,ello
umaexcelentemaneiradeaprendersobreoprograma.Noentanto,umbomdocumentodegordura,esevocsentirquevoctemcoisas
melhoresparafazercomseutempodoquelertudoisso,vocdevesercapazdefazeramaioriadascoisasporbrincarcomosoftwaree
mergulharnomanual(ouequivalentementeajudaonline),quandovocnopodevercomofazeralgoouoprogramanoestsecomportando
comoesperado.Estaseoforneceumabreveintroduoparaosimpacientes,explicandocomocomear.
Parainiciaroprograma,vocprovavelmenteirdigitartopcatoualgocomojava-jar topcat-full.jar(verSeo10paramaisdetalhes).
Paraverumatabelaquevoctemnodisco,vocpodedaroseunomenalinhadecomandooucarreglousandoacargabotodaGUI.
ArquivosFITS,VOTableeCDFsoreconhecidosautomaticamenteseseusdadosestoemoutroformato,comoASCII(verSeo4.1.1),
vocprecisadizeraoprograma(porexemplo,ascii-fnalinhadecomando).Sevocquerapenasexperimentaroprogramaparafora,
topcat-demovaicomearcomumpardepequenasmesasparafinsdedemonstrao.
Aprimeiracoisaquevocvajaneladecontrole.Estetemumalistadetabelacarregada(s)noladoesquerdo.Seumdelesdestacado,
clicandosobreela,informaessobreeleseromostradosdireitaalgumasdestas(nomedatabela,aordemdeclassificao),vocpode
mudaraqui.Napartesuperiorumabarradeferramentascomumasriedebotes,amaioriadosquaisseabremnovasjanelas.Estesdividem
seemalgunsgrupos:

Carregar/Salvar/Enviartabela(s).

Apresentarosvriosaspectosdainformaosobreosdadosdatabelaemetadados.

Abrirjanelasdeplotagem/visualizaodevriostipos.

Juntesetabelasdevriasformas,incluindoReaesCruzadasespacial

Ajudaeinformaes
AAjuda(

boto)aparecenamaioriadasjanelassevocclicarneleumnavegadordeajudaserexibidamostrandoumaparteapropriada

domanual.Assimcomoabarradeferramentas,humasriedemenusnapartesuperioramaioriadasopesbastarepetirosqueaparecem
nabarradeferramentas,masalgumasoutrasmenoscomunspodemestardisponveistambm.AAjudademenudlhemaisalgumasopes
aolongodasmesmaslinhas,incluindoexibirasinformaesdeajudaparaoseunavegadorhabitual,emvezde(umpoucodesconexo)ajuda
visualizadordeTOPCAT.Todasasjanelasseguemmaisoumenosessepadro.Paraalgunsdosbotesdabarradeferramentasquevoc
provavelmentepodeadivinharoqueelesfazemdeseuscones,paraoutros,provavelmente,noparadescobrirquevocpodepassarcomo
ratoparaveradica,procurenosmenus,ouleromanual,ousimplesmenteempurrloever.
Algumasdasjanelaspermitemquevocfaaasalteraesdevriostiposparaastabelas,comorealizarotipo,aseleodelinhas,a
http://127.0.0.1:2525/doc/sun253/sun253.html

6/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

modificaodedadosoumetadados.Nenhumdelesafetaatabelanodisco(oubancodedados,ouqualqueroutrolugar),masse
posteriormentevocsalvaratabelaasalteraesserorefletidasnatabelaquevocsalvar.
Umpontonotvelqueteremmentedizrespeitomemria.TOPCATbastanteeficientenousodememria,masemalgunscasos,quandose
tratadegrandestabelasquevocpodeverumOutOfMemoryError.Normalmente,possveltrabalharredondaissousandooXmx- NNNM
bandeiranoarranqueverSeo10.2.2.
Finalmente,sevoctiverdvidas,comentriosousolicitaessobreosoftware,eelesnoparecemserabordadosnomanual,consulteapgina
webTOPCAT,utilizeotopcatusermailinglist,ouentreemcontatocomoautorofeedbackdousuriosemprebemvindo.

Tabela3Aparente
ATabelaaparenteumavistaemespecialdeumamesaquepodeserinfluenciadaporalgunsdoscomandosdevisualizao.
QuandovoccarregaumatabelaemTOPCATeletemumasriedecaractersticascomoonmerodecolunaselinhasqueelacontm,a
ordemdaslinhasquecompemosdados,osdadosemetadadossimesmos,eassimpordiante.Enquantomanipullo,vocpodemodificara
maneiraqueatabelaaparececomoprograma,mudandoouadicionandodadosoumetadados,oualteraraordemouseleodecolunasou
linhasquesovisveis.Paracadatabelaasua"mesaaparente"umatabelaquecorrespondeaoestadoatualdatabeladeacordocomas
mudanasquevocfez.
Emdetalhe,atabelaaparenteconsistenumatabelacomofoioriginalmenteimportadaparaoprogramaalmdequalquerumadasseguintes
alteraesquevocfez:
SelecodelinhasmodificadasmudandoacorrentesubconjuntoFila
MudanasnoatualOrderRowcausadaporfazerumaespcie
Mudanasnoatualconjuntodecolunascausados
pelaadio,escondendooumovercolunas

Alteraesdedadoscelulares,editandoclulasdajaneladedados
MudanasametadadosdatabelaeditandoclulasdojanelaParameter
MudanasametadadosdecolunaeditandoclulasdojanelaColunas
Atabelaaparenteutilizadanosseguintescontextos:
JaneladeDados
AjanelaDadossempremostraaslinhasecolunasdatabelaaparente,porisso,sevocestiveremdvidasobreoqueformarumatabela
seroexportadas,vocpodeveroqueparecequeno.
Exportaes
Quandovocsalvaumatabela,ouexportlo,arrastandoopainelListadeTabelanajaneladecontrole,oucriarumatabeladuplicada,
oquadroaparentequecopiado.Assim,porexemplo,sevocdefinirumsubconjuntocontendoapenasasdezprimeiraslinhasdeuma
tabelae,emseguida,salveoemumanovatabela,oucriarumaduplicatadentroTOPCATutilizandoaTabelaDuplicate( botoda
barradeferramentas),atabelaresultanteconterapenasosdezlinhas.
Ingressa
QuandovocusaajaneladejogoouJanelaconcatenaoparaaconstruodeumanovatabelacombaseemumoumaisdosj
existentes,anovatabelaserconstrudosobreabasedasversesaparentesdastabelasqueestosendooperados.Omesmoseaplica
funcionalidadejuntarcomofornecidopeloenviosdemesanajanelaTAP,eabuscaposicionalmltipla(Cone,SIA,SSA)janelas.
Algunsdosoutrostabelavistajanelassoafetadostambm,porexemplo,ajanelaColunasexibesuascolunasnaordememqueaparecemna
tabelaaparente.

3.1SubconjuntosRow
UmacaractersticaimportantedoTOPCATacapacidadededefinireusarSubconjuntosRow.UmsubconjuntoRowumaseleodas
linhasdentrodeumatabelainteiraaservistosdentrodoaplicativo,ouequivalentementeumanovatabelacompostaapartirdeumsubconjunto
desuaslinhas.Vocpodedefiniressaseuslosdevriasmaneirasdiferentesautilidadevemdefinindoosemumcontextoeuslosemoutro.
AJanelasubconjuntoexibeossubconjuntosdelinhadefinidosatualmenteepermitequealgumasoperaessobreeles.
Aqualquermomento,cadamesatemumacorrentesubconjuntolinha,eissoafetaaTabelaaparente.Vocsemprepodeveroque,olhando
paraoselector"RowSubset"najaneladecontrolequandoessatabelaselecionadaporpadro,eleumcontendotodasaslinhas.Vocpode
mudla,escolhendoentreesteselectoroucomoresultadodealgumasoutrasaes.
Outroscontextosemquesubconjuntospodemserusados
estoescolhendoumaseleodelinhasapartirdoqualacalcularnajanelade

estatsticasemarcaogruposdelinhasparaplotarutilizandomarcadoresdiferentesnosvriosplotagem(eplotagemdeestiloantigo)janelas.
3.1.1DefinindoSubconjuntos
VocpodedefinirumsubconjuntoRowemumadasseguintesformas:
Selecionarlinhasnonavegador
VocpodeselecionarumanicalinhanaJaneladeDados,clicandosobreela,ouselecionarumgrupodelinhasadjacentes,arrastandoo
mousesobreeles.Vocpodeadicionarmaislinhasparaaseleo,mantendoobotopressionadoenquanto<Control>vocfazlo.Uma
vezquevoctemumconjuntodelinhasselecionadasvocpodeusarosubconjuntodelinhasselecionadas( ou)Subconjuntode
linhasnoseleccionadas(

botes)paracriarumnovosubconjuntocombasenoconjuntodelinhasrealadasouseucomplemento.

http://127.0.0.1:2525/doc/sun253/sun253.html

7/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

CombinandoissocomaclassificaodaslinhasnatabelapodesertilsevocfizerumaOrdemascendenteemumadeterminadacoluna
e,emseguida,arrasteoincioalgumaslinhasdatabelavocpodefacilmentecriarumsubconjuntocompostopelosmaioresvaloresde
umadeterminadacoluna.
Definindoumaexpressoalgbrica
ApartirdajanelasubconjuntousandooAdicionarNovosubconjunto(

)irapareceroJanelaalgbricasubconjuntoquelhe

permitedefinirumnovosubconjuntousandoumaexpressoalgbricacombasenosvaloresdasclulasemcadalinha.Oformatodetais
expressesdescritonaSeo7.
Pontostraadosvisveis
Emalgunsdosplotagem(eplotagemdeestiloantigo)doWindowsquevocpodetraarcolunasunscontraosoutros,e,posteriormente,
zoomineoutusandoomouse.Sevocaumentarozoomparaexibirapenasalgunsdospontostraadose,emseguida,usaroNew
subconjuntodevisvel( ou boto),emseguida,umnovosubconjuntosercriadocontendoapenasaslinhasrepresentadaspor
pontosnocampodevisodatramanapoca.
Pontostraadosselecionados
Paraobtermaiscontrolesobrequaispontostraadosdevemserincludosemumsubconjunto,vocpodeusarosorteiosubconjunto
Regio( boto)emalgumasdasjanelasdeplotagem.Istopermitelhetraarcomomouseumaregioouregiesdequalquerforma,
acriaodeumnovosubgrupocontendoapenasaslinhasrepresentadaspelospontosdentrodessasregies.
Colunasbooleanos
Qualquercolunaquetemumboolean(verdadeiro/falso)valortipopodeserusadocomoumsubconjuntolinhasemquetemumvalor
verdadeiroestnosubconjuntoeoutrosno.Qualquercolunabooleanemumatabeladisponibilizadocomoumsubconjuntolinhacom
omesmonome,quandoatabelaimportada.
Emtodosessescasos,vocsersolicitadoaatribuirumnomeparaosubconjunto.Talcomoacontececomosnomesdascolunas,umaboa
idiaseguiralgumasregrasparaessesnomes,paraquepossamserusadasemexpressesalgbricas.Elesdevemser:
Distintodeoutrosnomesdesubconjuntoedecoluna,mesmoparaalmdo/inferiordistinesmaisculas
Sobaformadeumidentificadordejava(comeacomumaletra,continuacomcaracteresalfanumricos,incluindosublinhado,sem
espaos)
Nomuitotempo
Quandovocescolheumnome,vocpodedigitarumaouselecioneumdalistadropdown,quedosnomesdetodosossubconjuntos
existentes.Issopermitequevocredefinirsubconjuntosexistentes.NotaSevocselecionaroudigitarumdosnomesexistentes,qualquer
contedoanteriordessesubconjuntoserperdido.
Noprimeiromtododedefiniosubconjuntodecima,oactualsubconjuntoserdefinidoimediatamenteparaocriadorecentemente.Em
outroscasos,onovosubconjuntopodeserdestacadodeformaadequadaemoutrasjanelas,porexemplo,porserplotadosemdispersojanelas
enredo.

3.2OrderRow
Vocpodeclassificaraslinhasdecadatabeladeacordocomosvaloresemumacolunaselecionada.Normalmentevocdesejaclassificaruma
colunanumrica,masoutrosvalorespodemserclassificveis
tambm,porexemplo,umacolunadeCordasirclassificaremordemalfabtica.

Algunstiposdecolunas(porexemplo,aquelesdematriz)notmqualquerordembemdefinida,enopossvelselecionarestesparaa
classificaodiante.
Aqualquermomento,cadamesatemumacorrentedefimdelinha,eissoafetaaTabelaaparente.Vocsemprepodeveroqueolhandona
rubrica"Ordem"najaneladecontrolequandoessatabelaselecionadapelopadro"(nenhum)",oquesignificaqueaslinhastmamesma
ordemdegrandezaqueatabelaqueforamcarregadosapartirde.Apequenaseta( / )indicaseosentidodotipoparacimaoupara
baixo.Vocpodealteraraordemdeclassificao,selecionandoumnomedacolunaapartirdestecontrole,emudarosentido,clicandonaseta.
AordemdeclassificaotambmpodeseralteradousandoositensdemenunajanelaColunasoumenuspopupclicandocomobotodireito
najaneladedados.
Seleodeumacolunaparaclassificarporcalculaanovaordemdelinhaatravsdarealizaodeumaespciesobreosvaloresdasclulasea
ento.Seosdadosdatabelamudardealgumaforma(porexemplo,porquevoceditarclulasdatabela),entopossvelqueaordemde
classificaoparatornarsedesatualizado.
AatualordemdelinhaafetaaTabelaaparentee,portanto,determinaaordemdelinhasemtabelasquesoexportadosdequalquerforma(por
exemplo,escrito)deTOPCAT.VocsemprepodeveraslinhasemsuaordematualmenteclassificadasnaJaneladeDados.

3.3conjuntodecolunas
Quandocadatabelaimportada,temumalistadecolunas.Cadacolunateminformaesdecabealhoquedeterminaotipodedadosquepode
preencherasclulasdessacoluna,bemcomoumnome,etalvezalgumasinformaesadicionais,comounidadesedescritordecontedo
unificado.Todaestainformaopodeservistoe,emalgunscasos,modificados,najanelaColunas.
DuranteotempodevidadatabeladentroTOPCAT,estalistadecolunaspodeseralteradapelaadiodenovascolunas,escondendose(e
talvez,posteriormente,revelando)colunasexistentes,emudandosuaordem.Oestadoatualdequaiscolunasestopresentesevisveiseque
ordemelesestoemcoletivamenteconhecidocomooconjuntodecolunas,eafetaaTabelaaparente.Oatualconjuntodecolunassempre
refletidanaordememqueascolunassoexibidasnajaneladedadosejaneladeestatsticas.AJanelaColunasmostratodasascolunas
conhecidas,incluindoasocultas,demodoconjuntodecolunassesoactualmentevisveisindicadopela(maisesquerda)dacoluna
"visvel".
VocpodeafetaracolunaatualSituadonasseguintesformas:
http://127.0.0.1:2525/doc/sun253/sun253.html

8/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Esconder/Revelarcolunas
NaJanelaColunasvocpodealternarentreascolunasocultoevisvelclicandoemseucaixanoVisvelcoluna.Parafazercomqueum
grupodecolunasocultasouvisveisaomesmotempo,selecioneaslinhascorrespondentes(arrasteomousesobreelesparaselecionarum
grupocontguosegureobotodecontroleparabaixoparaadicionarmaislinhasindividuaisougruposcontguosparaaseleo)ebateu
oEsconderSelecionado( )ouRevelarselecionado( boto)nabarradeferramentasoumenu.Notaaoselecionarlinhas,no
arrasteomousesobreacolunaVisvel,fazloemalgumlugarnomeiodatabela.OOcultartodosos(

)erevelartodosos(

botesdefinidostodasascolunasnatabelainvisvelouvisvelumaconveninciatilsevoctemumatabelamuitogrande.
Voctambmpodeocultarumacolunaclicandocomobotodireitosobreelenajaneladedados,oqueabreummenupopup
selecioneaocultaropo.Paratornlovisvelnovamentevoctemqueirparaajaneladecolunascomoacima.
MovaColunas
Najaneladedadosquevocpodemovercolunas,arrastandoocabealhodacolunacinzaesquerdaoudireitaparaumanovaposio
(comodecostumeemumaJTable).Alternativamente,vocpodearrastaraslinhasdajanelaColunas,agarrandoocabealhodalinha
cinza(clulanumeradaesquerda)earrastandooparacimaouparabaixo.Qualquerumdestesafetaoconjuntodecolunas,comovoc
podeveraoolharparaumajanelaaomovercolunasnaoutra.
Adicionarcolunas
Vocpodeusaranovacolunasinttica( )ouNewSkyCoordenarColumns( )botesnajanelaColunasounomenupopup
(cliquecomobotodireito)naJaneladeDadosparaadicionarnovascolunasderivadasqueridosexsiting.
Substituirumacoluna
SeumacolunaforselecionadonajanelaColumnsouapartirdomenupopupdajaneladedadosquevocpodeusaracoluna
Substituircomsinttico( boto).Estesemelhanteaoadicionarumacolunasintticodescritonoitemanterior,maseleaparece
umnovodilogocolunacomcaractersticassemelhantes(nome,unidadesetc)aosdacolunaqueestsendosubstitudo,equando
completouranhurasanovacolunanaparaatabeladeesconderoantigo.
Adicionarumacolunadesubconjunto
SevoctiverdefinidoumsubconjuntoRowdealgumaformaevocquerqueeleapareaexplicitamentenatabela(porexemplo,para
que,quandovocescreveamesaparaforaaseleosalva),vocpodeselecionarosubconjuntonaJanelaSubconjuntoseusaroPara
Coluna( )boto,queiradicionarumanovacolunabooleanparaamesacomovalorverdadeiroparalinhaspartedesse
subconjuntoefalsoparaasoutraslinhas.

Tabela4I/O
4.1FormatosdeMesa
TOPCATsuportaumaamplavariedadedeformatosdedadostabulares.Namaioriadoscasosestessoformatosdearquivosparatabelas
armazenadoscomoarquivosindividuaisemumdiscoounofinaldeumaURL,mashoutraspossibilidades,porexemplo,umatabeladeter
abertopoderiaseroresultadodeumaconsultaSQLemumbancodedados.
Desdequevocpodecarregarumatabeladeumformatoesalvloemumdiferente,TOPCATpodeserusadoparaconverterumatabelaa
partirdeumformatoparaoutro.Seissotudoquevocquerfazernoentanto,vocpodeacharquemaisconvenienteusaratcopyutilitrio
delinhadecomandonoSTILTSpacote.
Amanipulaoformatoextensvel,assimnovosformatospodemseradicionadosfacilmente.Todaatabeladeentrada/sadatratadopelo
STIL,aStarlinkTabelasInfrastructureLibrarydescriesmaisdetalhadassobreosrecursosdeE/Spodeserencontradoemsua
documentao.
Assubseesseguintesdescrevemosformatosdisponveisparalereescrevertabelas.Asduasoperaessoseparadas,porissonemtodosos
formatosdeentradasuportadostmcorrespondnciaformatosdesadaeviceversa.
4.1.1Formatosdeentradasuportados
CarregandotabelasemTOPCATfeitoapartirdalinhadecomandoquandovociniciaroprogramaouusaroTableCargadilogo.Para
FITS,VOTableeCDFformataoformatodearquivopodeserdetectadoautomaticamente(notequeestefeitoporolharparaocontedodo
arquivo,notemnadaavercomextensesdearquivo).Paraoutrosformatos,porm,porexemplo,ASCIIouvaloresseparadosporvrgula,
vocterqueespecificaroformatoqueoarquivoestdentroNajaneladecarga,humacaixadeseleoapartirdoqualvocpodeescolhero
formatoe,apartirdalinhadecomandovocusaro-fbandeiraverSeo10paramaisdetalhes.Vocsemprepodeespecificaroformatoem
vezdeusaradetecoautomtica,sevocpreferirestapodeserumaboaidiaseumamesapareceestarfalhandoparacarregardeforma
surpreendente,umavezquepodedarlheumamensagemdeerromaisdetalhada.
Emambososcasos,oslocaisdemesapodeserdadacomonomesdearquivosoucomoURLsequalquercompressodedados(gzip,unix
comprimirebzip2)serautomaticamentedetectadoetratadovejaSeo4.2.
Nota:emalgumasversesanterioresdoTOPCAT,formatartabelasASCIIpodeserdetectadoautomaticamente,assimvocpodecarreglos
digitandoalgocomo"Table.txt topcat".Naversoatual,voctemquesinalizarqueestaumatabelaASCII,porexemplo,digitando"
topcat-f ascii Table.txt".
AsseesseguintesdescrevemosformatosdetabelaqueTOPCATpodeler.
4.1.1.1FITS
http://127.0.0.1:2525/doc/sun253/sun253.html

9/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

FITSbinrioeextensesdetabelaASCIIpodeserlido.Normalmente,TOPCATircarregartodasasextensesTABLEouBINTABLEem
umdeterminadoarquivo.
SesomenteumanicaextensonecessrioapartirdeumsistemamultiextensoFITSficheiro,esteindicadomedianteumidentificador
depoisdeum'#'nofimdalocalizaodemesa.Oidentificadorpodeseremumadasduasformas:
OndicenumricodoHDU.Aprimeiraextenso(primeiroHDUapsaHDUprimrio)numerada1.Assim,emumcomprimido
FITStabelachamada"spec23.fits.gz"comumaHDUprimrioeduasextensesBINTABLE,vociriaveroprimeirousandoonome
spec23".fits.gz"ou"spec23.fits.gz#1"easegundacomonome"spec23.fits.gz#2".Osufixo"#0"nuncausadoparaumarquivo
FITSlegal,umavezqueoHDUprimrianopodeconterumatabela.
Onomedaextenso.EsteovalordocabealhoextnamenoHDU,oualternativamenteovalordeextnameseguidopor"",seguido
pelovalordeEXTVER.IstoseguearecomendaonosFITSpadroqueextnameeEXTVERcabealhospodemserusados
para

identificarumaHDU.Assim,emummultiextensoFITSarquivo"cat.fits",ondeumaextensodetabelatemextname='UV_DATA'e
EXTVER=1,poderiaserreferenciadoscomo"cat.fits#UV_DATA"ou"cat.fits#UV_DATA1".Matchingdessesnomescase
insensitive.
Vocpodeselecionarqualextensousardeformainterativasevocusaronavegadordehierarquiaparacarregaramesa.
SeatabelafoiescritousandooTOPCAT"encaixa-plusformato"desada(verSeo4.1.2.1),emseguida,osmetadadosserolidosdo
primrioHDUtambm.
ParaarquivosFITSnormais,cartesdecabealhonocabealhoHDUdatabelaserdisponibilizadocomoparmetrosdatabela(verApndice
A.3.2).Apenascartesdecabealhoquenosoutilizadosparaespecificaroprprioformatodetabelasovisveiscomoparmetros(por
exemplo,NAXIS,TTYPE*etccartesnoso).HISTRIAecomentarcartessoexecutadosemconjuntocomoumvalordemultilinha.
SeatabelaarmazenadaemumFITSextensomesabinrioemumarquivonodiscolocalemformadescompactada,entoatabela
'mapeado'namemriaissogeralmentesignificaocarregamentorpidoebaixousodememria.
4.1.1.2FITSorientadaaColuna
AssimcomobinrionormaleASCIIFITStabelas,STILsuportaarquivosFITSquecontmdadostabularesarmazenadosemformato
orientadoacoluna.IstosignificaqueatabelaarmazenadaemumaextensoBINTABLEHDU,masqueBINTABLEtemumanicalinha,
comcadacluladessalinhasegurandonovalordedadosdeumacolunainteira.A(omaislentovarivel)decadadimensofinaldestasclulas
(declaradoatravsdoscartesdecabealhoTDIMn)amesma,isto,onmerodelinhasnatabelaqueestrepresentado.Opontodistoque
todasasclulasdeumadadacolunasoarmazenadosdeformacontgua,queparatabelasmuitograndes,eespecialmentemuitolargassignifica
quecertospadresdeacesso(basicamente,aquelescujoacessoapenasumapequenaproporodascolunasnumatabela)podesermuitomais
eficienteumavezqueexigemmenossobrecargadeE/Snaleituradeblocosdedados.
EssastabelassoperfeitamentearquivosFITSlegais,masamaioriadossoftwaresnoSTILprovavelmentenoirreconhecloscomotabelas
naformahabitual.Esteformatoprincipalmentedestinadoparaocasoemquevoctemumagrandemesaemalgumoutroformato
(possivelmenteoresultadodeumaconsultaSQL)evocdesejaarmazenaremcachelodeumaformaquepodeserlidadeformaeficiente,um
aplicativobaseadoemSTIL.
ComoFITSnormais,duasvariantessosuportadoscom(colfits-plus)esem(colfits-bsicos)metadadosarmazenadocomouma
matrizdebytesVOTablenoHDUprimrio.
Colfitsformatoestdisponvelapenasparadadosquearmazenadoscomoumarquivodescompactadonosistemadearquivos(no,por
exemplo,apartirdeumaURL).
4.1.1.3VOTable
VOTableumformatobaseadoemXMLparadadostabulares,aprovadopeloObservatrioVirtualInternacionalAlianaenquantoosdados
tabularquepodesercodificadopordesignparecidocomoqueFITSpermite,prevacodificaomuitomaisricadaestruturaemetadados.
TOPCATacreditaselerqualquertabelaqueestemconformidadecomasVOTable1.0,1.1,1.2ou1.3especificaes.Istoincluimesasem
queosdadosdaclulaestoincludosnalinhacomoelementosXML(formatoVOTable/TableData),nemcompreendidos/referenciadas
comoFITSmesa(VOTable/FITS)ouincludo/referenciadocomoumfluxobinrio(VOTable/BINRIOouVOTable/BINARY2).No
TOPCATnotentarserexigentequantodeentradadedocumentosVOTable,eelevaiterumbommovimentonaleituraVOTablesque
violamospadresdevriasmaneiras.
DocumentosVOTablepodeterumaestruturahierrquicacomplicado,epodemcontermaisdoqueumatabelareal(elementoTABELA).
Normalmente,TOPCATircarregartodasastabelasqueencontranodocumento.Sevocsquercarregarumanicatabela,indicarondice
baseadoemzerodoelementoTABLEemumabuscaemlarguradepoisdeumcaractere'#'nofinaldaespecificaodemesa.Aquiestum
exemplodedocumentoVOTable:
<VOTABLE>
<Resource>
<TABLE Name="Star Catalogue"> ... </ TABLE>
<TABLE Name="Galaxy Catalogue"> ... </ TABLE>
</ Resource>
</ VOTABLE>

Seissoestdisponvelemumarquivochamado"cats.xml"depoisdecarregarodocumentodamaneirausualapartirdonavegadorfilestoreou
linhadecomandovaiabrirduasnovastabelasnoTOPCAT.SevocquiserapenasoCatlogoEstrelaouoCatlogoGalaxyvocpodeusaro
nomede"cats.xml#0"ou"cats.xml#1",respectivamente.

http://127.0.0.1:2525/doc/sun253/sun253.html

10/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

4.1.1.4CDF
FormatocomumdedadosdaNASA,descritonohttp://cdf.gsfc.nasa.gov/,umformatobinrioparaarmazenamentodedadosdeauto
descrio.Elegeralmenteusadoparaarmazenardadostabularesparareascomooespaoeafsicasolar.Desdev4.01TOPCATcapazde
lerarquivosCDF,emboranopossaescrevlos.Atualmente,nofeitanenhumatentativapararepresentarvaloresvezesrepresentandode
umaformahumanafriendly.Issopodemudaremfuturasverses.
4.1.1.5ASCII
Emmuitoscasos,astabelassoarmazenadosemalgumtipodeformatodetextosimplesnoestruturada,comclulasseparadasporespaosou
outrosdelimitadores.Existeumagrandevariedadedetaisformatos,dependendodoqueosdelimitadoressoutilizados,comoascolunasso
identificadas,seosvaloresembrancosopermitidaseassimpordiante.impossvellidarcomtodaselas,masTOPCATtentafazerumbom
palpitesobrecomointerpretarumdeterminadoarquivoASCIIcomoumatabela,queemmuitoscasosbemsucedida.Emparticular,sevoc
stemcolunasdenmerosseparadosporalgoqueseparececomespaos,vocdeveestarmuitobem.
AquiestoasregrasdecomoastabelasASCIIdeformatosointerpretados:
BytesnoarquivosointerpretadoscomocaracteresASCII
Cadalinhadatabelarepresentadoporumanicalinhadetexto
Aslinhassoterminadasporumoumaiscaracteresdefimdelinhacontguos:avanodelinha(0x0A)ouretornodecarro(0x0D)
Dentrodeumalinha,oscampossoseparadosporumoumaiscaracteresembranco:espao("")outabulao(0x09)
Umcampoouumaseqnciadecaracteressemaspasnoespaoembranco,ouumaseqnciadecaracteresnonovalinhaentre
correspondnciasimples(')ouduplas(")aspasosespaosso,portanto,permitidoemcamposcitados
Dentrodeumcampoentreaspas,caracteresembrancosopermitidasesotratadosliteralmente
Dentrodeumcampocitado,qualquercaractereprecedidoporumabarrainvertida("\")tratadoliteralmente.Issopermitequeos
caracteresdeaspasparaaparecerdentrodeumastring.
Umastringvaziacitado(duascitaesadjacentes)ouaseqncia"nulo"(noindicada)representaovalornulo
Todasaslinhasdedadosdeveteromesmonmerodecampos(istoonmerodecolunasdatabela)
Otipodeumacolunadedadosimaginadodeacordocomoscamposqueaparecemnatabela.Setodososcamposemumacolunapode
seranalisadocomointeiros(ouvaloresnulos),entoessacolunavaisetransformaremumacolunadotipointeiro.Ostiposqueso
julgados,emordemdepreferncia,so:Boolean,Curto Integer,Longo,Float,duplo,seqncia
SopermitidasAlgunsvaloresespeciaisparacolunasdepontoflutuante:NaNparanoumnmero,quetratadoomesmoqueumvalor
nuloparaamaioriadospropsitos,eInfinitoouinfparainfinito(comousemumprecedentesinal+/).Estesvaloresso
comparadoscasoinsensvel.
Linhasvaziassoignoradas
Qualquercoisadepoisdeumhashdecaracteres"#"(comexceodeumaemumastring)emumalinhaignorado,tantoquantoos
dadosdatabelavaiqualquerlinhaquecomeacomum"!"Tambmignorado.Noentanto,aslinhasquecomeamcomum"#"ou"!"
noinciodoquadro(antesdequaisquerlinhasdedados)interpretadocomometadadoscomosesegue:
Altima"#"/"!"Linhadepartidaantesdaprimeiralinhadedadospodeconterosnomesdascolunas.Seeletemomesmo
nmerodecampos,conformeexistemcolunasnatabela,cadacamposerlevadoparaserottulodacolunacorrespondente.Caso
contrrio,elairserfeitacomoumalinhadecomentrionormal.
Quaisquerlinhasdecomentrioantesdaprimeiralinhadedadosnoabrangidospelodispostoacimaserconcatenadoparaformar
a"descrio"parmetrodatabela.
Sealistaderegrasacimapareceassustador,nosepreocupe,emmuitoscasos,eladevefazerosentidodeumamesasemterdelerasletras
pequenas.AquiestumexemplodeumatabelaASCIIformatoadequado:
#
# Aqui est uma lista de alguns animais.
#
# PERNAS RECNO ESPCIES NOME ALTURA / m
1 porco "Pigling Bland" 4 0,8
2 vaca Daisy 4 2
3 peixinho Dobbin "" 0,05
4 formiga "" 6 0,001
5 formiga "" 6 0,001
6 formiga'' 6 0,001
7 "formiga rainha" 'Ma \' am '6 2e-3
8 humano "Mark" 2 1.8

Nestecaso,eleiridentificarasseguintescolunas:
Nome Tipo
-------RECNO Curto
ESPCIES Cordas
Nome String
Pernas curtas
ALTURA / m Float

Eletambmvaiusarotexto"Aqui est uma lista de alguns animais",comoadescriodoparmetrodatabela.Semqualqueruma


daslinhasdecomentrio,eleaindairiainterpretaratabela,masascolunasseriadadoosnomescol1..col5.
Sevocentenderoformatodeseusarquivos,maselesnocorrespondemexatamenteaoscritriosacima,amelhorcoisa,provavelmente,para
escreverumprogramafreestandingsimplesouscriptqueirconvertlosemformatodescritoaqui.VocpodeacharPerlouawkidiomas
adequadosparaestetipodecoisa.
Esteformatonodetectadoautomaticamentevocdeveespecificarquevocdesejacarregarumatabelaemasciiformato.
http://127.0.0.1:2525/doc/sun253/sun253.html

11/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

4.1.1.6IPAC
InfraredProcessamentodeCaltecheCentrodeAnliseusarumformatobaseadoemtextoparaoarmazenamentodedadostabulares,definido
nohttp://irsa.ipac.caltech.edu/applications/DDGEN/Doc/ipac_tbl.html.Astabelaspodemarmazenaronomedacoluna,tipo,unidadese
valoresnulos,assimcomoosparmetrosdatabela.Elesnormalmentetmumaextensodenomedearquivo". tbl"esousados
paradados

doSpitzer,entreoutrascoisas.Umexemploparecidocomeste:
\ Title = 'animais'
\ Esta uma tabela com alguns animais na mesma.
| RECNO | ESPCIES | NOME | PERNAS | Altura |
| Carvo | carvo | carvo | int | dupla |
|||||M|
| | | Nulo | | |
1 porco Pigling Bland 4 0,8
2 vaca Daisy 4 2
3 peixinho Dobbin 0 0.05
4 nulo formiga 6 0,001

4.1.1.7valoresseparadosporvrgula
Formatodevalorseparadoporvrgulas("CSV")umformatobaseadoemtextosemipadrocomumemqueoscampossodelimitadospor
vrgulas.Planilhaseletrnicasebancosdedadossocapazesdeexportarosdadosemalgumavariantedamesma.AintenoqueTOPCAT
podelertabelasnaversodoformatofaladoporMSExcel,entreoutrasaplicaes,emboraadocumentaoemquefoibaseadonofoiobtida
diretamentedaMicrosoft.
Asregrasparaosdadosqueelecompreendesocomosesegue:
Cadalinhadeveteromesmonmerodecamposseparadosporvrgulas.
Espaosembranco(espaooutabulao)aoladodeumavrgulaignorado.
Adjacentevrgulas,ouumavrgulanoincioounofinaldeumalinha(espaoembrancoparte)indicaumcamponulo.
Aslinhassoterminadasporqualquerseqnciadetransportederetornooudenovalinhadecaracteres('\r'ou'\n')(umcorolriodisto
queaslinhasembrancosoignoradas).
AsclulaspodemsercolocadosentreaspasduplasOsvalorescitadospodemconterquebrasdelinha(ouqualqueroutropersonagem)
umcaracteredeaspasduplasdentrodeumvalorcitadorepresentadoporduasaspasduplasadjacentes.
Aprimeiralinhapodeserumalinhadecabealhocontendonomesdecolunasemvezdeumalinhadedados.Exatamenteasmesmas
regrassintticassoseguidosparatallinhacomoparaaslinhasdedados.
Esteformatonodetectadoautomaticamentevocdeveespecificarquevocdesejacarregarumatabelaemcsvformato.
4.1.1.8TabelaSeparadoTab
TabelaSeparadoTabouTST,umformatodetabelacombaseemtextousadoporumnmerodeferramentasastronmicas,incluindoda
StarlinkGAIAedoESOSkycatnoqualelesebaseia.AdefiniodoformatopodemserencontradasnoStarlinkSoftwareNota75A
implementaoaquiignoratodasaslinhasdecomentrio:.comentriosespeciais,taiscomoos"# coluna unidades de:"noso
processados.
Umexemploparecidocomeste:
Exemplo simples TST; catlogo fotometria estelar.
AC Davenhall (Edinburgh) 26/7/00.
Catlogo de U, B, V cores.
UBV fotometria do Monte Observatrio abbora,
ver Sage, Rosemary and Thyme (1988).
# Incio de definies de parmetros.
EQUINCIO: J2000.0
POCA: J1996.35
id_col: -1
ra_col: 0
dec_col: 1
# Fim de definies de parmetros.
ra <tab> dezembro <tab> V <tab> B_V <tab> U_B
- <tab> --- <tab> - <tab> --- <tab> --5:09:08.7 <tab> -8:45:15 <tab> 4,27 <tab> -0.19 -0.90 <tab>
5:07:50.9 <tab> -5:05:11 <tab> 2,79 <tab> 0,13 <tab> 0,10
5:01:26.3 <tab> -7:10:26 <tab> 4,81 <tab> -0.19 -0.74 <tab>
5:17:36.3 <tab> -6:50:40 <tab> 3,60 <tab> -0.11 -0.47 <tab>
[EOD]

4.1.1.9ConsultasdebancodedadosSQL
Comaconfiguraoadequada,TOPCATpodeserusadoparaexaminarosresultadosdeconsultasemumbancodedadosrelacionalSQL
compatvel.
Consultasdebancodedadospodeserespecificadocomoumastringnoformato:
http://127.0.0.1:2525/doc/sun253/sun253.html

12/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

jdbc: driver especfico-url # sql-query

Aformaexatadependentedodriver.AquiestumexemploparaoMySQL:
jdbc: mysql :/ / localhost/astro1 user = # mbt ra SELECT, dezembro DE ONDE SWAA vmag <18

queteriaumatabeladeduascolunas(ascolunassendo"ra"e"dec"),construdoapartirdecertaslinhasdatabela"SWAA"nabasededados
"astro1"namquinalocal,usandoosprivilgiosdeacessodembtusurio.
Felizmente,vocnotemqueconstruirissocomamo,humdilogoSQLQueryparaajudaracoloclojuntos.
NotesequeTOPCATnoverumatabelanobancodedadosdiretamente,masoresultadodeumaconsultaSQLnessatabela.Sevocquiser
vertodaatabelaquevocpodeusaraconsulta
SELECT * FROM table-name

masestejacientedequetalconsultapodesercaroemumagrandemesa.
OusodeconsultasSQLrequeralgumaconfiguraoadicionaldeTOPCATvejaSeo10.3.
4.1.1.10MundoDataCenter
fornecidoalgumsuporteparaarquivosproduzidospeloCentrodeDadosMundialdeFsicaTerrestreSolar.Oformatoemsi,aparentemente,
notemnome,masosarquivosnesteformatoparecidocomoseguinte:
Formatos e unidades de Coluna - (formatar colunas fixas que so espao simples separados.)
-----------------------Data e hora (AAAA MM DD HHMMSS)% 4d% 2d% 2d% 6d % 1s
ndice aa - 3-hora (provisria) nT% 3d
2000 01 01 000000 67
2000 01 01 030000 32
...

SuporteparatabelasWDCexperimental(queoformatoaindaexiste?)podenosermuitorobusto.
Esteformatonodetectadoautomaticamentevocdeveespecificarquevocdesejacarregarumatabelaemwdcformato.
4.1.2Formatosdesadasuportados
EscrevendotabelasdeTOPCATfeitousandoajanelaSalvartabela.Emgeral,voctemqueespecificaroformatoemquevocdesejaquea
tabelasejadesada,selecionandoapartirdoSalvarJanelaOutputFormatTableseletorasseguintesseesdescrevemasescolhaspossveis.
Emalgunscasos,existemvariantesdentrodecadaformatoestessodescritoscomobem.
Oprogramanotemformatodearquivo"nativo",massevocnotemprefernciaparticularsobrequaloformatoparasalvartabelaspara,
FITSumaboaescolha.UncompressedFITStabelasnonamaioriadoscasostemqueserlidotodoocaminho(elesso"mapeados"paraa
memria),oqueostornamuitorpidoparacarregar.OformatoFITSqueescritopordefault(tambmconhecidocomo"ENCAIXAplus")
tambmusaumtruqueparaarmazenarmetadadosadicionais,comoparmetrosdemesaeUCDsdeformaTOPCATpodelersenovamente
maistarde(verSeo4.1.2.1).EssesarquivossobastanteutilizvelcomoFITSnormaistabelasporoutrasaplicaes,maselesssero
capazesdeverosmetadadoslimitadosarmazenadosnoscabealhosFITS.Paraarquivosmuitograndes,emalgumascircunstncias,orientadas
paraacolunaFITS("colfits")formatopodesermaiseficienteparaalgumasaplicaes,emboraissosejaimprovveldeserentendidoano
serporcdigobaseadoemSTIL(TOPCATeSTILTS).Sevocquiserescreverparaumformatoquemantmtodososmetadadosemum
formatoporttil,emseguida,umdosponto4.1.2.3formatospoderiasermelhor.
4.1.2.1FITS
AosalvaremFITSformatarumnovoarquivogravadoconstitudopordoisHDUs(cabealho+UnidadesdeDados):umprimrio(exigido
pelanormaFITS),eumanicaextensodotipoBINTABLEcontendoosdadosdatabela.
Hduasvariantesdesteformato:
encaixabsico
OHDUprimriocontmapenascabealhosmuitomnimasesemdados.
encaixaplus
OHDUprimriocontmumamatrizdebytesquearmazenaosmetadadosdatabelacompletocomootextodeumdocumentoVOTable,
juntocomoscabealhosquemarcamestefoifeito.AmaioriadosleitoresFITStabelairignorarcompletamenteesteetrataroarquivo
comosecontivesseapenasatabela.QuandoTOPCAT(ououtrosSTILaplicaesbaseadasem)llonoentanto,eleslerosmetadadose
tornlodisponvelparauso.Destaforma,vocpodearmazenarseusdadosnoformatoFITSeficienteeamplamenteporttilsemperder
osmetadadosadicionais,comoparmetrosdetabela,colunaUCDs,descrieslongascolunas,etc,quepodemserassociadasparaa
mesa.Existemoutrosesquemas,maispadroparacombinarosbenefciosdaFITSeVOTable,massofredealgumasdesvantagens:
votable-fits-inlinedifcildeprocessardeformaeficiente(emespecial,osdadosnopodemserfacilmentemapeadosem
memria)evotable-fits-hrefrequerquevocmantenhaseusdadosemdoisarquivosseparados,quepodemficarseparadasumas
dasoutras.SevocquisergarantirqueosmetadadosestodisponveisparaoutrosprogramasVOTableaware,vocdeveusarumdos
normaisformatosVOTable.

http://127.0.0.1:2525/doc/sun253/sun253.html

13/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Emgeral,vocpodesimplesmentedeixarTOPCATdetectarautomaticamenteoformatoenosepreocuparsobrequaldestasvariantesest
sendoutilizadaseencaixa-plusestsendousadovocacaboudeobteralgunsbenefciosocultos.
4.1.2.2FITSorientadaaColuna
AosalvaremFITSorientadaacolunaformatarumnovoarquivogravadoconstitudopordoisHDUs(cabealho+unidadesdedados)um
primrio(exigidopelanormaFITS)eumanicaextensodotipoBINTABLEcontendoosdadosdatabela.AocontrriodoformatoFITS
normaisnoentanto,estequadroconstitudoporumanicalinha,emquecadaclulacontmosdadosparaumacolunainteira.Estepodeser
umformatomaiseficienteparatrabalharcomquandoselidacommuitogrande,eespecialmentemuitoampla,tabelas.Osbenefciosso
maioresquandootamanhodoarquivoexcederaquantidadedememriafsicadisponveleasoperaessonecessriasquepercorreratabela
usandoapenasalgumasdascolunas(muitodasoperaesdaTOPCAT,porexemplotraandoduascolunasunscontraosoutros,seencaixam
nestacategoria).AsobrecargaparalereescreveresteformatoumpoucomaiordoqueparaFITSnormaisnoentanto,eoutrasaplicaes
podemnosercapazdetrabalharcomele(emborasejaumarquivoFITSlegal),entonamaioriadoscasosFITSnormaisaescolhamais
adequada.
ComoFITSnormais(orientadaparaalinha)(verSeo4.1.2.1),existemduasvariantes:
colfitsplus
OHDUprimriocontmumamatrizdebytesquearmazenaosmetadadosdatabelaemformatoVOTable.
colfitsbsico
OHDUprincipalnocontmdados.
4.1.2.3VOTable
QuandoumatabelasalvoemformatoVOTable,umdocumentoemconformidadecomaespecificaoVOTablecontendoumnico
elementoTABLEdentrodeumelementonicorecursoescrito.AversodaespecificaoVOTablesegundoaqualasadasergravada
podesercontroladousandoovotable.version propriedadedosistema.
Humcertonmerodevariantesquedeterminamaformanaqualosdadosdatabela(elementodedados)escrito:
votableTableData
ElementoTableData(XMLpuro)
votablebinaryinline
Elementobinrioquecontmdadoscodificadosembase64nodocumento
votablefitshref
FITSelementoquecontmumarefernciaaumarquivoFITSrecmescritoexterna(comumnomederivadodoquedodocumento
VOTable)
votablebinaryhref
Elementobinrioquecontmumarefernciaaumarquivobinriorecmescritoexterna(comumnomederivadodoquedodocumento
VOTable)
votablefitsinline
FITSdadoscodificadosembase64elementocontendonodocumento
VejaaespecificaoVOTableparamaisexplicaodoqueessasvariantesdizer.Todoselespodemserlidospelomanipuladordeentrada
VOTable.
SeVOTable1.3sadaestemvigor,os*-binary-*opessersubstitudopor-*-binary2 *.
4.1.2.4ASCII
OsquadrospodemserescritousandoumformatoquecompatvelcomoformatodeentradaASCII.Eleescrevetoclaramentequanto
possvel,porissodeveficarumaboachancedesercompreensvelparaosoutrosprogramasquerequeremalgumtipodeinterpretaodetexto
simplesdeumatabela.
Aprimeiralinhaumcomentrio(iniciandocomum"#carter")queosnomesdascolunas,efeitaumatentativadealinharosdadosnas
colunasusandoespaos.Aquiumexemplodeumatabelacurtaescritonesteformato:
# ndice Espcies Nome Mamfero Pernas Altura
1 porco Bland 4 0,8 verdadeiro
2 vaca Daisy 4 2.0 verdadeiro
3 peixinho Dobbin 0 0.05 falso
4 formiga "" 6 0,0010 falso
5 formiga "" 6 0,0010 falso
6 Mark humano 2 1.9 verdadeiro

4.1.2.5Texto
Astabelaspodemsergravadosemumformatobaseadoemtextosimples,queprojetadoparaserlidoporsereshumanos.Noexisteleitor
paraesteformato.
Aquiumexemplodeumatabelacurtaescritonesteformato:
+ ------- + ---------- + -------- + ------ + -------- + ----- --- +
| ndice | Espcies | Nome | Pernas | Altura | Mamfero |
+ ------- + ---------- + -------- + ------ + -------- + ----- --- +

http://127.0.0.1:2525/doc/sun253/sun253.html

14/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

| 1 | porco | Bland | 4 | 0.8 | verdadeiro |


| 2 | vaca | Margarida | 4 | 2.0 | verdadeiro |
| 3 | peixinho | Dobbin | 0 | 0,05 | false |
| 4 | formiga | | 6 | 0,0010 | false |
| 5 | formiga | | 6 | 0,0010 | false |
| 6 | humano | Mark | 2 | 1.9 | verdadeiro |
+ ------- + ---------- + -------- + ------ + -------- + ----- --- +

4.1.2.6valoresseparadosporvrgula
Astabelaspodemsergravadosnoformatosemipadrodevaloresseparadosporvrgulas(CSV),descritosemmaisdetalhesemSeo4.1.1.7.
Istopodesertilparaimportarparacertasaplicaesexternas,comoalgumasplanilhasoubancosdedados.
Existemduasvariantes:
CSV
Aprimeiralinhaumcabealhoquecontmosnomesdascolunas.
CSVnoheader
Nenhumalinhadecabealhoemitido,todasaslinhasrepresentamaslinhasdedados.
4.1.2.7IPAC
OsquadrospodemserwrttenparaoformatodedadosdeIPAC,descritoemmaisdetalhenaSeco4.1.1.6.
4.1.2.8TabelaSeparadoTab
OsquadrospodemserescritasemformatoTST,aqualdescritaemmaisdetalhenaSeco4.1.1.8.Istopodesertilparasecomunicarcom
algumasoutrasferramentasastronmicascomoGAIA.
4.1.2.9tabelasSQL
Comaconfiguraoadequada,TOPCATpodeescrevertabelascomonovastabelasemumbancodedadosrelacionalSQLcompatvel.
Paraaescrita,alocalizaoespecificadacomooseguinteURL:
jdbc: especfica do driver-url # new-table-name

Aformaexatadependentedodriver.AquiestumexemploparaoMySQL:
jdbc: mysql :/ / localhost/astro1 user = # mbt newtab

queescreverocontedoatualdonavegadoremumanovatabelacomonome"newtab"nabasededados"astro1"namquinalocalcomos
privilgiosdeacessodembtusurio.
Felizmente,vocnotemqueconstruirestaURLmo,humacaixadedilogoSQLparaajudaracoloclojuntos.
OusodeconsultasSQLrequeralgumaconfiguraoadicionaldeTOPCATvejaSeo10.3.
4.1.2.10HTML
UmatabelapodeserescritacomoumHTML4.01TABELAelemento,adequadoparausocomoumapginawebouinseroemum.
Existemduasvariantes:
HTML
UmdocumentoHTMLindependente,comHTML,acabeaeocorpotagasada.
HTMLelemento
ApenasoelementoTABLEquerepresentaatabeladesadaestadevenormalmenteserincorporadoemumdocumentoHTMLmaior
antesdouso.
4.1.2.11LaTeX
UmatabelapodeserescritocomoumaLaTeXtabularambiente,adequadoparaainseroemumdocumentodestinadoapublicao.
Existemduasvariantes:
LaTeX
OtabularelementosemitidoestaterdeserincorporadoemumdocumentoLaTeXmaiorantesdouso.
LaTeXdocumento
UmdocumentoLaTeXautnomo,queconsistenatabeladentrodeumatabeladentrodeumdocumentoemitido.
Obviamente,istonotoapropriadoparagrandestabelas.
4.1.2.12MirageFormat
http://127.0.0.1:2525/doc/sun253/sun253.html

15/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

MirageumapoderosaferramentajavaautnomodesenvolvidonosLaboratriosBellparaanlisededadosmultidimensionais.Eleusaseu
prprioformatodearquivoparaaentrada.TOPCATpodeescrevermesasnoformatodeentradaqueusaMirage,demodoquevocpode
preparartabelasnoTOPCATeescrevlosparausoposteriorpeloMirage.
Tambmpossvel,emprincpio,paralanarMiragediretamentededentroTOPCAT,usandooMirageExportarparaitemnajanelade
controledoarquivodemenuissofarcomqueMirageparainiciaravisualizaodoselecionadoTabelaaparente.Paraqueissofuncioneas
classesMiragedeveestarnoseuclasspath(vejaSeo10.2.1)quandoTOPCATexecutado.
ParecehaverumbugnoMiragequesignificaqueestenemsemprefuncionasvezesMirageiniciasemdadoscarregadosnele.Nestecaso,
vocterquesalvarosdadosnodiscoemformatoMirage,iniciarMirageseparadamente,ecarregarosdadosnousodoNewDatasetitemdo
MirageConsolemenu.
NotequequandoMiragefoilanadoapartirdeTOPCAT,saindoMirageoufecharajanelasairTOPCATtambm.
Formatospersonalizados4.1.3E/S
,emprincpio,possvelconfigurarTOPCATparatrabalharcomoutrosdoqueoslistadosnestaseoformatosdearquivodatabela.Eleno
requerqualqueratualizaodaprpriaTOPCAT,masvoctemqueescreverouadquirirummanipuladordeentradaesadae/ouparao
formatodetabelaemquesto.
Ospassosquevocprecisatomarso:
1. Escreverclassesjavaqueconstituemasuaentradae/ousadademanipulador
2. CertifiquesedequeessasclassesestodisponveisnoclasspathenquantoTOPCATestemexecuo(vejaSeo10.2.1)
3. Definaasstartable.readerse/oustartable.writerspropriedadedosistemaparaonomedasclassesdemanipulador(verSeo
10.2.3)
ExplicandocomoescreveressesmanipuladoresestalmdoescopodestedocumentoverodocumentodeusurioejavadocsparaSTIL.

4.2LocaisdeMesa
Emmuitoscasos,carregaresalvarmesasserfeitautilizandodilogosGUI,taiscomoofilestorecargaesalvarjanelas,ondevocsprecisa
clicaremumnomedearquivooudiretrioparaindicaracarga/salvarlocal.Noentanto,emalgunscasos,porexemplo,especificandotabelas
nalinhadecomando(Seo10.1)oucaminhosdedigitaodiretamentenacarga/salvarjanelasdedilogo,vocpodequererdara
localizaodeumatabelaparaentradaousadausandoapenasumanicacadeia.
Namaioriadasvezesvocsvaiquererdigitarumnomedearquivoouumcaminhoabsolutoourelativopodeserusado.Noentanto,
TOPCATtambmsuportaousodiretodeURLs,inclusiveusandoalgunsprotocolosespecializados.AquiestalistadetiposdeURL
permitidos:
http:

LeiaapartirderecursosdeHTTP.

ftp:

LeiaapartirderecursosdeFTPannimo.

arquivo:

Leiaapartirdearquivoslocaisnoparticularmentetil,poisvocpodefazeramesmacoisausandoapenasonomedoarquivo.

jar:

ProtocoloespecializadoparaolhardentrodearquivosJavaArchiveverJarURLConnectiondocumentao.

myspace:

AcessaarquivosnoAstroGrid"MySpace"armazenamentodearquivovirtual.EssasURLsalgoparecido"myspace :/ levantamento
/ iras_psc.xml",epodeacessararquivosnomyspacesodequeousurioestconectado.EssesURLspodemserusados
para

entradaesadadetabelas.ParauslosvocdeveterumacontaAstroGrideoWorkBenchAstroGridousimilardeveestaremexecuo
sevocnoestconectadonomomentoumdilogoiraparecerparapedirlhenomeesenha.

ivo:

CompreendetipoivoURLsquesignificamarquivosnoAstroGrid"MySpace"armazenamentodearquivovirtual.EssasURLsalgo
parecido"ivo :/ / uk.ac.le.star / gerenciador de arquivos # n-2583".EssesURLspodemserusados
paraentradae

sadadetabelas.ParauslosvocdeveterumacontaAstroGrideoWorkBenchAstroGridousimilardeveestaremexecuosevoc
noestconectadonomomentoumdilogoiraparecerparapedirlhenomeesenha.

jdbc:

UsadoparasecomunicarcombancosdedadosrelacionaisdoSQLcompliant.EstessoumpoucodiferentesparaURLsnormaisveja
Seo4.1.1.9e4.1.2.9Seo.

TalcomoacontececomosdilogosdecargabaseadoemGUI,compressodedadosemqualquerumdosformatossuportados(gzip,bzip2,
Unixcompactar)detectadoetratadoautomaticamenteparalocaisdeentrada.

5juntaseosJogos
TOPCATpermiteunirduasoumaistabelasemconjuntoparaproduzirumnovoemumavariedadedemaneiras,etambmparaidentificar
linhas"semelhantes"dentrodeumanicatabeladeacordocomosseuscontedoscelulares.Estaseodescreveosrecursosparaarealizao
dessasoperaesrelacionadas.
Hduasmaneirasbsicasparasejuntartabelasemconjunto:decimaparabaixoeladoalado.Atoptobottomjuntar(queaquieuchamode
concatenao)bastantesimplesnamedidaemqueexigeapenasquevocdecidirquaiscolunasdeumatabelaquecorrespondemacolunas
naoutra.Ajuntarseladoaladomaiscomplicadoqueraramenteocasodessalinhainaprimeiratabeladevecorresponderalinhaina
http://127.0.0.1:2525/doc/sun253/sun253.html

16/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

segunda,porisso,necessrioforneceralgunscritriosparadecidirquais(sehouver)emlinhaasegundatabelacorrespondeaumadadalinha
doprimeiro.Emoutraspalavras,umaespciedecorrespondnciaentrelinhasemdiferentestabelasprecisaacontecer.Istocorrespondeaoque
sechamaumjuntarnatecnologiadedados.Linhascorrespondentesdentrodeumanicatabelaumaoperaoqueenvolvetilmuitasdas
mesmasquestes,demodoquedescritoaquitambm.

5.1AconcatenaodeTabelas
DuastabelaspodemserconcatenadasusandooJanelaconcatenao,queapenasrequerquevocespecifiqueasduastabelasaseremunidas,e
paracadacolunanaprimeiratabela("Base"),quenasegundacoluna("anexado")mesa(sequalquer)correspondeaele.ATabelaaparente
utilizadaemcadacaso.Oquadroresultante,oqualadicionadolistadetabelasconhecidasnajaneladecontrolo,temasmesmascolunasque
atabeladebasededados,eumnmerodelinhasigualsomadonmerodelinhasnabasededadoseastabelasanexas.
Comoumexemplomuitosimples,concatenandoessasduastabelas:
Nome Messier RA Dec
---------------Nebula 97 168.63 55.03 Coruja
101 210,75 54,375 Pinwheel Galaxy
64 194,13 21.700 Galxia do olho roxo

e
RA2000 DEC2000 ID
--------------185,6 58.08 M40
186,3 18,20 M85

comasatribuiesdeRA>RA2000,Dec>DEC2000eMessier>IDdaria:
Nome Messier RA Dec
---------------Nebula 97 168.63 55.03 Coruja
101 210,75 54,375 Pinwheel Galaxy
64 194,13 21.700 Galxia do olho roxo
M40 185,6 58.08
M85 183,6 18,20

Claroquederesponsabilidadedousurioparagarantirqueacorrespondnciadecolunassensvel(queasduascolunascorrespondentes
significamamesmacoisa).
VocpoderealizarumaconcatenaousandoajanelaconcatenaoobterestausandoastabelasConcatenar(

boto)najanelade

controle.

5.2linhascoincidentesentretabelas
Aojuntarduasmesasladoalado,vocprecisaidentificarquallinha(s)emumcorrespondemaquallinha(s)nooutro.Conceitualmente,isso
feitoporolharparacadalinhadaprimeiratabela,dealgumaformaidentificarnasegundatabelaquallinha"refereseamesmacoisa",e
colocandoumanovalinhanatabelaassociadaqueconsisteemtodososcamposdalinhaemaprimeiratabela,seguidoportodososcamposde
sualinhacorrespondidanasegundatabela.Oquadroresultantetementoumnmerodecolunasigualsomadonmerodecolunas,emduas
tabelasdeentrada.
Naprtica,humasriedecomplicaes.Porumlado,cadalinhaemumatabelapodeserigualadaporzero,umouvriosregistrosnaoutra.
Poroutrolado,definiroqueseentendepor"referindoseamesmacoisa"podenosersimples.Htambmoproblemaderealmenteidentificar
estesjogosdeformarelativamenteeficiente(semcompararexplicitamentecadalinhaemumatabelacomcadalinhadooutro,oqueseriamuito
lentoparatabelasgrandes).
UmexemplocomumocasodecombinardoiscatlogosdeobjetosSuponhaquetemososseguintescatlogos:
Xpos yPos Vmag
-----------1134.822 599,247 13,8
659,68 1046 .874 17,2
909,613 543,293 9.3

e
xy BMAG
-----909,523 543,800 10.1
1832.114 409,567 12,3
1135.201 600,100 14,6
702,622 1004 .972 19,0

equeremoscombinlosparacriarumnovocatlogocomumalinhaparacadaobjetoqueapareceemambasastabelas.Parafazerisso,voc
temqueespecificaroquecontacomoumjogonestecaso,digamosqueumalinhaemumjogosdemesa(refereseaomesmoobjeto)uma
linhanaoutra,seadistnciaentreasposiesindicadasporseuXeYcoordenadaspartidasparadentrodeumaunidade(sqrt((Xposx)2 +(y
ypos)2 )<=1)).Emseguida,ocatlogo,vamosacabarcom:
Xpos yPos Vmag xy BMAG
-----------------1134.822 599,247 13,8 1135,201 600,100 14,6

http://127.0.0.1:2525/doc/sun253/sun253.html

17/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

909,613 543,293 9,3 909,523 543,800 10,1

Humasriedevariaessobreestenoentantooscritriosdecorrespondnciapodeenvolvercucoordenaemvezdeoscartesianas(ouno
sercoordenadasfsicasemtodos),vocpodequerercorresponderamaisdeduastabelas,vocpodequereridentificargruposdeobjetos
correspondentesemumanicatabela,vocpodequererasadaparaincluirlinhasquenocorrespondemtobem...
AJaneladejogopermitequevocespecifique
Astabelasdevemsercombinados
Quaissooscritriosparalinhascorrespondentes
Oquefazerparaaslinhasquenotmexatamenteumjogo
Quelinhasdeincluirnatabeladesada
eparainiciaraoperaocorrespondente.Dependendodotipodejogoescolhido,algumascolunasadicionaispodemseracrescentadostabela
resultantedandomaisdetalhessobreaformacomoojogofoi.Normalmente,o'scorematch'umadelasOvalorexatoeosignificadodesta
colunadependedojogo,masnormalmentedadistnciaentreospontoscombinadosemalgumasunidadessensatasquantomenorovalor,
melhorapartida.VocpodedescobrirexatamenteoqueissosignificapontuaoexaminandoadescriodacolunanajanelaColunas.
Colunasnatabelaresultantemanterseusnomesoriginais,amenosquelevariaaambigidade,casoemqueaeliminaodeambiguidadesem
sufixo"_1"ou"_2"adicionadoaonomedacoluna.
Paracombinarduastabelas,useopardejogo(

boto)najaneladecontroleparacombinarmaistabelasdedoisdeumasvez,useas

outrasopesdaJaneladoControleJuntemenu.

5.3linhascorrespondentesemumatabela
Emboraoefeitoumpoucodiferente,procurandoatravsdeumatabelanicaparaaslinhasquecombinamentresi(sereferemaomesmo
objeto,comoexplicadoacima)umprocessosemelhanteeexigemuitodasmesmasinformaesaseremespecificados,principalmente,oque
contacomoumajogo.Vocpodefazerissousandoajaneladejogointerno,obtidopormeiodojogointerno( boto)najanelade
controledajuntamenu.

5.4JogosMultiObjetos
OcorrespondenteemTOPCATdeterminadaporcritriosdecorrespondnciaespecificados,conformedescritonoApndiceA.8.1.1.Estes
critriosdarcondiesparasedoisitens(linhasdatabela)contamcomocombinadocomooutro.Nocasodeumjogodepar,claraaforma
comoestedeveserinterpretado.
Noentanto,algumasdasoperaesdeharmonizaotaiscomoojogointernodebuscaparagruposdecorrespondnciaquepodetermaisde
doismembros.EstaseoexplicacomoTOPCATaplicaoscritriosdecorrespondnciadeparesdadoparaaidentificaodegruposmulti
objeto.
Emumcontextojogomultiobjeto,ocombinadoridentificaumgrupocombinadocomoomaiorgrupopossveldeobjetosemquecadaumest
ligadoporumacorrespondnciapardequalqueroutroobjetonogrupoumgrupode"amigosdosamigos".Formalmente,oconjuntode
gruposcombinadosumconjuntodegrficosdisjuntoscujosnssoaslinhasdatabeladeentradaedecujasbordassojogospardesucesso,
ondenoexistejogopardesucessoentrensdediferenteselementosdesseconjunto.Assim,oconjuntotemumnmeromnimodeelementos,
ecadaumdoselementosumgrupocorrespondentedetamanhomximo.Opontoimportanteaserobservadoque,paraqualquerpar
particularemumgrupocombinado,nohnenhumagarantiadequeosdoisobjetoscorresponderumaooutro,squevocpodepulardeum
paraooutroatravsdeparesquefazemjogo.
Assim,nocasodeumcujogomultiobjetoemumcampoquemuitolotadoemcomparaocomoraiodeerroespecificado,bempossvel
quetodososobjetosnatabeladeentrada(s)paraacabarcomopartedamesmagrandecorrespondnciagrupo.Resultadosemoupertodeste
limiardepercolaoso(a)provavelmentenotile(b)probabilidadedelevarumlongotempoparaserexecutado.Algunscuidadosdevem
serexercidosaoespecificarcritriosdecorrespondnciaemcontextosjogomultiobjeto.

5,5PlotagemresultadaPartida
Tendorealizadoumdesempate,muitasvezesumaboaidiadeolharparaosresultadosgraficamente.Sevocpodeplotaroscatlogosde
entradaesadadocatlogo,comaindicaodequaislinhasnasentradasforamunidas,vocpoderapidamenteobterumaboaidiado
resultadodapartida,eseelefezoquevocesperava.Istoespecialmenteverdadeironapresenadecamposlotados,critriosde
correspondnciaexperimentais,ououtrascircunstnciasemqueojogopodenosaemcomooesperado.
DesdeTOPCATverso4.1,paraamaioriadosjogosdepares,vocpodefazerissoautomaticamente.Quandoumfsforoapropriado
concluda,vocpodeverumdilogodeconfirmaocomoesta:

Parenredodilogoconfirmaodeconcluso
http://127.0.0.1:2525/doc/sun253/sun253.html

18/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

SevocclicarnoOKboto,eleirsimplesmenteignorarodilogo.Noentanto,sevocclicarnoLoteresultadoboto,umanovajanela
aparecercomenredodetodosospontosapartirdoscatlogosdeentradaelinkspar(linhasentreasposiessejuntaram)paraaslinhas
unidas.Oresultadoalgocomoisto:

SadadecrossmatchResultadoPlot
Issomostraclaramentequeospontosforamunidos.Vocpodemexercomoscontrolesdoenredodamaneirausualparaajustarasada(ver
ApndiceA.4).Tambmpossvelacriaodetaisparcelasmo.

5.6NotassobreMatching
Estaseoforneceumpoucomaisdetalhadamentesobreaformacomoacorrespondnciadelinhadetabelaslocais(seesSeo5.2eSeo
5.3)feito.Eleprojetadoparadarumaidiaaproximadadaspartesinteressadasnoumadescriotutorialdosprimeirosprincpiosde
comotudofunciona.
Oalgoritmobsicoparaacorrespondnciabaseadanadivisodoespaodelinhas,possivelmentecombinandoemumnmero
(indeterminado)decaixas.Estascaixasnormalmentecorrespondemaodisjuntosclulasdeumespaofsicooufictciacoordenar,masno
precisafazlo.Noprimeiropasso,cadalinhadecadamesaavaliadaparadeterminarquaislixeiraspodeconterpartidasparaqueesteser
geralmenteocompartimentoquecaiequaisquercaixotes"adjacentes"dentrodeumadistnciacorrespondentetolernciacorrespondente.
Umarefernciaparaalinhaestassociadacomcadatalbin.Nasegundaetapa,cadabinexaminado,eseduasoumaislinhasestoassociados
acadapossvelpardelinhasnoconjuntodeassociadosavaliadoparaverseelefaznaverdadeconstituemumparcombinado.Istoir
identificartodoseapenasosparesdelinhasqueestorelacionadosdeacordocomoscritriosdecorrespondnciaselecionados.Duranteeste
processo,umcertonmerodeoptimizaespodemseraplicadosdeacordocomosdetalhesdosdadoseapartidarequerido.
OalgoritmodecorrespondnciadescritoacimamaisoumenosumO(logN(N))deprocesso,ondeNonmerototaldelinhasemtodasas
tabelasqueparticipamdeumjogo.Estaumaboanotcia,umavezqueainterpretaoingnuaseriaO(N2 ).Istopodequebrarnoentanto,
seatolernciacorrespondentetalqueonmerodelinhasassociadascomalgunsouamaioriadaslixeirasficagrande,casoemqueumO(H2
http://127.0.0.1:2525/doc/sun253/sun253.html

19/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

)componentepodeviradominar,ondeMonmerodelinhasporbin.Onmeromdiodelinhasporbinrelatadonoregistrodequandoum
jogoestadecorrer,paraquepossamanterumolhosobreisso.
Paramaisdetalhessobreosalgoritmoscorrespondentes,consulteojavadocparaauk.ac.starlink.table.joinpacote,ouentreemcontato
comoautor.

5.7Correspondnciacomumatabelaremota
TOPCAToferecealgumasfacilidadesparacrossmatchesposicionaisemtabelasquesoexpostosatravsdeserviosvirtuaisObservatrioda
Web(Conedebusca,simplesdeacessoaImagemeAcessoespectralsimples)ecorrespondnciaSQLlikegeral(TAP).Estesfuncionamde
mododiferentedasoutrasfunesdescritasnestaseo,quefuncionamemtabelaslocais,emboraconceitualmenteoresultadosemelhante.
Vejaseo6paramaisdetalhes.

6ObservatrioVirtualdeAcesso
VriasdasjanelasemTOPCATlhepermiteminteragircomoschamadosDataAccessLayerserviosprestadosnombitodoObservatrio
Virtual(VO).Aspalavrasdeordemnosoimportantes,masaidiabsicaqueestepermitequevoclocalizeumserviodefornecimento
dedadosquepossamserdeinteresseparavoc,e,emseguida,consultaresseservioparaobterosdados.OVOnoumanicaentidade
monoltica,masumconjuntodeprotocolosquepermitemumaferramentadeusogeral,comoTOPCATfalarcomserviosdisponibilizadospor
muitosprovedoresdedadosdiferentesparticipantesdeumaformauniforme,semterqueterumconhecimentoprviodoquesoserviosl
fora,ouosdetalhesdecomoseusdadossoorganizados.
OfuncionamentobsicosemelhanteparatodosdoacessodaTOPCATaestesservios:
1. Selecioneoregistroparaconsultarservios(ouuseopadro)
2. Consultaqueoregistrodosserviosdeinteresse
3. Apartirdalistaretornadadeservios,selecioneaquelequevocdesejaconsultardados
4. Especifiqueaconsultaparaenviarparaoserviodedados
5. Comeceaconsultaeesperarpeloresultado
Estasidiassoexplicadascommaisdetalhesnasprximassubsees.AsjanelasdeondeissofeitosodocumentadosnoApndiceA.9.
Nota:ParaobterinformaessobreSAMPoudeplstico,quesoprotocolosdesenvolvidosnocontextoObservatrioVirtual,masnoso
necessariamentepreocupadoscomoacessoremotodedados,consulteaSeo9.

6.1ORegistro
ASecretariafundamentalparaamaneiraqueoVOfunciona.Umregistroumalistadetodososserviosdisponibilizadospordiferentes
provedoresdedados.Cadaentradaregistraalgumasinformaessobreotipodeservio,que,desdeque,otipodedadosqueelecontm,e
assimpordiante(registospodeconteroutrostiposdeentrada,bemcomo,masnovamosdiscutilosaindamaisaqui).Qualquerprovedorde
dadospodeadicionarumaentradanoregistroparaanunciarqueeletemdeterminadosconjuntosdedadosdisponveisparaacesso.
ExistemvriosregistroselestendemasermantidospordiferentesorganizaesVOregionais.Nomomentodaescrita,hregistrosmantidos
paraacessopblicopor(restosde)AstroGriddoReinoUnido,dosEUANVO/VAO,eaESA,entreoutros.Projetosespecficospodem
tambmmanterseusprpriosregistroscomHoldingsLimitedparausointerno.Osprincipaisregistrosdeacessopblicofalarunscomos
outrosparasincronizarseucontedo,demodoaumaprimeiraaproximao,quecontmlistassemelhantesdeentradasparaooutro,eissono
deveriaimportarmuitoqualvocusa.Naprtica,existemalgumasdiferenasdeformatoecontedoentreeles,paraquesepossatrabalhar
melhorqueooutroparavocoupodeconterumregistroquevocprecisa.Namaioriadoscasos,porm,usandooregistropadro(atualmente
oAstroGridum)vaiprovavelmentefazeroquequerqueseja.

Servios6.2DadosdeAcesso
UmnmerodediferentestiposdeserviossodefinidoselistadosnoRegistroosqueTOPCATatualmentesabecomoacessarsoos
seguintes:
ConeSearch:
recuperarasentradasemumadeterminadaregiodocuapartirdeumcatlogoremoto
SimplesAcessoImagem(SIA):
encontrardadosdeimagem(muitasvezesemformatoFITS)emumadeterminadaregiodocuapartirdeumarquivodeimagem
remota
SimplesAcessoespectral(SSA):
encontrardadosespectrais,geralmenteemumadeterminadaregiodocu,apartirdeumarquivoremotodeobservaesespectraisou
modelostericos
TabelaAccessProtocol(TAP):
fazerconsultasdeformalivreaumbancodedadosremotoutilizandoumalinguagemdeconsultaSQLlike
InformaestcnicasdetalhadassobreestesprotocolospodemserencontradosnositedaIVOA(http://www.ivoa.net/)naPesquisaCone,
SIA,SSAeTAPdocumentos,masestesnosodeformaleituraobrigatriaparaosusuriosdoservios.Estesprotocolos(almdeCone
Search)sobastantecomplexasetmmuitascaractersticasespecializadaseopcionais.AsopesoferecidasparaConePesquisaeTAPso
razoavelmentecompleto,masapenasparaSIAeSSATOPCATproporcionaumnvelbastantebsicodeinterao,emuitosrecursos(por
exemplo,consultasSSAporcomprimentodeonda,ouconsultasnoposicionaisparadadostericos)nosoacessveisapartirdele.
http://127.0.0.1:2525/doc/sun253/sun253.html

20/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ConePesquisa,SIAeSSAsoposicionaisprotocolosoquesignificaqueelesconsultamumanicaregiodocu.TOPCATforneceacessoa
essestiposdeservioemduasformasprincipais:
Consultaposicionalnico
Sevocentrarcomamoumaposionocu(AR,Dec)eraio,vocpodebaixarumatabelaquecontmosresultadosdeumapesquisa
paraumnico(geralmente,pequeno)regionocu.ConsulteasseessobreCone,SIA,SSAdilogosdecarganoApndiceA.9.
Consultaposicionalmltipla
Vocpodedefinircomocadalinhadeumatabeladeentradaselecionaumaregionocu.Istoirgeralmentecorrespondemaseleco
deumacolunaparaaAReumacolunadedez,eumraiofixoouumacolunadandooraio.Emseguida,umaconsultaposicionalpode
serfeitaparacadalinhadatabeladeentrada.Oresultado,efetivamente,umajunoentreaentradaTabelaaparenteeatabelaremotade
dadosdeobjetos,imagensouespectros.ConsulteasseessobreCone,SIA,SSAvriasjanelasdeconsultanoApndiceA.9.
TAPnorestritaaconsultasposicionaisetemoseuprpriointerface.VejaaTAPseodilogocarganoApndiceA.9.

7Sintaxedeexpressesalgbricas
TOPCATpermiteinserirexpressesalgbricasemvrioscontextos:
1. ParadefinirumanovacolunaemtermosdecolunasexistentesnaColunaSyntheticdilogo
2. ParadefinirumnovosubconjuntoRow,combaseemdadosdatabelanoAlgbricasubconjuntodilogo
3. ParadefinirumcostumeAoAtivaonaAtivaododilogo.
4. Quandoconfrontadoscomumseletordecolunaparaplotagemouparaoutrosfins,emalgunscasos,vocpodedigitarumaexpressoem
vezdeselecionaroudigitarumnomedecolunasimples.
Esteumpoderosorecursoquepermitequevocmanipuleeselecionarosdadosdatabeladeformamuitoflexvelvocpodepensarnisso
comoumaespciedeplanilhaorientadaparaacoluna.Asintaxeparaainserodessasexpressesexplicadonestaseo.
OquevocescrevesorealmenteexpressesnalinguagemJava,quesocompiladosemJavabytecodeantesdaavaliao.Noentanto,isso
nosignificaquevocprecisaserumprogramadorJavaparaescrevlos.AsintaxebastantesemelhanteaoC,mas,mesmoquevocnunca
tenhaprogramadoemCcoisasmaissimples,ealgunscomplicados,sobastanteintuitivos.
Aexplicaoaseguirdalgumasorientaeseexemplosparaescreverestasexpresses.Infelizmente,umtutorialcompletosobreaescritade
Javaestalmdoescopodestedocumento,masdevefornecerinformaessuficientes,mesmoparaumnovatoparaescreverexpressesteis.
Asexpressesquevocpodeescreverso,basicamente,qualquerfunodetodososvaloresdacolunaebandeirasdeinclusosubconjunto
queseaplicamaumadeterminadalinhaoresultadodafunopode,ento,definirovalorporlinhadeumanovacoluna,ouabandeirada
inclusodeumnovosubgrupo,ouaaoaserrealizadaquandoumalinhaativada,clicandosobreela.Seosoperadoresefunesinternas
nososuficientes,oupesadoparaexpressarsuafunoemumalinhadecdigo,vocpodeadicionarnovasfunesaoescreversuas
prpriasclassesvejaSeo7.9.
Nota:seoJavaestsendoexecutadoemumambientecomcertasrestriesdesegurana(umgerentedeseguranaquenopermiteacriao
decarregadoresdeclassepersonalizada),emseguida,expressesalgbricasnovaifuncionar,eosbotesquepermitemquevocdigitlos
serdesativado.

7.1Referenciandovaloresdeclulas
Paracriarumaexpressotilparaumaclulaemumacoluna,vocterquesereferiraoutrasclulasemdiferentescolunasdamesmalinhada
tabela.Vocpodefazerissodetrsformas:
PeloNome
Onomedacolunapodeserutilizadosenico(nenhumaoutracolunadatabelatemomesmonome)e,setiverumaformaadequada.
IssosignificaquedeveteraformadeumavariveldeJavabasicamentecomeandocomumaletraecontinuandocomletrasou
nmeros.Emparticular,nopodeternenhumespaonamesma.Osublinhadoesmbolosdemoedacontamcomocartasparaestefim.
Osnomesdascolunassotratadoscasoinsensvel.
Por$ID
Oidentificador"$ID"dacolunapodesersempreutilizadaparasereferiraeleesteomelhormtodotilseonomedacolunano
adequado,poralgummotivo(porexemplo,elecontmespaosounoexclusivo).Esteapenasumsinalde"$"seguidoporum
nmerointeironicoatribudopeloprogramaparacadacolunaquandoeleencontradopelaprimeiravez.Vocpodedescobriro
identificador$IDolhandonoJanelaColunas.
PorUCD$especificador
Seacolunatemumdescritordecontedounificado(oquenormalmentesserocasoparaVOTableoupossivelmenteFITSformatar
tabelas),vocpodesereferiraeleusandoumidentificadordaforma"UCD $ <ucd-spec>".DependendodaversodosistemaUCD
usado,UCDspodecontervriossinaisdepontuao,comosublinhados,vrgulasepontosparaopropsitodestasintaxeestesdevem
todosserrepresentadacomosublinhados("_").Assim,paraidentificarumacolunaquetemaUCD"phot.mag; em.opt.R",voc
deveusaroidentificador"UCD $ phot_mag_em_opt_r".Acorrespondncianodiferenciamaisculasdeminsculas.Futhermore,uma
fugasublinhadofuncionacomoumcuringa,paraqueacolunaacimatambmpodeserreferenciadocomoidentificador"UCD $
phot_mag_".SevriascolunastmUCDsquecombinamcomoidentificadordado,oprimeiroserusado.
Notesequeamesmasintaxepodeserusadaparafazerrefernciaaparmetrosdetabela(verSeo7.3)colunastmprefernciapor
isso,seumacolunaeumparmetrodeamboscorresponderaUCDsolicitado,ovalordacolunavaiserusado.
Porutype$especificador
SeacolunatemumauType(oquenormalmentesserocasoparaVOTableoupossivelmenteFITSformatartabelas),vocpodese
http://127.0.0.1:2525/doc/sun253/sun253.html

21/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

referiraeleusandoumidentificadordaforma"utype $ <utype-spec>".Utypespodecontervriossinaisdepontuao,como
vrgulasepontosparaopropsitodestasintaxeestesdevemtodosserrepresentadacomosublinhados("_").Assim,paraidentificar
umacolunaquetemouType"ssa: Access.Format",vocdeveusaroidentificador"utype $ ssa_Access_Format".A
correspondncianodiferenciamaisculasdeminsculas.SevriascolunastmUtypesquecombinamcomoidentificadorespecificado,
oprimeiroserusado.
Notesequeamesmasintaxepodeserusadaparafazerrefernciaaparmetrosdetabela(verSeo7.3)colunastmprefernciapor
isso,seumacolunaeumparmetrodeamboscorresponderautypesolicitado,ovalordacolunavaiserusado.
Humacolunaespecialcujonome"Index"ecujoID$"$0".Ovalordesteomesmoqueonmerodalinhanatabelaindiferenciados(os
nmerosdecinzaesquerdadagradenajaneladedados),entoparaaprimeiracolunadatabelanoordenada1,paraosegundo2,e
assimpordiante.
Ovalordasvariveis
demodoreferenciadosserumprimitivo(boolean,byte,short,char,int,long,float,double)seacolunacontmumdos

tiposcorrespondentes.Casocontrrio,serumobjetodotiporealizadapelacoluna,porexemplo,umaseqncia.Naprtica,issosignifica:
vocpodeescreveronomedeumacoluna,eeleiravaliarovalornumrico(oustring)queessacolunacontmemcadalinha.Vocpode
entousarissoemexpressesalgbricasnormais,como"B_MAG-U_MAG"comoseriadeesperar.

7.2ReferenciamentoRowsubconjuntoBandeiras
SevoctiveralgumaSubconjuntosRowdefinidovoctambmpodeacessarovalordoboolean(true/false)sinalizadorqueindicasealinha
atualemcadasubconjunto.Novamente,hduasmaneirasdefazerisso:
PeloNome
Onomeatribudoaosubconjuntoquandofoicriadopodeserutilizadosenicoesetemumaformaadequada.Osmesmoscomentrios
aplicamseanomesdecolunasacima.
Por_ID
O"_ID"identificadordosubconjuntopodesersempreutilizadaparasereferiraele.Comooidentificador"$ID"paraascolunasacima,
esteumnmerointeironicoprecedidoporumsmboloespecial,destavezosublinhado"_".
Nota:emversesanterioresdoTOPCATocardinal("#"),emvezdeosublinhadoparaestefimosinaldehashnotemmaisesse
significado.
Emambososcasos,ovalorserumvalorbooleanoestespodemserteisemconjuntocomacondicional":?"operadorouaocombinaros
subconjuntosexistentesutilizandooperadoreslgicosparacriarumnovosubconjunto.

7.3ReferenciandoParmetrosTabela
Algumastabelastmvaloresconstantesaelesassociadosestaspodemrepresentarcoisastaiscomoapocaemqueasobservaesforam
feitas,onomedocatlogo,umaresoluoangularassociadocomtodasasobservaes,ouqualquernmerodeoutrascoisas.Essasconstantes
soconhecidoscomoparmetrosdatabelaepodeservisualizadoemodificadonajaneladeparmetros.Osvaloresdetaisparmetrospode
serreferenciadonasexpressesalgbricasdaseguinteforma:
param$name
Seonomedoparmetrotemumaformaadequada(comeandocomumaletraecontinuandocomletrasounmeros)elepodeser
referenciadoporprefixaressenomecomastring$ param.
UCD$UCDspec
SeoparmetrotiverumdescritordecontedounificadoquepodeserreferenciadaporprefixaroespecificadorUCDcomastring$ UCD
.QuaisquersinaisdepontuaonaUCDdevesersubstitudoporsublinhadoseumsublinhadodireitainterpretadocomoumcuringa.
VejaSeo7.1paramaisdiscusso.
utype$utypespec
SeoparmetrotemumauType,elepodeserreferenciadoporprefixaroespecificadoruTypecomacordautype $.Quaisquersinaisde
pontuaonouTypedevemsersubstitudosporsublinhados.VejaSeo7.1paramaisdiscusso.
Observeque,seumparmetrotemumnomedeformainadequada(porexemplo,contendoespaos)enotemUCDentonopodeser
referenciadoemumaexpresso.

7.4ValoresNulos
Quandonosotomadasmedidasespeciais,seumvalornulo(clulaembranco)encontradonaavaliaodeumaexpresso(geralmentepor
causadeumadascolunasqueinvocatemumvalornulonalinhaemquesto),entooresultadodaexpressotambmnulo.
possvelexercerumcontrolemaiordoqueesta,masrequerumpoucodecuidado,porqueasexpressestrabalharemtermosdevalores
primitivos(aquelesnumricosoubooleanos),quenofazem,emgeral,tmumvalornulodefinido.Onome"null"emexpresseslhedojava
nulodereferncia,masissonopodesercomparadocomumvalorprimitivoouusadocomoovalorderetornodeumaexpressoprimitiva.
Namaioriadoscasos,asduasdicasaseguirdevempermitirlhetrabalharcomvaloresnulos:
Testesparanulo
Paratestarseumacolunacontmumvalornulo,precederastring"NULL_"(useletrasmaisculas)paraonomedacolunaou$ID.O
resultadoserumvalorbooleanoqueverdadeiroseacolunacontmumNaNembrancoouumpontoflutuante(notanumber)de
valor,efalsecasocontrrio.
Retornandonulo
Pararetornarumvalornuloapartirdeumaexpressonumrica,useonomede"NULL"(maisculas).Pararetornarumvalornuloapartir
http://127.0.0.1:2525/doc/sun253/sun253.html

22/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

deumaexpressononumrico(porexemplo,umacolunaString)usaronome"nulo"(letrasminsculas).
Osvaloresnulossomuitasvezesutilizadosemconjuntocomooperador,condicional":"aexpresso
testar? TVAL: FVal

retornaovalorTVALseaexpressobooleanatesteavaliaverdade,ouFValsetesteavaliafalsa.Assim,porexemplo,aseguinteexpresso:
Vmag == -99? NULL: Vmag

podeserusadoparadefinirumanovacolunaquetemomesmovalorqueacolunaVmagparaamaioriadosvalores,masseVmagtemovalor
"mgica"99anovacolunaconterumbranco.Otruqueoposto(substituindoumvalorembrancocomumamagia)podeserfeitoassim:
NULL_Vmag? -99: Vmag

MaisalgunsexemplossodadosnaSeo7.8.

7.5Operadores
OsoperadoressopraticamenteosmesmosquenalinguagemC.Osmaiscomunsso:
Aritmtica
+(adicionar)
-(subtrair)
*(multiplicar)
/(dividir)
%(mdulo)

Lgico
!(no)
&&(e)
| |(ou)
^(ouexclusivo)
==(identidadenumrica)
! =(numriconoidentidade)
<(inferior)
>(superior)
<=(menorouigual)
> =(maiorouigual)

Bitabit
E(e)
|(ou)
<<(deslocamentoesquerda)
>>(deslocamentoparaadireita)
>>>(deslocamentoparaadireitalgico)

Typecastsnumricos
(Byte)(numrico>byteassinado)
(Short)(numrico>2byteinteiro)
(Int)(numrico>4byteinteiro)
(Longa)(numrico>8byteinteiro)
(Float)(numrico>4bytespontoflutuante)
(Duplo)(numrico>8bytespontoflutuante)

NotequevocpodeencontrarasfunesdeconversonumricanaMatemticaclassedescritanoApndiceB.1abaixomais
convenienteparaconversesnumricasdoqueestes.
Outro
+(concatenao)
[](arraydereferencing)
?:(alternarcondicional)
instanceof(associaodeclasse)

7.6Funes
Muitasfunesestodisponveisparausodentrodesuasexpresses,abrangendofunespadromatemticasetrigonomtricas,funesde
utilidadearitmticas,conversesdetipo,ealgunsastronmicosmaisespecializadas.Vocpodeuslosdamaneiraquevocespera,usandoo
nomedafuno(aocontrriodenomesdecolunas,estecasesensitive),seguidodeargumentosseparadosporvrgulasentreparnteses,de
forma
max (IMAG, JMAG)

http://127.0.0.1:2525/doc/sun253/sun253.html

23/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

vaidarlheomaiordosvaloresnoIMAGcolunaseJMAG,eassimpordiante.
Asfunessoagrupadasnasseguintescategorias:
TrigDegrees
Funestrigonomtricaspadrocomngulosemgraus.
Tempos
Funesparaconversodevaloresdetempoentrevriasformas.Asformasutilizadassejam
ModificadoJulianDate(MJD)
Amedidacontnuaemdiasdesdeameianoite,noinciode17deNovembrode1858.BaseadonoUTC.
ISO8601
UmarepresentaodestringdaformaAAAA-MM-ddThh: mm: ss.s,ondeoTumcaractereliteral(umcaracteredeespaopode
serusadoemseulugar).CombasenoUTC.
JulianEpoch
AmedidacontnuacombaseemumanoJuliandeexatamente365,25dias.Parafinsdeaproximadosesteseassemelhaaonmero
fracionriodeanosADrepresentadapeladata.svezes(masnoaqui),representadoporumprefixo'J'J2000.0definidocomo
2000Janeiro1.5naescaladetempoTT.
BesselianEpoch
Amedidacontnuacombaseemumanotropicaldecercade365.2422dias.Parafinsdeaproximadosesteseassemelhaao
nmerofracionriodeanosADrepresentadapeladata.svezes(masnoaqui),representadoporumprefixo'B'.
DecimalAno
NmerofracionriodeanosADrepresentadapeladata.2000,0,ou1999.99recurringequivalentemente,meianoite,noincioda
primeiradeJaneirode2000.Devidoanosbissextos,otamanhodeumaunidadedependequeanopol
Portantomeiodiade25deoutubrode2004de2004-10-25T12: 00:00noformatoISO8601,comoumvalorde53.303,5MJD,
2004,81588comoEpochJuliane2004,81726comoBesselianEpoch.
Atualmenteestaimplementaonopodeserinvocadaparamelhordoqueummilsimodesegundo.
Matemtica
Funesmatemticasetrigonomtricaspadro.Funestrigonomtricastrabalharcomngulosemradianos.
Converses
Funesparaconverterentrestringsevaloresnumricos.
Formatos
Funesparaformatarvaloresnumricos.
Aritmtica
Funesaritmticaspadro,incluindocoisascomoarredondamento,assinarmanipulaoefunesmximas/mnimas.
CoordsRadians
Funesparatransformaesnguloemanipulaes,combaseemradianosemvezdegraus.Emparticular,osmtodosdetraduo
entreradianosehh:mm:ss,souDDD:MM:representaessexagesimaistiposs.ssofornecidos.
Cobertura
Funesrelacionadascomacoberturaepegadas.UmpadrodecoberturaMultiOrderOsmapasdecobertura,descritasno
http://www.ivoa.net/Documents/MOC/.
Tilings
FunesazulejosPixelparaaesferaceleste.
Distncias
Funesparaconverterentrediferentesmedidasdedistnciacosmolgica.
Osseguintesparmetrossoutilizados:
z:redshift
H0:constantedeHubble,emkm/s/Mpc(valorexemplo~70)
omegaM:arelaodensidadedouniverso(exemplovalor0,3)
omegaLambda:constantecosmolgicaNormalizada(exemplovalor0,7)
Paraumuniversoplano,omegaM+omegaLambda=1
OstermoseasfrmulasutilizadasaquisotomadasapartirdopapelporDWHogg,medidasdedistnciaemcosmologia,astro
ph/9905116v4(2000).
Arrays
Asfunesqueexecutamoperaesdeagregaodeclulascomvalordematriz.Asfunesnestaclasse,comoamdia,soma,
mximoetcspodeserusadoemvaloresquejsomatrizes.Namaioriadoscasosissosignificaemvaloresemcolunasdetabelasque
sodeclaradascomovalordearray.FITSemesasVOTablepodetercolunasquecontmvaloresdematriz,masoutrosformatoscomo
CSVnopode.
Htambmumconjuntodefunesnomeadasconjuntocomvriosnmerosdeargumentos,quepermitemmontarumvalormatriza
partirdeumalistadenmerosdeescalares.Issopodeserusado,porexemplo,paraobteramdiadeumconjuntodetrsmagnitudes
usandoumaexpressocomo"mdia (array (jmag, hmag, kmag))".
Cordas
FunesdemanipulaodeStringedeconsulta.
Fundentes
Funesparaconversoentrefluxoevaloresdemagnitude.FunessofornecidosparaaconversoentreofluxoemJanskyseAB
http://127.0.0.1:2525/doc/sun253/sun253.html

24/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

magnitudes.
Algumasconstantesparaconversesaproximadasentreasdiferentesescalasdemagnitudetambmsofornecidos:
ConstantesJOHNSON_AB_ *,paraJohnson<>conversesdemagnitudeAB,deFreieGunn,AstronomicalJournal108,1476
(1994),aTabela2(1994AJ....108.1476F).
ConstantesVEGA_AB_ *,porVega<>ABconversesdemagnitude,deBlantonetal,AstronomicalJournal.129,2562(2005),
asequaes.(5)(2005AJ....129.2562B).
KCorrections
FunesparaclculoKcorrees.
CoordsDegrees
Funesparatransformaesangularesemanipulaes,comngulosgeralmenteemgraus.Emparticular,osmtodosdetraduoentre
grausehh:mm:ss,souDDD:MM:representaessexagesimaistiposs.ssofornecidos.
UmalistagemdasfunesdessasclassesdadaemApndiceB.1,eadocumentaocompletasobreelesestdisponveldentroTOPCATda
JanelaFunesdisponveis.
7.6.1NotaTcnica
EstanotaforneceumpoucomaisdedetalheparaprogramadoresJavasobreoqueestacontecendoaquiapenascontinuealersevocquer
entendercomoousodefunesemexpressesalgbricasTOPCATrelacionasecomocdigoJavanormal.
AsexpressesquevocescrevesocompiladasparabytecodeJavaquandovocinserilos(sehum"errodecompilao'serrelatado
imediatamente).Asfuneslistadasnassubseesanterioressotodosospublic staticmtodosdasclassesqueestodisponveispor
padro.AsclasseslistadasestotodosnoNoentanto,osmtodosestticospblicossotodosimportadosemumnamespaceannimopara
bytecodecompilao,demodoquevocescreve(sqrt (x)enoMaths.sqrt (x).Omesmoacontececomoutrasclassesqueso
importados(quepodeestaremqualquerpacoteounenhum)seusmtodospblicosestticostodosirparaonamespaceannimoAssim,
mtodoconfrontosdenomessoumapossibilidade..
EstaintelignciatudopossvelgraasaoinvsmaravilhosoJEL.

7,7Mtodosdeinstncia
Existeumaoutracategoriadefunesquepodemserutilizadasparaalmdoslistadosnaseoanterior.Estessochamados,emJava/
orientadaaobjetolinguagem",mtodosdeinstncia"erepresentamfunesquepodemserexecutadasemumobjeto.
possvelinvocarqualquerumdosseusmtodosdeinstnciapblicasobrequalquerobjeto(emboranoemvaloresprimitivosaqueles
numricosebooleanos).Asintaxequevoccoloqueum"."seguidopelomtododeinvocaodepoisdoobjetoquevocdesejainvocaro
mtodoon,daNAME.substring (3)emvezdesubstring (NOME, 3).Sevocsabeoqueestfazendo,nohesiteemiremfrenteefazer
isso.Noentanto,amaioriadosmtodosdeinstnciaprovvelquevocqueirausartmequivalentesnasfunesnormaislistadasnaseo
anterior,amenosquevocumprogramadorJavaousentindoseaventureiro,vocprovavelmentemelhorforaignorandoesterecurso.

7,8Exemplos
Aquiestoalgunsexemplosgerais.Elespoderoserutilizadosparadefinirascolunasousintticas(ondenumrico)paradefinirosvaloresde
umdoseixosemumaparcela.
Mdia
(Primeiro + segundo) * 0.5

Raizquadrada
sqrt (varincia)

ConversoAngle
radiansToDegrees (DEC_radians)
degreesToRadians (RA_degrees)

Conversodestringparanmero
parseInt (US $ 12)
parseDouble (ident)

Conversodenmeroparastring
toString (ndice)

Conversoentretiposnumricos
toShort (obs_type)
toDouble (intervalo)

ou
(Short) obs_type
Range (duplo)

http://127.0.0.1:2525/doc/sun253/sun253.html

25/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Conversodesexagesimalparagraus
hmsToDegrees (RA1950)
dmsToDegrees (decDeg, decMin, decSec)

Conversodegrausparasexagesimal
degreesToDms ($ 3)
degreesToHms (RA, 2)

Recorteoutlier
min (1000, max (valor, 0))

Convertendoumvalormgicoparanull
jmag == 9999? NULL: jmag

Convertendoumvalornuloparaummgico
NULL_jmag? 9999: jmag

Tomandooterceiroelementoescalardeumacolunacomvalordegama
psfCounts [2]

eaquiestoalgunsexemplosdeexpressesbooleanasquepoderiamserusados
paradefinirsubconjuntosdelinhas(oucolunasparacriar

sintticosbooleanos):
Dentrodeumintervalonumrico
RA> 100 && RA <120 && dezembro> 75 && dezembro <85

Dentrodeumcrculo
Dois dlares * $ 2 + $ 3 * $ 3 <1
skyDistanceDegrees (RA0, dec0, hmsToDegrees (AR), dmsToDegrees (DEC)) <15./3600.

Asprimeiras100linhas
ndice <= 100

Cadadcimolinha
ndice% 10 == 0

IgualdadedeCordas/correspondncia
equals (setor ", ZZ9 Plural Z Alpha")
equalsIgnoreCase (SETOR ", zz9 plural alpha z")
startsWith (SETOR, "ZZ")
contm (ph_qual, "L")

Cadeiadeexpressesregulares
jogos (setor "[XYZ] Alpha")

Combinandosubconjuntos
(_1 _2 &&) &&! _3

Testedevalornobranco
! NULL_ellipticity

7.9Adiodefunesdefinidaspelousurio
Asfunesfornecidasporpadroparausocomexpressesalgbricas,enquantopoderoso,podenofornecertodasasoperaesquevoc
precisa.Porestarazo,possvelescreversuasprpriasextensesparaalinguagemdeexpresso.Destaforma,vocpodeespecificaras
funesarbitrariamentecomplicadas.Note,porm,queissosirpermitirlhedefinirnovascolunasousubconjuntosemquecadaclulauma
funoapenasdasoutrasclulasnamesmalinhanohmaneiradedefinirumvaloremumalinha,emfunodosvaloresemoutraslinhas.
Afimdefazerisso,voctemqueescreverecompilarumprograma(provavelmenteshort)nalinguagemJava.Umadiscussocompletasobre
comoprocederparaissoestalmdoescopodestedocumento,porisso,sevocnovoemJavae/oudeprogramaoquevocpodeprecisar
deencontrarumprogramadoramigvellocalparaajudar(ouemaildoautor).AexplicaoaseguirdestinaseaprogramadoresJava,masno
podeserincompreensvelparanoespecialistas.
Ospassosquevocprecisaseguirso:
1. Escreverecompilarumaclassequecontmumoumaismtodosestticospblicosquerepresentamafuno(s)exigido
2. Faadestaclassedisponvelnoclasspathdoaplicativoemtempodeexecuo,conformedescritoemSeo10.2.1
3. Especifiqueonomedaclasseparaaaplicao,oucomoovalordasjel.classesoujel.classes.activationpropriedadesdo
sistema(doispontosseparados,seexistemvrios),conformedescritonaSeo10.2.3ouduranteumacorridausandoajaneladefuno
disponveis'semAddClass( boto)
http://127.0.0.1:2525/doc/sun253/sun253.html

26/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

QuaisquermtodosestticospblicosdefinidosnasclassessupracitadosestardisponvelparausonaColunasinttico,Algbricasubconjunto
ou(nocasodefunesdeativaoapenas)janeladeativaodoWindows.Elesdevemserdefinidosparatiraredevolverostiposprimitivos
ouobjetorelevanteparaafunodesejada(nocasodasfunesdeativaoovalorderetornodevesernormalmenteumaseqnciacurtalog).
Porexemplo,umaclassedeescritacomoseseguedefineamdiadetrsvalores:
AuxFuncs public class {
average3 public static double (double x, double y, double z) {
retornar (x + y + z) / 3.0;
}
}

eaexpresso"average3 ($ 1, $ 2, $ 3)"pode
entoserutilizadoparadefinirumanovacolunasinttica,dandoamdiadastrs

primeirascolunasexistentes.Exatamentecomovociriaconstruirestedependentedoseusistema,maspodeenvolverfazeralgocomoo
seguinte:
1. Escrevendoumarquivochamado"AuxFuncs.java"contendoocdigoacima
2. Compillousandoumcomandocomo"AuxFuncs.java javac"
3. IniciandoTOPCATcomasbandeiras:"topcat-Djel.classes = AuxFuncs-classpath."

8AesdeAtivao
Almdeveroresumodedadosdatabelafornecidaporumatramaouestatsticasresumo,muitasvezesnecessrioparaseconcentraremuma
determinadalinhadatabela,oquedeacordocomanaturezadatabelapoderepresentarumobjetoastronmico,umeventooualgumoutro
entidade.NajaneladedadosumalinhadatabelasimplesmenteumalinhadaJTableexibido,eemumatramaquecorrespondeaumponto
traado.
Sevocclicarnopontotraadoemumadasjanelasdegrficos,ouemumalinhanaJaneladeDados,alinhadatabelacorrespondenteser
ativado.Quandoumalinhaativado,trscoisasacontecem:
1. Seessalinharepresentadoporumpontoemqualqueraberto2ou3dimensionaljanelasdispersodoenredo,ummarcadorcursor
visvelserosorteadoscentradanesseponto.
2. Seajaneladedadosvisvel,atabelaserroladoparamostraralinhaeeleserdestacado
3. Seumaaodeativaofoidefinido,eleserchamado
Osdoisprimeirosdestessignificaquevocpodefacilmenteverquepontoemumatramaquecorrespondealinhanatabelaeviceversabasta
clicaremumeoutroserdestacado.
Oterceiropodesermaiscomplicada.Porpadro,nenhumaaodeativaodefinida,portanto,nadamaisacontece,eissopodemuitobem
seroquequiser.Noentanto,clicandosobreaaodeativaoseletoranajaneladecontrole,vocpodeabrirajaneladeativaoquepermite
quevocescolhaumaaoadicionalaterlugar.Existemvriasopesaquievriasformasdealcanlos(veranexoA.10.2paramais
detalhes),masostiposdeaesqueestoprevistassoparaexibirumaoumaisimagensouespectrosrelativoslinhaquevocidentificou.
Umadasopesdisponveis,porexemplo,recuperaumaimagemporteselodealgunsminutosdearcoemtornodaposionocudefinido
pelalinhadeumaSuperCOSMOStodoocupesquisadeimagemeapareceloemumajaneladevisualizao.Assim,porexemplodetervisto
umpontointeressanteemlotedeumcatlogogalxiavocpodeclicarsobreele,eimediatamenteverumaimagemparaidentificaroseutipo
morfolgico.
Asaesexatasquevocdesejaexecutarpodeestarintimamenteadaptadoaosdadosquetm,porexemplo,vocpodeterumconjuntode
espectrosnodisconomeadoporobjetoID.impossvelatenderaessaspossibilidadescomumconjuntodeopesprembalados,paraque
sejamcapazesdedefinirsuasprpriasaespersonalizadasaqui.IssofeitoporescritoumaexpressousandoasintaxedescritanaSeo7.
Umasriedefunesespeciais(descritonasubseoseguinte)sofornecidosparafazercoisascomoexibirumaimagemouumespectroem
umnavegador(dadoseunomedearquivoouURL),oudadosdeacessodedeterminadosservidoresdedadosnaweb,masnohnadapara
pararoentupimentoaventureirosemseusprpriosprogramasexternospara,emprincpio,vocpodeconfigurarpraticamentequalquercoisa
queaconteacombaseosvaloresnalinhaquevocativou.

8.1FunesdeAtivao
Aodefinirasaesdeativaopersonalizadanajaneladeativao,vocentraemumaexpressoaserchamadoemumalinhaquandoele
ativado.EssaexpressousaasintaxedefinidanaSeo7epodefazerusodasfuneslistadasnoApndiceB.1.Noentanto,nestecaso,h
umalistaadicionaldefunesquevocpodeusaroquefazercomquealgoacontea(porexemplo,exibirumaimagem)emvezdeapenas
retornarumvalor.Asseguintesclassesdefunesestodisponveis:
SDSS
FunesdevisualizaoespecializadosparausocomoSloaneDigitalSkyServidor.
Navegadores
ExibeURLsemnavegadoresweb.
SuperCosmos
FunesdevisualizaoespecializadosparausocomolevantamentoSuperCOSMOS.Estasfunesexibirimagensderecortedevrios
arquivoshospedadosemPesquisasSuperCOSMOSSky(http://wwwwfau.roe.ac.uk/sss/).Namaioriadoscasosestescobrirtodoocu
dosul.
Mgc
FunesespecializadasparausocomdadosdoGalaxyLevantamentodoMilnio.
Sog
FunesparaexibiodeimagensemSOGvisualizadorexterno(http://www.starlink.ac.uk/sog/).
http://127.0.0.1:2525/doc/sun253/sun253.html

27/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

BasicImageDisplay
Funesparaexibiodeimagensemformatodegrficosemumajanelasemfrescurasvisualizao(umaImageWindow).Formatosde
imagemsuportadosincluemGIF,JPEG,PNGeFITS,quepodemsercompactados.
TwoQZ
Funesespecializadasparausocomosdadosdapesquisa2QZ.Osdadosespectraisforamtiradasdiretamentedositeda2QZem
http://www.2dfquasar.org/.
Imagem
Funesparaexibiodeimagensemumajanela.FormatosdeimagemsuportadosincluemGIF,JPEG,PNGeFITS,quepodemser
compactados.OprogramaSoG(http://www.starlink.ac.uk/sog/)serusadoseestiverdisponvel,casocontrrio,aimagemtelespectador
semfrescurasserusadoemseulugar.
Sada
Funesparasadadelogsimples.
Sistema
Executacomandosdosistemaoperacionallocal.Estessoexecutadoscomosetivessedigitadoapartirdacasca,oulinhadecomando.
UmalistagemdasfunesdessasclassesdadaemApndiceB.2,eadocumentaocompletasobreelesestdisponveldentroTOPCATda
JanelaFunesdisponveis.

9InteroperabilidadeFerramenta
TOPCATcapazdesecomunicarcomoutrasferramentasqueutilizamumououtrodosdoisprotocolosdemensagens:
SAMP(AplicaesSimplesprotocolodemensagens)
PLASTIC(plataformadeinterconexoastronmico
Umexemplodotipodecoisaquepodeserfeitopodeser:
1. TOPCATenviaumcatlogoparaumaferramentadevisualizaodeimagem
2. Aferramentadevisualizaodaimagemmostraasentradasdocatlogocomomarcadorescolocadosadequadamenteemumaimagem
exibida
3. Aesdousurioquedestacamumdospontosemumanicaferramentapode,ento,destacarautomaticamenteomesmopontonooutro
ExemplosdotipodeferramentaquepodeinteroperarcomTOPCATdestaformasoferramentasdeanlisedeimagem(Aladin,GAIA,DS9
)ferramentasdeanlisedemesa(VisIVO,STILTS,outrasinstnciasdoprprioTOPCAT),ferramentasdeanlisedeespectro(SPLAT,
VOSpec),cuferramentasdevisualizao(GrandeTelescpioMundial,Virgem),linguagensdescript(Sampy),eoutros.
SAMPeplsticofazermuitoomesmotrabalhoqueosoutros,etrabalhardamesmamaneira.SAMPumaevoluodoplsticocomumasrie
demelhoriastcnicas,eassimoplsticoagorapreteridoemfavordeSAMP.Nonecessrioqueosusuriosaentenderasdiferenasentre
osdois,mas,emgeral,umaferramentausandoSAMPpodesecomunicarcomoutrasferramentasqueutilizamSAMP,eomesmocomo
plstico,masnamaioriadoscasosainteroperaoentreplsticoeferramentasSAMPnovaifuncionar.
Aarquiteturadecomunicaodosdoisprotocolosbasicamenteomesmo:todasasferramentasdecomunicaocomumacentraldeprocesso
"Hub",demodoqueumhubdeveestaremexecuoparaqueamensagemdeoperar.SeumhubestfuncionandoquandoTOPCATcomea,
ouseuminiciadoenquantoTOPCATestemfuncionamento,eleseconectaraelaautomaticamente.Umhubpodeseriniciadoapartirde
TOPCATsenecessriodetalhesdecomofazerissosodadasnaSAMPePLSTICOseesabaixo.Outrasferramentasterosuasprprias
polticasparaconexocomohub,masemgeralumaboaidiaparacomearaprimeiradeumhubantesdeiniciarseasferramentasquevoc
querfalarcomele.
TOPCATpodetrabalharnomodoPLASTICSAMPou,masnoambosaomesmotempo.Eledeterminaqualmodousarnainicializao:seo
samp-ou-plsticobandeirafornecidonalinhadecomandoomodocorrespondenteserusadocasocontrrio,seaSAMPcorrerouhub
deplsticopodemserencontrados,omodocorrespondenteusado,casocontrrio,opadroSAMP.fcildedizerdomodoqueestsendo
usado,olhandoparaajaneladecontrolenomodoSAMPopainelSAMPexibindoconexoestatusdamensagemvisvelnaparteinferior
dopaineldoladodireito(existemalgumasoutrasmudanasnoGUItambm).Facilidadesparamonitoramentodecomunicaesso
consideravelmentemelhoresemSAMPdoquenomodoPLSTICO.
Estacomunicaotemdoisaspectos:porumladoTOPCATpodeenviarmensagensparaoutrasaplicaesquefazcomqueelesfaamas
coisas,eporoutroladoTOPCATpoderecebereagirsobreessasmensagensenviadasporoutrosaplicativos.Osenviadoserecebidos
mensagenssodescritosseparadamentenassubseesabaixo.Htambmseessobreos,umpoucodiferentes,maneirasdecontrolare
monitorarmensagensoperatiionparaoscasosdeSAMPeplstico.

9.1controleSAMP
QuandoexecutadonomododeSAMP,ajaneladecontrolepossuivriasformasdevisualizarecontrolarostatusSAMP.
BotoSAMPEstado(

AbreaJanelaSAMP,quemostraumavisodetalhadadoestadodascomunicaesSAMP,epermitequevocpararegistrarou
cancelaroregistrocomohub,eparainiciarumhub,senecessrio.
PainelSAMPEstado
AparteinferiordopaineldoladodireitotemumareadenominadaSAMP.Issodumavisoresumidadasituaodoregisto,osoutros
aplicativosconectadosemensagensrecentementeenviadaserecebidas.EladescritaemmaisdetalhenoApndiceA.2.4.
TabelaBroadcast(
)eTabela(Enviar )opesdemenu
AInteropmenuofereceestasopesquepermitemquevocenviaratabelaatualmenteselecionadaparaumoutodososclientes
http://127.0.0.1:2525/doc/sun253/sun253.html

28/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

conectados.Observequesserativadoseohubestemexecuo,ehpelomenosumclienteconectado,quesabereceberumatabela.
ATransmissoopotambmestdisponvelnabarradeferramentas.
PararInternoHub(
opodemenu)
Porpadro,quandoTOPCATinicia,eleirprocurarumhubSAMP,esenadapareceestarfuncionandocomearuminternamente,que
normalmentedecorreatsadasTOPCAT.Issogeralmentenoproblemtico,massevocpreferirexecutarumhubexternopara
TOPCAT,entovocpodeprecisarencerrarTOPCATdeantesdeiniciarumnovo.Usandoestaopodesligahubinternodo
TOPCAT.
UmasriedeoutrasjanelaspossuemumInteropmenucomTransmisso(

)eEnviar(

)operaesparatiposdedadosapropriados

paraessajanela.svezesTransmissoaparecenabarradeferramentastambm.EmalgunscasoshtambmAceitar(

)opesde

alternncianomenuInterop.EstescontrolarseTOPCATirresponderamensagensapropriadasenviadosporoutrasaplicaesSAMP.

9.2controlePLSTICO
VocpodevisualizarecontrolarasoperaesrelativasaocubodeplsticodaInteropdemenunajaneladecontrole.Elecontmasseguintes
opes:
RegistesenoPLASTIC
TentalocalizarumhubPLASTICcorrendoeseregistarcomele.
Cancelaroregistrocomplstico
SeatualmenteregistradoscomumhubPLSTICO,cancelaoregistrocomele.
Mostraraplicativosregistrados
AbreumapequenajanelaqueexibeoqueasaplicaesestoatualmenteregistradoscomqualquerhubdeplsticocomqueTOPCAT
estregistrado.Istosermantidoatdatacomoaplicaesregistrarecancelaroregistro.
ComecehubPLASTICinterno
IniciaumhubdeplsticocomopartedoprocessonoqualTOPCATestemexecuo.Issosvaifuncionarseumhubnoestiverem
execuo.OhubterminarquandoTOPCATsai.
ComecehubPLASTICexterno
Iniciaumhubdeplsticocomoumprocessoseparado.Issosvaifuncionarseumhubnoestiveremexecuo.Ocentrovaicontinuar
funcionandoatquesejaexplicitamenteencerrado(porexemplo,usandoumamatanadecomando).Porqueestatemalgumas
caractersticasdependentesdosistema,nogarantidoquefuncione,especialmenteemambientesnoUnix.
Ajudasobreainteroperabilidade
Abreumaseodeajudaapropriadanonavegadordaajuda.
TransmissoTabela
Transmiteatabelaselecionadaatualmenteparatodasasaplicaesdeescutacomplstico.
Enviartabelapara...
Enviaatabelaselecionadanomomentoparaumaaplicaodeaudioselecionaousodeplstico.Selecioneoaplicativodestinatrio
desejadonosubmenu.

9.3MensagensdeTransmisso
EstaseodescreveasmensagensqueTOPCATpodemtransmitiraoutrasferramentasqueentendemaSAMPouprotocoloPLSTICO,e
comolevlosaserenviada.Aproximadamenteosmesmosresultadosdecomportamento,querparaSAMPouplstico,excetoasindicadas.
Namaioriadoscasos,vocpodeescolherduasmaneirasdetransmitirumamensagemdeTOPCAT:
Transmisso
Transmiteamensagemparatodososoutrosaplicativosatualmenteregistradoscomohubqueentenderessamensagem.
Enviar
Enviaamensagemparaumnicoaplicativoquevocselecionar.Asaplicaesadequadas(aquelesquesoregistradoscomohube
pretendemcompreenderessamensagem)solistadosevocpodeescolherum.
ExaminandoalistadeaplicaesnoEnviarmenudlheumaindicaodequaisumbroadcastseriatransmitidopara.Note,porm,ques
porqueumaplicativoaparecenestalistanosignificanecessariamentequeelevaifazeralgosubstancialcomamensagem,porexemplo,alguns
aplicativosderegistrarcomohubapenasparamonitorarotrfego.Emgeral,adifusoeEnviaraesserdesativado(cinzentoout)se
TOPCATnoestregistradocomumhub,ousenohouveraplicaesdeescutaquepretendemapoiaramensagemrelevante.
AbaixoestumalistadelugaresquevocpodefazercomqueTOPCATparatransmitirmensagens.OsSAMPMTypeseplsticoIDsde
mensagenssolistadosjuntamentecomasdescriesamenosquevocforumdesenvolvedordeferramentaquevocprovavelmentepode
ignorarestes.
TransmitirTabela
AjaneladecontroledaInteropmenuforneceTransmissoTabelaeTabelaEnviaropesquefazemcomqueatabelaselecionada
atualmenteparasertransmitidaparaoutrasaplicaesdeescuta.Elessoconvidadosacarregaratabelaemseuatual("aparente")
forma.ATransmissoaotambmestdisponvelnabarradeferramentas.
SAMPMTypes:table.load.votableoutable.load.fits
IDsdemensagensPLSTICAS:ivo :/ / votech.org / votable / cargaouivo :/ / votech.org / votable /
loadFromURL

http://127.0.0.1:2525/doc/sun253/sun253.html

29/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Transmitirsubconjunto
AJanelasubconjuntodaInteropmenucontmTransmissosubconjuntoeEnviarsubconjuntoopes.Estescausamosubconjunto
selecionadoparaserenviadoparaoutrasaplicaesdeescuta(essasaessestodisponveisquandoumdossubconjuntos
selecionado).Estoabertascandidaturasparadestacaraslinhascorrespondentesaessesubconjunto.Notequeestesterefeitoseo
outroaplicativo(s)estexibindoatabelaqueestesubconjuntorelaciona.Esteserocasoemumadasduassituaes:(1)atabelafoi
carregadoapartirdamesmaURL/filenamepelaoutraferramenta(s)ou(2)aoutraferramenta(s)adquiriramamesa,poisjtemfoi
transmitidousandoSAMP/PLSTICO.
Almdisso,semprequeumnovosubconjuntocriado,porexemplo,inserindoumaexpressoalgbricaoutraandoumaregioemum
terreno(verSeo3.1.1),voctemaopodetransmitirosubconjuntodiretamenteparaumaoutodasasaplicaesdeescutacomo
umaalternativaparaadicionaronovosubconjuntoalistasubconjuntodatabela.
SAMPmtype:table.select.rowList
PLASTICIDMensagem:ivo :/ / votech.org / votable / showObjects
TransmitirRow
OControlWindowtemumatransmissoRowopopelaaodeativaoselector.Seestaopoforselecionada,entoaqualquer
momentovocativarumalinha(porexemplo,clicandonopontocorrespondenteemumaparcela)outrasaplicaesqueestoolhando
paraamesmamesasoconvidadosadestacarquealinhaemsuacpiadatabela.Quantotransmissosubconjuntoacima,estester
efeitoseooutroaplicativo(s)estexibindoamesmatabela.
UmainstalaosemelhanteestdisponvelcomooTransmitRowoponoacesdeactivaodejanelaemsiacaixaapenasuma
conveninciaparaumaopomaisutilizadas.
SAMPmtype:table.highlight.row
PLASTICIDMensagem:ivo :/ / votech.org / votable / highlightObject
TransmitirCoordenadas
OutraaodeativaodeTransmissoCoordenadas.Nestecaso,quandovocativarumalinha(porexemplo,clicandonoponto
correspondenteemumaparcela)outrasaplicaessoconvidadosaindicaraposiodocucorrespondentelinhaqueativado,por
exemplo,colocandoocursorsobreele.AscolunasdatabelaquecorrespondemaAscensoRetaeDeclinaodeveserselecionadapara
queissofuncione.
SAMPmtype:coord.pointAt.sky
PLASTICIDMensagem:ivo :/ / votech.org / Sky / pointAtCoords
TransmitirImagem
OLoteDensidadeproduzumhistograma2d,quenaverdadeumaimagem.OInteropmenuforneceTransmissodaImageme
enviarumaimagemopesqueirenviaresta(comoumaimagemFITS)paraoutrasaplicaesquepodemexibilodealgumaforma.
EsteumcomplementotilsinstalaesdajanelaPlotdadensidade,umavezquenotmcaractersticasdevisualizaodeimagens
muitosofisticadas(mapasdecorvarivel,contornoparcelasetc.)
Almdisso,oVerURLimagemcomoaodeativaoopopermiteidentificarumacolunaquecontmumaURLdeimageme
enviloparaumvisualizadordeimagemadequadaoutelespectadores.
SAMPmtype:image.load.fits
PLASTICIDMensagem:ivo :/ / votech.org / encaixa / imagem / loadFromURL
TransmitirSpectrum
OVerURLcomoSpectrumAoAtivaoopopermiteidentificarumacolunaquecontmumaURLespectroeenviloparaum
visualizadordeespectroadequadooutelespectadores.
SAMPmtype:spectrum.load.ssa-generic
PLASTICIDMensagem:ivo :/ / votech.org / espectro / loadFromURL
TransmitirListaderecursos
OPaineldeConsultadeRegistropresentenamaioriadasjanelasdoObservatrioVirtualpermitequevocenvieaslistasdeVO
identificadoresderecursosderegistroparaoutrasaplicaesquepodemfazerusodeles.ObserveissosfuncionanomodoSAMP,e
noparaoplstico.
SAMPMTypes:voresource.loadlist.cone,voresource.loadlist.siap,voresource.loadlist.ssap

9.4Mensagensrecebidas
EstaseodescreveasmensagensqueTOPCATirresponderaquandorecebelosdeoutrasaplicaesatravsdohubSAMP/plstico.Os
SAMPMTypeseIDsdemensagensdeplsticosolistadosjuntamentecomasdescriesamenosquevocforumdesenvolvedorde
ferramentaquevocprovavelmentepodeignorarestes.
CargaTabela
Carregaumatabelaenviadaporoutraaplicao.Eleadicionadolistadetabelasnajaneladecontrole.
http://127.0.0.1:2525/doc/sun253/sun253.html

30/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

SAMPmtype:table.load.votable,table.load.fits,table.load.cdfoutable.load.stil
PLASTICIDMensagem:ivo :/ / votech.org / votable / cargaouivo :/ / votech.org / votable / loadFromURL
Observeomtypenopadrotable.load.stilsuportadoparacarregartabelascomSAMP.Istocomoooutrotable.load. *
MTypes,masqualquerformatodetabelasuportadopeloaplicativopermitido.Estemtypetemum"parmetroadicionalformato",que
deveconteronomedoformatodetabela(nodiferenciamaisculasdeminsculas).
Novasubconjunto
Carregaumaseleodelinhaenviadoapartirdeoutroaplicativo.Seumaplicativoexternoestolhandoparaamesmamesaqueumque
TOPCATfoicarregado,elepodeenviarumaseleodelinha.Nestecaso,TOPCATvaiacrescentarqueaseleocomoumnovo
subconjuntoRowparaatabela.Onomedosubconjuntorecebidovaiserodaaplicaodeorigem,porexemplo"Aladin".Seum
subconjuntodequeonomejexiste(oqueprovavelmenteporqueamesmaaplicaoenviouumaseleodelinhaanteriormente),
entooseucontedosersubstitudopelanovaseleo.Emambososcasos,orecebimentodamensagemfazcomqueparcelasexibindo
osdadosdatabelaemquestodemostrarospontosdonovosubconjunto.
Nota:estecomportamentodiferentedocomportamentoemversesTOPCATantesv3.0.Diferentesopesparaamanipulao
exatamentecomoumaseleodelinharecebidatratadapodeserdisponibilizadoemversesfuturas.
SAMPmtype:table.select.rowList
PLASTICIDMensagem:ivo :/ / votech.org / votable / showObjects
DestaqueRow
SeTOPCATjcarregouatabelaidentificadapelopedido,elevaiativaralinhasolicitada.Issoresultarnalinhaqueestsendomarcado
emquaisquerparcelasactualmentevisveisenajaneladedadosseestivervisvel,bemcomoderealizarqualqueraoadicionalquevoc
configurounajaneladeativao.
SAMPmtype:table.highlight.row
PLASTICIDMensagem:ivo :/ / votech.org / votable / highlightObject
Identificadoresdecargaderecursos
RecebeumalistadeidentificadoresderecursosVOregistrodeoutroaplicativo.VriosdeTOPCATvirtuaisjanelasdeacesso
Observatrioexibirumalistaderecursosemseupaineldeconsultaderegistro.Normalmente,osrecursosindicadassoumconjunto
padroousoaquelesquevoctiverselecionadodigitandopalavraschave.Noentanto,outroaplicativopodeenviarumalistade
recursos,eseelessodeumtipoapropriadoparaajanelaemquesto,eseajanelaestvisvel,asualistaexibidaatualmentesero
substitudosporaquelesqueforamenviadas.
SAMPMTypes:voresource.loadlist,voresource.loadlist.cone,voresource.loadlist.siap,
voresource.loadlist.ssap

ObterTabela
PermitequeosclientespararecuperartabelasatualmentecarregadosnaTOPCAT.Estemtypetemumparmetroobrigatrioformato
dandoa(caseinsensitive)Nomedoformatodetabelanecessriaparaatabeladesada.Eletambmlevauminteirocomoparmetro
opcionalID,dandoonmerodeidentificao(comomostradonalistadatabelaJaneladeControle)databelanecessrio.Seidest
ausenteounopositivo,atabelaatualusado.ArespostaretornadotemumparmetrodesadaurldaroURLdaaparentetabelaem
questo.Estemtypeexperimentalepodesermodificadoouretiradonofuturo.
SAMPmtype:table.get.stil.
Mensagensdenveldosistematambmsorespondidas.ParaSAMPestesso:
samp.hub.disconnect
samp.hub.event.shutdown
samp.hub.event.register
samp.hub.event.unregister
samp.hub.event.metadata
samp.hub.event.subscriptions
samp.app.ping

eparaoplstico:
ivo :/ / votech.org / test / echo
ivo :/ / votech.org / info / getName
ivo :/ / votech.org / info / getIconURL
ivo :/ / votech.org / hub / evento / ApplicationRegistered
ivo :/ / votech.org / hub / evento / ApplicationUnregistered
ivo :/ / votech.org / hub / evento / HubStopping

10InvocandoTOPCAT
IniciandoTOPCATpodeserapenasumcasodedigitar"topcat"ouclicaremumconeadequadoeobservandoajaneladecontrolepopup.
Seforesseocaso,eeleestcorrendoalegrementeparavoc,vocprovavelmentepodeignorarestaseo.Oquesesegueumadescriode
http://127.0.0.1:2525/doc/sun253/sun253.html

31/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

comoiniciaroprograma,evriosargumentosdelinhadecomandoeopesdeconfiguraoquenopodemseralteradosapartirdedentrodo
programa.AlgunsexemplossodadosnaSeo10.5.Naverdade,aobtenodoprogramanocobertoaquiconsulteapginaweb
TOPCAThttp://www.starlink.ac.uk/topcat/.
ExistemvriasmaneirasdeiniciarTOPCATdependendodecomo(ese)elefoiinstaladoemseusistemaalgumasdasquaisestodescritas
abaixo.
Podehaveralgumtipodecurtocorteconenareadetrabalho,queseiniciaoprogramanestecaso,apenasclicandosobreelaprovavelmente
vaifuncionar.Nafaltaquevocpodesercapazdelocalizaroarquivojar(provavelmentechamadotopcat.jar,topcat-full.jarou
topcat-lite.jar)ecliquesobreisso.Essesarquivosseriamlocalizadosno/ lib / topcat / javadiretrioemumainstalaopadro
Starjava.Observequequandovoccomearclicandoemalgoquevocnopodeteraopodeentraremqualquerumadasopesdelinha
decomandodescritasabaixoparausaressasopes,quevocpodeprecisardefazerparausosriodoprograma,vocterqueexecutaro
programaapartirdalinhadecomando.
Alternativamente,vocvaiterquechamaroprogramaapartirdalinhadecomando.EmsistemasoperacionaisUnixlike,vocpodeusaro
topcatscript.Sevoctiverainstalaocompletastarjava,este,provavelmente,nostarjavadiretrio/java/bin.Sevoctiverumdos
arquivosjarautnomos(topcatfull.jaroutopcatlite.jar),eledeveestarnomesmodiretrioqueele/eles.Senoestiverl,vocpode
descompactloapartirdoprprioarquivojar,usandoumcomandocomounzip topcat topcat-lite.jar.Seessediretrio(ejava)est
emseucaminho,emseguida,vocpodeescrever:
topcat [java-args] [Topcat-args]

Emtalcaso,osargumentosquepartem-Dou-Xsoconsideradosargumentosparaocomandojava,quaisquerargumentosquecomeam-J
soretiradosdo-Je,emseguida,passados
comoargumentosparaocomandojava,um-classpath pathdefineumcaminhodaclasseaser

utilizadosemadiosclassesTopCat,etodososdemaisargumentossoutilizadosporTOPCAT.
SevocnoestiverexecutandoUnixemseguida,iniciarapartirdalinhadecomandoquevocterqueusarojavacomandoprprio.A
maneiramaissimplesdefazerissoseralgocomo:
java caminho [java-args]-jar / to / topcat.jar [Topcat-args]

(Ouomesmoparatopcat-full.jaretc).NoentantoNOTA:usandojavade-jarbandeiraignoraqualqueroutrainformaocaminhode
classe,comoavariveldeambienteCLASSPATHoujavado-classpathbandeiravejaSeo10.2.1.
NotesequeJavaWebStarttambmpodeserusadoparachamaroprogramasemanecessidadedequalquerdownload/instalaoprvia
desculpe,issonoestdocumentadocorretamenteaquiainda.
Osignificadodosopcionais[Topcat-args]e[-args JAVA]seqnciasestodescritasnaSeo10.1eSeo10.2abaixo,respectivamente.

10.1TOPCATArgumentosdelinhadecomando
VocpodecomearTOPCATapartirdalinhadecomandosemargumentosnestecaso,elevaiajaneladecomandoapartirdoqualvoc
podecarregaremtabelasapenasaparecer.Noentanto,vocpodeespecificarbandeirase/oulocaisdemesaeformatos.
Sevocchamaroprogramacoma"ajuda-bandeira",vocveraseguintemensagemdeuso:
Uso: topcat <flags> [[-f <formato>] <table> ...]
Bandeiras gerais:
-Help mostra esta mensagem e sada
Verses dos componentes de impresso de verso etc e sada
-Verbose aumentar o detalhe dos relatrios para consolar
-Debug adicionar informaes de depurao para consolar as mensagens de log
-Demo comea com dados de demonstrao
-Running uso instncia TOPCAT existente se est em execuo
Memria de armazenamento de memria uso para tabelas
Disco rgido uso armazenamento de backup para tabelas grandes
-Samp usar SAMP para a interoperabilidade ferramenta
Plstico uso de plstico para a interoperabilidade ferramenta
- [No] hub [no] executar cubo interno SAMP / PLSTICO
-Exthub executar hub SAMP / plstico externo
-Noserv no executar quaisquer servios (plstico ou SAMP)
-nocheckvers no marcar mais recente verso
-palafitas <args> STILTS executados no TOPCAT
-Jsamp <args> executar JSAMP no TOPCAT
teis bandeiras Java:
-Classpath jar1: jar2 .. especificar classes adicionais
Megabytes de uso da XmxnnnM nnn de memria
-Dname = propriedade do sistema conjunto de valor
Formatos de Auto-detectados:
encaixa-plus, colfits-plus, colfits-bsicos, fits, votable, cdf
Todos os formatos conhecidos:
encaixa-plus, colfits-plus, colfits-bsicos, se encaixa, votable, cdf, ascii, csv, tst, o IPAC, wdc
Propriedades do sistema teis (-Dname = valor - listas so separadas por dois pontos):
java.io.tmpdir diretrio espao de arquivo temporrio
classes do driver JDBC jdbc.drivers
jel.classes aulas funo personalizada algbricas
aulas de funo ao personalizada jel.classes.activation

http://127.0.0.1:2525/doc/sun253/sun253.html

32/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas


star.connectors aulas FileStore costume remotas
startable.load.dialogs aulas de dilogo de carga personalizado
startable.readers manipuladores de entrada da tabela personalizada
startable.writers manipuladores de sada da tabela personalizada
poltica de armazenamento startable.storage
trabalho mark.workaround torno marca / reset bug
(Ver topcat-jsamp-ajuda para mais)

Osignificadodasbandeirascomosesegue:
F<formato>
Significaqueoarquivo(s)emhomenagemaelenalinhadecomandoestoemumformatodearquivoespecfico.Algunsformatosde
arquivo(VOTable,FITS)podemserdetectadosautomaticamentepeloTOPCAT,masoutros(incluindovaloresseparadosporvrgula)
nopodeverSeo4.1.1.Nestecaso,voctemqueespecificarcomo-fbandeiraqueformatoosarquivosnomeadosestodentro
Qualquerarquivodatabelanalinhadecomandodepoisdeum-f <formato>seqnciadeveestarnoformatochamadoataprximafbandeira.Osnomesdeambososformatosdeautodetectadas(aquelesquenoprecisamdeum-f)eosformatosnodetectadoauto
(aquelesquefazem)sodadasnamensagemdeusovocpodever,dandoaajuda-bandeira(istomensagemmostradoacima).Voc
tambmpodeusaronomedaclassedeumaclassenoclasspathqueimplementaoTableBuilderInterfaceverSUN/252.
Ajuda
Seo-ajuda(ou-h)flagdado,TOPCATvaiescreverumamensagemdeutilizaoesairimediatamente.
Verso
Seaversodabandeiradado,TOPCATimprimirumresumodesuaversoeasversesedisponibilidadedealgunsdosseus
componentes,esairimediatamente.
Verbose
A-verbose(ou-v)flagaumentaonveldedetalhamentodasmensagensqueTOPCATescreveparaasadapadro(oconsole).Isso
podeserrepetidoparaaumentaronveldedetalhesmaisadiante.Asmensagensqueelecontrolasohojeaquelesescritoatravsdo
sistemaderegistropadrodojavaveradescriodajanelaLogparaobtermaisinformaessobreisso.
Debug
A-debugbandeiraafetaaformacomoasmensagensdelogaparecer(seaparecerafetadapela-verbosebandeira).Seestiver
presente,essasmensagensvofornecermaisdetalhessobreolocalondecadamensagemfoigeradaapartir.
Demo
A-demobandeirafazcomqueoprogramaparainiciarcomalgumasmesasdedemonstraocarregadosdentroVocpodeuslaspara
brincarcomsuasinstalaes.Observeessastabelasdedemonstraosomuitopequenasparaevitartomarummontedeespaona
instalao,enocontmdadosparticularmentesensveis,elessoapenasparadarumaidia.
Running
Aduraodabandeirapodeserusadoaoespecificarastabelasnalinhadecomando.SeumainstnciaexistentedoTOPCATjestem
execuo,asmesassocarregadosnele.SenenhumainstnciadeTOPCATestemexecuo(oupelomenosumanopodeser
descoberto),entoaduraosinalizadornotemefeitoeumanovainstnciainiciada,comodecostume.
Memria
Seamemriabandeiradadoentooprogramairarmazenarosdadosdatabelanamemria,emvezdopadroquearmazenar
pequenasmesasnamemria,eosmaioresemarquivostemporriosemdisco.
Disco
Seodiscobandeiradadoentooprogramairarmazenarosdadosdatabelaemarquivostemporriosemdisco,emvezdopadroque
armazenarpequenasmesasnamemria,eosmaioresnodisco.Sevocsairdemensagensdememria,correndocomodisco
bandeirapodeajudar,emboraapolticapadrodevefuncionarmuitobem.Osarquivosdedadostemporriossogravadosnodiretrio
temporriopadro(definidopelojava.io.tmpdirpropriedadedosistemamuitasvezes/ tmpeexcludosquandooprograma
encerrado,amenosqueelesaideumamaneiraincomum.
Samp
ForasTOPCATusarSAMPparaainteroperabilidadedeferramentas(verSeo9).Esteopadro,masomododeplsticoemvezde
SAMPcasocontrrioserescolhidoseumhubdeplstico,masnenhumhubSAMPestsendoexecutadonainicializao.
Plstico
ForasTOPCATusarplsticoemvezdeSAMPparaainteroperabilidadedeferramentas(verSeo9).
[No]hub
OhubbandeiraprovocaTOPCATparaexecutarumSAMPinternaouhubPLSTICO(SAMPporpadro),senenhumhubjestem
execuo,e-nohubbandeiraimpedequeissoacontea.Ocomportamentopadro,quandonenhumadessasbandeirasdado,
atualmente(desdev3.8)parainiciarumhubautomaticamenteparaSAMP,masnoparaoplstico.OhubterminarquandoTOPCAT
faz,oupodeserdesligadomanualmentecomoInterop|PararInternoHub(
itemdemenu).VejaSeo9.
Exthub
CausasTOPCATparatentarexecutarumSAMPexternoouhubPLSTICO,senenhumhubjestemexecuo.Ocentrovai
apareceremsuaprpriajanela,epodeserinterrompidofechandoajanela.OcentrovaicontinuaracorreratrsTOPCATtermina.
InvocandoprocessosexternosdeJavainerentementenoconfivel,entoissofeitoemumabasedemelhoresesforos.VejaSeo9
.
Noserv
ImpedeTOPCATdaexecuodequaisquerservios.Atualmente,osserviosquepodemexecutarsoSAMPoudeplstico(veja
acima).
checkvers
ImpedeTOPCATdeverificarumaURLexternaparaqueelepossadeterminarseaversomaisrecenteestsendoexecutado.
palafitas<stiltsargs>
EstabandeiraumaconveninciaquepermitequevocexecuteoSTILTSferramentadelinhadecomandoemvezdeTOPCAT.Isso
possvelporqueTOPCATconstrudoemcimadepernasdepauecontmumsubconjuntodoseucdigo.VejaoSTILTSManual(ou
topcat-palafitas-ajuda)paraaformado<stilts-args>.
Jsamp<jsampargs>
Estabandeiraumaconveninciaquepermitequevocexecuteojsampferramentadelinhadecomando,apartirdoJSAMPpacote,em
vezdeTOPCAT.IstopossvelporqueTOPCATcontmabibliotecaJSAMP.JSAMPoferecevriasSAMPutilidadesrelacionadas
http://127.0.0.1:2525/doc/sun253/sun253.html

33/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

como,comoumcentroindependenteeferramentasdediagnstico.ConsulteadocumentaoJSAMP,outopcat-jsamp-ajudapara
maisinformaes.
Outrosargumentosnalinhadecomandosotidascomooslocaisdasmesas.Quaisquertabelasassimespecificadosserocarregadosna
TOPCATnainicializao.Esseslocaissonormalmentenomesdearquivos,mastambmpoderiaserURLsouconsultasSQL,outalvezalgo
mais.Almdisso,elespodemconter"identificadoresdefragmentos"(comum"#")paralocalizarumatabeladentrodeumdeterminado
recurso,demodoque,porexemplo,alocalizao
/ My/data/cat1.fits # 2

significaasegundaprorrogaodomultiextensodearquivoFITS/ my/data/cat1.fits.Seo4.2descrevemaisdetalhadamenteostipos
deURLsquepodemserusados
aqui.

NotequeasopesparasiJavatambmpodeserespecificadanalinhadecomando,conformedescritonaprximaseo.

10.2OpesJava
Comodescritoacima,dependendodecomovocinvocarTOPCATvocpodesercapazdeespecificarargumentosparasiJava(a"Java
VirtualMachine"),queafetamaformacomoeleexecutado.Estespodemserdefinidosnalinhadecomandooudealgumaoutramaneira.As
subseesseguintesdescrevemcomocontrolarJavademaneirasquepodemserrelevantesparaTOPCATelesso,porm,umpouco
dependentedoambientequeestsendoexecutado,demodoquevocpodeexperimentarvariaesdependentesdosistemaoperacional.
10.2.1ClassePath
OclasspathalistadelugaresqueJavaolhaparaencontrarospedaosdecdigocompiladoqueeleusaparaexecutarumaplicativo.Ao
executarTOPCATissosempretemdeincluirasprpriasclassesTOPCATestapartedachamadadecostumeedescritonaSeo10No
entanto,paracertascoisasJavapodeprecisardeencontraralgumasoutrasclasses,emespecialpara.:
DriversJDBC(verSeo10.3)
Fornecerfunesalgbricasestendidas(verSeo7.9)
LanamentoMirage(verponto4.1.2.12)
InstalaodemanipuladoresdeI/Oparaosnovosformatosdetabela(verSeo4.1.3)
Sevocestiverindoparausarasinstalaesquevocprecisaparainiciaroprogramacomelementosdecaminhodeclasseadicionaisque
apontamparaalocalizaodasclassesnecessrias.ComofazerissodependedecomovocestinvocandoTOPCAT.Sevocestiverusando
thttopcatscriptdeinicializao,vocpodeescrever:
topcat-classpath outros-caminhos ...

(IssoaumentaoscaminhosdadasaospadresexigidosparasiTOPCAT).Sevocestinvocandojavadiretamente,entovocpodeescrever
nalinhadecomando:
caminho java-classpath / to / topcat.jar: outros caminhosuk.ac.starlink.topcat.Driver ...

oudefiniroambienteCLASSPATHalgovarivelassim:
caminho setenv CLASSPATH / to / topcat.jar: outros caminhos-

Emqualquercaso,mltiploscaminhos(extra)devemserseparadospordoispontosnaoutrospercursosdecadeia.
Observeque,sevocestiverexecutandoTOPCATusandojavade-jarbandeira,qualquertentativadefazerparaespecificaroclasspathser
ignorado!IstotemavercomomodelodeseguranadoJava.Sevocprecisaespecificarumcaminhodeclassequeincluimaisdoqueas
classesTOPCATprprios,vocnopodeusarjava-jar(usejava-classpath topcat-lite.jar: ...
uk.ac.starlink.topcat.Driverlugar).
10.2.2Tamanhodamemria
SeTOPCATfalharduranteaoperaocomumamensagemquedizalgosobreumjava.lang.OutOfMemoryError,entooseutamanhode
heapmuitopequenoparaoquevocesttentandofazer.Vocterqueexecutarjavacomumtamanhomaiorpilhausandoo-Xmxbandeira.
InvocandoTOPCATdotopcatscriptqueiriaescreveralgocomo:
topcat-Xmx256m ...

ouusandojavadiretamente:
java-Xmx256m ...

oquesignificausarat256megabytesdememria(noseesqueado"M"paramegabyte).JVMsmuitasvezesopadroparaumtamanhode
heapde64M.Vocprovavelmentenoquerespecificarumtamanhodeheapmaiordoqueamemriafsicadamquinaquevocest
executando.
Existemoutrostiposdeopesdememriaeajustecontroladosutilizandoasopesdaforma-X <something-or-other>sevocestiverse
sentindoaventureirovocpodesercapazdedescobrirsobreestesdigitando"java-X".
Notanoentanto:usandoodiscobandeiradescritonaSeo10.1podeserumasoluomelhorissofazcomqueosdadosdoarmazenamento
deprogramadegrandestabelasemdisco,emvezdenamemria.
http://127.0.0.1:2525/doc/sun253/sun253.html

34/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

10.2.3Propriedadesdosistema
AspropriedadesdosistemasoumaformadeobtenodeinformaesemJava(elessooequivalenteJavadevariveis
deambiente).Os

seguintesosquetmsignificadoespecialdentroTOPCAT:
apple.laf.useScreenMenuBar

NaplataformaAppleMacintoshs,estapropriedadecontrolaseosmenusaparecemnapartesuperiordatela,comodecostumepara
Mac,ounotopodejanelasindividuaiscomodecostumeparaJava.PorpadroeledefinidocomoverdadeiroparaTOPCAT,ento
menusaparecemprincipalmentenapartesuperiordatela(emboranosejacertodizerqueTOPCATobedeceaoMacolharesentirse
completamente)sevocpreferirolookmaisJavalikeesentir,configurloparafalso.

http.proxyHost

SevocestiveroperandodentrodeumfirewallqueprobeconexesHTTPdiretas,vocpodedefinirissoparaonomedeumservidor
proxyHTTPparaacessarservidoresremotoscomonecessrioparaafuncionalidadeVOetcHumasriedepropriedadesdosistema
relacionadosquevocpodeoupodenoprecisarusarnestecaso:http.proxyPort,https.proxyHostetcConsulteadocumentao
dojavaapropriado(porexemplo,pesquisandopor"http.proxyHost")paramaisdetalhes.

java.io.tmpdir

OdiretrionoqualTOPCATvaiescreverosarquivostemporriosdequenecessita.Issogeralmentefeitosomenteseodisco
sinalizadorfoiespecificado(verSeo10.1).

jdbc.drivers

Podeserdefinidacomoumalista(separadapordoispontos),declassesdodriverJDBCqueutilizambancosdedadosSQLpodeser
acessado(verSeo10.3).

jel.classes

Podeserdefinidacomoumalista(separadapordoispontos)declassesquecontmmtodosestticosquedefinemasfunesfornecidas
pelousurioparacolunassintticosousubconjuntos.(VerSeo7.9).

jel.classes.activation

Podeserdefinidacomoumalista(separadapordoispontos)declassesquecontmmtodosestticosquedefinemasfunesfornecidas
pelousurioparausoemexpressesdeativaopersonalizada.(VerSeo7.9).

jsamp.hub.profiles

EstapropriedadedeterminaqueperfisdeumhubSAMPvaiusarsevocexecutarumhubinternoouexternodeTOPCAT(oucomo
hub/exthub-bandeira,oudaGUI).Ovalorumalistadeespecificadoresdeperfilseparadoporvrgulasopesso"std"paraPerfil
Padro,"web"paraoperfildaWebouonomedeumaclassequeimplementaaorg.astrogrid.samp.hub.HubProfileinterface.A
configuraopadroexecutadoapenasumhubpadrodoperfil,mas,porexemplo,definindoocomo"std, web"seriaexecutadoum
perfildeWebtambm.Notequevocdeveincluirstdnalista,casocontrrioTOPCATnosercapazdefalarcomohub.Consultea
documentaoJSAMPparamaisdetalhes.

jsamp.localhost

DefineonomedamquinaemqueohostlocalparaseridentificadoemURLs,parapontosdeextremidadeservidorinstncia.Seno
estiverdefinida,opadroatualmenteoendereodeautoretorno"127.0.0.1".Noentanto,seessapropriedadedefinida
(presumivelmenteparatotalmenteouparcialmentequalificadonomededomniodohostlocal)seuvalorserutilizadonolugar.Dois
valoresespeciaistambmpodeserregulada:"[nome do host]"paraonomededomniototalmentequalificadodohost,e"
[hostnumber]"paraonmeroIP.

jsamp.server.port

DumnmerodeportapreferidaemqueparaabriroservidorHTTPinternodoTOPCAT,usadoparacomunicaesSAMPentre
outrascoisas.Seestaportanoestiverdisponvel,outraportaserusadaemseulugar.

jsamp.xmlrpc.impl

IndicaqueaimplementaoXMLRPCpluggabledeveserusadoparacomunicaesSAMP.Porpadroumaimplementaointerna
usada.Sefordefinidocomo"xml-log"ou"rpc-log",entotodasascomunicaesXMLRPCseroregistradosemtermosmuitoou
bastantedetalhados,respectivamente,paraasadapadro.Onomedaclassedeumorg.astrogrid.samp.xmlrpc.XmlRpcKit
implementaopodeserdadaemvezdeusarumaimplementaopersonalizada.

lut.files

Podeserdefinidacomoumalista(em*nix,separadospordoispontos,pontoevrgulaseparadonoWindows)dearquivosdandotabelas
depesquisapersonalizadaparaoeixoauxiliaredensidademapasmapadecores.Cadaarquivodeveserumarquivodetextocontendo
umnmerodelinhasseparadasporespao,cadaumcontendovermelho,verde,azulamostrasnafaixade01.Porexemplo,oarquivo
1,0 1,0 0,0
1,0 0,0 1,0

dariaummapadecoresquedesaparecedoamareloaomagenta.Podeserdadaqualquernmerodeamostrasaescalainterpolado.
mark.workaround

Sedefinidocomo"true",issovaifuncionaremtornodeumbugnamarca ()/reset ()mtodosdealgunsjavaInputStreamaulas.


Estessobastantecomuns,inclusivenosistemadebibliotecasJ2SEdaSun.Useistosevocestvendooserrosquedizemalgocomo"
Redefinindo a marca invlida".Atualmenteopadro"false".

myspace.cache

Sedefinidocomo"true",issovaiimpedirqueosdiretriosnonavegadordearquivosMySpacedeserlidomaisdeumavez.Estauma
soluoparaosproblemasdedesempenhoMySpacenomomentodaescrita(abrilde2006)definindooverdadeiropodelevaradelistas
dearquivosdataemMySpace,maspodesermuitomaisrpido.Estecomportamentopodeserretiradanasversesfuturasseo
desempenhomelhoraMySpace.Atualmenteopadro"false".

service.maxparallel

Aumentaonmeromximodeconsultassimultneasquepodemserfeitasduranteumaoperaodemulticone.Vocsdeveaumentar
estevalorcommuitocuidadojquecorreoriscodesobrecarregarosservidoresetornarseimpopularentreoscentrosdedados.Como
regrageral,vocsdeveaumentarestevalorsetiverobtidoapermissodoscentrosdedadoscujosserviosemquevocestarusando
oaumentodoparalelismo.

star.basicauth.user
star.basicauth.password

Sedefinido,estesirofornecernomedeusurioesenhaparaaautenticaobsicaHTTP.Todavezqueoaplicativotentaacessaruma
URLHTTPeatendidoporumarespostanoautorizada401,elevaitentarnovamentefornecendoessascredenciaisdousurio.Este
uminstrumentobastanterudimentar,umavezqueamesmaidentidadefornecidoindependentementedequalURLestsendoacessado,
maspodeserdealgumautilidadenoacessoaserviosprotegidosbasicautenticao.

http://127.0.0.1:2525/doc/sun253/sun253.html

35/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Seessaspropriedadesnosodefinidas,emseguida,aoencontrarum401naaplicaoiraparecerumajaneladedilogopedindonome
deusurioesenha.
star.connectors

Podeserdefinidacomoumalista(separadapordoispontos)declassesquefornecemacessoaimplementaesfilespaceremotos.Assim,
asclassescomnomesdevemimplementarouk.ac.starlink.connect.Connectordeinterfacequeespecificacomovocpodefazer
logonemumserviocomoesseeforneceumavisohierrquicadoespaodearquivoqueelecontm.

startable.load.dialogs

Podeserdefinidacomoumalista(separadapordoispontos)declassesdedilogocargademesapersonalizado.Emresumo,vocpode
instalarseusprpriosdilogosdeimportaodetabelasemtempodeexecuo,fornecendoclassesqueimplementamo
uk.ac.starlink.table.gui.TableLoadDialoginterfaceenomelosnesteimvel.VejaSTILdocumentaoparaobtermais
detalhes.

startable.readers

Podeserdefinidacomoumalista(separadapordoispontos)deformatodetabelapersonalizadoclassesdemanipuladordeentrada(ver
Seo4.1.3).

startable.storage

Podeserdefinidoparadeterminarapolticadearmazenamentopadro.Definilopara"disco"tembasicamenteomesmoefeitoqueo
fornecimentodo"disco"argumentonalinhadecomandoTOPCAT(verSeo10.1).Outrosvalorespossveisso"adaptveis
","

memria","de lado"e"descartar"verSUN/252.Opadro"adaptvel",quesignificaarmazenarmenorestabelasem
memria,eosmaioresnodisco.

startable.writers

Podeserdefinidacomoumalista(separadapordoispontos)deformatodetabelapersonalizadomanipuladorclassesdesada(verSeo
4.1.3).

topcat.exttools

DefineferramentasdeextensoparaserusadoporTOPCAT.Ovalorumalistaseparadapordoispontosdenomesdeclasses,cada
umadasquaisdeveimplementarouk.ac.starlink.topcat.TopcatToolActioninterfaceetemumconstrutorsemargumento.As
aescorrespondentesataisclassesseroadicionadosbarradeferramentas.Esteumrecursodeextensibilidadeexperimental,oque
podesermodificadoouretiradoemumaversofutura.

user.dir

Defineodiretriodetrabalhoatual.Issodeterminaopadroapartirdoqualosnavegadoresdearquivosseriniciado.

votable.namespacing

DeterminacomonamespacingtratadoemdocumentosdeentradaVOTable.Osvaloresconhecidosso"nada"(semnamespacing,
xmlnsdeclaraesemdocumentoVOTableprovavelmenteirconfundirparser),"negligente"(qualquercoisaquepareceque,
provavelmente,umelementoVOTablesertratadocomoumelementoVOTable)e"rigoroso"(elementosVOTabledeveser
devidamentedeclaradoemumdosnamespacesVOTablecorretas).Tambmpodeserdefinidocomoonomedaclassedeum
uk.ac.starlink.votable.Namespacingimplementao.Opadro"frouxa".

votable.strict
DefinaverdadeiroparaaaplicaoestritadanormaVOTableaoanalisarVOTables.Issoimpedequeoanalisadordetrabalharrodada
certoserroscomuns,comofaltaarraysizeatributosemelementosCAMPO/paramcomdatatype = "char".Falseporpadro.
votable.version
SelecionaaversodopadroVOTablequeVOTablessadaestardeacordocomporpadro.Podelevarosvalores"1.0","1.1","
1.2"ou"1.3".Porpadro,Verso1.2VOTablessoescritos.

ParadefiniressaspropriedadesnalinhadecomandoquevocusaroD-bandeira,quetemaforma
-D <property-name> = valor

SevocestiverusandooscriptdeinicializaoTOPCAT,vocpodeescreveralgocomo:
topcat-Djdbc.drivers = org.postgresql.Driver ...

ousevocestiverusandoojavacomandodiretamente:
java-Djdbc.drivers = org.postgresql.Driver ...

Alternativamente,vocpodeacharquemaisconvenienteparaescreveressasdefiniesemumarquivochamadostarjava.properties.
noseudiretriohomeabandeiradelinhadecomandoacimaseriaequivalenteainseriralinha:
jdbc.drivers = org.postgresql.Driver

nasua. starjava.propertiesarquivo.

10.3JDBCConfigurao
EstaseodescreveaconfiguraoadicionalquedeveserfeitoparapermitirqueTOPCATparaacessarbancosdedadosrelacionaisdoSQL
compatvelparaleitura(verSeo4.1.1.9)ouescrito(verponto4.1.2.9)tabelas.Sevocnoprecisafalarcomosbancosdedadosdotipo
SQL,vocpodeignorarorestodestaseo.AsetapasdescritasaquisoospadresparaconfigurarJDBC(quesortdestandsparaJava
DatabaseConnectivity),descritosmaisdetalhadamenteempginawebJDBCdaSun.
ParausarTOPCATcombancosdedadosSQLcompatvel,vocdeve:
TeracessoaumbancodedadosSQLcompatvellocalmenteouatravsdarede
TenhaumdriverJDBCapropriadoparaessebancodedados
InstaleestedriverparausocomTOPCAT
ConheaoformatoqueomotoristausaparaURLsparaacessarastabelasdebancodedados
Terprivilgiosapropriadosnobancodedadosparaexecutarasoperaesdesejadas
Instalarocontroladorconsisteemduasetapas:
http://127.0.0.1:2525/doc/sun253/sun253.html

36/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

1. Definaojdbc.driverspropriedadedosistemaparaonomedaclassedodriverconformedescritonaSeo10.2.3
2. VerifiqueseoclasspathvocestiverusandoincluiestaclassededriverconformedescritonaSeo10.2.1
EstespassossotodospadroparaousodoJDBCsistema.
Paraoconhecimentodoautor,TOPCATatagoratemsidoutilizadocomsucessoosseguintesRDBMSsecorrespondentesdriversJDBC:
MySQL
MySQLfoitestadonoLinuxcomoConnector/Jmotoristaeparecefuncionarversestestadassoserver3.23.55com3.0.8e4.1.20
doservidorcommotorista5.0.4motorista.svezes,astabelascommuitos(centenasde)colunasnopodeserescritodevidoarestries
decomprimentoinstruoSQL.Notequenoconhecidoporserumbugmetadadosdecolunanaverso3.0.6dodriver,quepode
causarumerrodeClassCastExceptionquandoastabelassoescritos.Verifiqueadocumentaododriverparaparmetrosadicionais,
porexemplo"useUnicode = true & characterEncoding = UTF8"pode
serobrigadoalidarcomalgunscaracteresnoASCII.

PostgreSQL
PostgreSQL7.4.1,aparentemente,trabalhacomseuprpriodriver.Observeodesempenhodestedriverpareceserbastantepobre,pelo
menosparaescrevertabelas.
Orculo
VocpodeusaroOraclecomodriverJDBCquevemcomopartedeseupacotebsicoInstantClient.Noentanto,vocnopode
atualmenteutilizaracargaSQL/SQLsalvarcaixasdedilogoparafazlo.VoctemqueespecificarumURLJDBCespecificandoa
consultaparaleitura/mesaparaescrevercomoumastringnoLocalizaocampodatabelanormaldecarga/salvarcaixasdedilogo.A
URLserparecidocom
jdbc: oracle: thin: @ / / hostname: 1521/database # SELECT ...

paraconsultarumbancodedadosexistente(carregamento)e
jdbc: oracle: thin: @ / / hostname: 1521/database # new-table-name

paraescreverumanovatabela(economia).
SQLServer
HmaisdeumdriverJDBCconhecidoportrabalharcomoSQLServer,incluindojTDSeodriverMicrosoftJDBC.Algumas
evidnciassugeremquejTDSpodeseramelhorescolha,massuamilhagempodevariar.
SybaseASE
TemhavidoumusobemsucedidodaSybase12.5.2ejConnect(jconn3.jar)usandoumaURLJDBCcomo"jdbc: sybase: Tds:
hostname: port / dbname user = XXX & password = XXX # selecione ...".UmatentativaanteriorusandoSybaseASE
11.9.2falhou.
OutrosRDBMSsemotoristaspodeounopodetrabalharporfavor,deixenossaberosresultadosdetodasasexperinciasquevoccarrega
parafora.SunmanterumalistadedriversJDBCparadiversosbancosdedadoselepodeserencontradoem
http://servlet.java.sun.com/products/jdbc/drivers.
AquiestoexemplosdelinhasdecomandoparainiciarTOPCATusandobancosdedadosconhecidosparaotrabalho.
PostgreSQL
java-classpath topcat-full.jar: pg73jdbc3.jar \
-Djdbc.drivers = org.postgresql.Driver \
uk.ac.starlink.topcat.Driver

MySQL
java-classpath topcat-full.jar: mysql-connector-java-3.0.8-bin.jar \
-Djdbc.drivers = com.mysql.jdbc.Driver \
uk.ac.starlink.topcat.Driver

Orculo
java-classpath topcat-full.jar: ojdbc14.jar \
-Djdbc.drivers = oracle.jdbc.driver.OracleDriver \
uk.ac.starlink.topcat.Driver

SQLServercomjTDS
java-classpath topcat-full.jar: jtds-1.1.jar \
-Djdbc.drivers = net.sourceforge.jtds.jdbc.Driver \
uk.ac.starlink.topcat.Driver

10.4Dicasparatabelasgrandes
UmesforoconsiderveltemidoparatornarTOPCATcapazdelidarcomgrandesconjuntosdedados.Emparticular,noemgeral,temque
lerarquivosinteirosnamemria,afimdefazeroseutrabalho,porissonoestrestritoaousodearquivosqueseencaixamem'memriaheap
"damquinavirtualjavaouparaamemriafsicadamquina.Comoregrageral,oprogramavaifuncionaremvelocidaderazovel,commesas
atcercade110milhesdelinhas,dependendodamquinaqueestsendoexecutado.Onmerodecolunasmenosdeumproblema,
emboravejaabaixosobreodesempenho.
Noentanto,amaneiracomovocchamaroprogramaafetaoquobemelepodelidarcomgrandesmesasvocpode,emalgumas
circunstncias,receboumamensagemqueTOPCATficousemmemria(umpopupouuma"OutOfMemoryError"relatriosucintosobreo
console),ehalgumascoisasquevocpodefazersobreisso:
http://127.0.0.1:2525/doc/sun253/sun253.html

37/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

AumentaramemriaheapdoJava
QuandoumprogramaJavaexecutado,eletemumaquantidademximadememriafixaqueeleirusarJavarealmentenofazusode
memriavirtual.Omximopadrotipicamente64Mb,noentanto,quedependedesuaconfiguraojava.Vocpodeaumentarisso
usandoo-Xmxbandeira,seguidopelamemriamximaacumuladaporexemplo",topcat-Xmx256m"ou"java-Xmx256m-jar
topcat-full.jar".Noseesqueado"M"paraindicarmegabytes.Emgeral,razovelaumentarestevaloratquaseaquantidadede
memriafsicalivreemsuamquina,sevocprecisa(tendoemcontaasnecessidadesdeoutrosprocessosemexecuoaomesmo
tempo),masatentativamaisgeralmenteirresultaremdesempenhoabismal.VejaSeo10.2.2.
UsearquivosFITS
Porcausadamaneiraqueseencaixaarquivossoorganizados,TOPCATcapazdecarregarastabelasquesoarmazenadoscomo
descompactadoFITStabelasbinriosnodiscoquasequeinstantaneamente,independentementedoseutamanho(nocasode
carregamentoapenaslosmetadados,equaisquerelementosdedadosssolidosseequandoelessonecessrios).Entosevoctem
umgrandearquivoarmazenadoemformaVOTableoubaseadosemASCIIquevocusacomfreqnciaelevamuitotempopara
carregar,umaboaidiaparaconvertloemformatoFITSumavezparaposteriorutilizao.Vocpodefazerissocarregandoana
TOPCATumavezesalvlocomoFITS,ouusandoopacotedelinhadecomandoseparadaSTILTS.Notesequeavariante"encaixa
plus",queTOPCATusaporpadromantmtodososmetadadosqueseroarmazenadosemumVOTablecorrespondente,entovoc
normalmentenoirperderinformaes,fazendoisso(verSeo4.1.2.1).Almdeacelerarascoisas,ousodearquivosFITStambm
irreduziranecessidadedeutilizar-Xmxbandeirascomoacima.
Executaremmodode64bits
Sevocestivertrabalhandocomumarquivoouarquivoscujotamanhototalseaproximaouultrapassacercade2Gbyte,vocdeveusar
umaversodojavade64bits.Issosignificaquevocvaiprecisardeumsistemaoperacionalde64bits,etambmumaversoda
mquinavirtualJavade64bits.Execuode"java-version"(ou"topcat-verso")provavelmentediralgosobre64bitnessse
de64bits.
Useoarmazenamentoorientadaacoluna
Pararealmentegrandesmesasdearmazenlosnacolfitsformatodesadapodemelhorarsignificativamenteodesempenho.Este
armazenatodososelementosdeumanicacolunacontguanodisco,oquesignificaqueaexploraopormeiodetodososvaloresem
umoupoucoscolunaspodeprosseguircommuitomenosdesnecessriodeE/Semrelaoaosnormais(orientadaalinha)ENCAIXA
formato.Elevaifazermaisdiferenaquandoatabelamaiordoqueaquantidadedememriafsicadisponvel,eatabelatemmuitas
colunas.Estejaciente,porm,queasoperaesquerequeremtodasasclulasemtodasaslinhas(porexemplo,calcularestatsticaslinha
)podeserumpoucomaislentousandoesteformato.
Tambmpossvelusaroarmazenamentoorientadasparaacolunaparanofitsespecificandooflag-Dstartable.storage = lado.
Issocomousarodiscodebandeira,masusaarquivostemporriosorientadaalinhaemvezdeorientadaacoluna.Noentanto,uslo
parataisarquivosgrandessignificaqueaconversoprovvelquesejabastantelento,assimvocpodesermelhorforadeconvertero
arquivooriginalparacolfitsformatoemumaetapaseparadaeusandoisso.
Useosinalizadordisco
AformacomoosdadoslojasTOPCATtabelaconfigurvel,eosdetalhespodemsercontroladas,definindosuapolticade
armazenamento.Apolticadearmazenamentopadro(desdeaverso3.5),"adaptvel",significaqueosdadosrelativamente
pequenasmesassoarmazenadosnamemriae,paraosmaioresemarquivostemporriosemdisco.Issogeralmentefuncionamuitobem
evocnoprovvelquevocprecisaparamudarisso.Noentanto,vocpodeexperimentarsequiser,eumapequenaquantidadede
memriapodesersalvosevocincentivloparaarmazenartodososdadosdatabelanodisco,especificandoodiscobandeiranalinha
decomando.Vocpodeconseguiromesmoefeito,adicionandoalinhastartable.storage = disconos. starjava.properties
emseudiretriohome.VejaSeo10.1,Seo10.2.3.
Tantoquantoodesempenhovai,otamanhodamemriadamquinaquevocestusandofazadiferena.Seotamanhodoconjuntodedados
quevocestlidando(esteotamanhodosHDUFITSseemformatoFITS,maspodesermaioroumenordoqueotamanhodoarquivo
paraoutrosformatos)vaicabernamemriafsicautilizadaentotudogeralserexecutadomuitorapidamente,porqueosistemaoperacional
podearmazenaremcacheosdadosnamemriasemaiordoqueamemriafsica,emseguida,osdadostmquemanteraserreleiturado
discoeamaioriadasoperaessermuitomaislento,emboraousodearmazenamentoorientadaacolunapodeajudarmuitonessecaso.

10,5Exemplos
AquiestoalgunsexemplosdeinvocaoTOPCATapartirdalinhadecomando.Emcadacaso,duasformassoapresentados:umausandoo
topcatscript,eumausandooarquivojardiretamente.Nesteltimocaso,ojavacomandoassumidocomonoseucaminho,eoprprio
arquivojar,assumiunodiretriomy / tcdir,podesernomeadotopcat.jar,topcat-full.jar,ouqualqueroutracoisa,masaformado
comandoomesmo.
Nohargumentos
topcat
java-jar topcat.jar

Mensagemdeusodesada
topcat-h
java-jar topcat.jar-h

CarregueumarquivoFITS
testcat.fits Topcat
java-jar meu / tcdir / topcat.jar testcat.fits

Carregamentodearquivosdevriosformatos
Topcat t1.fits-f ascii t2.txt t3.txt-f t4.xml votable
java-jar meu / tcdir / topcat.jar t1.fits-f ascii t2.txt t3.txt-f t4.xml votable

Useoformatodearmazenamentoemdiscoeimpulsionoumemriaheap
http://127.0.0.1:2525/doc/sun253/sun253.html

38/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas


topcat-Xmx256m-disk
java-Xmx256m-jar meu / tcdir / topcat.jar disco

Faafunespersonalizadasdisponveis
topcat-classpath meu / funcdir / funcs.jar-Djel.classes = my.ExtraFuncs t1.fits
java-classpath meu / tcdir / topcat.jar: my / funcdir / funcs.jar \
-Djel.classes = func.ExtraFuncs \
uk.ac.starlink.topcat.Driver t1.fits

FaaaconectividadedebancodedadosPostgreSQLdisponvel
topcat-classpath my/jdbcdir/pg73jdbc3.jar-Djdbc.drivers = org.postgresql.Driver
java-classpath meu / tcdir / topcat.jar: my/jdbcdir/pg73jdbc3.jar \
-Djdbc.drivers = org.postgresql.Driver uk.ac.starlink.topcat.Driver

UsarpersonalizadomanipuladoresdeE/S
topcat-classpath meu / driverdir / drivers.jar \
-Dstartable.readers = my.MyTableBuilder \
-Dstartable.writers = my.MyTableWriter \
java-classpath meu / tcdir / topcat.jar: my / driverdir / drivers.jar \
-Dstartable.readers = my.MyTableBuilder \
-Dstartable.writers = my.MyTableWriter \
uk.ac.starlink.topcat.Driver

A-dx = ydefiniespodemserevitadoscolocandoequivalentesx = ylinhasnos. starjava.propertiesemseudiretriohome.

ATOPCATdoWindows
EsteapndicedumpasseiodetodasasjanelasqueformamaaplicaoTOPCAT,explicandoaanatomiadasjanelaseasvriasferramentas,
menuseoutroscontroles.AtributoscomunsamuitasoutodasasjanelassodescritosnoApndiceA.1,easseesseguintesdescrevemcada
umadasjanelasindividualmente.
Quandooaplicativoexecutado,aajudaparaWindows(

botodabarradeferramentas)serexibidoadescrioapropriadaparaa

janelaemqueinvocado.

A.1Caractersticascomunsdejanela
EstaseodescrevealgumascaractersticasquesocomunsamuitasoutodasasjanelasutilizadasnoprogramaTOPCAT.

A.1.1Barra
Cadajanelatemumabarradeferramentasnapartesuperiorcontendovriosbotesquerepresentamasaesquepodemserchamadosapartir
dajanela.Amaioriadelescontmosseguintesbotes:
Perto
Fechaajanela.Estebotodeconveninciatemomesmoefeitodefecharajaneladequalquermaneirasuaplataformagrficapermite
normalmente.Namaioriadoscasos,fechandoajanelanoperderoestadoassociadoaele(comocampospreenchidos)sevoc
recuperarajanelamaistardeelevaiolharamesmadequandovocfechou.
Ajudar
AbreumnavegadorAjudajanela,oufazsequevisvelsejtiversidoaberto.Ajanelaexibirasinformaesdeajudarelevanteparaa
janelanaqualvocempurrouesteboto.
Botesdabarradeferramentas,muitasvezesaparecemnosmenusdamesmajanelatambmvocpodeidentificlos,porqueelestmo
mesmocone.Istoumaconveninciainvocandoaaodabarradeferramentasoudomenuteromesmoefeito.
Muitasvezes,umaaosserpossvelemcertascircunstncias,porexemplo,sealgumaslinhasnoassociadoJTableforamselecionados.Sea
aonoforpossvel(ouseja,nofariasentidoparainvoclo),entoobotonabarradeferramentasenaopodemenuseracinzentado,
indicandoqueelenopodeserinvocadonoestadoatual.

MenusA.1.2
Amaioriadasjanelastemumabarrademenunapartesuperiorcontendoumoumaismenus.Estesmenusgeralmentefornecemasaes
disponveisnabarradeferramentas(identificvel,porqueelestmosmesmoscones),epodeforneceralgumasoutrasaesmenoscomumente
exigidostambm.
Aquiestoalgunsdosmenuscomunsavriasjanelas:
MenuJanela
Quasetodasasjanelastmestemenu.Pelomenosasseguintesopesestodisponveis:
JaneladeControle
http://127.0.0.1:2525/doc/sun253/sun253.html

39/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Garantequeajaneladecontrolevisvelnatela,deiconifyingeelevla,senecessrio.Istopodesertilsevocperder"ajanela
atrsdeumaproliferaodeoutros.
Scrollable
Seescolhido,issofazcomquetodoocontedodajanelaparaserenroladoemrolagem.Geralmentenorecomendadousaresta
opo,umavezque,emgeral,asjanelassoorganizadasdemodoqueoredimensionamentodelesvairedimensionarpartes
sensveisdeles,maspodesertilseestiverusandoalgumasdasjanelasmaioresemumatelamuitopequeno.
Perto
Fechaajanela.Estebotodeconveninciatemomesmoefeitodefecharajaneladequalquermaneirasuaplataformagrfica
permitenormalmente.Namaioriadoscasos,fechandoajanelanoperderoestadoassociadoaele(comocampospreenchidos)se
vocrecuperarajanelamaistardeelevaiolharamesmadequandovocfechou.
Sada
SaiTOPCAT.Vocsersolicitadoparaconfirmarestaacoseastabelassocarregadas,umavezquepoderesultaremperdade
dados.
MenuAjuda
Quasetodasasjanelastmestemenu.Asseguintesopesestodisponveis:
Ajudar
AbreajaneladaAjuda.
AjudaparaJanela
AbreajaneladaAjudaajanelaexibirasinformaesdeajudarelevanteparaajanelaemqueomenuaparea.
Ajudanonavegador
Tentamostraraajudadoaplicativoemumnavegadorweb.Issoumpoucodependentedosistemaenogarantidoque
funcione.
Ajudanonavegador(pginasimples)
Tentamostraraajudadoaplicativoemumnavegadorwebcomoumnico(pginadecomprimento).Istopodesertilsevoc
quiserprocurarporumadeterminadapalavraouseqncianotexto.Issoumpoucodependentedosistemaenogarantidoque
funcione.
Ajudaparaajanelanonavegador
Tentamostrarapginadeajudarelevanteparaajanelaemqueomenuapareceemumnavegadordaweb.Issoumpouco
dependentedosistemaenogarantidoquefuncione.
SobreTOPCAT
Abreumapequenajanelacominformaessobreaversoeautoriadoprograma.Tambminformasobredisponibilidadede
algunscomponentesopcionais.
MenuDisplay
EstemenuestdisponvelparaamaioriadasjanelasqueexibemseusdadosusandoumaJTablecomponente.Sepresentes,quecontm
umalistadecolunasnaJTablecomtickboxesaoladodelesclicandononomedeumacolunanestemenudefineseacolunaestvisvel
najanela.

JTablesA.1.3

UmexemploJTable
Muitasdasjanelas,incluindoajaneladedados,exibirseusdadosemumcomponentevisualchamadodeumJTable.Issoexibeumagradede
valores,comttulosparacadacoluna,emumajanelaquevocpodepercorrer.EmboraJTablessousados
paraumasriedecoisasdiferentes

(porexemplo,mostrandoosprpriosdadosdatabelanajaneladedadosemostrarosmetadadosdecolunanajanelaColunas),ofatodequeo
mesmowidgetutilizadoproporcionaumaaparnciacomum.
AquiestoalgumasdascoisasquevocpodefazercomumJTable:
Vaoredor
Usandoasbarrasderolagemquepodemaparecerdireitaeabaixodatabela,vocpoderolaremtornodeleparaveraspartesqueno
soinicialmentevisveis.Vocpodepegaroscontrolesdeslizantesearrastlosaoredor,segurandoobotodomousepressionado
enquantovocmovlo,oucliquenoslider"cavado"umladoououtrodaposioatualdocontroledeslizanteparamoverumatela
cheia.EmalgumascircunstnciasassetasdocursoreasteclasPageUp/PageDownpodemoveratabelatambm.SeoJTable
pequenoosuficienteparacaberdentrodajanelaasbarrasderolagempodenoaparecer.
Movercolunas
Aoclicarnocabealho(bitttulocinzanapartesuperior)deumacolunaearrastandooparaaesquerdaoudireita,vocpodealterara
http://127.0.0.1:2525/doc/sun253/sun253.html

40/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ordemdascolunas,conformeapresentado.Emalgunscasos(naJaneladeDados)estetemefectivamenteoefeitodealteraraordemdas
colunasnatabelaemoutroscasos,elaapenascosmtica.
Redimensionarcolunas
Arrastandonalinhaentreoscabealhosdelinha,vocpodealteraralarguradascolunasnatabela.
Editarclulas
Emalgunscasos,asclulassoeditveis.Seelesso,ento,clicandoduasvezesnaclulacomearumasessodeedioparaessa
clulaepressionandoReturnirconfirmarqueaediofoifeita.
Selecionelinhas
svezes,aslinhaspodemserdestacadasvocpodeselecionarumalinha,clicandosobreelaouumasriedelinhascontguas,clicando
earrastandodesdeoprimeiroatoltimo.Paraadicionarnovaslinhasaumconjuntojselecionadosemdesmarcaroprimeirolote,
segureatecla"Control"parabaixo,enquantovocfazisso.
Classificarlinhas
Emalguns,masnotodososcasos,vocpodeverumpoucoparacimaouparabaixoemumdoscabealhosdascolunas.Istoindicaque
aslinhasdatabelaforamclassificadosdeacordocomosvaloresdacoluna.Sevocclicaremumoutrocabealhodacoluna,aslinhas
seroreclassificadosdeacordocomosvaloresdessacoluna.Clicandonovamentenamesmacolunainverteaordemdeclassificao.
EsterecursoestdisponvelapenasparadeterminadosJTablesexibidas.
EmalgunscasosemqueumJTableexibido,haverummenunabarrademenuchamadodeexibio.Issopermitequevocselecioneas
colunasquesovisveisequeestoescondidos.Clicandonomenulhedarumalistadetodasascolunasdisponveisnatabela,cadaumcom
umacaixadeseleoporelecliquenacaixaparadefinirseacolunaexibidaouno.

SelectorColunaA.1.4

SelectorColunaeditvel
VriasjanelasemTOPCATconvidloaselecionarumvalordacolunadeumadasmesascarregadas,apresentandoumacaixadeseleo
comoadafigura.ExemplosdissosooloteeJogojanelas.
Nocasomaissimples,vocpodesimplesmenteselecionarovalorapartirdalistadecolunas,clicandonasetaparabaixodireitae,em
seguida,selecionandoumdalistadropdowndecolunasqueoferecido.Notesequeapenasascolunasapropriadasserooferecidospor
exemplo,seumvalornumriconecessria,colunascomvalordecordasnoseroincludos.
Outrapossibilidadeusaraspequenassetasparaaesquerda/direitanocantodireitoparapercorrertodasascolunasconhecidos.Istopodeser
tilemparcelas,porexemplo,paraverumaseqnciadetodasasparcelasdisponveiscontraumadeterminadaabcissausandoapenasum
cliquedecadavez.
Finalmente,vocpodedigitarumaexpressoquedovalornecessrio.Issopodeseronomedeumacolunacomosevoctivesseescolhidoo
nalistadropdown,ouumaexpressocombaseemnomesdecolunas,ouatmesmoumvalorconstante.Asintaxedalinguagemdeexpresso
explicadonaSeo7Digitandoonomedacolunaemvezdeselecionar,podesermaisconvenientesealistadeselecomuitolonga.
digitandoumaexpresso,obviamente,lhedmuitomaispossibilidades.
Noteseque,dependendodasuaplataformanacaixadeseleopodenoparecerexatamentecomoafiguraacima.Noentanto,sevocpode
digitaralgo(provavelmenteclicandonele),entovocdevesercapazdeusarexpressescomodescritosacima.Algunsseletoresnoentanto,
apenasterosnomesdascolunassevocnopodeescreverumvalorparaele,voctemqueescolherumadasopesapresentadas.

JaneladeControleA.2

Ajaneladecontrole
http://127.0.0.1:2525/doc/sun253/sun253.html

41/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

AJaneladeControleajanelaprincipalapartirdoqualtodasasatividadesdaTOPCATsocontrolados.Elelistaastabelasconhecidas,
resumesuascaractersticas,epermitequevocabriroutrasjanelasparatarefasmaisespecializadas.QuandoTOPCATinicia,vocveresta
janelapodeounopodeteralgumastabelascarregadoneledeacordocomcomovocchamouoprograma.
Ajanelaconstitudaporduaspartesprincipais:alistadetabeladopaineldoladoesquerdo,eoPropriedadestabelaatualpaineldireita.
TabelascarregadasemTOPCATsomostradosnalistadetabelas,cadaumaidentificadaporumnmerodendicequenuncamudaparauma
determinadatabela,eumaetiquetaqueinicialmentedefinidoapartirdesualocalizao,maspodeseralteradaporconvenincia.
Umadastabelasnalistadestacado,oquesignificaqueatabelaatualmenteselecionadavocpodealteraraseleoclicandoemumitemna
lista.Informaessobreatabelaselecionadamostradonopaineldepropriedadesdireita.Issomostracoisascomoonmerodelinhase
colunas,aordemdeclassificaoatual,seleodelinhasubconjuntoatualeassimpordiante.Elecontmalgunscontrolesquepermitemque
vocalteraressaspropriedades.Almdisso,muitosdosbotesnabarradeferramentasserelacionamcomatabelaselecionadaatualmente.
Almdisso,humabarradeferramentasealgunsmenusnotopo,queexibemjanelaseexecutaroutrasaces,existeummonitordememria
naparteinferioresquerda,epode,dependendodaformacomoTOPCATfoiinvocada,serumpainelmarcadoSAMPnaparteinferiordo
paineldoladodireito.
AListademesa,opainelPropriedadesdatabelaatual,monitordememria,painelSAMPeaesdisponveisnabarradeferramentasemenus
daJaneladoControlesodescritasnassubseesaseguir.

ListaTabelaA.2.1
OpainelListademesadoladoesquerdodajaneladocontrolebastantesimplesquelistatodasastabelasatualmenteconhecidosTOPCAT.
Seumanovatabelaintroduzidaporcarregloapartirdajaneladecargaoucomoresultadodealgumaao,comotabeladejuno,em
seguida,seunomeenmeroaparecernalista.Atabelaselecionadanomomentodestacadaclicandononomedeumatabeladiferente(ou
usandoasteclasdeseta,sealistatemofocodoteclado)vaialteraraseleo.Aspropriedadesdatabelaselecionadasoexibidasnopainel
Propriedadesdatabelaatualparaasuadireita,eumasriedebotesdabarradeferramentaseitensdemenureferemseaele.
Sevocclicarduasvezesemumatabelanalista,oupressioneReturnenquantoeleestiverselecionado,quetabelaJaneladeDadosser
exibida.
Algumasoutrasaplicaes(TreeviewoumesmooutrainstnciadoTOPCAT)podeminteroperarcomTOPCATusandodraganddrop,e
paraestesalistadetabelaumbomlugarparaarrastar/soltartabelas.Porexemplo,vocpodearrastarumndatabeladaprincipalpainelde
TreeviewesolteonalistadatabeladeTOPCAT,evocsercapazdeusaressatabelacomosetivessesidocarregadoapartirdodisco.Voc
tambmpodecolaronomedoarquivoouaURLdeumatabelaparaalistadetabela,evaisercarregado.
svezes,quandoumatabelaestsendocarregadoumaentradacinzentooutaparecernalistacomtextocomo"mesaSAMPCarregando"ou
similar.Taisentradasnopodemserselecionados,maselespermitemquevocsabequealgoestacontecendo.

PainelA.2.2Propriedadestabelaatual
OPropriedadesdatabelaatualdopainelnoladodireitodajaneladecontrolecontmumasriedecomandosqueserelacionamcomatabela
selecionadaatualmenteesuaspropriedadesaparenteselesvoficarembrancosenenhumatabelaselecionada.Aquiestoqueositens
individuaisdizer:
Etiqueta
Onomecurtoassociadocomatabelaselecionada.EleusadonopainelListademesaetendoemvistaarotulagemjanelasparaque
vocpossaverqualatabelaquesereferem.Geralmente,inicialmentefixadodeacordocomamesaondeveio,masvocpodealterlo
digitandonocampodetexto.
Localizao
Afonteoriginaldatabelaselecionada.IstotipicamenteumnomedearquivoouURL(talvezabreviado),maspodeseroutracoisa,
dependendodeondeamesaveio.
Nome
Umnomeassociadocomatabelaselecionada.Estepodeserderivadodenomedatabelaquesetinhaumaoudealgumascordasde
nomesarmazenadosnatabelademetadados.
Linhas
Onmerodelinhasnatabelaselecionada.SeacorrentesubconjuntoRownoincluitodasaslinhas,emseguida,umaindicaode
quantossovisveisdentrodessesubconjuntoserdadotambm.
Colunas
Onmerodecolunasnatabelaselecionada.Sealgunsestoatualmenteoculto(noincludonoatualconjuntodecolunas),uma
indicaodequantossovisveis,serdadatambm.
Ordemdeclassificao
Acoluna(sehouveralgum),quedeterminaoactualpedidodelinha.Umseletormostraacoluna(sehouver)emqueaslinhasdatabela
soclassificadasaparenteepermitequevocescolhaumdiferente.Apequenasetaaoladoindicaseotipocrescenteoudecrescente.
Rowsubconjunto
OnomedoatualsubconjuntoRow.UmseletormostraonomedosubconjuntoquedeterminaquaislinhasfazempartedaMesaaparente
epermitequevocescolhaoutro."Todos"indicaquetodasaslinhasestoincludas.Sevocselecionarumnovovalorusandoeste
seletor,emseguida,outrasjanelasqueexibeminformaessensveisaosubconjuntodatabelaatualvaimudarasuasubconjuntoexibido
paraorecmselecionada.Noentanto,oinversonoacontecevocpodemudarosubconjuntovisvelnajaneladeestatsticas,por
exemplo,ouumadasjanelasdegrficoseissonoafetarovalorexibidoaqui.
Aodeativao
OselecionadodeAodeativao.Aaopodeseralteradoclicandonestebotoparaexibirajaneladeativao.
ATransmissoRowcaixadireitaumatalhoparaumaaodeativaotilcorrespondeaopoJaneladeAtivaode
http://127.0.0.1:2525/doc/sun253/sun253.html

42/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

TransmissoRowatodososouvintesouseja,significaquetodasasoutrasferramentasquefalamTOPCATusandoSAMPou
plsticoserinformadosobreaativaodelinhaaqualquermomentoissoacontece.Estacaixadeseleoseracinzentadosenenhum
protocolodemensagensadequadoestemuso(verseo9).

MemoryMonitorA.2.3

JaneladeControleMemoryMonitor
Omonitordememriaumapequenaferramentanocantoinferioresquerdodajaneladocontrolequedumaindicaodousodememriado
TOPCAT.OsnmerosindicamotamanhodapilhausadaatualmenteeomximoqueJavavaiusar(porexemplo,"64M"para64megabytes),
easduascoresmaisescuraspreenchidosapartirdaesquerdaindicamacorrentetotaleusadoproporesdeste.Nonecessrioentenderem
detalhesoqueelassignificam,masseomaisescuro(usado)corvemparapreenchertodaarea,aaplicaoirabrandare,emseguida,
sinalizarumerrodefaltadememria.VejaaSeo10.4paraalgumasdicassobreoquefazerseissoacontecer.
Sevocclicarnomonitordememria,vocirsolicitarqueaMquinaVirtualJavaexecutaumacoletadelixoemvolta,oquepodetero
efeitoderecuperarpartedamemriaemodificarousoatual.Istonorealmentetil(Javavaicoletadelixo,porvezessensveissemavisar),
masvocpodefazlosevocestiverentediado.

A.2.4PaineldeSAMP

JanelaPaineldeControledoSAMP
SeTOPCATestexecutandonomodoSAMP,opainelSAMPnaparteinferiordajaneladocontroledumavisorpidadostatusatualdas
comunicaesSAMP.ParaumadiscussosobreoqueesteosporqusdeSAMP,verSeo9.Observequesenoforexecutadonomodo
deSAMP(porexemplo,seestivernomodonoservidordeplsticoou)destepainelnoaparecer.MododeSAMPopadroem
circunstnciasnormais.
Opainelcompostopelasseguintespartesprincipais:
MensagemVer
Issomostraumarepresentaogrficadetodasasmensagensqueforamrecentementeenviadosourecebidosdeoutrosaplicativospor
TOPCAT.Tringulosesquerdadocrculocentralrepresentaasmensagensrecebidasetringulosdireitarepresentamosdesada.Um
tringulopreenchidorepresentaumamensagemqueaindaestesperadeumaresposta,eumaabertarepresentaumamensagemqueou
noestesperandoumarespostaoujrecebeuum.Cdigodecoresusadoparaindicarosucessooufracasso.Ostringulos
desaparecemdatelalogodepoisqueelesjnoestoesperadeumaresposta.
ClienteVer
UmconemostradonestepainelparacadaaplicativoatualmenteregistradoscomohubSAMP,incluindoaprpriaTOPCAT.Se
nenhumconeestdisponvelparaumaplicativoregistrado,umquadradocinzagenricousado.
Indicadordeconexo
UmconedireitapodeservisvelparaindicarounoTOPCATestregistradocomohub.
QuandoTOPCATnoestconectadoaumhubSAMP(provavelmenteporquenenhumestfuncionando),essespainisseroacinzentado.
MaisdetalhesecontroleparaasinformaesapresentadasnestepainelestodisponveisnaJanelaSAMP.

A.2.5ToolbarButtons
HumasriedebotesnabarradeferramentasdaJaneladoControleestessoaformamaisconvenientedeinvocaramaioriadasfunesdo
TOPCAT.Elesestoagrupadosdaseguinteforma:
Importaoeexportao
CargaTabela
FazapareceratabeladecargadilogoquelhepermitecarregarumatabelaemTOPCAT.Seumatabelacarregadotornasea
novatabelaatual.
Salvartabela(s)/Session
FazapareceratabelaSalvardilogoquepermitequevocescrevatabelasdevriasmaneiras.VocpodeescreveraatualMesa
aparente,ouvriastabelas,ousalvar(amaiorparte)oestadodasessoatual.
TransmissoTabela
TransmiteaatualMesaaparenteparatodososaplicativosregistradosusandooSAMPouprotocoloPLSTICO.VejaSeo9.
Vistasdetabela(verApndiceA.3)
JaneladeDados
Exibeaslinhasdatabelaecolunasemumvisualizadorderolagemparaquevocpossaverseocontedodaclula.
http://127.0.0.1:2525/doc/sun253/sun253.html

43/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ParmetrosJanela
Exibeatabela"parmetros",quesometadadosqueseaplicaatodaatabela.
ColunasJanela
Exibemetadadossobrecadacoluna,comootipodedados,asunidades,descrio,etcUCDs
SubconjuntosJanela
Exibeosactualmentedefinidossubconjuntosdelinhasepermitenovosaseremdefinidos.
EstatsticasJanela
Exibeumajanelaparacalcularquantidadesestatsticosparaosvaloresemcadacolunadatabela.
WindowsGraphics
HistogramaPlot
Exibeumajanelaparatraarhistogramas1D.
AvioPlot
Exibeumajanelaparafazervriostiposdetramaemeixoscartesianosem2D.
SkyPlot
Exibeumajanelaparafazervriostiposdetramanaesferaceleste.
CubePlot
Exibeumajanelaparafazervriostiposdetramaemeixoscartesianos3D.
SpherePlot
Exibeumajanelaparafazervriostiposdetramaem3Deixosusandocoordenadaspolaresesfricas.
Correspondnciaejuntandose(verSeo5)
ParJogoJanela
Exibeumacaixadedilogoparaassociartabelasladoaladoalocalizaraslinhasquecombinamentresi.
VriasConePesquisa
Exibeumajanelaquepermiteaumcrossmatchposicionalentreumatabelalocaleumatabelaremotaexpostaatravsdeum
serviodepesquisaVOCone.
Janelaconcatenao
Exibeumacaixadedilogoparaassociartabelasdecimaparabaixo.
Notesequecorrespondaenvolvendoumanicatabela,oumaisdeduastabelas,podeserfeitousandoasopesdajuntamenu.
Diverso
JanelaSAMP
Exibeumajanelaqueexibedetalhessobreostatusatualepermiteaconfigurao,demensagensdeSAMP(verSeo9).Note
queestebotonoestarvisvelseTOPCATestexecutandonomodoPLSTICO.
FunesDisponveis
Exibeumajanelacomtodasasfunesquepodemserusadasparaescreverexpressesalgbricas(verseo7).
Ajudar
Exibeonavegadordeajuda,abraaentradanajaneladecontrole.
Sada
Consultasparaconfirmao,emseguida,saidoaplicativo.

ItensdomenuA.2.6
Estaseodescreveasaesdisponveisnosmenusdajaneladecontroleadicionaisparaaquelestambmestdisponvelnabarrade
ferramentas(descritonaseoanterior)eaquelescomunsaoutrasjanelas(descritonoAnexoA.1.2).
Oarquivomenucontmasseguintesaesadicionais:
DuplicarTabela
AdicionaumanovacpiadaatualMesaaparenteparaalistadetabelasconhecidas.Istocomoocarregamentonatabelaatualdenovo,
anoserqueassuascaractersticasaparentestornamseascaractersticasbsicasdocopiadoum,porisso,porexemplo,qualquerque
sejaofimdalinhaatualpassaaseraordemnaturaldonovo.
Descartardemesa(s)
Removeatabelaatualdalistaefechaeesquecetodasasjanelasvistaassociados.Umatabeladescartadanopodeserreintegrado.Voc
sersolicitadoparaconfirmarestaao.Descartandoumatabela,destaformapodeliberarmemria,paraoutrasoperaes,masmuitas
vezesnoseelefazounodependedosdetalhesdeondeatabelavem.EstaaotambmpodeserdesencadeadaporbateroExcluir
teclanotecladoquandoalistadetabelatemofocodoteclado.Sevriastabelassoselecionadasaomesmotempo,vocsersolicitadoa
removertodoseles.
MovaTabelaUp
Moveatabelaselecionadaatualmenteatumslotnalistatabelas.Istopodeserconvenienteparavisualizao,etambminfluenciaa
ordememqueastabelassosalvasaofazerumatabelaouMultipleSessionsave.Estaaotambmpodeserdesencadeadaporbater
ALTsetaparacimateclanotecladoquandoalistadetabelatemofocodoteclado.
http://127.0.0.1:2525/doc/sun253/sun253.html

44/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Movertabelaparabaixo
Moveatabelaselecionadaatualmenteparabaixopelatelanalistadetabelas.Istopodeserconvenienteparavisualizao,etambm
influenciaaordememqueastabelassosalvasaofazerumatabelaouMultipleSessionsave.Estaaotambmpodeserdesencadeada
porbaterALTsetaparabaixoteclanotecladoquandoalistadetabelatemofocodoteclado.
Enviartabelapara...
EnviaatabelaselecionadanomomentoparaumaaplicaodeaudioselecionausandoSAMPouplstico.Selecioneoaplicativo
destinatriodesejadonosubmenu.
ExibirLog
AbreaJanelaLogparaexibirmensagensdeloggeradospeloaplicativo.Destinadoprincipalmenteparadepurao.
OVistomenucontmaesparaolanamentodasjanelasquedocertospontosdevistadometadadosdatabela.Estessofornecidoscomo
botesdabarradeferramentastambm.
OGrficosmenucontmaesparaolanamentodasjanelasquedovriasopesdeplotagemevisualizao.Osmaisimportantesso
fornecidoscomobotesdabarradeferramentastambm,masestemenucontmalgumasaesquenoestodisponveisemoutroslugares.
Osmarcada"(antigo)"soasjanelasdeplotagemqueestavamdisponveisantesTOPCATverso4elestmumainterfacedeusurio
diferente,sogeralmentemenospoderosos,esoumpoucoobsoleto,masaindafuncionam.Asoutrasopesdabarradeferramentasnoso
umpoucoexperimental.Ositensdisponveisapartirdestemenuenoabarradeferramentasso:
TempoPlot
ExibeajanelaPlotTempoparaplotagemdedadosdesriestemporais.Esteatualmenteexperimentalenotemalgunsrecursosteis.
HistogramaPlot(old)
Exibeajaneladehistogramadeestiloantigoparaaplotagem1dhistogramas.
Plot2D(old)
Exibeajaneladeplotagem2Ddeestiloantigoparaplotagem2Ddedispersoparcelas.
Plot3D(old)
Exibeajaneladeplotagem3Ddeestiloantigoparatraar3ddedispersoparcelasemeixoscartesianos.
SpherePlot(old)
Exibeajanelaesferadeestiloantigoparatraar3ddedispersoparcelasemeixospolaresesfricas,comousemumacoordenadaradial.
EmpilhadosPlotLine(old)
ExibeajanelaPlotLinhaStackeddeestiloantigoparatraarvriosgrficosdelinhasempilhadasverticalmentecontraumanica
coordenadaX(estafuncionalidadenoduplicadaemumadasjanelasdeestilonovo).
DensidadeMapa(old)
ExibeajanelaMapadeDensidadedeestiloantigoparaplotagem2Dmapasdedensidade(histogramasimagemsemelhanteemuma
grade2ddecaixas).
Ajuntamenucontmaesparavriostiposdetabeladejuno.Ositensfornecidosadicionalparaaquelesnabarradeferramentasso:
VriasSIA
ExibeajanelaSIAmltiplaquepermitecrossmatchcomumserviodeimagemremota.
VriasSSA
ExibeajanelaSSAmltiplaquepermitecrossmatchcomumserviodeespectroremoto.
JogoInterno
Exibeajaneladejogointernoparaencontrarcorrespondnciasinternasentreaslinhasnamesmatabela.
NTableJogo
Exibeumacaixadedilogoparacombinarmaisdeduastabelasemconjunto.
OdoWindowsmenucontmaesparacontrolarquaistabelavistajanelasestovisveisnatela.Sevoctemmuitasmesaseestousando
vriospontosdevistadiferentesdevriosdeles,onmerodejanelasnatelapodesairdamoefcilperderanoodoqueolugarondea
janela.Asaesdessemenufazeralgumacombinaodeambosescondendoourevelandoasvriasjanelasdeexibioassociadoouatabela
selecionadaoutodasasoutras.Janelasescondidassoremovidasdatela,massereativado(porexemplo,usandoobotodabarrade
ferramentasapropriado)vovoltarnomesmolugarenomesmoestado.Revelandotodasasjanelasassociadasaumadeterminadatabela
significamostrartodasasjanelasdeexibioquetenhamsidoabertosantes(elenoirexibirjanelasquenuncaforamexplicitamenteabertos).
MostrarSelecionadoapenasvisualizaes
Revelartodasasjanelasdeexibioassociadocomatabelaselecionadaeescondertodososoutros.
VisualizaesMostrarselecionados
Revelartodasasjanelasvista,queestoassociadoscomatabelaselecionadanomomento.
MostrarTodosVisualizaes
Revelartodasasjanelasdeexibioassociadocomtodasastabelas.
EscondernoselecionadosVisualizaes
Escondertodasasjanelasdeexibioassociadocomoutrosdoqueoqueestselecionadotabelas.
EsconderVisualizaesselecionados
Escondertodasasjanelasdeexibioassociadocomatabelaselecionadanomomento.
OcultartodososVisualizaes
Ocultartodasasjanelasdeexibio.Sevocficarmuitoconfuso,estaumaboaparaselecionarparalimparasuatelaantesde
restabelecerosquevocrealmentequerseolhar.

http://127.0.0.1:2525/doc/sun253/sun253.html

45/208

21/4/2014

Notequeajaneladecontroleitem(

TOPCAT - Ferramenta para operaes em catlogos e tabelas

)emmenusemtodasasoutrasjanelastambmtilparaogerenciamentodejanelasquetrazde

voltaajaneladecontroleseelefoiescondido.
OVOgruposdemenusemconjuntoasaesqueacessamfontesdedadosremotas.Todasessasopestambmpodemserencontradastanto
najaneladecargabarradeferramentasouajuntamenu.
AInteropmenucontmopesrelevantesparaainteroperabilidadedeferramentas(SAMPouplstico).Essesitensestodisponveisem
outroslugaresnabarradeferramentasoudoArquivomenu.

A.3TableViewdoWindows
MuitasdasjanelasquevocverdentrodeinformaesdeexibioTOPCATsobreumanicatabela.Existemvriosdestes,cadaum
exibindoumaspectodiferentedosdadosdatabelaocontedodasclulas,estatsticas,etccolunametadadosExisteumadecadatipopara
cadaumadastabelascarregados,emboranonecessariamentetodosserexibidadeumavez.Abarradettulodessasjanelasvaidizeralgo
comoTOPCAT(3):colunasdeumatabela,oqueindicaqueeleestexibindoinformaessobreosmetadadosdacolunaparaatabela
denominada"3:"najaneladecontrole.
Paraabrirqualquerumadessasjanelas,selecioneatabeladejurosnaJaneladeControleecliquenobotodabarradeferramentasadequada
(ouoitemequivalentenatabelaVisualizaesmenu).Issotambmirabrirumanovajanela,dotipoquevocrequisitou,ousevocabrila
antes,vaitercertezaquevisvel.
Sevoctemmuitasmesaseestousandovriospontosdevistadiferentesdevriosdeles,onmerodejanelasnatelapodesairdamoe
fcilperderanoodoqueolugarondeajanela.NestecasodaJaneladoControledoWindowsmenu(descritonoAnexoA.2.6)oua
janela|janeladecontroleitemdemenuemqualquerumadasjanelasdeexibiopodesertilparamantlossobcontrole.
Asseesaseguirdescrevemcadaumadessasjanelastabelavista,porsuavez.

JanelaDadosA.3.1

JaneladeDados
AjaneladedadosapresentaumaJTablequecontmasclulasreaisdaTabelaaparente.Vocpodeexibilousandoosdadosdatabela(
boto)quandoatabelaescolhidoestselecionadonajaneladecontroleListaTable's.
Vocpoderolaraoredordamesadamaneirausual.Namaioriadoscasos,vocpodeeditarasclulas,clicandoduasvezesneles,embora
algumasclulas(porexemplo,aquelesquecontmmatrizesemvezdeescalares)atualmentenopodesereditado.Seeleseparececomuma
ediotevelugar,eletem.
ExisteumacolunadecinzadenmerosesquerdadaJTablequedondicedelinhadecadalinha.Esteovalordacolunadendice
especial,queosnmerosdecadalinhada(noaparente)tabelaoriginalapartirde1.Seatabelafoiordenadaestesnmerospodemnoestar
emordem.
Notesequeareordenaodascolunasarrastandoosseusttulosemtornoiralteraraordemdascolunasnatabelaconjuntodecolunase,
portanto,aTabelaaparente.
Sevoctemmesacommuitascolunas,podeserdifcilderolaratelaparaoslados,paraqueacolunaquevocestinteressadoemvista.
Nestecaso,vocpodeirparaajanelaColunasecliquenadescriodacolunaquevocestdepoisnaexposiol.Istoteroefeitode
rolagemdajaneladedadosparaoslados,paraqueasuacolunaselecionadavisvelnocentrodatelaaqui.
http://127.0.0.1:2525/doc/sun253/sun253.html

46/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Osseguintesbotesestodisponveisnabarradeferramentas:
Subconjuntodelinhasselecionadas
DefineumnovosubconjuntoRowconstitudoporessaslinhasqueatualmenteestoemdestaque.Vocpodedestacarumgrupo
contguodelinhasarrastandoomousesobreelesoutrosgruposcontguospodemseradicionados,mantendoateclaControlenquanto
arrasta.Estaaosestdisponvelquandoalgumaslinhasforamselecionados.
Subconjuntodelinhasnoseleccionadas
DefineumnovosubconjuntoRowconstitudoporessaslinhasquesovisveis,masdemomentonorealado.Vocpodedestacarum
grupocontguodelinhasarrastandoomousesobreelesoutrosgruposcontguospodemseradicionados,mantendoateclaControl
enquantoarrasta.Estaaosestdisponvelquandoalgumaslinhasforamselecionados.
OSubconjuntosdemenutambmcontmoseguinteitem:
Destaquesubconjunto
Esteumsubmenunoqualtodosossubconjuntosdelinhaactualmentedefinidossolistados.Seleccionarumdelesmarcaaslinhas
correspondentesaessesubconjuntocomosetivessemsidoseleccionados.
Assimcomoomenunormal,botodireitodomousesobreumadascolunasnatabelaexibidaapresentarummenupopupColuna,que
forneceumamaneiraconvenientedefazeralgumascoisascomacolunaemquesto:
SubstituirColuna
ApareceumdilogoColunasintticaparasubstituirestacolunacomumanovasntese.Odilogoinicializadocomomesmonome,
unidadesetccomoacolunaselecionada,ecomumaexpressoqueavaliaoseuvalor.Vocpodealterarqualquerumdesses,eanova
colunairsubstituiroantigo,queserescondidoerenomeadoacrescentandoseumsufixocomo"_old"aoseunome.
Novacolunasinttica
AbreumdilogoColunasintticoparainserirumanovacolunasintticologoapseste.
Classificarse
Classificaaslinhasdatabeladeacordocomovalorcrescentedocontedodacoluna.Apenasdisponvelsealgumtipodeordem(por
exemplo,numricooualfanumrico)podesensatamenteseraplicadocoluna.
Classificarparabaixo
Classificaaslinhasdatabeladeacordocomovalordocontedodacolunadescendente.Apenasdisponvelsealgumtipodeordem(por
exemplo,numricooualfanumrico)podesensatamenteseraplicadocoluna.
Esconder
Ocultaacoluna.ElepodeserrestabelecidoapartirdajanelaColunas.
PesquisaColuna
Paracolunascomvalordecadeia,estaopopermitequevocprocureporvaloresemumacoluna.Sevocselecionlo,vocser
solicitadoadigitarumaexpressoregular,e,emseguida,qualquerlinhaquecorrespondeexpressonestacolunaserselecionado
(realado).Sehapenasumacolunacorrespondenteserativadotambm.Aexpressoobedecenormaldeexpressoregularsintaxe,por
isso,porexemplo,vocdigitar". * XYZ. *"paraencontrartodasaslinhasquecontmacadeiadecaracteres"XYZ".
ExplodeMatrizColuna
Paracolunasquetmumvalordearraycomumnmerofixodeelementos,selecionarestaopoiresconderacolunaoriginale
substituloporumconjuntodecolunasescalares,umaparacadaumdosseuselementos.Porexemplo,seumacolunaPMAGcontm
umvetorde5elementosdotipoflutuador []representandomagnitudesem5bandasdiferentes,estaopoiresconderPMAGe
inserir5novasFloatcolunasdotipoPMAG_1...PMAG_5emseulugar,cadaumcontendoumdasmagnitudes.

A.3.2ParmetrosJanela

http://127.0.0.1:2525/doc/sun253/sun253.html

47/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ParmetrosJanela
AJanelaParmetrosexibemetadadosqueseaplicaatodaatabela(emvezdeque,paracadacoluna).Vocpodeexibilousandoos
parmetrosdeumatabela( boto)quandoatabelaescolhidoestselecionadonajaneladecontroleListaTable's.
Nalinguagemdetabela/bancodedados,umitemdemetadadosportabelamuitasvezesconhecidocomoum"parmetro"databela.Pelo
menos,onmerodelinhasecolunasserolistados.Algunsformatosdearquivodatabela(porexemploVOTableeFITS)tmdisposiopara
armazenaroutrosparmetrosdatabela,enquantooutros(porexemploCSV)no.Nesteltimocaso,nopodemuitobemdeinteresseexibida
nestajanela.
ApartesuperiordatelaumaJTablecomumalinhaparacadaparmetro.Indicaonomedoparmetro,oseuvalor,otipodeitemque
(integer,string,etc)eoutrositensdeinteresse,comounidades,dimensionalidadeouUCDseelessodefinidos.Seumacolunadatabelano
tementradas(porexemplo,acolunaUnidadespodeestarvaziaporquenenhumdosparmetrosteveunidadesdefinidasporele),entoessa
colunapodemestarausentesdaexposionestecaso,aexibiodomenupodeserusadorevella.
Vocpodeeditaralgunsvaloresdeparmetrosedescries,clicandoduasvezessobreeles,comodecostume.
Aparteinferiordateladumavisoampliadadeumparmetroselecionado(cliqueemumalinhanapartesuperiorparaselecionarum).Isto
especialmentetilseovalordoparmetromuitolongoparamostrarplenamentenodisplaydemesa.Namaioriadoscasos,vocpodeeditar
oscamposaquiparaalterarovaloreoutrascaractersticasdeumparmetro.
Osseguintesitensestodisponveisnabarradeferramentas:
Adicionarparmetro
Abreumanovajaneladeparmetroparapermitirquevocadicionarumnovoparmetroparaamesa.
RemoverParmetro
SeumoumaisdosparmetrosexibidosnaJTablenestajanelaforamselecionadosclicandosobreosregistrosrelevantes,emseguida,
clicandonestebotoirremovlos.Algunsparmetros,comoaContagemdelinhanopodeserremovido.

ColunasA.3.3Janela

http://127.0.0.1:2525/doc/sun253/sun253.html

48/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ColunasJanela
AJanelaColunasexibeumaJTabledandotodasasinformaes(metadados)conhecidosobrecadacolunanatabela.Vocpodeexibilo
usandoacolunaInformaes( boto)quandoatabelaescolhidoestselecionadonajaneladecontroleListaTable's.
Ovisorpodedemorarumpoucodetempoparaseacostumar,jquecadacolunanatabeladedadosprincipalrepresentadoporumalinhana
JTableexibidosaqui.AordemeaslargurasdascolunasdaferramentaJTablepodeseralteradadamesmaformaqueparaoindicadordeDados
JTable,masestenotemefeitosobreosdados.
Acolunamaisesquerda,identificadocomo"visvel",contmumacaixadeseleoemcadalinha(umparacadacolunadatabeladedados).
Inicialmente,estessotodosassinalada.Aoclicarsobreascaixas,vocpodealternarentreelesmarcadaedesmarcada.Quandodesmarcada,a
colunaemquestoficaroculta.Alinhaaindapodeservistonestajanela,masacolunadedadoscorrespondentenomaisumaparteda
Tabelaaparente,porissonovaiservistonajaneladedadosouapareceremversesexportadosdatabela.Vocpodemarcarvriascolunas/
Tireaquideumasvez,destacandoumconjuntodelinhas,arrastandoomousesobreelese,emseguida,usandooOcultarSelecionado(
)ouRevelarSelecionado(

)botesdabarradeferramentasouitensdemenu.Sevocquiseresconderourevelartodasascolunasna

tabela,useoOcultartodosos(

)ouRevealAll(

)botes.

CadacolunadaJTableexibidacorrespondeaumpedaodeinformaoparacadaumadascolunasnatabeladedadosnomedacoluna,
descrio,etcUCDtabelasdediferentestipos(porexemplo,aqueleslidosdediferentesformatosdeentrada)podeterdiferentescategoriasde
metadados.Porpadro,umacategoriademetadadosexibidonesteJTablesepelomenosumacolunadatabelatemumvalordiferentede
espaoembrancoparaquecategoriademetadados,assim,porexemplo,sehcolunasdatabelapossuemumUCDdefinido,entoacoluna
UCDnoaparecer.PodemserfeitasCategoriasdeapareceredesaparecernoentanto,usandoaexibiodomenu.Ositensdemetadadosso
asseguintes:
Visvel
IndicaseacolunapartedaMesaaparente.Seestacaixanoestiverpreenchido,emseguida,paraamaioriadosfinsacolunaser
escondidodatela.Vocpodealternaravisibilidade,clicandosobreestacoluna.
Nome
Onomedacoluna.
$ID
UmvalordoIDnicoeimutvelparacadacoluna.Estessoteisnadefiniodeexpressesalgbricas(verSeo7),umavezqueso
garantidosexclusivoparacadacoluna.Emboraonomedacolunapodeserutilizado,bemcomo,onomenopodesernicoenopode
teraformacorretaparaousoemumaexpressoalgbrica.
Classe
AclasseJavadositensnacoluna.VocnotemquesabermuitoJavaparaentenderesteselessofloatoudoubleparanmerosde
pontoflutuanteByte,Short,IntegerouLongparanmerosinteiros,Booleanparaum(falsetrue/)flaglgico,ouStringparaumastring
deASCIIouUnicodecaracteres.Existemoutraspossibilidades,masestesdevemincluiramaiorparte.Oscaracteres'[]',apsonomede
classeindicaquecadacluladacolunacontmumamatrizdotipoindicado.
Forma
Asclulasdeumatabelapodecontermatrizes,bemcomoescalares.Seacolunacontiverumamatriztipo,istoindicaqueaformaque
deveserinterpretadocomo.Eledasdimenses,afimdecolunamajor.Oltimoelementopodeserum"*",paraindicarqueotamanho
damatrizpodeservarivel.Paracolunasescalares,esteitemficarembranco.
Unidades
Asunidadesemqueasquantidadesdestacolunasoexpressos.
Expresso
Aexpressoalgbricaquedefineosvaloresnestacoluna.Issosserpreenchidoseacolunaemquestoumacolunasintticoque
vocadicionou,aoinvsdeumpresentenosdadosemsuaformaoriginalcarregado.
Descrio
Umadescriotextualdafunodestacoluna.
UCD
AUCDassociadoaestacoluna,seforespecificado.UCDssodescritoresdecontedouniforme,eindicarasemnticadosvalores
destacoluna.
http://127.0.0.1:2525/doc/sun253/sun253.html

49/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

UCDDescrio
SeaseqncianacolunaUCDoidentificadordeumUCDconhecido,adescriopadroassociadoaesseUCDmostradoaqui.
Podehaveroutrositensnalistaespecficosparaatabelaemquesto.
VocpodeeditarosnomesdascolunasealgumasoutrasentradasnesteJTableclicandoduasvezessobreeles,comodecostume.
AordememqueaslinhassoapresentadosdeterminadopelacorrentedatabelaConjuntodecoluna.Vocpodealteraraposiodeuma
colunanaordemarrastandoaclulanmerocinzanaparteesquerdadalinhacorrespondenteparacimaouparabaixonotequeesteapenas
possvelparacolunasatualmentevisveis(aquelescomacaixadeseleoVisvelassinalada).Outraformademudaressaordemarrastaros
cabealhosdascolunasparaaesquerdaouparaadireitanajaneladedados.
Osseguintesbotesestodisponveisnabarradeferramentas:
Novacolunasinttica
IstoabreumajanelaColunasintticoquepermitequevocdefinaumanovacolunaemtermosdasjexistentes,escrevendouma
expressoalgbrica.Anovacolunaseradicionadaporpadroapsaltimacolunaselecionada,ounofinal,senenhumforselecionado.
AdicionarSkyCoordenarColunas
IstoabreumajanelaSkyCoordenadasquelhepermitedefinirumpardenovocucoordenarcolunasbaseadoemumparexistentede
cucoordenarcolunas.
SubstituirColunaComsinttico
Seumanicacolunaselecionado,emseguida,clicarnestebotoiraparecerumdilogoColunasintticaparasubstituiracoluna
selecionadaporumnovosinttico.Odilogoinicializadocomomesmonome,unidadesetccomoacolunaselecionada,ecomuma
expressoqueavaliaoseuvalor.Vocpodealterarqualquerumdesses,eanovacolunairsubstituiroantigo,queserescondidoe
renomeadoacrescentandoseumsufixocomo"_old"aoseunome.
Coluna(s)OcultarSelecionado
Sequalquerumadascolunassoselecionadas,emseguida,clicandonestebotoirescondlos,ouseja,retirlosdoatualconjuntode
colunas.IstotemomesmoefeitoqueanulandotodasascaixascorrespondentesaessascolunasnoVisvelcoluna.
Coluna(s)selecionadoRevelar
Sequalquerumadascolunassoselecionadas,emseguida,clicarnestebotoircertificarsequeelessovisveis,isto,queeles
aparecemnoatualconjuntodecolunas.Issotemomesmoefeitoqueselecionartodasascaixasdeseleocorrespondentesaessas
colunasnaVisvelcoluna.
OcultarTodasasColunas
Aoclicarnestebotoirescondertodasascolunasdatabelaamesanotercolunasvisveisneleseguindoeste.Sevocquerapenas
veralgumascolunas,podeserconvenienteusarestebotoe,emseguida,selecionarunspoucosvisveisindividualmentearevelar.
RevelarTodasasColunas
Aoclicarnestebotoirgarantirquetodasascolunasdatabelasovisveis(nenhumdelesestescondido).
ExplodeMatrizColuna
Seumacolunaforselecionada,quetemumtipodematriz,aoclicarnesteboto,irsubstitulocomascolunasdevalorescalarcontendo
cadaumdosseuselementos.Porexemplo,seumacolunaPMAGcontmumvetorde5elementosdotipoflutuador []representando
magnitudesemcincobandasdiferentes,emseguida,selecionandooebaterestebotoiresconderPMAGeinserir5novasFloat
colunasdotipoPMAG_1...PMAG_5emseulugarcontendocadaumadasgrandezas.
Ordenarselecionados
Seumanicacolunaselecionado,emseguida,atabelaatualordemdeclassificaoserdefinidaparaclassificarascendentenessa
coluna.Casocontrrio,essaaonoestdisponvel.
Ordenarselecionadoparabaixo
Seumanicacolunaselecionado,emseguida,atabelaatualordemdeclassificaoserdefinidaparaclassificardescendentenessa
coluna.Casocontrrio,essaaonoestdisponvel.
Vriasdessasaesoperamcomacolunaoucolunasatualmenteselecionado.Vocpodeselecionarascolunasclicandonalinha
correspondentenaJTableexibidocomodecostume.Umefeitocolateraldeselecionarumanicacolunaqueaexibiodetabelanajanelade
dadosvaiserroladaparaolado,demodoqueacolunaselecionadavisvelem(aproximadamente)nomeiodatela.Estapodeserumabeno,
sevocestlidandocomumatabelaquecontmumgrandenmerodecolunas.

A.3.4SubconjuntosJanela

http://127.0.0.1:2525/doc/sun253/sun253.html

50/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

SubconjuntosJanela
AJanelaSubconjuntosexibeossubconjuntosdelinhaqueforamdefinidos.Vocpodeexibilousandoossubconjuntosdelinha(

boto)

quandoatabelaescolhidoestselecionadonajaneladecontroleListaTable's.
OssubconjuntossoexibidosemumaJTablewidgetcomumalinhaparacadasubconjunto.AscolunasdaJTablesocomosesegue:
_ID
Umidentificadorexclusivoeinaltervelparaosubconjunto,oqualconsistedeumcarcter"_"(sublinhado)seguidoporumnmero
inteiro.Istopodeserusadoparasereferiraeleemexpressesparacolunassintticosououtrossubconjuntos.
Nota:emversesanterioresdoTOPCATocardinal("#"),emvezdeosublinhadoparaestefimosinaldehashnotemmaisesse
significado.
Nome
Umnomeusadoparaidentificarosubconjunto.ideal,masnonecessariamente,nico.Elepodesereditado(cliqueduasvezesna
clula)paramudaronome.
Tamanho
Onmerodelinhasnestesubconjunto.Estacolunanormalmentepreenchidoquandoosubconjuntodefinido,masnogarantido
parapermanecercorreto,seamudanadedadosdatabela,umavezqueacontagempodeserumprocessocaroporissonofeito
automaticamenteacadamudana.Seosvaloresnestacolunaestoembrancooususpeitaincorreta,umarecontagempodeserforado
usandoossubconjuntosContagem( boto)descritosabaixo.
Frao
MostraamesmainformaoqueoanteriorTamanhodacoluna,mas,comoumapercentagemdonmerototaldelinhasdatabela.
Expresso
Seosubconjuntofoidefinidoporumaexpressoalgbrica,issovaiestaraqui.Elepodesereditado(cliqueduasvezesnaclula)para
alteraraexpresso.
Coluna$ID
Seosubconjuntofoidefinidopelaequivalnciacomumacolunacomvalordeboolean,issovaimostraro$IDdacolunaqueeleveio
(verApndiceA.3.3).
EntradasnosNomeeExpressocolunaspodemsereditadosclicandoduasvezessobreelesdeumaformanormal.
Osseguintesbotesdabarradeferramentasestodisponveisnestajanela:
Novasubconjunto
AbreaJanelasubconjuntoalgbricoparapermitirquevocdefinaumnovosubconjuntoalgebricamente.
AdicionarAmostraSubconjunto
AbreumajaneladedilogoparapermitirquevocdefinaumnovosubconjuntoconsistindodetodososN'thlinhadatabela.
AdicionarCabeasubconjunto
AbreumajaneladedilogoparapermitirquevocdefinaumnovosubconjuntoconsistedosprimeirosNlinhasdatabela.
AdicionarCaudasubconjunto
AbreumajaneladedilogoparapermitirquevocdefinaumnovosubconjuntoconsistindonosltimosNlinhasdatabela.
Removersubconjunto
Excluiumdossubconjuntosdalista.Umavezexcludo,umsubconjuntonopodeserrecuperado.Notesequeastentativasdeusaro
seunomeou_IDemexpressesalgbricasquevocadicionaroumodificarnofuturoirfalhar,emboraseuusoemexpresses
existentescontinuaroatrabalhar.
Invertersubconjunto
Criaumnovosubconjuntoqueocomplementodoselecionado.Onovovaiincluirtodasaslinhasquesoexcludospeloselecionado(e
viceversa).Parausarestaao,primeiroselecioneumsubconjuntoclicandoemsualinhanaJTable.
ParaColuna
SeumadaslinhasnaJTableselecionado,issovaisetransformaressesubconjuntoemumanovacoluna.VaiaparecerajanelaColuna
sinttico,preenchidoadequadamenteparaadicionarumanovacolunabooleanaparaatabelacombasenosubconjuntoselecionado.
Vocpodeaceitlocomo,oumodificaralgunsdoscampos.Parausarestaao,primeiroselecioneumsubconjuntoclicandoemsua
linhanaJTable.
http://127.0.0.1:2525/doc/sun253/sun253.html

51/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Destaquesubconjunto
Destaquesdocontedodestesubconjunto,marcandoaslinhasvisivelmentenajaneladedadosetambmgarantirqueaslinhasso
visveisemtodasasjanelasdoenredo.Estareplicaoqueacontecequandoosubconjuntocriadoprimeiro.
Contarlinhas
Contaquantaslinhasestoemcadasubconjuntoeexibeestanotamanhodacoluna.Issoforaumacontagemourecontagemde
preencherouatualizaressesvalores.
Transmissosubconjunto
FazcomqueosubconjuntoselecionadoparasertransmitidousandoSAMPouplsticoparaoutrasaplicaesdeescuta.Qualqueroutra
aplicaoouvirqueestexibindoamesmatabelaentoconvidadopararealaraseleodelinhascorresondingaosubconjunto
selecionado.EstaopoeocorrespondenteEnviarsubconjuntopara...opotambmestodisponveisapartirdaInteropmenu.
VejaSeo9paraobtermaisinformaessobreainteroperabilidadedeferramentas.
Osseguintesitensdemenuestodisponveis:
Enviarsubconjuntopara...
Quantotransmissosubconjuntoitemacima,masenviaosubconjuntodeapenasumnicoaplicativoselecionado.Umsubmenuvai
darumalistadetodososaplicativosatualmenteregistrados,quepodedarsentidoaumsubconjunto.Senohouvernenhum,esteitem
serdesativado.
LinhasAutoCount
Normalmente,otamanhoeFracocolunasdatabelaapresentada(veracima)soenchidasnaslogoqueumnovosubconjunto
definido.Noentanto,paratabelasmuitograndesissopodeserlentasevocquiserevitarissoautocountingvocpodedesmarcaresse
itemdemenu.Nestecaso,ascolunasdetamanhoeFraosserpreenchidoquandooconde( boto)atingidaouseTOPCAT
descobreotamanhocomooresultadodealgumaoutraoperao(comoplotagem).

A.3.5EstatsticasJanela

EstatsticasJanela
Ajaneladeestatsticasmostraasestatsticasparaosvaloresemcadaumadascolunasdatabela.VocpodeexibilousandoasEstatsticasde
Coluna(
boto)quandoatabelaescolhidoestselecionadonajaneladecontroleListaTable's.
OsvalorescalculadossoapresentadosnumaJTablewidgetcomumalinhaparacadacolunanatabelaprincipal,eumacolunaparacadaumde
umnmerodequantidadesestatsticoscalculadosemalgunsoutodososvaloresnacolunadatabeladedadosquecorrespondelinhade
grade.Asseguintescolunassoexibidasporpadro:
Nome
Onomedacolunanatabelaprincipalrepresentadoporestalinhadegrade.
Significar
Ovalormdiodasclulasboas.Paracolunasbooleanas,estaaproporodeclulasboasquesoverdadeiras.
SD
Odesviopadrodapopulaodasclulasboas.
Mnimo
Ovalormnimo.Paracolunasnumricasosignificadodestebastantebvio.Paraoutrascolunas,seumaordenaopodeser
razoavelmentedefinidosobreeles,ovalor'menor'podesermostrado.Porexemplovaloresdeseqnciamostraraentradaqueseriao
primeiroemordemalfabtica.
Mximo
Comomnimo,masmostraosmaioresvalores.
Ngood
Onmerodeclulasnobranco.
Vriositensadicionaisdeinformaoestatsticatambmsocalculados,masascolunasqueexibemestessoocultasporpadroparaevitara
http://127.0.0.1:2525/doc/sun253/sun253.html

52/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

desordem.Vocpoderevelarestesusandoaexibiodomenu:
ndice
Ondicedacolunanatabela,isto,aordemnaqualexibido.
$ID
Aetiquetadeidentificaonicoparaacolunadatabelaprincipal.
Soma
Asomadetodososvaloresnacoluna.Paracolunasbooleanosestaumacontagemdonmerodevaloresverdadeirosnacoluna.
Variao
Avarinciadapopulaodasclulasboas.
AmostraSD
Odesviopadrodaamostradasclulasboas.
Amostradevarincia
Avarinciadaamostradasclulasboas.
DesvioAbsolutoMediana
Amdiadosdesviosabsolutosdamediana:mdia (abs (x-mediana (x)).Istoumamedidarobustadedispersoestatstica.
EscaladoDesvioMedianaAbsoluta
ODesvioMedianaAbsoluta(vejaacima),multiplicadopor1,4826.Istosupostoserumestimadorconsistenteparaodesviopadro,
nahiptesedeumadistribuionormal.
Enviesado
Gammaumamedidadeassimetriadadistribuiodevalor.
Kurtosis
Gamma2medidadeachatamentodadistribuiodevalor.
Filademin
Ondicedalinhanatabelaprincipalemqueovalormximoocorreu.
Filademax
Ondicedalinhanatabelaprincipalemqueovalormximoocorreu.
NBAD
Onmerodeclulasembrancoasomadestevaloreboarelaoclulasseramesmaparacadacoluna.
Cardinality
Seacolunacontmumpequenonmerodevaloresdistintos,entoessenmero,dacolunacardinalidadeirsermostradoaqui.
Cardinalidadeonmerodevaloresdistintosqueaparecemnessacoluna.Seonmerodevaloresrepresentadosgrande(actualmente>
50)ouumagrandeproporodosvaloresnomaus(actualmente>75%),emseguida,nenhumvalormostrado.
Almdisso,algunsquantisvalorespodemcalculadosobdemanda(selecionandoseusvaloresnaexibiodomenu,comoparaalistaanterior).
Osvaloresdisponveisso:
Q001:
valorabaixodoqual0,1%delinhascaem
Q01:
valorabaixodoqual1%delinhascair(1percentil)
Quartile1:
valorabaixodoqual25%daslinhascair(primeiroquartil)
Mediana:
valorabaixodoqualos50%delinhasdecair(mediana)
Quartile3:
valorabaixodoqual75%daslinhascair(terceiroquartil)
Q99:
valorabaixodoqual99%daslinhascair(percentil99)
Q999:
valorabaixodoqual99,9%daslinhascair
Estessoconsideravelmentemaiscaroparaoclculodoqueasoutrasquantidadesdeestatstica,eassimelesnosofornecidosporpadro.Se
voctentarcalcullosparagrandestabelas,vocpodereceberumamensagemdizendoquenohmemriasuficiente.
AsquantidadesapresentadasnestajanelanosonecessariamenteaquelesdetodaatabelasoaquelesparaumdeterminadosubconjuntoRow
.Naparteinferiordajanelaosubconjuntoparaclculosselector,quepermitequevocescolhaqualsubconjuntoquiserqueosclculosa
seremfeitos.Aoclicarnestevocpodecalcularasestatsticasdediferentessubconjuntos.Quandoajanelaabertapelaprimeiravez,ou
quandoelechamadoapartirdeummenuoubarradeferramentasnajaneladecontrole,osubconjuntocorresponderaosubconjuntolinha
atual.
Abarradeferramentascontmosseguintesbotesextras:
SalvarcomoTabela
Aoclicarnestebotoirsalvarasquantidadesexibidasnestajanelaparaumatabelanodisco.Elepodesersalvoemqualquerumdos
formatostabularesqueTOPCATentende.
ImportarcomoTabela
Atabeladequantidadesestatsticosapresentadosporestajanela(linhascorrespondentesparacolunasdatabeladeentradaecolunas
correspondentesaquantidadesestatsticos)porsisumamesa.Aoclicarnesteboto,podesercarregadoemTOPCATcomouma
novatabelaemanipuladodetodasasmaneirashabituais.Issotemomesmoefeitoquesalvarasestatsticasparaoarquivo(verboto
anterior)e,emseguida,recarregaroarquivo.
Recalcular
Umavezqueasestatsticasforamcalculadasparaumdeterminadosubconjuntoelessoarmazenadosemcachee,normalmente,no
http://127.0.0.1:2525/doc/sun253/sun253.html

53/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

recalculadonovamente.Useestebotosevocquiserforarumnovoclculo,poisosdadospodemtermudado.
Paraumagrandemesaosclculospodemdemorarumpouco.Enquantoestoaserrealizadapodeinteragircomajanelacomonormal,mas
umabarradeprogressomostradonaparteinferiordajanela.Sevociniciarumnovoclculo(pressionandoobotorecalcularouselecionar
umnovosubconjunto)oufecharajaneladuranteumclculo,oclculosubstitudoserinterrompido.

A.4PlotdoWindows
EstaseodescreveasjanelasdeplotagemintroduzidasnoTOPCATverso4.Estesfornecemamaiorpartedamesmafuncionalidadeque
asjanelasdoenredodeestiloantigo,mastambmmuitomaisflexibilidade,configurabilidade,extensibilidadeemelhordesempenhoe
capacidadedefazersentidovisualdegrandesconjuntosdedados.
TOPCATtemumcertonmerodejanelaspararealizaravisualizaodedadosdevriostipos.Estespartilhamvriascaractersticasqueso
descritasnaprimeirasubsecoabaixoasprpriasjanelasespecficasestodescritosnassubsecesseguintes.
Seisjanelasenredoestodisponveisnomomento(umexperimental):
HistogramaPlot
AvioPlot
SkyPlot
CubePlot
SpherePlot
TempoPlot(experimental)
Maispodemserintroduzidosemversesfuturas.
Orestantedestaseodescreveasfunesdeplotagememdetalhe.

DiferenasA.4.1doantigoestilodeplotagemdoWindows
Umbreveresumodemelhoriasessasjanelasoferecemnosdeestiloantigojanelasdatramaaseguinte:
NewSkyCoordenarPlot
Escolhadeprojeo:Sin(rotativo),Aitoff,placaCarre
Opessoequatorial,galctico,supergalactic,eclptica:Cudedadosesistemasdevisoselecionadosseparadamentecoordenar
CoordenarSkygraderotulados,configurvelevisvelemtodososzooms
Novasopesdeplotagemdedados
Vetores
Reticncias(comngulodeposio)
Pontolinkspardedados
Contours
Marcadoresdetamanhovarivel
Respostainterativamelhorada
Vriasaesdarodadomouseearrastepanezoomatramainstantaneamente
Em3dparcelasbotodireitodomouserecentrescubonopontoselecionado
Em3dparcelaszoomdadosampliaocuboemvezdeampliaroprpriocubowireframe
Muitoscontrolessocontrolesdeslizantesqueatualizamoenredoquevocdeslize
Melhorsuporteparagrandesconjuntosdedados
Vriascaractersticasforamintroduzidasparafornecerumavisualizaomaissignificativadegrandesconjuntosdedados.Melhoria
tramasecontornosdedensidadesemelhantedarlhemelhoresmaneirasdeentenderparcelascontendomuitosmaispontosdoqueh
pixelsparaplotarlos.Hseparadamentealgumasmelhoriasnaescalabilidade:normalmentevocpodeobterumdesempenhorazovel
interativaatcercade10milhesdepontosdeacordocomamemriadisponvel,etc,equevocestfazendo(emborahajarelatosde
quetrabalhamcomvrios108 pontos).Aintenomelhoraresselimiteaindamaisnofuturo.
Novosmodosdeenredodesombreamento
Densidadecdigodecoresparatodosostiposdegrficos,commapadecoresabsolutooumodificardatasetcorbase.Oresultadoalgo
queseparececomumgrficodedispersoembaixasdensidadeseumenredodensidadeparaaltasdensidades,egeralmentesignifica
quevocpodefacilmentefazersentidoquantitativodasregiessuperpovoadasdeumgrficodedisperso.Codificaoplano,
transparenteeauxcoraindaestdisponvelcomoantes.
Rotulagemeixomelhorado
Aescolhadotamanhodafonteeestilo
OpodeentradadoLaTeXparacaracteresnoASCII,etc
Entrareixosrotuladomelhor
OpocarrapatoMinor
http://127.0.0.1:2525/doc/sun253/sun253.html

54/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Plotagemfunoanalticaem2D
FunesenredodeXouYcoordenarutilizandolinguagemdeexpressoalgbrica.
Configurabilidade
Muitasmaisopesdeconfigurao,incluindoacolocaolenda,exibiodegradeecor,suavizao,limitesapinhamentortulode
texto,etcetc
Asnovasjanelaspermitemquevocmontarumapilhadecamadasquerepresentamdiferentestiposdegrficosdediferentesconjuntosde
dadossobreosmesmoseixos.Ainterfacedeusurioparacontrolaresteumpoucodiferentedoqueparaasjanelasdatramamodaantiga,e
descritonasseesseguintes.Noentanto,fazendoumatramasimplesaindasimples:selecionarumatabela,selecioneascolunas,evocest
fora.
Algumascaractersticasdasparcelasdeestiloantigoquesonoatualmente(v4.1)disponvelnasparcelasnovoestiloso:
oenredolinhaempilhada
verdadeirosmapasdedensidadeRGB(emboraosmodosdesombreamentodensidademuitasvezesvaifazercomobomouumemprego
melhor)
nebulizaoemparcelas3D
correlaolinear
ttulosdeenredo
histogramadeexportaocomoumatabela
Aintenoapresentaralgunsdostudoissoemumafuturaverso,possivelmenteinformadopordemandadousurio.

A.4.2JanelaViso

JanelaPlot
Janelasdolotecompostodeduaspartesprincipais:opainelPlotcontendoosgrficosreaisplotados(porpadro,napartesuperior),eoPainel
http://127.0.0.1:2525/doc/sun253/sun253.html

55/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

decontrole(porpadro,naparteinferior).Opaineldecontroleondevocconfiguraoquesertraada.Paraumenredosimplesdedisperso
podeserapenasumcasodeselecionarquaisascolunasaconspirarcontraooutro,maselepodeficarbastantedetalhado.Sevocquisermais
espaonatelaparajogar,elepodesertilparaflutuaropaineldecontroleemumajanelaseparadausandooscontrolesdeFloat( botoda
barradeferramentas)vocpodeencontrarestebototantonoprincipaleasbarrasdeferramentasdopaineldecontrole.Paraunfloatpainelde
controle,ousimplesmentefecharajaneladopaineldecontrole,oucliquenovamentenobotodabarradeferramentasControlesdeflutuar.
Comcontrolesflutuantes,ajanelaseparececomafiguraaseguir.

JanelaTerrenocompaineldecontroleflutuou
Opaineldecontroleemsitemduaspartesprincipais:umapilhadecontroleesquerdaquecontmcontrolesatualmenteativos
(representadospornomesecones),eumpaineldedetalhesdireita,quemostrainformaessobreocontroleselecionadonomomento.
Cliqueemumadasentradasdecontroledoladoesquerdoparaverosdetalhesdireita.Controlesdiferentestmdiferentespainisdedetalhe,
mas,emgeral,cadaumvaitervriasabasparaconfigurarcoisasdiferentes.Vocpodeselecionarestesclicandonosnomesdeguia.Umaboa
maneiradeaprendersobreasopesclicarsobreosdiferentescontroleseseusguiasparaveroqueestdisponveleexperimentarcomas
vriasopesparaveroqueacontececomoenredo,mastodosospainiseabastambmsoexplicadasnestemanual.Opaineldecontrole
tambmtemumabarradeferramentasnotopo,usadoparaadicionareremovercontrolesdapilha.
Alistadecontroletemdoistiposdeentrada:
Controlesfixos:
Estescontrolamaaparnciageralenredo.Nafiguraacima,oscontrolesfixosMachados(

)eLegend(

)sovisveis.

OsdiferentescontrolesfixosestodescritosnoAnexoA.4.3.
Controlesdecamada:
Estesdeterminamosdadosreaisqueseroplotadosequalaformagrficaprecisocadacontrolecontribuicomumaoumaiscamadas
paraoenredo.Paraadicionarumcontroledecamada,useabarradeferramentaslogoacimacadabotocomumpoucodeverde"+"
adicionaumcontroledotipocorrespondente.Pararemoverumcontroledecamada,selecioneoeuseoRemoveacamadaatual(
boto)nabarradeferramentas.VoctambmpodeusaroCamadasdemenunotopodajanelaprincipalparaadicionareremover
camadas.
AcaixadeseleoaoladodecadacontroledeterminaseeleestativonomomentoSenadaforfeito,todasasinstruesdeplotagem
contmserignorado.Vocpodeconfigurlosativosouinativos,clicandonascaixasdeseleco.
Voctambmpodearrastarcadacontroleparacimaouparabaixo,arrastandocomapega( ).Camadasmaisabaixonalistaso
plotadosmaistarde(talvezmaiscedoobscurecendoum),assimvocpodearrastlosparacimaeparabaixoatquevoctenhaas
camadasquevocquernapartesuperior.
OsdiferentescontrolesdecamadaestodescritosnoAnexoA.4.4.
Nopdajanela,htambmquatrooutrospainispequenos:
http://127.0.0.1:2525/doc/sun253/sun253.html

56/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

PosiodoPainel
Quandoocursorposicionadosobreoprprioenredo,esterelataasuaposioemcoordenadasdedados.Emalgunscasos,taiscomo
3dtramas,istopodenoserpossvel,casoemquebranco.
ContagemPainel
Exibeonmerodepontosplotadoseatualmenteonmerototaldepontosrepresentadospelatrama.Ototal(asegundafigura)o
nmerodeposiesemtodososconjuntosdedadosplotados,eonmeroatual(aprimeirafigura)excluiaquelesemsubconjuntosno
atualmenteplotadoseosqueestoforadoslimitesdatramavisvel.
AjudaNavegao
Mostraalgunslembretesparaquediferentesgestosdomousefazer.Pequenosconessosupostorepresentarclicandoearrastando
diferentesbotesdomouseearodadomouse.Observeasalteraesdecontedodeacordocomondeomouseestsobreoenredo,
desdequeafetaocomportamentodenavegao.ParamaisinformaesconsulteoApndiceA.4.2.1.Clicandono botofarcomque
estepaineldeirembora.
ProgressBar
Sealgolentoestacontecendovocpodeverumabarradeprogressonaparteinferiordatelaenquantovocespera.Amenosquevoc
esttramandovriosmilhesdepontos,vocnopodeverissoemtudo.Paracargasdedadoslentos,estesempreserexibida.Poraes
comorealmentedesenharogrficoevirandoumabolhaemumaseleosubconjuntovocpodeescolherseoprogressomostrado
usandooMostrarPlotProgress( boto)nabarradeferramentas.bomsaberquealgoestacontecendo,maspodeseruma
distraoexibindooprogressotambmretardaoenredoumpoucoparabaixo.
Abarradeferramentasprincipal,napartesuperiordajanelacontmasseguintesaes(repetidonomenus):
FloatControles
ColocaoPaineldecontroleemumajanelaflutuante,emvezdenaparteinferiordajaneladoenredo,comodescritoacima.Umavez
flutuante,opaineldecontrolepodemserunidasdevoltaparaajanelaprincipal,clicandonovamenteesteboto.
DesenhesubconjuntoRegio
PermitequevocdesenheumaregionateladefinindoumnovosubconjuntoRow.Quandovocterminardedesenhlo,clique
novamentenestebotoparaindicarquevocestfeito.VejaApndiceA.4.2.3paramaisdetalhes.
Subconjuntodevisvel
DefineumnovosubconjuntoRowconsistindoapenasospontosqueestoatualmentedisponveisnasuperfciedatrama.Veja
ApndiceA.4.2.3paramaisexplicaes.
Replot
Redesenhaoenredoatual.Normalmentenonecessriousaresteboto,umavezquesevocalterarqualquerumadascaractersticas
datramacomoscontrolesnestajanelaoenredovaiserredesenhadoautomaticamente.Noentanto,sevoctiveralteradoosdados,por
exemplo,aoeditarasclulasdaJaneladeDados,ouredefinindoumsubconjunto,oenredonoautomaticamenteredesenhado.Ao
clicarnestebotoredesenhaoenredotendoemcontatodasasalteraesaosdadosdatabela.
Redimensionar
Redimensionaoseixosdoplanoatualparaqueelecontmtodosospontosdedadosemsubconjuntosselecionadosnomomento.Por
padro,oenredoserinicialmenteescaladocomoesse,maselepodetermudadoporcausademudanasnaseleosubconjuntooude
zoominouout.
BloquearMachados
Normalmente,quandoosdadosrepresentadosmudousignificativamente,oseixossoautomaticamenteredimensionadosdemodoque
todosospontossovisveis.Oaplicativofazumaestimativasobrequandoumaboaidiafazerissoredimensionamentoautomtico.Se
vocnoquerqueeleautorescale,definaestebotodealternncia,enovairedimensionaramenosqueelerealmentetemque.Istono
estdisponvelparaoCuPlot.
EsbooFrames
Seselecionadoprovocaintermedirios"esboo"framesaserdesenhadoquandosenavegaemtornodegrandesparcelas.Paragrficos
quelevammuitotempo(pelomenosumafracononegligenciveldeumsegundo)paradesenhar,seessaopoforselecionada,em
seguida,aonavegaremtornodelevaipintarquadrosintermedirioscombaseemumasubamostradosdados,emvezdepintartodaa
tramaemcadapasso.Issopoderesultaremumaaparnciaumtantotrmula,masissosignificaqueasatualizaesdequadrosacontecem
commaisfreqncia,porissoumpoucomaisgil.
MostrarProgressoLote
Seselecionouumabarradeprogressonaparteinferiordajanelaestativaquandograndes(Lento)parcelasestoemandamento.Isto
podesertilsevocestivernavegandoemvoltadeumterrenomuitograndeparaquevocpossaveralgumacoisaestacontecendoem
vezdaaplicaoaparentementesimplesmentenofazernada.Poroutrolado,umabarradeprogressovacilantepodeserumadistrao.
Atualizandoabarradeprogressotambmpoderetardaroenredoumpouco.
ExportaoPlot
PermitesalvaratramaemumavariedadedeformatosgrficosusandooPlotExportaojanela.
Assubseesaseguirexplicaralgumasoutrascaractersticascomunsatodasasjanelasdeplotagem.
A.4.2.1Navegao
Todasasjanelasdoenredosointerativos,evocpodenavegarporelesusandoosbotesdomouse.Paraamaioriadostiposdegrficosos
botesdireitoeesquerdoearodadomousefazeralgumacoisaem3dparcelasobotodomeiousadotambm.
Osdetalhesdasaesqueratofazeroquedependerdequaljaneladeplotagemquevocestusando,eelestambmpodemserconfigurados
emcertamedida,usandooNavigationguianoMachadoscontrolefixonapilhadecontrole.Noentanto,comoregra,asaesquandousado
sobreocorpodoenredosoestes:
Arrasteparaaesquerda
http://127.0.0.1:2525/doc/sun253/sun253.html

57/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Arrastaoenredoemtorno.Semprequepossvel,amesmaposioenredopermanecesobocursorenquantovocarrasta.Em2deste
garimpaoenredoparaaesquerda/direita/cima/baixo,eem3dgiralo.
Arrasteparaadireita
Estiquezoom.Arrastarparacima/baixo/polpastrechosdoenredonavertical,earrastandoparaaesquerda/direitatrechos/polpaslo
horizontalmente.Ozoomcentradanaposioondevoccomeaaarrastarapartir,demodoqueaposiodedadospermaneceno
mesmolugarnatela.Em3D,ozoomaolongodasduasdireesdatramamaisalinhadoscomoplanodatela.
Rodadomouse
Girandoarodadomouseparafrente/trsozoomin/out.Em2D,ozoomemtornodaposioatualdomouse,eem3d
(geralmente)emtornodocentrodavisodocubo.
Cliqueesquerdo
Identificaumponto.Sehouverumpontotraadopertodocursor,eleirtraarummarcadorsobreeleeactivarele.Sevocclicaremum
poucovaziodatrama,qualquerpontoativadoexistenteserremovido,casocontrrio,nadavaiacontecer.
Nostiposdegrficos2D,possveldeslocarouzoomemapenasumadireo,usandoasmesmasaesforadoprprioenredo.Sevocfizer
umaaopan/zoomesquerdadoeixoY,seropan/zoomapenasnavertical,esevocfazloabaixodoeixoX,elevaifazloapenasna
horizontal.
Amaioriadessasaesdarlhealgumfeedbackvisualnatela,mostrandoumretngulooualgumasflechasparalhedarumaidiadoquevoc
estfazendo.Sevocacharqueumadistrao,vocpodedesliglousandooPlot|MostrarNavegaoGrficos( itemdemenu).

Paineldeajudadenavegaonaparteinferiordajaneladeplotagem
Emcadajaneladeplotagemhumalinhanaparteinferiordajanelaqueddicassobreasaesdenavegaodisponveisatualmente.Os
pequenosconessocadasupostorepresentarumclique( )ouumarrasto( )comumdostrsbotespressionados,ouumarotaoda
roda( ),esoseguidosporumabrevedescriodoqueelevaiconseguir.Observeessasdicasmudardeacordocomondeomouseest
posicionadonatela.Movendoobotosobreestepainelvailhedaralgumaajudacomaajuda.Clicandono botofarcomquealinhade
desaparecer,evocpodetrazlodevoltacomaJanela|MostrarNavegaoAjuda(
itemdemenu).O botoirabrirumajanela
especficadeajudanavegaonestajanela.
Sevocestiverusandoummousecommenosdetrsbotesounoroda,osseguintesgestossubsitutegeralmentepodeserusado:
Botoesquerdo
Sevoctiverapenasumboto,isso.
Botodireitodomouse
Sevoctiverapenasumboto,vocpodeuslocomateclaCTRL.
Botodomeio
Sevoctiverapenasumboto,vocpodeuslocomateclaSHIFT.Sevoctiverdoisbotes,porvezes,pressionandoosambosao
mesmotempovaifuncionar.
Roda
Muitasvezes,umaaoderodapodemsersimuladasemumtrackpadmovendodoisdedosjuntosparacimaouparabaixo.
ControlescamadaA.4.2.2dadosdatabela
Amaioria,masnotodos,dosdisponveiscontrolesdecamadaestopreocupadoscomplotagemdedadosdetabela,dealgumaformaoude
outra.Emgeral,estespermitemquevocconfigureumaformadegerarumacamadadetrama(algunsgrficosgerados)dealgumascolunas
selecionadasdeumadeterminadatabelacomumestiloescolhido.
Noentanto,sevoctivermaisdeumsubconjuntoRowparaumadeterminadatabela,umnicocontrolepodeserusadoparagerarvrias
camadas,umaparacadasubconjunto.Namaioriadoscasos,fazsentidoparaterosgrficosgeradospelosdiferentessubconjuntosconfigurado
deformasemelhante,masaindavisualmentedistinguveis.
Estescontrolesdecamadamesageralmentetmtrsguias:Posio,subconjuntoseformulrio.OguiaPosioparaespecificaras
coordenadas,edependedotipoespecficodatramaedocontroledacamada.Ossubconjuntoseformulriodecontrolequesubconjuntosde
linhasoplotadosecomoelessoexibidos,eumadescriodecomoelessoorganizadossegueabaixo.

GuiaSubconjuntosdeumcontroledecamadadedadosdatabela
OSubconjuntosguialistaossubconjuntosdelinhadefinidosparaatabelaquevocselecionounaposiodetabulao.OsubconjuntoTudo
estsemprepresenteoutrospodemounopodemser,dependendoseelesjdefinido.Notesequeaesquevoctomanatrama(por
exemplo,aseleodeumnovosubconjuntoporregio)poderesultaremnovasentradassendoadicionadoaestalista.
http://127.0.0.1:2525/doc/sun253/sun253.html

58/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Alistadosnomesdeixadosossubconjuntoscomumacaixadeseleodeativaoeumapegaopaineldadireitadodetalheparao
subconjuntoselecionado.Selecioneumsubconjuntodever/alterarosseusdetalhesclicandosobreela.
Paracadasubconjuntovocpodeselecionar:
Seplotado(usandoacaixadeseleodeativao)
Aseqnciadeplotagem(arrastandooparacimaeparabaixo,usandoasuapega)
Acorplotagempadro
Aetiquetacomoqualanotadanalegenda(sevisvel)
Seeleaparecenalegendaemtudo
EmboravocpodeselecionarcoresdeplotagemnoFormulriodeguia,bemcomo,geralmentemelhorfazloaqui,poisissomudaacorde
todasasformastraadasparaumdeterminadosubconjunto,aoinvsdeumaformadecadavez.

ConfiguraoestilonoseparadorFormadeumcontroledecamadadedadosdatabela
OFormulriodeguiapermitequevocselecioneasinformaesdeestiloparadeterminarosdetalhesdecomoatramavaiolharparacada
camada.Osdetalhesdiferemmuitoentreostiposdecontroledecamada,maselesgeralmentecontmdoissubpainisparadefinirosdetalhes
deestilo,estiloglobaleEstilosdesubconjunto:
Estiloglobal
Controlaosdetalhesdeestiloparaaformaescolhida,porformaetamanhodomarcadorinstncia.Opesaquiafetamtodosos
subgrupos,emboraporpadroacorretiradodoSubconjuntosguia.Sevocquiserdefiniracoramesmaparatodosossubconjuntos,
desmarqueapelosubconjuntocaixaqueirativaracorselector.
Estilosdesubconjunto
Sevocquerterdiferentessubconjuntosrepresentadoscomdiferentesestilos,porexemploformasdiferentesparadiferentessubgrupos,
vocpodeselecionarumsubconjuntoaquiealterardetalhesdeestiloparaapenasessesubconjunto,substituindoasconfiguraesglobais
acima.
A.4.2.3DefinioSubconjuntosporRegio
AsjanelasdatramapodeserusadoparafazernovasseleesRowsubconjunto.
Sevocrodou,zoom,definiroseixosmanualmenteounonavegouoenredodeformaqueapenasospontosatualmentedisponveisnatrama
soosquevocestinteressado,vocpodeclicarnoNewsubconjuntodevisvel( boto)barradeferramentas.Istodefineum
subconjuntocompostoportodosospontosquesovisveisnoloteatual.Istostilseogrupoestiverinteressadoemcorrespondeauma
regioretangularnoespaodeplotagem.
UmamaneiramaisflexveldesenharumaoumaisregiesnogrficoqueidentificamospontosquevocestinteressadopolegadasParafazer
isso,bateuosorteiosubconjuntoRegio( botodabarradeferramentas).Tendofeitoisso,vocpodearrastaromousesobreoenredo
(mantenhaobotoesquerdodomousepressionadoenquantovocsemove)paracercarospontosquevocestinteressadopolegadasAo
fazlo,umamanchacinzatranslcidoserdeixadoparatrsnadadentrodoblobvaiacabarnosubconjunto.possveldesenharumaou
muitasbolhas,quepodemsersobrepostosouno.Sevoccometerumerroaodesenharumaseqnciadebolhas,vocpodeclicaroboto
direitodomouse,eoblobadicionadomaisrecentementedesaparecer.Quandovocestnestemododedesenhoderegio,vocnopode
ampliarouredimensionarajanelaoualterarascaractersticasdatrama,eosubconjuntoRegioSorteiobotoaparececomumamarcasobre
ele( )paralembrloquevocestnele.Aquiestoqueoenredoseparecequandovocestdesenhando:

http://127.0.0.1:2525/doc/sun253/sun253.html

59/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ModoRegioDesenho
Quandoestiversatisfeitocomaregioquevocdefiniu,cliqueno

botodabarradeferramentasnovamente.

Emambososcasos,quandovocindicouquepretendedefinirumnovosubconjuntolinha,umacaixadedilogoiraparecerparapedirlheo
seunome.ConformedescritonaSeo3.1.1,umaboaidiausarumnomequeapenascompostadeletras,nmerosesublinhados.
Opcionalmente,possvelselecionarumnomedesubconjuntoquetenhasidousadoantesdalista,queirsubstituirosantigoscontedodesse
subconjunto.QuandovocdigitaumnomeeaperteoOKboto,onovosubconjuntosercriadoeospontosemqueseromostradas
imediatamentenogrficousandoumnovosmbolo.Comodecostume,vocpodedefinirseospontosnestesubconjuntosoexibidosusandoo
Subconjuntosguianocontroledacamadademesa.
A.4.2.4LotejanelaExport

http://127.0.0.1:2525/doc/sun253/sun253.html

60/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Janeladeexportaodolote
OloteJanelaExportaopodeseralcanadocomoenredoExportarparaarquivo(

botodabarradeferramentas)emqualqueruma

dasjanelasdatrama.
Vocpodeselecionarumarquivodamaneirausual,esalvaratramaemumdosseguintesformatosgrficos:
png
PNGbitmap.
gif
GIFbitmapanoteonmerodecoreslimitadoa256.
jpeg
JPEGbitmapnotequeesteumformatocomperdas,maisadequadoparafotografiasdeparcelas,eascoresvoficarembaada.
pdf
PortableDocumentFormatnamaioriadoscasos,esteformatovetorialdmuitobomdesada,emespecial,otextoserprocessado
corretamente.
eps
PostScriptencapsuladoPostScriptnopodelidarcomatransparncia,oquesignificaque,emalgunscasos,apotnciairsairerrado.
ArquivosPostScripttambmpodesermuitograndesehouvermuitospontosdedados.
epsgzip
Assimcomoeps,masasadacompactadoantesdasada.
Hdoiscontrolesadicionaisnoladodireitodajanela:
Formatodearquivo
Selecionaoformatodesadacomoacima.Aconfiguraopadro(auto),queadivinhaoformatoquevocdesejausaronomedo
arquivo,equenormalmentefazacoisacerta.
ForaBitmap
Estaopostemefeitoparaosformatosgrficosvetoriais(PDFePostScript).Seforselecionado,eledesenhaocontedodatramade
dadoscomoummapadepixelseincorporaquenoarquivodesada,emvezdeplotarcadapontonasada.Istopodefazerasadamenos
bonito(marcadoresredondosjnoserperfeitamenteredonda),maspoderesultaremumarquivomuitomenorsehouvermuitospontos
dedados.Anotaesdeplotagem,comortulosdoeixonoseroafetadoselesaindasodesenhadoscomotextovetor.Noteseque,
emalgunscasos(porexemplo,ousodosautomveisoudedensidadedemodosdesombreamento),estetipodepixellisationvai
aconteceremqualquercaso.
Exportandoparaosformatosbaseadosempixels(GIF,JPEG,PNG)bastantesimples:cadapixelnatelaaparececomoumpixelnoarquivo
desada.PNGgeralmenterecomendado.GIFfuncionabemnamaioriadoscasos,massehouvermaisde255coresumpoucodaresoluo
decorserperdido.JPEGpodepreservarumaamplagamadecores,masnosuportaatransparnciaelossy,topertoinspeode
caractersticasdaimagemirrevelarborrar.
AoexportarparaPortableDocumentFormat(PDF)ouEncapsulatedPostScript(EPS),quesoformatosgrficosvetoriais,halgumascoisasa
considerar:
Posicionalquantizao
Algunsdosmodosdesombreamento(Densidade,Auto)soinerentementepixellatedeoutros(planas,Aux)noso.Noprimeiro
caso,vocvaiverlimitesdepixelparaospontostraadosemvezdeagradveis
bordasarredondadasemgrandesampliaes(emborao

textoeoseixosserosemprebemtraado).Emambososcasos,nomomentoaposioresoluoamesmaqueserianatela,porisso,
sevoctemumaaltaparcelade400pixelsporexemplo,existemapenas400coordenapossvelYnoqualummarcadorpodesertraada,
queporsuageralnobvio,olhandoparaatramadesada.Emversesfuturasresoluoposicionaldemodosnopixelizadaspodeser
melhorado.Emambososcasos,oaumentodotamanhodatramanatela,redimensionandoajanelaantesderealizarumaexportaopara
PDFouEPSirreduziroefeitodaquantizaoposicional.Observequetambmteroefeitodetornarosrtulosdetexto
proporcionalmentemenorparaosgrficos,entovocpodequereraumentarotamanhodafontetambm.
Transparncia
http://127.0.0.1:2525/doc/sun253/sun253.html

61/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

PorrazestcnicasmarcadorestransparentesnopodemserfacilmenteprocessadoquandoumloteexportadoparaPostScript.Em
algunscasos,oenredofeitousandoumbitmapnasadaPostScriptparapermitirtransparnciae,emalgunscasos,ospontossoapenas
plotadosopaco.PDFfazumpoucomelhor,masacomposiodeformastransparentessvezesumpoucodiferentenatelaeentreguea
umPDF.umaboaidiaparaverificarasadadasexportaesdetela,olhandoparaoarquivoproduzidosequenoseparececom
eledevefazer,adefiniodaForaBitmapopoprovavelmenteircertificarsequeelefaz,masissotambmvaipixellateossmbolos
traados.Nohmaisdiscussosobreestepontonassubseesparaosvriosmodosdesombreamento.
Tamanho
Emalgunscasos(2Degrficosdedispersoem3Dcommuitosmilharesdepontosoumais)arquivosEPSdesadapodeficar
extremamentegrandeotamanhoproporcionalaonmerodepontosdesenhado,actualmente,comumfactordealgumascentenasde
bytesporponto.Emalgunscasos,vocpodetrabalharemvoltadestetraandoalgunspontoscomotransparente,demodoqueoenredo
renderizadocomoumbitmap(vejaadiscussodetransparnciaacima),quedimensionacomoonmerodepixels,emvezdeonmero
depontos.OformatoGzippedEPSajudaumpouco(emborapossaserlenta)SadaPDFmelhorainda.MesmoosarquivosPDF
podemserunmanageablygrandeparamuitospontosnoentanto.

A.4.3controlesfixos

Controlesfixosnapilhadopaineldecontrole
Controlesfixossooscontrolesqueaparecemnotopodapilhanopaineldecontrole,enotemumacaixadeseleoouumaaladearrasto.
Elessousados
paraconfiguraraaparnciageraldatrama,independentedequalquercamadaenredoparticularouconjuntodedados.Aqueles

comunsatodosostiposdegrficossodescritasnassubseesaseguir,apesardealgunstiposdegrficostambmpodeteroseuprprio.
A.4.3.1Machados
OEixosdecontrole(

)temumnmerodeguiasespecficosparaotipodegrficoespecfico.Essasguiaspermitemquevocconfigureas

coisascomoasfaixasdeeixo,escaladoeixolinear/log,rotulagemeixo,desenhodegrade,detalhesdoscontrolesdenavegaoeassimpor
diante.Osdiferentestiposdegrficostmcontrolesdeeixoquediferemsignificativamenteentresioscontrolesdeeixoespecficosso
descritosemseparado,juntamentecomcadatipodegrfico.
A.4.3.2Legenda
ALendadecontrole(

)semprevisvelnoPaineldeControledoenredo.Elepermitequevocconfigureseecomoalegendadogrfico

aparece.
Essecontroletemduasguias.

GuiaEstilocontroleLegenda
Oestilodeguiaconfiguraaaparnciadopaineldelegenda,etemasopesfolowing:
Mostrarlegenda
Sealegendaaparecenatrama.Issodefinidoautomaticamente:seapenasumconjuntodedadosestpresentenenhumalegenda
mostrada,masumavezquevriosconjuntosdedadosestopresentesnalegendavisvel.Masaopopodesersubstitudo
manualmenteusandoessecontrole.
Opaco
Seforverdade,alendatemumfundobrancoopaco.Seforfalso,transparente,etodososdadosdatramaporbaixovisvel.
Fronteira
Seforverdade,umabordadelinhapretaexibidaemtornodalenda.Seforfalso,nohnenhumafronteira.

http://127.0.0.1:2525/doc/sun253/sun253.html

62/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaLocalcontroleLegenda
ALocalizaoguiaconfiguraondenoenredodalendadesenhada(sehouver).Existemduasopes,externoeinterno.SeInterno
escolhido,emseguida,umcontroleativadomostrandoumapequenacaixadentrodeumagrandecaixa.Arrasteapequenacaixacomomouse
paramudaraposiodalegendadentrodoslimitesdolote.
NoteseafonteusadanalegendaactualmentecontroladapelafontedoMachadosselector.
A.4.3.3AuxAxis
OAuxEixodecontrole(

)svisvelquandoomododecorAuxfoiselecionadoparaumadascamadasdedadossenenhumacamada

estusandoAuxsombreamento,ocontrolenoaparecernapilha.Elecontrolaumaescaladecornicaparaospontosquesocoloridaspor
valordedadospararepresentarumadimensoadicionalnosdados.
Quandopresente,essecontroletemtrsseguintesguias.

GuiaMapadecontroledoeixoAux
OMapaguiacontrolaacormapaeixoaux.Eletemasseguintesopes:
Shader
Selecioneomapadecoresapartirdeumalistadeopes.
SombraClipe
Selecioneumsubrangedomapaemcoresacima.Porpadrotodoomapadecoresusado,massevocquiseragamadecoresna
tramaaserformadoapartirdeapenasumapartedafaixadecormostraaShadercontrole,vocpodemoverasalasapartirdofinal
desteslider.
SombraLog
Seaescalaauxdevemapearlinearmenteoulogaritmicamenteparaomapadecores.
SombraVirar
Seaescalaauxdevemapearfrenteouparatrsnomapadecores.
NullCor
Quecordeveserusadapararepresentarpontoscomumvalornuloparacoordenarosdadosaux.SeoassociadoEsconderopofor
selecionada,emseguida,essespontosnoaparecernatramaemtudo.

EixoAuxcontrolarguiaRamp
Arampaguiacontrolaaexibioeanotaodarampadecoresqueexibeomapadecoressobreoenredo.Eletemasseguintesopes:
MostrarEscala
Searampaescalaauxvisvelseassimumarampadecordevidamenterotuladosaparecedireitadatrama.OassociadoAutoopo
fazcomqueessadecisoautomaticamente:sehouverdadosauxplotado,aescalaserexibido,casocontrrio,elenovai.Desmarque
Autosevocquiserdeterminaravisibilidadecomamo.
http://127.0.0.1:2525/doc/sun253/sun253.html

63/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

AuxEixoEtiqueta
Selecionaortulodeeixoaserexibidoprximoacorauxrampaseestivervisvel.OassociadoAutoopo,seselecionado,usaonome
deumadascoordenadasquefornecemdadosauxdesmarqueAutosevocquiserentrarcomumrtulocomamo.

GuiaIntervalodecontroleeixoAux
AFaixadeguiapermitequevocinsiraosvaloresinferioresuperiordointervalodedadosauxcomamo,eforneceumcontroledeslizante
duplopararestringirointervalodentrodesseslimites.Setantoointervalosuperiorouinferiordeixadovazio,elevaiserdeterminadaapartir
dosdados.
ObserveotipodeletrautilizadopararotularoeixoauxactualmentecontroladapelafontedoMachadosselector.

ControlesA.4.4Camada
Oscontrolessocontrolesdecamadanapilhadecontrolequepodemseradicionados,removidosemovimentadosparadeterminaroqueas
camadasvofazerseocontedodeumenredo.Podeterzero,umouvriosdecadaum.Quaisestodisponveisdependedequaltipode
grficoquevocestusando(porexemplo,ocontroleSpectrogramsestdisponvelparaatramaTime).Adicionarinstnciasdecada
controleparaapilhadecontroleusandoobotoapropriadonabarradeferramentasdopaineldecontrole(oquenametadeinferiordajanela)
ouoitemcorrespondentenoLayersmenu.
Oscontrolesdecamadadisponveissodescritasnassubseesaseguir.Maispodemseradicionadosemversesfuturas.
A.4.4.1ControledePosioCamada
Aposiodecontrolecamada(

)estdisponvelparatodosostiposdegrficos.Amaioriadasparcelascomearcomumdessesnapilha

porpadro,evocpodeadicionarumanovainstnciausandooControleIncluirposio(

boto)nabarradeferramentasdopainelde

controle,ouoitemcorrespondentenoLayersmenu.
Esteocontroloqueutilizadoparaamaiorpartedatramadedados,emquetraamasjanelas.Cadainstnciadestecontrolenapilhano
conspirarparaumdeterminadoconjuntodeposiesapartirdeumanicatabela.OconjuntodeposiesdefinidonoPosiesguiacomo
umnomedecolunaouexpressoparacadaparcelacoordenadas(porexemplo,paraXeYemloteplano).Noentanto,ocontrolopodegerar
mltiplascamadasapartirdestasposiesossubconjuntoscontrolesdeguiaquesubconjuntossoplotadosecomocadaumidentificado,
eoFormulrioguiaoferecemuitasopesparaogrficoseroplotadoscombasenasposies.
Estecontroleumcontroledetabeladedados,conformedescritonoApndiceA.4.2.2.EssaseoexplicaoSubconjuntosguiaaposioe
Formaabassodescritosemmaisdetalheabaixo.

GuiaPosiodecontroledacamadaPosio,paraPlaneenredo
Naposioguiavocentracoordenaaposiobaseparacadapontotraado.Issogeralmentesignificaescolherumamesaefornecendoum
valor(colunadatabelaouexpresso)paracoordenarcadaposio.Quandovocabreumajaneladeplotagem,TOPCATlhedumcontrole
camadadatabelaporpadro,etentapreencherascoordenadasdeposiocomalgunsvaloresrazoveis
databela(porexemplo,asprimeiras

colunasnumricas).
Observeosdetalhesdaposioguiaserdiferenteparadiferentestiposdegrficos,porexemplo,oenredoCubetemumZcoordenarcampo
aoladodeXeY.

http://127.0.0.1:2525/doc/sun253/sun253.html

64/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaFormadecontroledacamadaPosio
OFormulriodeguiapermitedefinircomooconjuntodedadosespecificadotraado.Apilhadoladoesquerdodumalistadeformulrios
sendoplotados,eopaineldadireitamostraaconfiguraodetalhadaparaaformaselecionada.
Quandoadicionadoemprimeirolugar,apilhacontmumanicaentrada,Mark,quetraaummarcadordeumadeterminadaformaetamanho
fixo.Acor,porpadrodeterminadopelaconfiguraonaguiaSubconjuntos.Paraumenredosimplesdedisperso,istotudoquevoc
precisa.Noentanto,humasriedeoutrasformasquevocpodedesenharbemouemvezdosmarcadoressimplesvetores,barrasdeerros,
elipses,contornos,rtulosdetexto,etcVocpodeadicionarumnovoformulrioparaapilha,clicandoemumdosbotesnabarrade
ferramentasnaguia.VocpoderemoverumformulriocomoRemove( boto)namesmabarradeferramentas.Voctambmpodeativar
/desativarloscomacaixadeseleoemovlosparacimaeparabaixocomaaladearrasto,comodecostume.Alistadeformulriosque
estodisponveisdependedotipodeenredoalistacompletaestnoanexoA.4.5.
Opaineldecadaformulriodedetalhesdependedoprprioformulrio.Eleestdivididonasseguintespainis,emboranemtodasasformas
tmtodosospainis.
Shading
Omododesombreamentocontrolaaformacomoospontossosombreadascombaseemsuacorescolhida.Asvriasopesso
descritasnoAnexoA.4.6.Dependendodomodoquepodehavermaisconfiguraesparapreencheraqui.
Coordenadas
Seascoordenadasadicionaissonecessriosparaessaforma,porexemplo,otamanhodasbarrasdeerro,vocprecisaentrarnacoluna
ouexpressoaqui.Cadacoordenarefetivamenteacrescentaumaoutradimensoparaoenredo.Muitasformas,comoMarcos,no
requeremquaisquercoordenadasadicionais.
Estilosglobal/subconjunto
ControlaosdetalhesdeestiloparaaformaescolhidaverApndiceA.4.2.2.
A.4.4.2ParPosiocamadadecontrole
AparPosiocontrolecamada(

)permitetraarsmbolosqueligamduasposiesnoespaoenredodamesmatabela.Vocpode

adicionarumdestescontrolesparaapilhausandooAddParControle(

boto)nabarradeferramentasdopaineldecontrole,ouoitem

correspondentenoLayersmenu.
Estecontroleparticularmentetilparavisualizarosresultadosdeumaprovacruzada,eusadoautomaticamentepeloresultadodolote(
opcional)oferecidosporalgumasdasjanelasJogoresultados.Sevocquisertraarparesdepontosdediferentestabelasdeentrada,primeiro
voctemquecriarumatabelaunida,usandoumadasfunescrossmatch.
ElefuncionadeformasemelhanteaoControledePosiodecamadanica,masaPosioguiatemcamposparanoum,masdoisconjuntos
decoordenadasapreencher
Estecontroleumcontroledetabeladedados,conformedescritonoApndiceA.4.2.2.EssaseoexplicaoSubconjuntosguiaaposioe
Formaabassodescritosemmaisdetalheabaixo.

http://127.0.0.1:2525/doc/sun253/sun253.html

65/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaPosiodoParcontrolecamadaPosio,paraSkyenredo
Naposioguiavocentranopardecoordenadasdeposioparacadapartraado.Istogeralmenteimplicaaselecodeumamesae
fornecendoumvalor(colunadatabelaouexpresso)paraoprimeiroesegundoconjuntosdecoordenadasposicionais.
Observeosdetalhesdaposioguiaserdiferenteparadiferentestiposdegrficos,porexemplo,oenredoSkytemlon1,LAT1,lon2eLat2
camposparaoprimeiroesegundoparesdelongitude/latitude,enquantoumenredoPlanetemX1,Y1,X2eY2.

GuiaFormadeParcontrolecamadaPosio
OFormulriodeguiapermitedefinircomooconjuntodedadosespecificadotraado.Alistaesquerdadumalistadeformulriossendo
plotados,eopaineldadireitamostraaconfiguraodetalhadaparaaformaselecionada.
AsformasdisponveisparaumenredoparAtualmenteMarcas(

),quechamaospontosemambasasextremidadesdopar,eLigao(

),quedesenhaumalinhaligandoos.Vocpodeconfigurloseselecionlosligadooudesligado,separadamente.Opaineldedetalhepara
estasformassodependentesdaformaemsieestodescritosemmaisdetalheemapndiceA.4.5,masospainisdedetalhessodivididosem
trspartes:
Shading
Omododesombreamentocontrolaaformacomoospontossosombreadascombaseemsuacorescolhida.Asvriasopesso
descritasnoAnexoA.4.6.Dependendodomodoquepodehavermaisconfiguraesparapreencheraqui.
Estilosglobal/subconjunto
ControlaosdetalhesdeestiloparaaformaescolhidaverApndiceA.4.2.2.
A.4.4.3HistogramaControledeCamada
OHistogramacontrolecamada(

),permitetraarumhistograma1dimensional.oprincipalcontrolenohistogramadajanelade

plotagem,mastambmestdisponvelnoPlanejaneladeplotagem,paraquepossaoverplotumhistogramaemumgrficodedisperso,se
vocpodepensaremalgumarazoparafazerisso.Ajaneladohistogramacomeacomumdessescontrolesnapilhaporpadro,mascomode
costume,vocpodeadicionarmais,usandooAdicionarcontroleHistograma(
boto)nabarradeferramentasdopaineldecontrole,ouo
itemcorrespondentenoLayersmenu.
Cadainstnciadestecontrolenapilhapodetraarumhistogramadeumaquantidadeespecficadeumatabelaparticular.Ovaloraser
histogramae,opcionalmente,umtermodeponderaoassociados,sodefinidosnoPosiesguiaousodenomesouexpressescoluna.No
entanto,ocontrolopodegerarmltiplascamadasapartirdestascoordenadasossubconjuntoscontrolesdeguiaquesubconjuntossoplotados
ecomocadaumidentificado,eoFormulrioguiaoferecemuitasopesparaogrficoseroplotadoscombasenasposies.
Estecontroleumcontroledetabeladedados,conformedescritonoApndiceA.4.2.2.EssaseoexplicaoSubconjuntosguiaaposioe
Formaabassodescritosemmaisdetalheabaixo.

http://127.0.0.1:2525/doc/sun253/sun253.html

66/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaPosiodecontroledacamadadeHistograma
NaposioguiaquevocdigiteovalordoXvalor,aquelequedeveserfinalmenteresolvidoparagerarohistograma.Istopodeserumnome
decolunadatabelaouumaexpresso.VoctambmpodepreencheropcionalmenteemumnomedecolunaouexpressonoPesocampo.Este
pesososvaloresconformeelessocontadoscadalinhadatabelacontribuicomumvalordealturadaponderaodecoordenadasparaobin
emquesuacoordenadaXquedas.Seopesonoforpreenchido,ovalor1assumido.

GuiaFormadecontroledacamadadeHistograma
OFormulriodeguiapermitedefinircomooconjuntodedadosespecificadotraado.Osestiloglobalesubconjuntoestilosubpainisde
controlecompartilhadoeconfigrationpersubconjunto,conformedescritonoApndiceA.4.2.2.Asopesdeconfiguraoespecficasso:
Transparncia
Comoasbarrassotransparentes.
FormulrioBar
Tipodebarrasdohistograma:cheio,aberto,passos,spikesetc
Espessura
LinhadeControlesespessuraquandoaplicvel.Issosrelevanteparaestilosdebarraquetraarumalinhadeespessurafinita,porisso
notemnenhumefeitoparabaresCheio.
Trao
Controlaopadrodetraodalinha(slido,pontos,traos,etc.)Issosrelevanteparaestilosdebarraquetraarumalinhadeespessura
finita,porissonotemnenhumefeitoparabaresCheio.
Histogramasteralgunsitensdeconfiguraoadicionais,conformedescritonasbarrasdecontrolefixos.Quandoumcontrolecamada
histogramausadonajaneladohistograma,ositensdeconfiguraosoencontradasnaBarescontrolefixo,ondeelescontrolamas
configuraesparatodasascamadasdohistogramanatrama.Noentanto,sevocusarumacamadadehistogramaemumPlaneenredo,os
itensaparecerocomoitensadicionaisnoformulriodeguiaepodesercontroladoseparadamenteparacadahistograma.
A.4.4.4Spectrogramcamadadecontrole
Estecontroleexperimental.Comoimplementadoatualmenteelanotemalgumascaractersticasimportantes.Podesermelhoradoou
retiradoemumaversofutura.
OControleSpectrogramCamada(

)traaumespectroemsucessivas(normalmente,masnonecessariamente,regularmenteespaados)

pontosemumasrietemporal.EleestdisponvelapenasparaoexperimentaldajaneladeplotagemTempo.

http://127.0.0.1:2525/doc/sun253/sun253.html

67/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaPlotTempocomumacamadaSpectrogram
Estecontroletemduasguias,dadoseEstilo,descritosaseguir.

GuiaDadoscontroleSpectrogram
Odadosguiapermitequevocespecifiquequaisosvaloresdeumatabelavaigerarumespectrograma.Eletemosseguintescampos:
Mesa
Oquadroforneceosdados.
Tempo
Acolunadatabelaouexpressodandocoordenarapocaemqueosespectrosestolocalizados.Estedevesernormalmenteumacoluna
digitadaemtemposesimplesmentedotiponumricoqueserinterpretadocomosegundosdesde1dejaneirode1970.
Espectro
Umacolunadetabelacomvalordegamadandoosdadosespectrais.
TimeWidth
Acolunadatabelaouexpresso(varivelouconstante),dandoacoberturatemporaldeumespectrotraado.Senoforpreenchida,
http://127.0.0.1:2525/doc/sun253/sun253.html

68/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

presumeseseromaiscomum(mediana)diferenaentreospontosdetempo.
Rowsubconjunto
Osubconjuntoparaoqualoespectrodeveserplotado.Paratraarvriossubgrupos(semsempreteiscomestetipodeenredo)voc
precisariadevrioscontrolesdecamadasespectrogramanapilha.

GuiaSpectrogramEstilocontrole
Oestilopermitelheconfiguraraformacomooespectrogramaplotado.Eletemosseguintescampos:
Shader
Selecioneomapadecoresapartirdeumalistadeopes.
SombraLog
Seaescalaauxdevemapearlinearmenteoulogaritmicamenteparaomapadecores.
SombraVirar
Seaescalaauxdevemapearfrenteouparatrsnomapadecores.
NullCor
Quecordeveserusadapararepresentaramostrasespectraiscomumvalornulo.SeoassociadoEsconderopoforselecionada,em
seguida,essespontosnoaparecernatramaemtudo(quesertransparente).
A.4.4.5FunodeControledeCamada
Afunodecontroledecamada(

)sestdisponvelparaosPlaneeHistogramaparcelas.UseoLayersitemdemenuoubotodebarra

deferramentascorrespondenteparaadicionarumainstnciaparaapilhadecontrole.

http://127.0.0.1:2525/doc/sun253/sun253.html

69/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Loteplanocomduascamadasdefunotraada,umcomoumafunodovalordeeixohorizontal,eumcomoumafunodovalor
doeixovertical
Estecontroletemtrsguias,funo,estiloeetiqueta,descritosaseguir.

GuiaFunodecontroledefuno
AFunoguiadefineafunoaserplotadaetemosseguintescampos:
Eixoindependente
QualoeixodavarivelindependentevariaaolongoopesestoatualmenteHorizontaleVertical.
Nomedavarivelindependente
Nomedavarivelindependente.Istotipicamentexporumavarivelindependentehorizontaleydeumavarivelindependentevertical,
masqualquerstringqueumidentificadordelinguagemdeexpressolegal(comeacomumaletra,continuacomletras,nmeros,
sublinhados)podemserusados.
Expressodefuno
UmaexpressodeTOPCATutilizandolinguagemdeexpressoemtermosdavarivelindependentequedefineafuno.Estaexpresso
deveserautnomonopodefazerrefernciaanenhumatabela.

http://127.0.0.1:2525/doc/sun253/sun253.html

70/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaEstilodecontroledefuno
OEstiloguiaconfiguraoestilodeplotagem.Asopesso:
Cor
Cordalinha.
Espessura
Espessuradalinhaempixels.
Trao
Padrodetraodalinhaslidaopadro,masestodisponveisvriasopes.
Suavizao
Seforverdade,aslinhassosuavizados,oqueostornamaissuavenatelaouexportarimagensdebitmap.Notemefeitoemimagensde
exportaodevetores(PDF,EPS).

Guiadeetiquetadecontroledefuno
Aetiquetaguiapermitequevocescolhaotextoqueaparecenalegenda.Asopesso:
Etiqueta
Dortuloqueaparecernalegenda.Porpadro,aexpressodefunousado,massevocquisersubstituiressevocpode
desmarcaroassociadoAutocaixadeseleoedigiteoseuprpriovalor.
EmLegenda
Seforverdade,umaentradaparaestafunoaparecenalenda,seforfalso,no.Observeaconfiguraodestevalornoafetasea
prprialendaaparece,quecontroladapelalendacontrole.

FormasA.4.5Lote
"Formas"deenredosoasinstruesparaqueasformasderealmentepintarsobreasuperfciedatramadadoalgunsdadosdeposiodeuma
tabela.Amaisbvia(Mark)simplesmenteparatraarummarcadorcomumtamanhofixoeformaemcadaposiodedados.Noentanto,
humasriedeoutrascoisasquevocpodequererfazer,incluindobarrasdeerro,vetores,contornos,rtulosdetexto,...
Asopesfornecidassodescritos,comasinformaesdeconfiguraoadicionalnecessrio,nasseesseguintes.Nemtodosesto
disponveisparacadatipodegrfico.
A.4.5.1MarkForm

PaineldeconfiguraoformaMark
OMarkformulrio(

)simplesmentedesenhamarcadorescomumaformaetamanhofixo.

Asopesdeconfiguraoso:
Mododesombreamento
VejaApndiceA.4.6.
Forma
Formademarcadordeumalistadeopes.
http://127.0.0.1:2525/doc/sun253/sun253.html

71/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Tamanho
Tamanhodomarcadorempixels.
A.4.5.2TamanhoForm

PaineldeconfiguraoformaTamanho
OTamanhodoformulrio(

)traamarcadoresdeumaformafixa,cujotamanhovariadeacordocomumconjuntodedadosfornecidos

coordenadas.Otamanhodomarcadorrepresenta,portanto,umadimensoadicionaldatrama.
Otamanhodomarcadordimensionadodeacordocomosvaloresdosdados.Ointervalodedadosnapartevisveldatramadeterminada,o
valormximoatribudoaotamanhomximodomarcador,eotamanhodecadamarcadordeterminadacomo(valordedados)/(valor
mximodedados).Atualmenteosvaloresdedadosdezero,semprecorrespondemaotamanhodomarcadordezero,osvaloresdedados
negativosnosorepresentados,eomapeamentolinear.Outrasopespodemserintroduzidasnofuturo.
Observeaescalaparaotamanhoemtermosdedimensesdatela(pixels).Paraasdimensesquecorrespondemaosvaloresdedadosreais,o
errodeformapodesermaisapropriada.
Asopesdeconfiguraoso:
Mododesombreamento
VejaApndiceA.4.6.
Tamanho
Otamanhodecoordenarosvaloresdedados.Preenchaestecomumnomedecolunaouexpressodamesa,assimcomoparaas
coordenadasposicionais.
Forma
Formademarcadordeumalistadeopes.
Maxmarcadordetamanho
Balanasotamanhomximomarcadorempixels.Deslizeissojuntoparaescalarostamanhosdetodososmarcadoresparacimaoupara
baixo.
A.4.5.3VectorForm

Paineldeconfiguraoformavetorial
AVectorforma(

)parcelasdirigidolinhasapartirdaposiodadosfornecidosvaloresdeltaparaascoordenadas.Osmarcadoresplotados

sotipicamentepequenassetas,masexistemoutrasopes.
Emalgunscasos,taisvaloresdeltapodeseramagnituderealnecessrioparaatrama,masmaisfrequentementedoqueosdadosdovetor
representaumvalorquetemumamagnitudediferenteouestemunidadesdiferentesparaosdadosposicionais.Comoumaconveninciapara
estecaso,oplotterpode,opcionalmente(efazporpadro)dimensionarasmagnitudesdetodososvetoresparatornlosumtamanhorazovel
(paraosmaioressoalgumasdezenasdepixelsdecomprimento).EstaescalapodeserajustadooudesligadousandoaEscalaeEscalaAuto
opesabaixo.
Asopesdeconfiguraoso:
http://127.0.0.1:2525/doc/sun253/sun253.html

72/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Mododesombreamento
VejaApndiceA.4.6.
DeltaX,DeltaY,...
Ascoordenadasdasmudanasemcadacoordenadaquedovector.Ascoordenadasaquicorrespondemscoordenadasdatrama.Para
coordenadascelestes,osvaloresdeltalongitudefornecidosestoemgrausesoconsideradoscomotendosidojmultiplicadaporcos
(latitude).
Seta
Setaformaselecionadaapartirdeumlequedeopes.
Escala
Alteraofatorpeloqualtodosostamanhosdevetoressoescalados.Seassetassomuitopequenos,deslizeoparaadireita,seelesso
grandesdemais,deslizeoparaaesquerda.Aescalalogartmica.
EscaladeAuto
Seselecionada,estaopoirdeterminarotamanhoescalaflechapadroapartirdosdadosqueircorrigiloparaqueasmaiores
flechassoalgumasdezenasdepixelsdecomprimentoporpadro.EssaescalapodeserajustadausandoaEscaladeslider.Seno
estiverselecionada,entoaposiopadrodabarradeescalacorrespondesposiesreaisdadaspelascoordenadasdeltasubmetidos.
BaresA.4.5.4errodeforma

BarrasdeErroformaropaineldeconfigurao
Asbarrasdeerroformar(

)desenhabarrasdeerrosimtricosouassimtricosemalgumasouemtodasasdimensesdeum1lote

cartesianoou3dimensional,2.Aformadas"barras"deerrobastanteconfigurvel,incluindo(para2eerros3d)elipses,retngulosetc,
alinhadocomoseixos(paraelipseseretngulosrotacionados,consulteoElipseformulrio).
Asopesdeconfiguraoso:
Mododesombreamento
VejaApndiceA.4.6.
Xerropositivo,Xerronegativo,...
Paracadadimensodatrama,vocpodeinserirvaloresdeerropositivose/ounegativoscomocolunasouexpressesdatabela.Todos
estesvaloresdevemserpositivotodososvaloresnegativosseroignorados.Seambososvalorespositivosenegativossopreenchidos
porumeixo,oserrosserassimtrica.Seovalornegativoestembranco(ouporqueacoordenarnoforpreenchido,ouporqueoseu
valorembrancoparaessalinha),asbarrasdeerrovaisersimtrica,ouseja,abarradeerronegativoseromesmotamanhoqueo
positivo.Sevocquisergarantirapenasumabarradeerropositivotraado,digite"0"paraoerronegativocorrespondente.
ErroBar
Formadebarradeerroapartirdeumalistadeopes.Aparnciaexactadependertambmadimensodoserrosfornecidos.
A.4.5.5EllipseForm

PaineldeconfiguraoformaEllipse
http://127.0.0.1:2525/doc/sun253/sun253.html

73/208

21/4/2014

AEllipseforma(

TOPCAT - Ferramenta para operaes em catlogos e tabelas

)desenhaumaelipse(ouretngulo,ououtrafigurasimilar)definidaporraiosmaioremenoreumnguloderotao

opcional.
Asopesdeconfiguraoso:
Mododesombreamento
VejaApndiceA.4.6.
MaiorRaio,MinorRadius
Doisraiosparaaelipse,nasmesmasunidadescomoascoordenadasdeposio(quegrausparaoenredodocu).Noimportaseo
principalmaiordoqueomenor.
Orientao
ngulodeposioemgraus.ParaoloteavioongulonosentidocontrrioapartirdoeixoXparaoraiomaior.Paraoenredocuo
ngulodoploNorteaoeixomaiornadireodoRApositivo.Seovalorestemfalta(sejaestecamponopreenchidoouembranco
nosdados)queconsideradozero.
Elipse
Formadeelipse,seleccionadoapartirdeumagamadeopes(tambmincluirectngulos,cruzes,etc.)
Escala
Alteraofatorpeloqualtodosostamanhoselipsesoescalados.Seasreticnciassomuitopequenos,deslizeoparaadireita,seelesso
grandesdemais,deslizeoparaaesquerda.Aescalalogartmica.
EscaladeAuto
Seselecionada,estaopoirdeterminarotamanhoescalaelipsepadroapartirdosdadosqueircorrigiloparaqueasmaiores
reticnciassoalgumasdezenasdepixelsdecomprimentoporpadro.EssaescalapodeserajustadausandoaEscaladeslider.Seno
estiverselecionada,entoaposiopadrodabarradeescalacorrespondesposiesreaisdadaspelascoordenadasraioselipse
submetidos.
A.4.5.6LinhaForm

PaineldeconfiguraoformaLinha
ALinhadeformulrio(

)desenhaumalinhapontoapontojuntandoseospontosquecompemoconjuntodedados.Observeque,para

definirumgrandeenoordenadasdedadosistopodelevaraumgranderabisconatela.
Asopesdeconfiguraoso:
Espessura
Espessuradalinhaempixels.
Trao
PadroDash.Alinhaslidaporpadro.
Suavizao
Seforverdade,pixelssoborradosparadaralinhadeumaaparnciamaissuave.
A.4.5.7formulriodetextoRtulo

Paineldeconfiguraoformartulodetexto
Otextodaetiquetadaforma(

)desenhaumrtulodetextoporcadaposiodoponto.

Asopesdeconfiguraoso:
http://127.0.0.1:2525/doc/sun253/sun253.html

74/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Texto
Acolunaouexpressonatabelafornecendootextoparaescreversobreoenredo.Qualquertipodedados(stringounumrico)
permitido.
SintaxeTexto
QuerusarasregrasdetextoouLaTeXsimplesdefazersentidoovalordetexto.
Tamanhodafonte
Tamanhodafonteempontos.
Estilodafonte
Estilodafontepadro,serifoumonoespaada.
Pesodafonte
Seafontesimples,negritoouitlico.
ncora
Aposiodotextoemrelaoposiodosdados.
Limitedeespaamento
LimiteAglomerao
Estasduasopesdecontrolaraformacomoasetiquetasespaadaspodeser.Rtulosquesomuitodepertoamontoadosnoser
simplesmentemostrado,desdeoverplottingmuitosrtulosjuntosacabacomeles,sendoilegvel.OespaamentoThresholddeslizante
controlaamenorreaqueumgrupodeetiquetaspodeterparasimesmossehmuitosnamesmarea,nenhumserdesenhado.
Deslizandoesquerdapermiteumamaioraglomeraoedireitopermitemenos.OlimitedeAglomeraocontrolaomaiornmerode
etiquetasquepodemserdeumgrupo.Definilopara2,porexemplo,tilsevocquiserverparesdertulos,mesmoqueoparest
perto.
A.4.5.8ContourForm

PaineldeconfiguraoformaContour
OContourforma(

)traacontornosdensidadeposio.Estesfornecemumaoutraforma(aoladodasAutoedensidademodosde

sombreamento)paravisualizarascaractersticasderegiesoverdenseemumatramalotado.
Oscontornosestodesenhadascomopixelsemvezdelinhas,demodoqueelesnoseparecemmuitobonitaemformatosdesadadovetor
exportados(PDF,PostScript).
Asopesdeconfiguraoso:
ContagemNvel
Onmerodecontornosdesenhados.Defacto,esteumlimitesuperiorsenohouvervariaosuficientenadensidadedatrama,em
seguida,menoslinhasdecontornoserdesenhado.
Suavizao
Otamanhodoncleodealisamentoaplicadadensidadeantesderealizaradeterminaodocontorno.Sefordefinidomuitobaixoos
contornossermuitoenrugada,esemuitoaltoelesvoperderdefinio.
Escalada
Comoadensidadesuavizadostratadoantesdeosnveisdecontornossodeterminados.Asopessolinear,logartmicaeigualrea.
PontoZero
Determinaonvelaqueoprimeirocontorno(e,portanto,todososoutros,osquaisestoseparadosdomesmoporumaquantiafixa)so
desenhados.Deslizandoestedeladoalado,vocpodevarreroscontornossobreafaixadedensidadeeterumaboaidiadeondeos
recursosinteressantesmentir.
A.4.5.9ParMarcasForm

PaineldeconfiguraoformaparMark
AparMarkforma(

)estdisponvelapartirdacamadadecontroloposiodopar,etraaummarcadordeformaetamanho

configurvelemambosospontosdeumparposio.Omesmomarcadorusadoparaambasasextremidadessevocquiserpontosdiferentes
vocpodeusardoisnicosMarcarformas.
http://127.0.0.1:2525/doc/sun253/sun253.html

75/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Asopesdeconfiguraoso:
Mododesombreamento
VejaApndiceA.4.6.
Forma
Formademarcadordeumalistadeopes.
Tamanho
Tamanhodomarcadorempixels.
A.4.5.10ParLigaoForm

PaineldeconfiguraoformaparLigao
AligaoParforma(

)estdisponvelapartirdocontroledacamadaposiopar,etraaumalinhaligandoosdoispontosemumpar

posio.
Asopesdeconfiguraoso:
Mododesombreamento
Mododesombreamento
VejaApndiceA.4.6.

A.4.6ModosShading
Amaioriadasformasdeparcelastmumacordeestiloassociadocomeles,paracadaconjuntodedados.Istodefineacorbsicausadapara
traaraformaemcadapontodedados.Noentanto,muitasdasformastambmpedirlheparaseleccionarummododesombreamento,oque
determinaacorrealexibidonatramaparaospontos.Acorsombreadabaseadanacorestiloseleccionado,maspodetambmserinfluenciado
pelonmerodepontostraadosl,coordenaralgunsdadosadicionais,ououtrasinformaesdeconfigurao.
Aoexportarparcelasparaumformatodegrficosvectoriaisexterno(EPSouPDF),algunsdosmodosdesombreamentopodenose
comportamdamesmacomoemumbitmap(natela,ouemumformatodebitmap,comoGIFouPNG).Taisanomaliassoobservadasnanas
descriesdomodoabaixo.
Asdiferentesopesdemododemododesombreamentosodescritasnassubseesaseguir.
ModoPlanoA.4.6.1

Seleodomododesombreamentoplano
OPlanomododesombreamento(

)simplesmentecorespontosdacorselecionadaporseuestilo.Elenotemparmetrosoucoordenadas

adicionais.
Exportao:Estemodofuncionasemproblemaparaasadatantobitmapevetor.
A.4.6.2modotransparente

SeleodomododesombreamentoTransparente
ATransparentmododesombreamento(

)coresmoldaemumaversotransparentedacorselecionadaporseuestilo.Ograude

transparnciadeterminadopelolimiteOpaquedeslizantenaextremidadeesquerda,ospontossototalmenteopacoeissoequivalentea
modalidadeplana,ecomovocdeslizarmaisparaadireita,ospontosdeobtermaistransparente.Quantomaiorforolimiteopaco,maispontos
temquesertraadasemcimaunsdosoutrosparaalcanarcorqueobscurececompletamenteofundo.
Exportao:Quandoospontossoopacos,estemodofuncionasemproblemaparaasadatantobitmapevetor,masquandoatransparncia
definidapodehaveranomalias.PontostransparentesforemprestadossadaPDF,emboraosnveisdetransparnciapodenoserexatamenteo
mesmoquenatela.IssopodesercorrigidousandoaForaBitmapoponoLoteExportdilogo.ParaPostScript,pontostransparentesso
http://127.0.0.1:2525/doc/sun253/sun253.html

76/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

renderizadascomoopaco.VocpodeusarForaBitmapcomPostScriptquevaiterdireitoatransparnciaparaestacamada,mas,emseguida,
todasascamadasanterioressercompletamenteobscurecida.
ModoAutoA.4.6.3

SeleodomododesombreamentoAuto
OAutomododesombreamento(

)corespontosisoladosemsuacorselecionada,masondevriospontosdomesmoconjuntodedados

sobreposioajustaacorescurecendolo.Istosignificaqueparapontosisolados(amaioriaoutodosospontosemumatramanolotado,ou
discrepantesemumatramalotado)elesecomportaexatamentecomoPlanomodo,masfcilveronderegiesoverdensementir.
IstocomoDensidademodo,massemopesconfigurveis
pelousurio.

Esteomodopadroparagrficos2D,umavezquelhedumaboaprimeiraidiadequeosdadosestofazendo.Para3dparcelaspodeser
utilizada,efuncionabemparaasparcelasdoconjuntodedadosindividuais,mas,nocasodemltiplosconjuntosdedadosquepodeser
enganadorpoisospixelscoloridosnopodesercolocadosensivelmentenoespao3D.
Oescurecimentodacorbaseadanafunoasinhaintenoquedoispontossobrepostosdeveserapenasosuficientediferentesnacorpara
adiferenadeservisvel,eomapeamentodimensionadademodoquesehregiesmuitodensaselesvosairquasepreto.
Exportao:Quandoexportadosparaformatosvetoriais,asadaautomaticamenteforadoaumbitmapparaascamadasdemodoAuto.No
casodoPostScript,issoobscurececompletamentetodasascamadasanteriores.
ModoA.4.6.4Densidade

SeleodomododeDensidade
ADensidademododesombreamento(

)usaummapadecoresconfigurvelparaindicarquantospontossoplotadossobreooutro.

Especificamente,ascoresdecadapixeldeacordocomonmerodevezesqueopixeltemtemsidocobertoporumadasformastraadaspela
camadaemquesto.Ditodeoutraforma,elegeraummapadedensidadedecoresfalsascompixeldegranularidadeusandoumkernelde
suavizaodaformadasformastraadaspelacamada.Oresultadoquevocpodeveradensidadedetramadepontosououtrasformas
plotados.
IstocomoAutomodo,mascommaisopesconfigurveis
pelousurio.Asopesso:

Mapa
Omapadecoresparaaexibiodevaloresdedensidade.Existemdoistipos,relativoseabsolutos.Mapasrelativostmnomesmarcados
porumasterisco("*")ealteraracordoconjuntodedadosbsicos,porexemplo,escurecerouclarearlo,enquantoosmapasabsolutos(o
resto)ignoraracorbsicadoconjuntodedadoscompleto.Paraumconjuntodedadosnicoenredo,osmapasabsolutossoos
melhores,masparavriossubconjuntospodesermenosconfusoparausarumparente.
MapaClipe
Selecioneapenasumapartedomapadecoresselecionadoacima.Porpadrotodoomapadecoresusado,massevocquiseragama
decoresnatramaaserformadoapartirdeapenasumapartedafaixadecormostraaShadercontrole,vocpodemoverasalasapartir
dofinaldesteslider.
Log
Selecionaseomapadecoresdeveseraplicadolinearmenteoulogaritmicamentegamadedensidades.Opadrologartmica.
Sacudidela
Seleccionaseomapadecordeveseraplicadoparaafrenteouparatrs,paraagamadedensidades.
Subrange
Ajustaointervalodedensidadesobreaqualomapadecoresaplicado.Porpadro,omapadecoresescaladousandolimites
encontradosapartirdadensidadededadosnatrama(asmaisdensasalgunspixelssoignorados),masvocpoderestringirointervalode
usaresteslider.
Exportao:Quandoexportadosparaformatosvetoriais,asadaautomaticamenteforadoaumbitmapparaascamadasdemodo
Densidade.NocasodoPostScript,issoobscurececompletamentetodasascamadasanteriores.
ModoAuxA.4.6.5
http://127.0.0.1:2525/doc/sun253/sun253.html

77/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Auxseleodomodo
OAuxmododesombreamento(

)coresdecadapontodeacordocomovalordeumconjuntodedadosadicionaisdecoordenadas.As

coresdeponto,ento,representarumadimensoadicionaldatrama.Noumaopoadicionalparadesenharospontoscomuma
transparnciafixo.
Osombreamentofeitodeacordocomumanicaescalafixaparatodososdadosnatrama.QuandopelomenosumacamadaAuxmodeest
sendoplotado,oAuxEixocontrolevisvelnopaineldecontrole,quepermiteconfiguraromapadecores,gama,displayrampaetc
Asopesso:
Aux
Acoordenadaauxiliarvaloresdedados.Preenchaestecomumnomedecolunaouexpressodamesa,assimcomoparaumaposiode
coordenadas.
LimiteOpaque
Determinatransparnciadospontos.Porpadro,elessototalmenteopaco,massevocdeslizarocursorparaadireita,elesvosetornar
cadavezmaistransparente.
Exportando:pontostransparentesforemprestadossadaPDF,emboraosnveisdetransparnciapodenoserexatamenteomesmoquena
tela.IssopodesercorrigidousandoaForaBitmapoponoLoteExportdilogo.ParaPostScript,pontostransparentessorenderizadas
comoopaco.VocpodeusarForaBitmapcomPostScriptquevaiterdireitoatransparnciaparaestacamada,mas,emseguida,todasas
camadasanterioressercompletamenteobscurecida.

JanelaLoteA.4.7Histograma

http://127.0.0.1:2525/doc/sun253/sun253.html

78/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaHistogramaPlot
Ohistograma(

)traahistogramas1dimensionais.Emmuitosaspectos,comooPlanoPlot,mastemumadicionaldecontrolefixos

Baresearolagemfuncionaumpoucodiferente.
Vejaomapadevisogeralparaosrecursoscomunsatodasasjanelasdeplotagem.Assubseesseguintesdescrevemnavegao,
configuraodeeixoseconfiguraobar.
Ohistogramadoloteofereceapenasosseguintescontrolesdeenredo:
HistogramaControledeCamada
ControlodafunoCamada
A.4.7.1HistogramaNavegao
Paracomentriosgeraissobreanavegaotrama,verApndiceA.4.2.1.Opesdeconfiguraoadicionaisestodisponveisnanavegao
guiadocontroleAxes.
Asaesdenavegaoparaestajanelaso:
Arrasteparaaesquerda
Pan.Nocorpodoenredoestemoveloaoredorparacima/baixo/esquerda/direita.Paramovloapenasnavertical,arrastesobrea
esquerdadoeixoY.Paramovloapenashorizontalmente,arrasteabaixodoeixoX.Vocpodeconfigurararrastandoocorpodoplano
paraserverticalouhorizontalapenasdefinindooMachadosPan/ZoomnaNavegaoguiaconfiguraodeeixos.
Arrasteparaadireita(CTRLarrastar)
Zoomestiramento.Nocorpodoenredo,arrastandoparacima/baixo/polpastrechosdoenredonavertical,earrastandoparaaesquerda
/direitatrechos/polpaslohorizontalmente.Paraampliarapenasnavertical,arrasteesquerdadoeixoY.Paraaumentarozoomapenas
horizontalmente,arrasteabaixodoeixoX.
http://127.0.0.1:2525/doc/sun253/sun253.html

79/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Zoominghorizontalmentenormalmenteirajustaralarguradasbarrasdehistogramaapropriadamente.
Normalmente,ozoomsercentradanahorizontalnaposioderatoenaverticalsobreoeixoX,demodoqueozoomnoirmoverse
naparteinferiordohistograma.VocpodeajustarissocomosAnchorX/YEixoopesnaNavegaoguiaconfiguraodeeixos.
Roda
ZoomIsotrpico.Girandoarodadomouseparafrente/trsozoomin/out,assimcomoarrastarcomobotodireitoparacimaeparaa
direitaouparabaixoeparaaesquerda.
VoctambmpodecorrigirmanualmenteoslimitesdoloteusandoaFaixadeguiadocontroleAxes.
A.4.7.2HistogramaEixosdecontrole
OHistogramadecontroledoeixodolotemuitosemelhanteaoeixoLoteplanodecontroledescritonoApndiceA.4.8.2.Anicadiferena
nanavegaodaguia.Paraohistograma,oAnchorXAxisopodefinidaemporpadro,jquenormalmentevocvaiquereralinhaY
=0paraficarancoradoaofundodoterrenoquandoozoom.
BaresA.4.7.3Controle
OBarrasdecontrole(

)encontradanapilhadajaneladohistogramacontrole.Eleconfiguraoposicionamentocomumeclculodas

barrasparatodasascamadashistogramamostrado.Eletemosseguintescampos:
BinTamanho
Aescalaparaalarguradecaixasquesoapresentadosnoecr.Hduasmaneirasdeespecificarisso.Seobotodeopodolado
esquerdoselecionado,ocontroledeslizanteadjacenteirajustarotamanhodacaixa,oquetambmafetadopelalargurarealdajanela
deplotagemempixels.Deslizeocontroledeslizanteparaaesquerdaparapegarcaixasestreitasoudireitodeobterosmaislargos.Seo
botodoladodireitoselecionado,vocpodedigitarumvalornumricodandoalargurarealemunidadesdedadosdecadabarra(para
umXlogartmicaeixoestevalorumfator).
FaseBin
Controlaondeopontohorizontalzeroparabinningestdefinido.Porexemplo,seoseutamanhobin1,controlaseescaninhoslimites
estoem0,1,2,..ou0.5,1.5,2.5,etc...Seocursorestemumaououtraextremidadedaescala,nohaverumlimitedebindeX=0
(lineareixoX)ouX=1(eixoXlogartmica).
Acumulativo
Seforverdade,asbarrasplotadassocalculadoscumulativamentecadabinincluiacontagemdetodasascaixasanteriores.
Normalizada
Seforverdade,ascontagensemcadahistogramaplotadossonormalizadosparasomarumvalorde1.

BaresfixodecontrolenajanelaHistograma

A.4.8Planejaneladeplotagem

http://127.0.0.1:2525/doc/sun253/sun253.html

80/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaPlanePlot
OLotePlane(

)traaposiescartesianas2dimensionaisemumavio.AscoordenadasposicionaissoXeY.Paracontrolaradireoe

linear/logdimensionamentodoseixos,consulteoCoordsguiadoMachadoscontrole.
Vejaomapadevisogeralparaosrecursoscomunsatodasasjanelasdeplotagem.Assubseesseguintesdescrevemnavegaoe
configuraodeeixos.
OPlanoPlotofereceosseguintescontrolesdeenredo:
Posiocamadadecontrole,comessasopesdeforma:
Marca
Tamanho
Vetor
Barrasdeerro
Elipse
Linha
RtuloTexto
Contorno
ControleParCamada,comosseguintescontrolesdeenredo:
Marcas
Link
http://127.0.0.1:2525/doc/sun253/sun253.html

81/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

HistogramaControledeCamada
ControlodafunoCamada
A.4.8.1PlanodeNavegao
Paracomentriosgeraissobreanavegaotrama,verApndiceA.4.2.1.Opesdeconfiguraoadicionaisestodisponveisnanavegao
guiadocontroleAxes.
Asaesdenavegaoparaestajanelaso:
Arrasteparaaesquerda
Pan.Nocorpodoenredoestemoveloaoredorparacima/baixo/esquerda/direita.Paramovloapenasnavertical,arrastesobrea
esquerdadoeixoY.Paramovloapenashorizontalmente,arrasteabaixodoeixoX.Vocpodeconfigurararrastandoocorpodoplano
paraserverticalouhorizontalapenasdefinindooMachadosPan/ZoomnaNavegaoguiaconfiguraodeeixos.
Arrasteparaadireita(CTRLarrastar)
Zoomestiramento.Nocorpodoenredo,arrastandoparacima/baixo/polpastrechosdoenredonavertical,earrastandoparaaesquerda
/direitatrechos/polpaslohorizontalmente.Ozoomemtornodaposiodomousenoinciodoarrasto.Paraampliarapenasna
vertical,arrasteesquerdadoeixoY.Paraaumentarozoomapenashorizontalmente,arrasteabaixodoeixoX.
Roda
ZoomIsotrpico.Girandoafrentedarodadomouse/paratrsozoomin/outemtornodaposiodomouse,assimcomoarrastarcom
obotodireitoparacimaeparaadireitaouparabaixoeparaaesquerda.
Cliqueesquerdo
Selecione.Sehouverumpontotraadopertodocursor,eleirtraarummarcadorsobreeleeativarisso.
VoctambmpodecorrigirmanualmenteoslimitesdoloteusandoaFaixadeguiadocontroleAxes.
A.4.8.2PlaneEixosdecontrole
OEixosdecontrole(

)paraajaneladoaviolotetemseisguias.

AbaCoordsdeavioEixosdecontrole
OCoordsguiacontrolaascoordenadasdoseixos.Eletemasseguintesopes:
X/YLog
Seselecionado,ascoordenadasdoeixohorizontal/verticalsologartmica,casocontrrio,elessolineares.
X/YVirar
Seselecionado,oeixohorizontal/vertical,eixosdecoordenadasfuncionamnosentidoopostoaonormal.
Bloqueiodeaspecto
Seforseleccionado,onmerodepixelsporunidadesempreamesmaemambososeixos,ouseja,aunidadequadradasempreum
quadrado.Casocontrrio,nohqualquerrestriosobreasdimensesrelativasdasunidadesdoeixoXeY.

GuiadenavegaodeavioEixosdecontrole
Anavegaoguiacontroladetalhesdecomoanavegaofunciona.Eletemasseguintesopes:
Pan/ZoomMachados
http://127.0.0.1:2525/doc/sun253/sun253.html

82/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Normalmente,arrastandocomosbotesesquerdo/direitodomouseouusandoarodadomousesobreaparteprincipaldatramasero
pan/zoomloemambasdireesXeY.AodesmarcaracaixaXouYaqui,vocpodeimpedirpan/zoomnadireocorrespondente,
demodoqueseacaixadeYdesmarcada,pan/zoomsvaiafetaradireovertical(observeomesmoefeitopodeserconseguido
arrastandoparaaesquerdadoeixoY).
AnchoreixoX/Y
Normalmente,asoperaesdezoomzoomemtornodaposiodomousenoinciodogestoroda/arrasto.Verificandoessascaixas
corrigecoordenararefernciaX/YparazoomsserosY=0ouX=0linhas.IstopodesertilsevocquiserqueoeixoXouYpara
ficarparado(porexemplo,nabordadoterreno)duranteaesdezoom.
FatordeZoom
Controlaofatorpeloqualcadaaodozoomampliaatrama.Movendoessecontroledeslizanteparaaesquerda/direitatornaomouse
mais/menossensvel(umclickwheelouarrastandoumadistnciafixatemmaismenosefeito/zoom).

GuiaIntervalodeavioEixosdecontrole
AFaixadeguiaforneceaconfiguraomanualdafaixavisveldoenredo.Fazeralteraesaesteguiairredefinirointervalodogrfico
visvel,masnoviceversazoomevisopanormicadaformausualnovaimudarasconfiguraesdestepainel.
Preenchendoosmnimos/mximoscamposparaumouambososeixosvairestringirafaixacorrespondentedeosdadosvisveis.Oslimites
correspondentesaqualquerumdessescamposquesodeixadasembrancoseroinicialmentetrabalhadosapartirdosdados.Ossubrange
duplasdeslizantesrestringirosintervalosdentrodosintervalosdemin/max(explcitasouautomtico).Notequevocpodemoverosdois
controlesdeslizantesdeumasvez,agarrandoumaposioentreosdois.
OLimparbotoredefinetodososcampos.OEnviarbotoatualizaatramacomosvaloresatuaisnessaguia,assimcomodefazeralteraesa
ela.

GuiaGradedeavioEixosdecontrole
Agrelhaguiaconfiguraaaparnciadagradedoeixo.Eletemasseguintesopes:
DesenheGrade
Seforverdade,aslinhasdegradeserosorteadosatravsdoenredoparacadamarcadeescala.
GradeCor
Selecionaacorcomqueaslinhasdegradeserosorteados.
Etiquetacor
Selecionaacornaqualeixotextodortuloserescrito.
MenorCarrapatos
Sedefinido,menores(unlabelled)asmarcasdeescalaserosorteadosentreosprincipais(marcadas)queridos.
X/YTickCrowding
Useocontroledeslizanteparainfluenciarquantasmarcasdeescalasodesenharemcadaeixo.
Suavizao
Controlaselinhasetextodegradeserodesenhadasantialiased(suavizada)ouno.TextoAntialiasedgeralmenteparecemaisagradvel,
maspodeservisivelmentemaislento.Estaoponoafetaparcelasexportados.Nomomentodaescrita,Macsmuitasvezesexigemessa
oposelecionadacasocontrrio,aescritapodesairdoladoerrado.

http://127.0.0.1:2525/doc/sun253/sun253.html

83/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaEtiquetasdeavioEixosdecontrole
OLabelsguiacontrolaosrtulosdetextonoseixos.SeoAutoopofordefinida,otextoserlevadodeumdosdadoscoordenasendoque
seroplotadas.Parasubstituiraquelescomseusprpriosrtulosdoeixo,unsetAutoetipodetextoemqueasetiquetascampos.

GuiaFonte
OFontguiaconfiguraotipodeletrautilizadoparaanotaoeixo.Elatambmafetaalgumasoutrascoisascomoalenda.
SintaxeTexto
QuerusarasregrasdetextoouLaTeXsimplesdefazersentidoovalordetexto.
Tamanhodafonte
Tamanhodafonteempontos.
Estilodafonte
Estilodafonte.
Pesodafonte
Seafontesimples,negritoouitlico.

JanelaLoteA.4.9Sky

http://127.0.0.1:2525/doc/sun253/sun253.html

84/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaSkyPlot
OLoteSky(

)traaposieslongitude/latitudenaesferaceleste.Elepodetraaraumasriedeprojees(atualmenteSin,Aitoffeplaca

Carre).
AscoordenadasdeposiosoLongitudeeLatitude,especificadoemgraus.Aofornecerlos,vocpodeespecificarumassociadoSistema
SkyDados(Equatorial,Galactic,SupergalacticouEcliptic2000).Notesequeesteosistemacudascoordenadasdedados,no
(necessariamente)datramaquevocquerver.Paraespecificarascoordenadasquevocquerosdadosaseremplotadosem,utilizeoVerSky
SistemaoponaprojeoguiadoMachadoscontrole.Noentanto,sevocsquerverosdadosusandoomesmosistemaqueascoordenadas
quevocestfornecendo,vocpodeignorardeixaressesvalorescomoseudefault(tantoEquatorial)enenhumaconversoserfeita.
Vejaomapadevisogeralparaosrecursoscomunsatodasasjanelasdeplotagem.Assubseesseguintesdescrevemnavegaoe
configuraodeeixos.
Oenredocuofereceosseguintescontrolesdeenredo:
Posiocamadadecontrole,comessasopesdeforma:
Marca
Tamanho
Vetor
Elipse
RtuloTexto
Contorno
ControleParCamada,comosseguintescontrolesdeenredo:
Marcas
http://127.0.0.1:2525/doc/sun253/sun253.html

85/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Link
A.4.9.1SkyNavegao
Paracomentriosgeraissobreanavegaotrama,verApndiceA.4.2.1.Opesdeconfiguraoadicionaisestodisponveisnanavegao
guiadocontroleAxes.
Asopesdenavegaoparaestajanelaso:
Arrasteparaaesquerda
Pan.NaprojeoSin,estetentagiraraesfera,comonortepermanecerverticalnatela,detalformaqueamesmapartedocupermanece
sobaposiodocursor.Embaixasampliaesissosvezesnopossvelseomousesobreaesferacomeaeacabaforadelea
navegaoserirregular.
AsprojeesCareeAitoffeaplacaagircomoumpedaodepapelquepodemserarrastadosemduasdimensesdamaneirausual.
Roda
Zoom.Girandoarodadomouseparafrente/trsozoomin/outemtornodaposiodomouse.ParaestaprojeoSinissotambmvai
teroefeitoderotaodaesferaparamanterNorteverticalnatela.
Arrasteparaadireita(CTRLarrastar)
Zoom.Arrastandocomobotodireitodomouseupandright/downandlefttemapenasomesmoefeitodegirarobotodomousepara
afrente/trs.
Cliqueesquerdo
Selecione.Sehouverumpontotraadopertodocursor,eleirtraarummarcadorsobreeleeativarisso.
VoctambmpodenavegarparaumaposionocuconhecidoporcoordenadasounomedoobjetousandooFOVguiadocontroleAxes.
A.4.9.2SkyEixosdecontrole
OEixosdecontrole(

)paraajaneladocuterrenotemcincoguias.

GuiaProjeodocuEixosdecontrole
Aprojeoguiacontrolacomoascoordenadasdeposiodocusoprojetadasnatela.
Projeo
Selecionaaprojeodocudeusar.AsopessoSin,AitparaAitoffecarroparaPlacaCaree.Pecadorotativo,osoutrosdoisso
essencialmenteplanasprojeesallsky.
Refletireixolongitude
Determinaselongitudeaumentadaesquerdaparaadireitaoudadireitaparaaesquerda.
VerSkySistema
Determinaocusistemaemqueasposiesdedadosservistodecoordenadas.EsteinteragecomosistemaSkydedadosselecionado
noPosiesguiadocontroledacamadademesaparacoordenadasdedadospontosdedadosfornecidossoprojetadosapartirdo
sistemadedadosparaosistemadevisoantesdesertraado.Sevoctem(porexemplo)dedadosemequatorialcoordenadasquevoc
desejaveremcoordenadasgalcticas,emseguida,selecioneoSistemaSkydadoscomoEquatorialeaSkySistemaVercomoGalactic.
Seossistemasdedadosevisualizaosoasmesmas,nohproblemaemdeixartantocomoseuspadres,mesmoseelesnoesto
equatorialonicoefeitoqueosdadosescolhidosevisosistmicacutemapartirdatransformaoentreeles.

http://127.0.0.1:2525/doc/sun253/sun253.html

86/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiadenavegaodocuEixosdecontrole
Anavegaoguiacontroladetalhesdecomoanavegaofunciona.Eletemaseguinteopo:
FatordeZoom
Controlaofatorpeloqualcadaaodozoomampliaatrama.Movendoessecontroledeslizanteparaaesquerda/direitatornaomouse
mais/menossensvel(umclickwheelouarrastandoumadistnciafixatemmaismenosefeito/zoom).

CampodeVisoguiadocuEixosdecontrole
OFOVguia(campodeviso)permitequevocdigiteumaposiodocuouonomedoobjetoeumraioeposicionaopontodevistaemque
regio.PreenchendooscamposebaterEnviarvaireposicionaravisodocu,masnoviceversaoperaesdepan/zoomnormaisno
afetarocontedodestepainel.
Nomedoobjeto
SevocpreencherestecomonomedeumobjetocelesteebateuoResolveboto,umaconsultaSimbadirexecutarparapreencheras
RAedezembrocamposcomasuaposio.
RA/Dec
PosiesJ2000docentrocampoobrigatrio.Estesvalorespodemserpreenchidospelaresoluodenomesdeobjeto,conformedescrito
acima,oumo.
Raio
Doraiodocampodevisodesejado.
Claro
Limpaoscamposnestaaba.

GuiaGradedocuEixosdecontrole
Agradeguiacontrolacomoocueixoscoordenadosaparecer.
DesenheGrade
Seselecionado,aslinhasdegradeserosorteadosnatrama.
Fraosexagesimal
Secuselecionadocoordenarasanotaesdagradeseremformatosexagesimal,casocontrrio,emgrausdecimais.
GradeCor
Selecionaacorcomqueaslinhasdegradeserosorteados.
Etiquetacor
Selecionaacornaqualeixotextodortuloserescrito.
GradeCrowding
Useocontroledeslizanteparacontrolaraformacomoaslinhasdegradedepertoembaladosestonoseixos.
RtulodePosicionamento
Controlaseeondeasanotaesnumricasdaslon/lateixossocolocados.AopopadroAutonormalmentefazacoisasensata,mas
existemoutrasopesparaforarrotulageminternaouexternamenteregiodoenredo,oupararemoverrtulosnumricos
completamente.
Suavizao
Controlaselinhasetextodegradeserodesenhadasantialiased(suavizada)ouno.TextoAntialiasedgeralmenteparecemaisagradvel,
maspodeservisivelmentemaislento.Estaoponoafetaparcelasexportados.Nomomentodaescrita,Macsmuitasvezesexigemessa
oposelecionadacasocontrrio,aescritapodesairdoladoerrado.

http://127.0.0.1:2525/doc/sun253/sun253.html

87/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaFonte
OFontguiaconfiguraotipodeletrautilizadoparaanotaoeixo.Elatambmafetaalgumasoutrascoisascomoalenda.
SintaxeTexto
QuerusarasregrasdetextoouLaTeXsimplesdefazersentidoovalordetexto.
Tamanhodafonte
Tamanhodafonteempontos.
Estilodafonte
Estilodafonte.
Pesodafonte
Seafontesimples,negritoouitlico.

A.4.10Cubejaneladeplotagem

http://127.0.0.1:2525/doc/sun253/sun253.html

88/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaCubePlot
OLoteCube(

)traaposiescartesianasem3dimensesemumespaode3d.

AscoordenadasposicionaissoX,YeZ.Paracontrolaradireoelinear/dimensionamentologartmicadoseixos,consulteoCoordsguia
doMachadoscontrole.
Vejaomapadevisogeralparaosrecursoscomunsatodasasjanelasdeplotagem.Assubseesseguintesdescrevemnavegaoe
configuraodeeixos.
Oenredocuboofereceosseguintescontrolesdeenredo:
Posiocamadadecontrole,comessasopesdeforma:
Marca
Tamanho
Vetor
Barrasdeerro
Elipse
Linha
RtuloTexto
Contorno
ControleParCamada,comosseguintescontrolesdeenredo:
Marcas
Link
NotequeousodoAutoeDensidademodosdesombreamentopodeserconfusoem3dimensescomvriosconjuntosdedados.Istoporque
pixelscombasenadensidadeaolongodeumalinhadevisonoestlocalizadoemqualquerpontodessalinha,assimpixelssombreadosno
podeaparecernolugar"certo"noespao3d.Omesmoaplicaseaummenorgrau,comcontornos.Elestrabalhammuitobemcomumnico
conjuntodedadosembora.
A.4.10.1CubeNavigation
Paracomentriosgeraissobreanavegaotrama,verApndiceA.4.2.1.Opesdeconfiguraoadicionaisestodisponveisnanavegao
guiadocontroleAxes.
Navegaoemtrsdimensescomumatelaemousebidimensionalumpoucodeumdesafio.Noentanto,asaeslistadasabaixodevem
tornlobastantesimplesdenavegaremtornodospontosnoespao3Dparaaumentarozoomsobreasregiesquevocestinteressado
polegadas
Arrasteparaaesquerda
Girar.Giraavistacubosobreseucentro.
Roda
ZoomIsotrpico.Girandoarodadomouseparafrente/trsampliaoespaodocubovistain/outemtornodocentrodocubo.A
posiodomousenoafetlo.
Arrasteparaadireita(CTRLarrastar)
Zoomtrecho2d.Arrastandocomobotodireitofazumzoomtrechonasduasdimensesmelhoralinhadoscomoplanodatela.Noh
movimentonaterceira(principalmenteperpendiculartela)direco.Ozumbidoemtornodeumalinhadefinidapelaposiodorato
noinciodozoom,queapontaaolongodaterceiradimenso.Vocpodeesticar/squashemambosossentidos,arrastandoomousepara
cima/baixo/esquerda/direitamaisfcildoquetentarexpliclo.
Centrodearrasto(SHIFTarrastar)
Pan2d.Arrastandocomobotocentralgarimpaoespao3Dnasduasdimensesmelhoralighnedcomoplanodatela.Noh
movimentonaterceira(principalmenteperpendiculartela)direco.
Cliqueesquerdo
Selecione.Sehouverpontostraadospertodocursorvaiidentificarum,traarummarcadorsobreele,eactivarlo.
Em3D,nobvioqueopontomaisprximodeumcursor2d,jqueumaposiodatelarepresentaumalinhanoumponto.Para
quebraradegenerescncia,opontoutilizadoomaisprximodocentrodemassadepontostraadosaolongodalinhadeviso
representadoporaposiodocursor.Oresultadodissoque,sevocclicaremumpontoisolado,vocvaipegaresseponto,esevoc
clicaremumconjuntodenso,vocvaiterumpontoprximodocentro(demassa)dequecluster.
Botodireitodomouse(CTRL+clique)
Recentro.Clicandocomobotodireitodomouseidentificaumaposiodeumaformasemelhanteesquerda,cliqueemSelecionar
ao,e,emseguida,traduzatramademodoquepontoestnocentrodavisodocubo.Issosignificaque,aoclicaremumclustervai
colocaresseclusternocentrodocubo.Sevocclicaremumaregiovazia,ummeiocaminhoentreaposiodafrenteedetrsdocubo
emqueX/Yposioserusado.
VoctambmpodecorrigirmanualmenteoslimitesdoloteusandoaFaixadeguiadocontroleAxes.
http://127.0.0.1:2525/doc/sun253/sun253.html

89/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.4.10.2CubeEixosdecontrole
OEixosdecontrole(

)paraajaneladocuboenredotemseteabas.

AbaCoordsdocuboEixosdecontrole
OCoordsguiacontrolaascoordenadasdoseixos.Eletemasseguintesopes:
X/Y/ZLog
Seselecionado,ascoordenadasdoseixosX/Y/Zsologartmica,casocontrrio,elessolineares.
X/Y/ZVirar
Seselecionado,oeixoX/Y/Zeixoscoordenadosexecutadosnadireoopostaaonormal.

GuiadenavegaodocuboEixosdecontrole
Anavegaoguiacontroladetalhesdecomoanavegaofunciona.Eletemasseguintesopes:
ZoomMachados
Porpadro,oAutoconfiguraoestemvigor.Istosignificaquearodaderatozoomsemtornodocentrodocubo,eobotodireito
arrastoampliaasduasdimensesmaisestreitamentealinhadascomoplanodoecr,comaposioderefernciadefinidopelaposio
inicialdorato.SeAutodesactivado,entotodasasoperaesdezoomsoemtornodocentrodocubo,eafetaroseixosindicados
pelosX/Y/Zcaixasdeseleo.
FatordeZoom
Controlaofatorpeloqualcadaaodozoomampliaatrama.Movendoessecontroledeslizanteparaaesquerda/direitatornaomouse
mais/menossensvel(umclickwheelouarrastandoumadistnciafixatemmaismenosefeito/zoom).

GuiaIntervalodocuboEixosdecontrole
http://127.0.0.1:2525/doc/sun253/sun253.html

90/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

AFaixadeguiaforneceaconfiguraomanualdafaixavisveldoenredo.Fazeralteraesaesteguiairredefinirointervalodogrfico
visvel,masnoviceversazoomevisopanormicadaformausualnovaimudarasconfiguraesdestepainel.
Preenchendoosmnimos/mximoscamposparaumoumaiseixosvairestringirafaixacorrespondentedeosdadosvisveis.Oslimites
correspondentesaqualquerumdessescamposquesodeixadasembrancoseroinicialmentetrabalhadosapartirdosdados.Ossubrange
duplasdeslizantesrestringirosintervalosdentrodosintervalosdemin/max(explcitasouautomtico).Notequevocpodemoverosdois
controlesdeslizantesdeumasvez,agarrandoumaposioentreosdois.
OLimparbotoredefinetodososcampos.OEnviarbotoatualizaatramacomosvaloresatuaisnessaguia,assimcomodefazeralteraesa
ela.

VerguiadocuboEixosdecontrole
OVerguiapodeconfigurarcomoocuboquecontmosdadosvistonajaneladoenredo,emboraelenocontrolaocontedodocubo.
ArotaoemtornodoeixoZ
ExplicitamentedefineonguloderotaoemtornodoeixoZ,independentementedeseuvaloratual,quepodetersidodefinidopor
aesdomouse.
Rotaodavertical
Explicitamentedefineonguloderotaodavertical,independentementedeseuvaloratual,quepodetersidodefinidoporaesdo
mouse.
Fatordezoom
Defineaampliaodoprpriowireframecubo,semafetarovolumededadosqueelecontm.Istonopodeserfeitocomorato.
CompensarX/Y/Zdocentro
Controlesondenateladowireframecubocentrado.Istonopodeserfeitocomorato.

GuiaGradedocuboEixosdecontrole
Agrelhaguiaconfiguraoaparecimentodaarmaodearamecuboencerrandoovolumededados.
Desenhearmaodearame
Seocubodesenhadoenvolvendoatodos.
MenorCarrapatos
Sedefinido,menores(unlabelled)asmarcasdeescalaserosorteadosentreosprincipais(marcadas)queridos.
X/Y/ZTickCrowding
Useocontroledeslizanteparainfluenciarquantasmarcasdeescalasodesenharemcadaeixo.
Suavizao
Controlaselinhasetextodegradeserodesenhadasantialiased(suavizada)ouno.TextoAntialiasedgeralmenteparecemaisagradvel,
maspodeservisivelmentemaislento.Estaoponoafetaparcelasexportados.Nomomentodaescrita,Macsmuitasvezesexigemessa
oposelecionadacasocontrrio,aescritapodesairdoladoerrado.

http://127.0.0.1:2525/doc/sun253/sun253.html

91/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaEtiquetasdocuboEixosdecontrole
OLabelsguiacontrolaosrtulosdetextonoseixos.SeoAutoopofordefinida,otextoserlevadodeumdosdadoscoordenasendoque
seroplotadas.Parasubstituiraquelescomseusprpriosrtulosdoeixo,unsetAutoetipodetextoemqueasetiquetascampos.

GuiaFonte
OFontguiaconfiguraotipodeletrautilizadoparaanotaoeixo.Elatambmafetaalgumasoutrascoisascomoalenda.
SintaxeTexto
QuerusarasregrasdetextoouLaTeXsimplesdefazersentidoovalordetexto.
Tamanhodafonte
Tamanhodafonteempontos.
Estilodafonte
Estilodafonte.
Pesodafonte
Seafontesimples,negritoouitlico.

A.4.11Spherejaneladeplotagem

http://127.0.0.1:2525/doc/sun253/sun253.html

92/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaSpherePlot
OLoteSphere(

)traaascoordenadaspolaresesfricasemumaisotrpicaespao3dimensional.Emboraascoordenadasfornecidasso

esfricaspolar,oespaovisvelnoestnecessariamentecentradanaorigemdascoordenadas,eoseixossovisveiscartesiano.Emmuitos
aspectos,issofuncionacomoajanelaCubePlot
AscoordenadasdeposiosoLongitudeeLatitude(emgraus)eRadius.
Vejaomapadevisogeralparaosrecursoscomunsatodasasjanelasdeplotagem.Assubseesseguintesdescrevemnavegaoe
configuraodeeixos.
Aesferaloteofereceosseguintescontrolesdeenredo:
Posiocamadadecontrole,comessasopesdeforma:
Marca
Tamanho
RtuloTexto
Contorno
ControleParCamada,comosseguintescontrolesdeenredo:
Marcas
Link
NotequeousodoAutoeDensidademodosdesombreamentopodeserconfusoem3dimensescomvriosconjuntosdedados.Istoporque
pixelscombasenadensidadeaolongodeumalinhadevisonoestlocalizadoemqualquerpontodessalinha,assimpixelssombreadosno
podeaparecernolugar"certo"noespao3d.Omesmoaplicaseaummenorgrau,comcontornos.Elestrabalhammuitobemcomumnico
conjuntodedadosembora.
http://127.0.0.1:2525/doc/sun253/sun253.html

93/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.4.11.1NavigationSphere
Paracomentriosgeraissobreanavegaotrama,verApndiceA.4.2.1.Opesdeconfiguraoadicionaisestodisponveisnanavegao
guiadocontroleAxes.
Navegaoemtrsdimensescomumatelaemousebidimensionalumpoucodeumdesafio.Noentanto,asaeslistadasabaixodevem
tornlobastantesimplesdenavegaremtornodospontosnoespao3Dparaaumentarozoomsobreasregiesquevocestinteressado
polegadasAsaessobastantecomoparaajanelaCube,mastudoozoomisotrpico.
Arrasteparaaesquerda
Girar.Giraavistacubosobreseucentro.
Roda
Zoom.Girandoarodadomouseparafrente/trsampliaoespaodocubovistain/outemtornodocentrodocubo.Aposiodo
mousenoafetlo.
Arrasteparaadireita(CTRLarrastar)
Zoom.Zoomingupandright/downandleftfazexatamenteomesmoquegirararodadomouseparaafrente/trs.
Centrodearrasto(SHIFTarrastar)
Pan2d.Arrastandocomobotocentralgarimpaoespao3Dnasduasdimensesmelhoralighnedcomoplanodatela.Noh
movimentonaterceira(principalmenteperpendiculartela)direco.
Cliqueesquerdo
Selecione.Sehouverpontostraadospertodocursorvaiidentificarum,traarummarcadorsobreele,eactivarlo.
Em3D,nobvioqueopontomaisprximodeumcursor2d,jqueumaposiodatelarepresentaumalinhanoumponto.Para
quebraradegenerescncia,opontoutilizadoomaisprximodocentrodemassadepontostraadosaolongodalinhadeviso
representadoporaposiodocursor.Oresultadodissoque,sevocclicaremumpontoisolado,vocvaipegaresseponto,esevoc
clicaremumconjuntodenso,vocvaiterumpontoprximodocentro(demassa)dequecluster.
Botodireitodomouse(CTRL+clique)
Recentro.Clicandocomobotodireitodomouseidentificaumaposiodeumaformasemelhanteesquerda,cliqueemSelecionar
ao,e,emseguida,traduzatramademodoquepontoestnocentrodavisodocubo.Issosignificaque,aoclicaremumclustervai
colocaresseclusternocentrodocubo.Sevocclicaremumaregiovazia,ummeiocaminhoentreaposiodafrenteedetrsdocubo
emqueX/Yposioserusado.
VoctambmpodecorrigirmanualmenteoslimitesdoloteusandoaFaixadeguiadocontroleAxes.
A.4.11.2SphereEixosdecontrole
OEixosdecontrole(

)paraajaneladeesferaterrenotemcincoguias.

Anavegaoguiacontroladetalhesdecomoanavegaofunciona.Eletemaseguinteopo:
FatordeZoom
Controlaofatorpeloqualcadaaodozoomampliaatrama.Movendoessecontroledeslizanteparaaesquerda/direitatornaomouse
mais/menossensvel(umclickwheelouarrastandoumadistnciafixatemmaismenosefeito/zoom).

GuiaIntervalodaesferaEixosdecontrole
AFaixadeguiaforneceaconfiguraomanualdointervalodedadosdatrama.Fazeralteraesaesteguiairredefinirointervalodogrfico
visvel,masnoviceversazoomevisopanormicadaformausualnovaimudarasconfiguraesdestepainel.Quaisquervaloresno
preenchidasserodeterminadosapartirdosdados.Oscamposso:
CubeBordaComprimento
http://127.0.0.1:2525/doc/sun253/sun253.html

94/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Especificaadimensoaolongodecadaladodocubovistaemunidadesdedados.
X/Y/ZCentro
Daposiodocentrodocubovistaemcoordenadasdedados.
OLimparbotoredefinetodososcampos.OEnviarbotoatualizaatramacomosvaloresatuaisnessaguia,assimcomodefazeralteraesa
ela.

VerguiadaesferaEixosdecontrole
OVerguiapodeconfigurarcomoocuboquecontmosdadosvistonajaneladoenredo,emboraelenocontrolaocontedodocubo.
ArotaoemtornodoeixoZ
ExplicitamentedefineonguloderotaoemtornodoeixoZ,independentementedeseuvaloratual,quepodetersidodefinidopor
aesdomouse.
Rotaodavertical
Explicitamentedefineonguloderotaodavertical,independentementedeseuvaloratual,quepodetersidodefinidoporaesdo
mouse.
Fatordezoom
Defineaampliaodoprpriowireframecubo,semafetarovolumededadosqueelecontm.Istonopodeserfeitocomorato.
CompensarX/Ydocentro
Controlesondenateladowireframecubocentrado.Istonopodeserfeitocomorato.

GuiaGradedaesferaEixosdecontrole
Agrelhaguiaconfiguraoaparecimentodaarmaodearamecuboencerrandoovolumededados.
Desenhearmaodearame
Seocubodesenhadoenvolvendoatodos.
MenorCarrapatos
Sedefinido,menores(unlabelled)asmarcasdeescalaserosorteadosentreosprincipais(marcadas)queridos.
AssinaleCrowding
Useocontroledeslizanteparainfluenciarquantasmarcasdeescalasodesenharnoseixos.
Suavizao
Controlaselinhasetextodegradeserodesenhadasantialiased(suavizada)ouno.TextoAntialiasedgeralmenteparecemaisagradvel,
maspodeservisivelmentemaislento.Estaoponoafetaparcelasexportados.Nomomentodaescrita,Macsmuitasvezesexigemessa
oposelecionadacasocontrrio,aescritapodesairdoladoerrado.

GuiaFonte
OFontguiaconfiguraotipodeletrautilizadoparaanotaoeixo.Elatambmafetaalgumasoutrascoisascomoalenda.
SintaxeTexto
http://127.0.0.1:2525/doc/sun253/sun253.html

95/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

QuerusarasregrasdetextoouLaTeXsimplesdefazersentidoovalordetexto.
Tamanhodafonte
Tamanhodafonteempontos.
Estilodafonte
Estilodafonte.
Pesodafonte
Seafontesimples,negritoouitlico.

JanelaLoteA.4.12Tempo
Estajanelaenredoexperimental.Comoimplementadoatualmenteelanotemalgumascaractersticasimportantes.Podesermelhoradoou
retiradoemumaversofutura.

OLoteTempo(

)destinaseaplotagemdedadosdesriestemporais.

Oeixohorizontalrepresentaotempo,epodeserindicado,eajanelapodeapresentarfunesdotempo,grficosdedispersoe
espectrogramas.Emfuturasverses,podesercapazdetraarvriosgrficosdesriestemporaisempilhadosverticalmenteusandoomesmo
eixohorizontal,masnomomentoelenofazisso.
Vejaomapadevisogeralparaosrecursoscomunsatodasasjanelasdeplotagem.Assubseesseguintesdescrevemnavegaoe
configuraodeeixos.
OenredoTimeofereceosseguintescontrolesdeenredo:
Posiocamadadecontrole,comessasopesdeforma:
Linha
http://127.0.0.1:2525/doc/sun253/sun253.html

96/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Marca
Barrasdeerro(barrasverticaisapenas)
RtuloTexto
ControleCamadaSpectrogram
ControlodafunoCamada
A.4.12.1Tempodenavegao
Paracomentriosgeraissobreanavegaotrama,verApndiceA.4.2.1.Opesdeconfiguraoadicionaisestodisponveisnanavegao
guiadocontroleAxes.
Asaesdenavegaoparaestajanelaso:
Arrasteparaaesquerda
Pan.Nocorpodoenredoissogeralmentemoveemtornodeesquerda/direita.Porpadro,omovimentoverticalinibida,poisvoc
normalmentenoquerissoparaumlotetempo.Paradeslocarverticalmente,arrasteesquerdadoeixoY.Tambmpossvelconfigurar
panormicasobreocorpodoenredoaseremambasasdireesusandooMachadosPan/ZoomnaNavegaoguiaconfiguraode
eixos.
Arrasteparaadireita(CTRLarrastar)
Zoomestiramento.Nocorpodoenredoissogeralmenteseestende/polpasatramacentradanaposiohorizontaldomouse.Porpadro,
ozoomverticalinibida,poisvocnormalmentenoquerissoparaumlotetempo.Paraampliarverticalmente,arrastesobreaesquerda
doeixoY.TambmpossvelconfigurarozoomnocorpodatramaseremambasasdireesusandooMachadosPan/Zoomna
Navegaoguiaconfiguraodeeixos.
Roda
Zoom.Girandoafrentedarodadomouse/paratrsozoomin/outemtornodaposiodomouse,assimcomoarrastarcomoboto
direitoparacimaeparaadireitaouparabaixoeparaaesquerda.
Cliqueesquerdo
Selecione.Sehouverumpontotraadopertodocursor,eleirtraarummarcadorsobreeleeativarisso.
VoctambmpodecorrigirmanualmenteoslimitesdoloteusandoaFaixadeguiadocontroleAxes.
A.4.12.2TempoEixosdecontrole
OMachados(

)paraajanelatramaotempotemseisguias.

AbaCoordsdetempoEixosdecontrole
OCoordsguiacontrolaascoordenadasdeeixovertical(vocnopodevirarouredimensionaroeixodotempo).Eletemasseguintesopes:
YLog
Seselecionado,ascoordenadasdeeixoverticalsologartmica,casocontrrio,elessolineares.
VirarY
Seselecionado,eixoverticaleixoscoordenadosaumentarparabaixoemvezdeparacima.

GuiaNavegaodetempoEixosdecontrole
http://127.0.0.1:2525/doc/sun253/sun253.html

97/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Anavegaoguiacontroladetalhesdecomoanavegaofunciona.Eletemasseguintesopes:
Pan/ZoomMachados
Porpadro,arrastandocomomouseouusandoarodadomousenocorpodoenredovaipanouzoomno(time)direohorizontal,que
geralmenteoquevocquerparaumasrietemporal.Usandoestecontrolevocpodefazlofuncionarnosentidoverticaltambm.
FatordeZoom
Controlaofatorpeloqualcadaaodozoomampliaatrama.Movendoessecontroledeslizanteparaaesquerda/direitatornaomouse
mais/menossensvel(umclickwheelouarrastandoumadistnciafixatemmaismenosefeito/zoom).

GuiaIntervalodetempoEixosdecontrole
AFaixadeguiaforneceaconfiguraomanualdafaixavisveldoenredo.Fazeralteraesaesteguiairredefinirointervalodogrfico
visvel,masnoviceversazoomevisopanormicadaformausualnovaimudarasconfiguraesdestepainel.
Preenchendoosmnimos/mximoscamposparaumouambososeixosvairestringirafaixacorrespondentedeosdadosvisveis.Oslimites
correspondentesaqualquerumdessescamposquesodeixadasembrancoseroinicialmentetrabalhadosapartirdosdados.Ossubrange
duplasdeslizantesrestringirosintervalosdentrodosintervalosdemin/max(explcitasouautomtico).Notequevocpodemoverosdois
controlesdeslizantesdeumasvez,agarrandoumaposioentreosdois.Paraoeixodotempo,ointervalopodeserinseridocomoumvalor
dedata/horaISO8601.
OLimparbotoredefinetodososcampos.OEnviarbotoatualizaatramacomosvaloresatuaisnessaguia,assimcomodefazeralteraesa
ela.

GuiaGradedetempoEixosdecontrole
Agrelhaguiaconfiguraaaparnciadagradedoeixo.Eletemasseguintesopes:
FormatodaHora
Selecionaarepresentaodedata/horaemqueoeixohorizontalrotuladopara.AsopessoISO8601,anodecimal,Modificado
JulianDay,eUnix(segundosdesdemeianoitede01dejaneirode1970).
DesenheGrade
Seforverdade,aslinhasdegradeserosorteadosatravsdoenredoparacadamarcadeescala.
MenorCarrapatos
Sedefinido,menores(unlabelled)asmarcasdeescalaserosorteadosentreosprincipais(marcadas)queridos.
Tempo/YTickCrowding
Useocontroledeslizanteparainfluenciarquantasmarcasdeescalasodesenhadosemcadaeixo.
Suavizao
Controlaselinhasetextodegradeserodesenhadasantialiased(suavizada)ouno.TextoAntialiasedgeralmenteparecemaisagradvel,
maspodeservisivelmentemaislento.Estaoponoafetaparcelasexportados.Nomomentodaescrita,Macsmuitasvezesexigemessa
oposelecionadacasocontrrio,aescritapodesairdoladoerrado.

http://127.0.0.1:2525/doc/sun253/sun253.html

98/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

GuiaEtiquetasdetempoEixosdecontrole
OLabelsguiacontrolaortulodetextonoeixoY(eixohorizontalnorotulado).SeoAutoopofordefinida,otextoserlevadodeum
dosdadoscoordenasendoqueseroplotadas.Parasubstituirissocomoseuprprioselo,eixo,unsetAutoedigiteotextoparaortuloY
campo.

GuiaFonte
OFontguiaconfiguraotipodeletrautilizadoparaanotaoeixo.Elatambmafetaalgumasoutrascoisascomoalenda.
SintaxeTexto
QuerusarasregrasdetextoouLaTeXsimplesdefazersentidoovalordetexto.
Tamanhodafonte
Tamanhodafonteempontos.
Estilodafonte
Estilodafonte.
Pesodafonte
Seafontesimples,negritoouitlico.

A.5OldestilodeplotagemdoWindows
EstaseodescreveosplotagemjanelasdeestiloantigousadocomopadroemversesTOPCAT2e3.Desdeaverso4(2013),a
visualizaofoireescrito,eonovopadrodeplotagemjanelasestodescritosnoAnexoA.4.Asjanelasdescritasnestaseoso
ligeiramenteobsoleto,enovaisermaisdesenvolvido.Amaioriadeseusrecursossotratadosmelhor,asjanelasdeplotagemdeestilonovo.
Noentanto,taispessoasaindasofuncionaisesevocquiseruslos,vocpodeencontrlosnogrficodemenudajaneladecontrole,
abaixodasopesdeenredodonovoestilo.
Caractersticascomunsdasjanelasdeplotagemdeestiloantigosodescritosnaprimeirasubseoabaixoasprpriasjanelasespecficasesto
descritosnassubsecesseguintes.

A.5.1Caractersticascomuns
Osvriostiposdejanelasdeplotagemdeestiloantigotemcaractersticasdiferentesparacumprirassuasfunesdiferentes,maseles
compartilhamumaformacomumdefazerascoisas.Cadajanelacontmumnmerodecontroles,incluindobotesdabarradeferramentas,
itensdemenu,seletoresdecolunaeoutros.Emgeral,qualquermudanaquevocfazparaqualquerumdoscontrolesfarcomqueatrama
sejaredesenhadoparateremcontaessamudana.Seissoexigeumaleituraoureleituradosdados,umabarradeprogressonaparteinferiorda
janelapodemostrarestaprogredindoexcetoparatabelasmuitograndes,geralmentemuitorpido.
CadaumadasjanelasdegrficosexibidoclicandonoitemdemenunoGrficosdemenudajaneladecontrole.Seumadastabelasnalista
selecionadonomomento(atabelaatual),anovajaneladeplotagemserinicialmenteexibidomostrandoosdadosdealgumasdesuascolunas
(geralmentenasprimeirascolunasnumricas)attulodeilustrao.Normalmentevocvaiquerermudaroscontrolesparaqueeleexibeas
quantidadesquevocestinteressadopolegadas
Assubseesseguintesdescrevemalgumasdascaractersticasquefuncionamdamesmaparaamaioriaoutodasasjanelasdegrficosdeestilo
antigo.
A.5.1.1DatasetSeletores
http://127.0.0.1:2525/doc/sun253/sun253.html

99/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Todasasjanelasdegrficosdeestiloantigofornecerumoumaiseixosnoqualtraar.Histogramatem1,osdedispersoedensidadeparcelas
2dtem2,ogrficodedisperso3Dtem3eoenredoesfricatem2ou3Emcadacasovocselecionarumoumaisconjuntodedadospara
traarsobreesseseixos,eselecionaroqueestilodeplotagemparausaremcadaset.Umconjuntodedadostipicamenteumnmerode
colunasdeumatabela(onmerocorrespondenteadimensionalidadedoenredo)eumaseleodesubconjuntosdelinhaassociadosaessa
tabela.Vocselecionaestaeoestilo(s)plotagemusandoopainelnaparteinferiordecadajaneladeplotagem.Aquiestseletorconjuntode
dadosparaogrficodedisperso2D:

Seletordeconjuntodedadospadroapartirdajaneladedisperso2d
Asdiferentespartesdotrabalhodecontroledaseguintemaneira:
Paineldedados
ATabelaseletordoidentificadordatabela(umdosmaiscarregadosnoTOPCAT)queosdadosvem.
AsEixoseletores(aquiXEixoeYAxis)doasquantidadesaseremdesenhados.Sevocclicarnapequenasetaparabaixodireitade
cadaseletordeobterumalistadetodasascolunasnumricasdatabelaescolhido,apartirdoqualvocpodeselecionarum.Sevoc
clicarnopoucosetasdireitaeesquerdaparaadireitadoseletorquevaipercorrertodasascolunasnatabela.Noentanto,sepreferir,voc
podedigitarumaexpressoparausaraqui.Estepodesermaisconvenientesehumalongalistadecolunas(outramaneiradelidarcom
issoparaesconderamaioriadascolunasusandooJanelaColuna).Noentanto,oquevocdigitarnotemqueserumnomedecoluna,
podeserumaexpressoalgbricabaseadoemcolunasnatabela,ouatmesmoumaconstante.Noexemplo,oeixoXonomeda
colunarecta,eoeixoYrepresentaaexpresso.AsintaxedalinguagemdeexpressoexplicadonaSeo7.
ALogcaixadeseleoparacadaeixousadoparaselecionarseaescaladeveserlogartmicaoulinear.
Oflipcheckboxparacadaeixousadoparaselecionarseosvaloresdoeixoaumentarnosentidoconvencional(esquerdaparaadireita,
debaixoparacima)ouoseuoposto.
Algunsdosbotesnabarradeferramentasmostradairmodificaroquevisvelnestepainel,porexemploainserodenovosseletores
parapermitiraseleodevaloresdeerro.Todososseletoresdetrabalhardamesmaformanoentanto.
PainelSubconjuntosRow
Istodefinequesubconjuntosdelinhaparaseroplotadosnestajanela,eestilodeplotagemquedeveserusadoporeles.Nestecasoh
trssubgruposdefinidos,All,galxiaeestrela.Ascaixasdeseleoesquerdaindicamquaisseroexibidosaqui,apenasosdois
ltimos.Conjuntosdepontosgeralmentesoplotadosnaordememquesoselecionadosparavisualizaodesdepontosplotados
depoispodeobscurecerostraadosantes("embaixo")issofazadiferena.Sevocquiserverumconjuntodepontossemqueseja
obscurecidaporoutrosnatrama,entodesmarclaeselecionlanovamentenovamente(clicandoduasvezesnacaixacorrespondente),
eissoirgarantirqueseuspontossoplotadosnotopo.
Osbotesdoladodireitodonomedecadasubconjuntomostramosmboloqueusadonatramaparaexibirosdadosdeque
subconjunto,nestecaso,umacruzvermelhaeumcrculoazul.Estessoselecionadosautomaticamentequandooprimeirosubconjunto
selecionadoparavisualizao(oconjuntoinicialestilopadrodependeprincipalmentedequantaslinhasexistemnatabelaselecionada
muitaslinhasdpequenospontos,dalgumasgrandes).Noentanto,voctemmuitaliberdadeparaconfiguraraformacomoeles
aparecem.Sevocclicarnobotocomosmbolosobreeleumdilogoirapareceroquelhepermiteselecionaracor,aforma,a
transparnciaeassimpordiante,bemcomooestilodebarradeerroseforocasoecoisascomoselinhasequipadasseroplotadospara
essesubconjunto.Asopesdisponveisvariamdeacordocomotipodetrama,esodescritosjuntamentecomasdiferentesjanelasde
grficosnasseguintessubsees.Ajaneladeestilopermanecevisvelatquevocrejeitlo,massevocclicaremumoutrodosbotes
nopaineldeSubconjuntosRowseucontedoseralteradoparapermitirquevocselecionevaloresparaosubconjuntocorrespondente.
Amaioriadasjanelasdevdeotmumestilodemarcadormenu.Issopermitequevocalteretodososestilosnatramadeumavezpara
sermembrosdeumconjuntouniforme,porexemplo,diferentespixelscoloridosouformasabertasnegros.Sevocselecionarumdeles
quevaisubstituirasseleesdeestiloexistente,maselespodemsereditadosindividualmentedepois.
DatasetBarradeFerramentas
Abarradeferramentasacimadopaineldedadosnafiguracontmbotesqueafetamoseletordeconjuntodedadosemsi.Osdois
primeirosbotesdeadicionareremoverconjuntosdedadosTabs(vejaabaixo)eestopresentesemtodasasparcelas.Osoutrositens
configurarseletoresopcionaisqueaparecemnoPaineldeDadososmostradosaquiestopreocupadoscomoauxiliarMachados,
rtulosdepontosebarrasdeerro,masnemtodosostiposdetramatmexatamenteosmesmos.
Tabs
Oexemplomostraduasguias:PrincipaiseAoatualmentevisvelA.Vocpodeselecionarumaguiaclicandoemseunome.Em
cadaguiavocselecionarumatabelaeumconjuntodecolunas/expresses,eseelesestotodospreenchidoscontribuirpontos(ou
bares,ouqualqueroutro)paraoenredo.Oconjuntodedadosprincipaldeterminaosvaloresiniciaisparaosrtulosdoeixo,masos
dadosvemigualmentedetodoseles.Osvaloresnumricosdascoordenadassotratadasdamesmaparatodososconjuntosdedados,
masseussignificadospodeserdiferente,porexemplo,umconjuntodedadospodeestartramandoVmagnitudecontraelipticidadee
outroBmagnitudeconspirandocontraelipticidade.
http://127.0.0.1:2525/doc/sun253/sun253.html

100/208

21/4/2014

OsAddDataSet(

TOPCAT - Ferramenta para operaes em catlogos e tabelas

)eremoverDataset(

)botesnabarradeferramentasadicionarumanovaguiaouremoveroselecionado,

respectivamente.InicialmenteapenasoguiaPrincipalestpresente,eestenopodeserremovido.
svezes(parcelashighdimensionais,eixosauxiliares,barrasdeerro)umasriedeinformaesprecisaserinseridonopaineldedados,ena
parteinferiordajanelapodeficarmuitogrande.Normalmente,aparceladapartesuperiordajaneladiminuiparaacomodlo.Pode,claro,
redimensionarajanelaparaganharmaisespao,massesuatelapequenavocaindapodeacabarcomumaincmodapequenaparcela.Se
issoacontecer,vocpodeusaroseguintebotonabarradeferramentasprincipal:
Rachadodajanela
Quandoestebotodealternnciaestligada,oseletordeconjuntodedadospodeserredimensionadaarrastandoabarraentreeleea
tramaemsiparacimaouparabaixo.Senohouverespaosuficienteparatodososcomponentesdoseletor,umabarraderolagem
aparecer.Quandoestdesligado(opadro),aalturatotaldoseletorservisvel,eoenredovaiencolherparaacomodlo.
A.5.1.2AxisConfigurationandZooming
Emtermosgerais,oseixosemqueosgrficossoplotadossodefinidospelosconjuntosdedadosquevocselecionou.Osrtulosdoeixoso
definidosapartirdosnomesouexpressesescolhidasparaacolunaprincipaldoconjuntodedados,eosintervalossodeterminadosdemodo
aquetodososdadosapartirdosconjuntosdedadosescolhidospodeservisto.Noentanto,estascoisaspodemserajustadasmanualmente.
Osseguintesrecursosestodisponveisdirectamenteapartirdajaneladeconfiguraodeintervalodoeixo:
XYZoom
Emalgumasdasjanelas(2dgrficodedisperso,histogramaemapadedensidade),vocpodealterarambasasgamasdeeixopor
zoominououtcomomousenaprpriasuperfciedatrama.Paraaumentarozoom,coloqueomousenocantosuperioresquerdoda
regioquevocdesejaexaminar,pressioneoboto,arrasteoparaocantoinferiordireito,esolteoboto.Paradiminuirozoom,arraste
paracimaedeixouemseulugar.Acaixadesenhadamedidaquearrastaparaquevocpossaveroquevocestfazendo.
CentroZoom
As3deesfricasparcelaspermitemampliarapartecentraldajanela.A"regioativa'paraarrastarestesquerdaoudireitadoenredo
(aregiodireitabastantefino,enoincluialargurautilizadapelalegenda).Quandooponteiroestivernessasregies,osmbolodo
cursordomousedeveseralteradoparaindicarqueozoompodeserfeito.Arrasteparabaixoparaaumentareatdiminuirozoom.
Umaalternativamaisfcilparafazerzoomnasjanelas3Dusararodadomouse,sevoctemum:rodaparaafrenteparaaumentaro
zoomeparatrsparadiminuirozoom.
AxisZoom
Emalgumasdasjanelas(2dtramadedisperso,histograma,mapadedensidade,linhasempilhadas),vocpodemodificarointervalo
emcadaeixoindependentementearrastandoomousesobreolocalondeoeixodesenhado.A"regioativa'paraarrastarapenas
abaixodoeixoXelogoesquerdadoeixoY,naregioondeasetiquetasnumricasedetextosoescritas.Quandooponteiroestiver
emumadessasregies,osmbolodocursordomousedeveseralteradoparaindicarqueozoompodeserfeito.QuantoaoZoomXY,
arrasteparaaesquerdaparaadireitaouparacimaparabaixoparaampliaredadireitaparaaesquerdaouparabaixoseparadiminuiro
zoom.
Auxiliar(cor)AxisZoom
AoauxiliarMachadosestoemuso,vocpodeampliareforadeles,arrastandoparacimaeparabaixonabarradecoresdireitada
trama,damesmaformaqueparaumeixoZoomacimadonormal.
Redimensionar
Sevocacharquevocestampliadaparaaregioemquevocnoquerestardentro,vocpodeusarobotodabarradeferramentas
Rescalepararetornarescaladefault(coberturatotal).Observeissoafetaquaisquereixosauxiliares,bemcomoosespaciais.Algumas
janelaspodemterbotesRescaleporeixotambm( , ).
Paraobtermaiscontrolesobreaescaladeeixoerotulagem,useoConfigureAxeseTtulo(

botodabarradeferramentas),queir

aparecerumdilogocomooseguinte:

Dilogodeconfiguraodeeixoparaeixos2D
http://127.0.0.1:2525/doc/sun253/sun253.html

101/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Vocpodepreencheressesvaloresparacadaeixodaseguinteforma:
Etiqueta
Paracadaeixocaixadertulocontmotextousadoparaanotaroeixonatrama.Porpadro,esseomesmoqueotextonoprincipal
seletordecolunadoconjuntodedados(normalmenteumnomedecoluna),seguidopelasunidadesseconhecido.Noentanto,vocpode
alterlodigitandoqualquertextoquevocquiser.
Alcance
Ascaixasdealcancepermitemespecificaroslimitesinferioresuperiordecadaeixo.Porpadroestessoembranco,oquesignificaque
oenredovaidimensionarseuseixosdemodoquetodososdadospodemservistos.Noentanto,sevocpreencherumaouambasas
caixascomumvalornumricoadequado,menor/limitesuperiorsercorrigidoparaisso.Notesequeo(acaixaesquerda)limiteinferior
devesernumericamenteinferioraolimite(caixadireita)superior.
Ambososvaloressoreajustadosseoeixodatramaalterado(umanovacolunaouexpressoselecionadoparaoconjuntodedados
Principal),ouseointervalorepostodealgumaoutraforma(porexemplo,ozoom).
OttulotramatambmpodeserdefinidonoTtuloLotepaineldajanela:
Ttulo
Qualquertextoinseridoaquiserexibidonapartesuperiordatramaparafornecerumttulo.
BaresA5.1.3erro
TOPCATpermitearepresentaogrficabastanteflexveldeerrossimtricasouassimtricasem1,2e3dimenses.Asparcelascomapoio
barradeerrosoa2D,3Deesfricasgrficosdedispersoelinhasdeenredoempilhados.
Porpadro,odesenhobarradeerrodesligado.Amaneiramaissimplesparaativlousarobotodabarradeerrorelevante(s)nabarrade
ferramentasdoseletordedados(aqueleabaixodaparcela).Paraoscartesianos(2D,3Delinhas)parcelas,algunsoutodososseguintesbotes
estopresentes:
Xerrossimtricos
ErrossimtricosY
ErrossimtricosZ
Qualquercombinaodosdoispodeestarativoaomesmotempo.Clicandoemumdessesbotesalternasimtricabarradeerrodedesenho
paraesseeixoligadooudesligado.Quandoligado,umseletordecolunaadicionalaparecerdireitadoseletordecolunaprincipalparao
eixoemquesto.Sevocpreencherestecomumnomedecolunaouexpressoquedoerrodesseeixo,emseguida,asbarrasdeerrosero
plotados.TOPCATpodefazerumaestimativacombaseemnomesdecolunaeUCDssobreascolunasquefornecemvaloresdeerroparaque
outrascolunas,demodoqueoseletordeerropodesepreenchidosautomaticamente.Noentanto,namaioriadoscasos,vocterdeforneceros
valoresdeerroaoselecionarumacolunadesimesmo,e,ocasionalmente,podesernecessriocorrigirpalpitesdeTOPCAT.
Aquiumgrfico2DnaqualsimtricaXeYerrosassimtricosestosendousados:

http://127.0.0.1:2525/doc/sun253/sun253.html

102/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaTerrenocomXsimtricaseassimtricaserrosY
Vocpodeverquecomoseletordecolunadeerro,opaineltornousedemasiadograndeparaajanelaparaumabarraderolagemtem
aparecidonaparteinferiorpodedeslocarseestaesquerdaedireitaouampliarajanelaparaveraspeasquevocprecisa.
Paraoenredoesfricoosseguintesbotesdealternnciadeerroestopresentes:
errosisotrpicostangenciais
errossimtricosradiais
Estesfuncionamdemodosemelhanteaoserorscartesianasacima,excetoqueaumatangenteadicionaumselectornicodecoluna,comum
selectordaunidadeassociada,pertodascoordenadasdelatitudeelongitudeselectoresparadeterminarotamanhoangularisotrpicadeerros
pequenoscrculos.
Sevocquiserusarassimtricaserrosouunilaterais,useasopesdaerrosdomenuemvezdosbotesdabarradeferramentas.Porexemplo,
asopesdebarrasdeerrodoeixoXnogrficodedisperso2Dso:
Nenhum
Simtrico
MenorS
SuperiorS
Menoresuperior
Estesdolhediferentescaixasseletorascoluna,masfuncionadamesmamaneiraqueassimtricas.
Hmuitasopesparaoestilodeplotagemdeum,doisetrsbarrasdeerrosdimensionais,incluindoseladasenoniveladasbares,mira,
http://127.0.0.1:2525/doc/sun253/sun253.html

103/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

elipseseretngulos.EsteestilodeplotagemcontroladoapartirdajaneladoenredoStyleEditorjanela(ver,porexemploApndiceA.5.3.1),
quepodeservisualizadaclicandonoconedomarcadornopaineldeSubconjuntosdelinhanaparteinferiordireitadajanela.Osestilosde
barradeerrodisponveisdependeroquaisoseixosqueatualmentetemerrosSenenhumfizerisso,entooseletorbarradeerroser
desativado.Voctambmpodeusaroestilodeerrodemenusparaalteraroestilodeerroparatodososconjuntosdedadosvisveisaomesmo
tempo.
EtiquetasA.5.1.4Ponto
Em2De3Dgrficosdedisperso,vocpodeescreverumtextortulosadjacentesaospontosplotados.Parafazerissocliquenosrtulos
Desenhar(
boto)nabarradeferramentasdoconjuntodedados(abaixodareadeplotagemnajaneladoenredo).Istoirrevelarumnovo
EtiquetasPontoseletorabaixodosespaciaisexistentes.Usandoisso,vocpodeselecionarqualquerumadascolunasdatabela(noapenasos
numricoscomoparaosoutrosseletores),oudarumastringouexpressonumricaenvolvendoos.Quandoesteseletorpreenchido,todosos
pontosdoconjuntodedadosquetemumvalordiferentedeespaoembrancoparaessaquantidadevaitloescritoaoladodopontonatela.

PontodeRotulagemparaMessierobjetosnatramaesfrica
Nesteexemplo,acolunaNAMEfoiseleccionada,demodoquecadapontorepresentado(nestecaso,todososobjectosMessier)estmarcado
comoseunome.Comovocpodever,ondemuitosrtulossoplotadosprximosumdooutroquepodeentraremmododecadaum.Em
algunscasosTOPCATomitirrtulosplotagememregiespopulosas,emoutrosno,mas,emqualquercaso,sevoctemrtuloscommuita
foraagrupadoselesnososusceptveisdeserlegvel.
A.5.1.5AuxiliarMachados
TOPCATpodeplotarosdadosemuma,duasoutrsdimensesespaciais,massvezesoqueosdadosquevocprecisaparavisualizarde
maiordimensionalidade.Paraisso,algumasdasjanelasdeplotagem(2De3Dgrficosdedisperso)permitemcontrolaracoloraodospontos
traadosdeacordocomosvaloresdeumaoumaiscolunas(ouexpressescalculados),quelhedmaisinformaovisualsobreosdadosque
vocestoexaminando.
Parausaresterecurso,cliquenoeixoauxiliarAdicionar(
http://127.0.0.1:2525/doc/sun253/sun253.html

boto)nabarradeferramentasdoconjuntodedados(abaixodareade
104/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

plotagememumajaneladeplotagem).Umnovoseletoreixoaparecerabaixoosespaciaisjexistentes,rotuladoAux1Eixo.Eletemregistro
evirarcaixascomooseixosespaciaiseparaadireita(vocpodeprecisardealargarajanelaouusarabarraderolagemnaparteinferiorpara
vlo)umseletorrepresentandoumnmerodecolourmapsparaescolheropadrolembrandoumarcorisgeralmentebastanteadequado,
masvocpodeescolheroutros.Sevocdigitarumnomedecolunaouexpressonoselector,cadapontotraadosercoloridodeacordocomo
valordessaquantidadenalinhacorrespondentededados.Seessaquantidadenuloparaumalinha,opontocorrespondentenosero
plotados.Aescaladireitadatramaindicacomoomapadecorescorrespondeavaloresnumricos.Pararemoveroeixoauxiliarevoltaraos
pontos,normalmentedecor,bastaclicarnoRemovereixoauxiliar( boto).

Plot3DdedadosdesimulaomostrandoX,Y,Zposioespacialcomoeixoauxiliarindicandoiterao.
Existemdoistiposdemapasdecoresquevocpodeescolher:afixaodacorecormodificando.Osfixaosomaisfceisdeentender:a
cororiginaldoponto(comodesenhadonalegenda)ignorado,ecoloridodeacordocomovalorrelevantenoeixoauxiliarselecionado.Os
mapascormodificadorastiraracororiginaleafetlodealgumaforma,porexemplo,alterandoasuatransparnciaouasuacomponenteazul.
Estasestomarcadascomumasterisco("*")noselectordemapadecor.Elespodemserusados
paratransmitirmaisinformaes,massomais

difceisdeinterpretarvisualmenteparaumacoisaqueosombreamentodabarradecoresnalegendanocorresponderexactamentescores
dospontostraados.
Usandomodificandocormapaspossvelexecutarlotescommaisdeumeixoauxiliarnormalmente,oprimeiroserummapadefixaoeos
subsequentesseromodificando.Assim,oprimeiroeixoauxiliarpodeteromapa(fixa)doarcoris,eosegundopodetero(modificando)
Transparnciamapa.Asalteraesdecoressoaplicadasemordem.possvel,massemsentido,detervriosmapasdefixaoaplicadosaos
mesmospontosaltimadenmeroumvaideterminaracoreosanterioresvaiserignorado.Vrioseixosauxpodeserobtidoclicandono
Adicionarauxiliareixobotomaisdeumavez.Aocombinarvriosmapasalgumpensamentotemqueserdadoaquaisusaralgumasboas
combinaessoostrsRGBouostrsYUV.
Agamabastanteamplademapasdecoresdeambosostiposfornecidoporpadro.Seestesnoatenderemssuasnecessidades,possvel
http://127.0.0.1:2525/doc/sun253/sun253.html

105/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

fornecerosseusprpriosmapasdefixaocorpersonalizadausandoolut.filespropriedadedosistemavejaSeo10.2.3.
fcildegerarimagensatraentesusandoeixosauxiliares.Fazerosentidovisualdosresultadosumaquestodiferente.Umespecialistaem
visualizaotentoudissuadirsuaintroduoemTOPCAT,alegandoqueosgrficosqueelesproduzemsomuitodifceisparaosseres
humanosainterpretarEsperoqueestasparcelaspodemajudarcomalgumaanlise,masumacaractersticaumtantoexperimentalquepode
ounopodeacabarporseramplamentetil.Onmeromximodeeixosauxiliaresquepodemserutilizadosemconjuntoactualmentetrs.
Istopoderiaseraumentadaapedido,massevocsentequepodegerarumenredointeligvelusandomaisdoqueisso,entovocest
consideravelmentemaisinteligentedoqueeu.
A.5.1.6DefinioSubconjuntosporRegio
Quandoasquantidadessoplotadasemumadasjanelasdegrficostornasefcilveragrupamentosdedadosquenopoderiamseraparente
umconjuntode(x,y)pontosquerepresentamumgrupodelinhaspodecorresponderaumagrupamentofisicamentesignificativodeobjetos
quevocgostariadetratarseparadamenteemoutraspartesdoprograma,porexemplo,calcularestatsticasemapenasestaslinhas,escrevlos
paraumnovatabela,ouplotagemlosemumacordiferenteemgrficoscomcoordenadasdiferentes.Istofacilmenteconseguidoatravsda
criaodeumnovosubconjuntoRowcontendoospontosagrupados,easjanelasdegrficosfornecemmaneirasdefazerisso.
Emalgumasdasparcelas(HistogramaScatter2denredomapadedensidadeedeenredoSpherical)vocpodedefinirosintervalosdoseixos
(manualmenteouporzoomcomomouseverApndiceA.5.1.2),demodoquesomenteospontosquevocqueridentificarsovisvel,e,em
seguida,cliquenoNewsubconjuntodevisvelbotodabarradeferramentas(ocone
, ou dependendodotipodegrfico).Isto
defineumsubconjuntocompostoportodosospontosquesovisveisnoloteatual.Istostilseogrupoestiverinteressadoemcorresponde
aumaregioretangularnoespaodeplotagem.
UmamaneiramaisflexveldesenharumaoumaisregiesnogrficoqueidentificamospontosquevocestinteressadopolegadasParafazer
isso,bateuosorteiosubconjuntoRegio( botodabarradeferramentas).Tendofeitoisso,vocpodearrastaromousesobreoenredo
(mantenhaobotoesquerdodomousepressionadoenquantovocsemove)paracercarospontosquevocestinteressadopolegadasAo
fazlo,umamanchacinzatranslcidoserdeixadoparatrsnadadentrodoblobvaiacabarnosubconjunto.possveldesenharumaou
muitasbolhas,quepodemsersobrepostosouno.Sevoccometerumerroaodesenharumaseqnciadebolhas,vocpodeclicaroboto
direitodomouse,eoblobadicionadomaisrecentementedesaparecer.Quandovocestnestemododedesenhoderegio,vocnopode
ampliarouredimensionarajanelaoualterarascaractersticasdatrama,eosubconjuntoRegioSorteiobotoaparececomumamarcasobre
ele( )paralembrloquevocestnele.Aquiestoqueoenredoseparecequandovocestdesenhando:

ModoRegioDesenho
Quandoestiversatisfeitocomaregioquevocdefiniu,cliqueno
http://127.0.0.1:2525/doc/sun253/sun253.html

botodabarradeferramentasnovamente.
106/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Emambososcasos,quandovocindicouquepretendedefinirumnovosubconjuntolinha,umacaixadedilogoiraparecerparapedirlheo
seunome.ConformedescritonaSeo3.1.1,umaboaidiausarumnomequeapenascompostadeletras,nmerosesublinhados.
Opcionalmente,possvelselecionarumnomedesubconjuntoquetenhasidousadoantesdalista,queirsubstituirosantigoscontedodesse
subconjunto.QuandovocdigitaumnomeeaperteoOKboto,onovosubconjuntosercriadoeospontosemqueseromostradas
imediatamentenogrficousandoumnovosmbolo.Comodecostume,vocpodedefinirseospontosnestesubconjuntosoexibidosusandoo
SubconjuntosRowcaixanaparteinferiordajanelaPlot.
A.5.1.7ExportadoresGrficos
Todasasjanelasdegrficosdeestiloantigotemasseguintesopesdeexportaonabarradeferramentas:
ExportarcomoPDF
ExportarcomoGIF
e,adicionalmente,oExportmenucontm:
ExportarcomoEncapsulatedPostScript
ExportarcomoGzippedEncapsulatedPostScript
ExportarcomoJPEG
ExportarcomoPNG
Estespodemserusados
paraexportaroenredoatualmentedisponveisparaumformatogrficoexternoparausoposterior.

Exportandoparaosformatosbaseadosempixels(GIF,JPEG,PNG)bastantesimples:cadapixelnatelaaparececomoumpixelnoarquivo
desada.PNGomaiscapaz,masnosuportadoportodososvisualizadoresdeimagens.GIFfuncionabemnamaioriadoscasos,masse
houvermaisde255coresumpoucodaresoluodecorserperdido.JPEGpodepreservarumaamplagamadecores,masnosuportaa
transparnciaelossy,topertoinspeodecaractersticasdaimagemirrevelarborrar.
AoexportarparaPortableDocumentFormat(PDF)ouEncapsulatedPostScript(EPS),quesoformatosgrficosvetoriais,halgumascoisasa
considerar:
Posicionalquantizao
Oarquivodesadairprocessartexto,linhasemarcadorescorretamente,combordaslisas,emvezdeetapasondeoslimitesdepixels
serianatela.Noentanto,aposioresoluoamesmaqueserianatela,porisso,sevoctemumaaltaparcelade400pixelspor
exemplo,existemapenas400coordenapossvelYnoqualummarcadorpodemserplotados.Emgeral,issonobvio,olhandoparaa
tramadesada,masvocpodeacharquetilparaaumentarotamanhodoenredonatela,redimensionandoajanelaantesderealizar
umaexportaodeEPS.Issoreduzoefeitodaquantizaoposicional,masnotequetambmteroefeitodetornarosrtulosdetexto
proporcionalmentemenorparaosgrficos.
Transparncia
PorrazestcnicasmarcadorestransparentesnopodemserfacilmenteprocessadoquandoumloteexportadoparaPostScript.Em
algunscasos,oenredofeitousandoumbitmapnasadaPostScriptparapermitirtransparnciae,emalgunscasos,ospontossoapenas
plotadosopaco.ExperimenteevejaseospontosdesairopacoemvezdetransparentepodesernecessrioexportarparaGIFemseu
lugar.Melhoressoluesalternativaspodemserfornecidosemversesfuturas.
Tamanho
Emalgunscasos(2Degrficosdedispersoem3Dcommuitosmilharesdepontos)arquivosEPSdesadapodeficarextremamente
grandeotamanhoproporcionalaonmerodepontosdesenhado,actualmente,comumfactordealgumascentenasdebytesporponto.
Emalgunscasos,vocpodetrabalharemvoltadestetraandoalgunspontoscomotransparente,demodoqueoenredorenderizado
comoumbitmap(vejaadiscussodetransparnciaacima),quedimensionacomoonmerodepixels,emvezdeonmerodepontos.O
formatoGzippedEPSajudaumpouco(emborapossaserlenta)SadaPDFmelhorainda.MesmoosarquivosPDFpodemser
unmanageablygrandeparamuitospontosnoentanto.

A.5.2Histograma(modaantiga)
Estaseodescreveumajaneladeplotagemdeestiloantigo.AsjanelasdeplotagempadrosodescritosnoApndiceA.4.

http://127.0.0.1:2525/doc/sun253/sun253.html

107/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaHistograma
Ajaneladehistogramapermitelhetraarhistogramasdeumaoumaiscolunasouquantidadesderivadas.Vocpodeexibilousandoo
histograma(
)itemnajaneladecontrole'sGrficosmenu.
Vocselecionaaquantidadeouquantidadesparatraarusandooseletordeconjuntodedadosnaparteinferiordajanela.Vocpodeconfigurar
oseixos,incluindozoomineout,comomouse(arrastarnoenredoouoseixos)oumanualmente,conformedescritonoApndiceA.5.1.2.
OBinPlacementcaixaabaixoosprincipaiscontrolesdoenredoondeasbarrassodesenhadas.Selecioneointervalohorizontaldecadabarra
usandooLarguracaixadeentradaoudigiteovalordesejadoouuseassetaspequenasparacima/baixodireitaparaaumentar/diminuiro
tamanhobin.Odeslocamentocaixanoladoesquerdodeterminamqueopontozeronoeixohorizontaldesceemrelaoaodascaixassea
caixaestivermarcada,entozero(ouumparaoeixoXlogartmica)estnocentrodeumacaixa,esefordesmarcada,entozero(ouuma)em
umlimitedebin.
Osseguintesbotesestodisponveisnabarradeferramentas:
Rachadodajanela
Permitequeoseletordeconjuntodedadosparaserredimensionadaarrastandoumseparadorentreeleeareadeplotagem.Bompara
telaspequenas.
Replot
Redesenhaoenredoatual.Normalmentenonecessriousaresteboto,umavezquesevocalterarqualquerumadascaractersticas
datramacomoscontrolesnestajanelaoenredovaiserredesenhadoautomaticamente.Noentanto,sevoctiveralteradoosdados,por
exemplo,aoeditarasclulasnajaneladedados,oenredonoredesenhadoautomaticamente(umavezqueeste,potencialmente,uma
operaocaraevocnopodeexigirisso).Aoclicarnestebotoredesenhaoenredotendoemcontatodasasalteraesaosdadosda
tabela.
ConfigureAxeseTtulo
Abreumdilogoparapermitiraconfiguraomanualdasfaixasdeeixo,rtulosdoseixosettulotramaverApndiceA.5.1.2.
ExportarcomoPDF
AbreumdilogoquevaiescreveratramaatualcomoumarquivoPDF.
ExportarcomoGIF
AbreumdilogoqueirimprimiroenredoatualparaumarquivoGIF.Oarquivodesadaomesmoqueaimagemplotadaquevoc
v.RedimensionarajaneladeplotagemantesdaexportaoparacontrolarotamanhodoGIFdesada.
Redimensionar
http://127.0.0.1:2525/doc/sun253/sun253.html

108/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Rescalesoseixos,demodoquealarguraealturasosuficientesparaacomodartodasasbarrasdezeronohistogramaparatodosos
conjuntosdedadosseleccionados.Porpadro,oenredovaiserescaladocomoesse,maselepodetermudadoporcausademudanasna
seleosubconjuntooudezoominouout.
RedimensionarX
Redimensionaoeixohorizontalparaacomodartodososbaresatualmenteplotados.Aescaladoeixovertical,noalterado.
RedimensionarY
Redimensionaoeixoverticalparaacomodartodososbaresatualmenteplotados.Aescaladoeixohorizontalnoalterado.
Grade
Defineseumagradedesenhadasobreasuperfciedatramaouno.
Mostrarlegenda
Defineseumalendamostrandocomocadaconjuntodedadosrepresentadovisveldireitadatrama.Inicialmente,alegenda
mostradasomentesehouvermaisdeumconjuntodedadosestsendomostradoaomesmotempo.
Lotecumulativa
Alternaseohistogramadevesernormaloucumulativa.Normalmente,aalturadecadabarradeterminadapelacontagemdonmerode
pontosquecaemnagamanoeixoX,queelecobre.Paraumlotecumulativo,aalturadeterminadaporcontagemdetodosospontos
entreinfinitonegativoeolimitesuperiordointervalonoeixoX,queelecobre.
Normalizao
Defineseoshistogramassonormalizados.Quandoseleccionado,cadaconjuntodedadosvaisernormalizadodemodoaqueasoma
dascontagensdetodasasbarrasaolongodetodaagamadedadosigualaum.
EntrareixoY
DefineseoeixoYescaladadeformalogartmicaouno.
Subconjuntodevisvel
DefineumnovosubconjuntoRowconsistindoapenasosdadosnosbaresquesovisveisnatramaatual.VejaApndiceA.5.1.6para
maisexplicaes.
Abarradeferramentasdoconjuntodedadoscontmasseguintesopes:
/

Adicionar/Removerdataset

Adiciona/removeabasemqueosdadosparaconjuntosdedadosadicionaispodemserinseridos.VejaApndiceA.5.1.1.
CountsPeso
Seestebotodealternnciaestligada,umadicionaldepesodoeixoseletorapareceabaixodoeixoXselector.Seestepreenchido
comumnomedecolunaoudeexpresso,emseguida,emvezdesimplesmenteacumularonmerodepontosporbin,oeixoYir
mostrarasomasobreaquantidadedeponderaoparaospontosemcadacompartimento.Noterumeixodepesoequivalentea
preencheroseuvalorcomaquantidadede1.Notesequecomopeso,afiguradesenhadanonumsentidoestritoumhistograma.
Quandoponderado,barespodemserdealturanegativa.UmaanomaliadatramacomoimplementadoatualmentequeoeixoYnunca
desceabaixodezero,demodoquequalquerumdessesbaresestoatualmenteinvisvel.Istopodeseralteradoemumaversofutura(em
contatocomoautorparavotarparaessaalterao).
OExportmenucontmasopesdeexportaodeimagemadicionaiseasseguintesopesespecficasparaohistograma:
SalvarcomoTabela
Ascontagensbin/montantescorrespondentesaohistogramaatualmentetraadosserogravadosemdiscoemformadetabela.Asduas
primeirascolunasdooslimitesinferioresuperiordecadacaixa,eascolunasposterioresdoasocupaesdecadabinparacada
conjuntodedadosplotados.Seapenasumconjuntodedadosplotado,haverapenastrscolunas.
ImportarcomoTabela
MontaumatabeladeacordocomoSalvaropoacima,masaoinvsdeescrevlosimportaesdediscolodiretamenteno
TOPCAT,ondeelepodesermanipuladodetodasasmaneirashabituais.
Voctemumaconsidervelliberdadeparaconfiguraraformacomoasbarrassodesenhadascontrolandoestedescritonasubseco
seguinte.
A.5.2.1HistogramaStyleEditor
Ascaixasemumhistogramapodeserrepresentadademuitasformasdiferentes.Umarepresentaodecomoumabarravaiserexibido
mostradoemumbotodireitadonomedecadasubconjuntovisvel,naparteinferiordireitadajaneladohistograma.Sevocclicarneste
botooseguintedilogoirapareceroquelhepermitealteraraaparncia.

http://127.0.0.1:2525/doc/sun253/sun253.html

109/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Dilogoeditordeestiloparaasbarrasdohistograma
ALendacaixadefinecomooconjuntoselecionadoseridentificadonalegendaqueapareceaoladodoenredo(emboraalendasservisvel
seMostrarlegenda(
)estligado):
cone
Exibeoconequesermostradoparaidentificarospontosnoconjuntoselecionado.Suaaparnciadependedasseleesquevocfazno
restodajaneladedilogo.
Etiqueta
Donomeescritonalegendaparaidentificarosubconjunto.Porpadro,estederivadodonomedosubconjuntoRowe,seissonofaz
partedoconjuntodedadosprincipal,onomedoguiadoconjuntodedados.Vocpodedigitarumnovovalorparamudaroqueest
escritonalegenda.
OcultarLegenda
Seestaopoforselecionada,nenhumaentradaparaoconjuntoselecionadoaparecernalegenda.
OBarraspaineldescreveaformadasbarrasaseremdesenhadosparacadaconjuntodedados.
Cor
Selecionaacorparaobaroualinhaqueirrepresentaresteconjunto.
FormulrioBar
Selecionaoestilodebar,queseroplotados.Osestilosdisponveissoretngulospreenchidos,retngulosabertos,pisoulinhasepicos.
ColocaoBar
SeleccionaondecadabarravaisercolocadosobreoeixoXnointeriordaregiodasordenadasquerepresenta.Atualmenteexistemduas
opes:Aolongosignificaqueabrangetodaasuagama,eadjacentesmeiosqueabrangeapenasumapartedesuaescala,demodoque
vriosconjuntosdedadosplotadosnomesmogrficonoobscurecemooutro(sedoisconjuntossoplotados,oprimeiroterametade
esquerdaeasegundaterametadedireitadecadaregiobin,eassimpordiante).Nocasoemqueexisteapenasumnicoconjuntode
dadosrepresentados,noimportadequaldelasescolhido.
Espessuradalinha
Determinaaespessuraempixelsdetodasaslinhasquesodesenhadas.SseaplicaparaaquelesFormulrioBarsqueusamlinhasem
vezdeblocosslidos.
Trao
Determinaoestilodetrao(slido,pontilhado,tracejadooupontilhadaponto)paratodasaslinhasquesodesenhadas.Sseaplicapara
aquelesFormulrioBarsqueusamlinhasemvezdeblocosslidos.
Todasasalteraesfeitasnestajanelasorefletidasnatramadeimediato.SevocclicarnoOKbotonaparteinferior,ajanelairdesaparecer
easmudanaspermanecem.SevocclicaremCancelarajanelairdesapareceretodasasalteraesfeitasserodescartadas.
Voctambmpodealterartodososestilosdeplotagemdeumasvez,usandooBarEstilodemenunajaneladohistograma.Aquivocpode
selecionarumgrupopadrodeestilos(porexemplo,todasasbarrasadjacentescheiascomcoresdiferentes)paraosconjuntosdetraados.

A.5.32DPlot(modaantiga)
Estaseodescreveumajaneladeplotagemdeestiloantigo.AsjanelasdeplotagempadrosodescritosnoApndiceA.4.

http://127.0.0.1:2525/doc/sun253/sun253.html

110/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaPlot
Ajaneladeplotagempermitefazergrficosdedisperso2dimensionaisdeumoumaisparesdecolunasdatabela(ouquantidadesderivadas).
VocpodeexibilousandooPlot( )itemnajaneladecontrole'sGrficosmenu.
Nasuperfcieaplotagemdeummarcadorplotadaparacadalinhanoconjuntodedadosselecionado(s)emumaposiodeterminadapelos
valoresdascolunasdatabelaselecionadasparafornecerosvaloresdeXeY.UmmarcadorsserotraadosseambososvaloresdeXeY
noestoembranco.Selecioneasquantidadesatramaeossmbolosdeplotagemcomoseletordeconjuntodedadosnaparteinferior.Voc
podeconfiguraroseixos,incluindozoomineout,comomouse(arrastarnoenredoouoseixos)oumanualmente,conformedescritono
ApndiceA.5.1.2.
Clicandoemqualquerumdospontostraadosirativarloverseo8.
Osseguintesbotesestodisponveisnabarradeferramentas:
Rachadodajanela
Permitequeoseletordeconjuntodedadosparaserredimensionadaarrastandoumseparadorentreeleeareadeplotagem.Bompara
telaspequenas.
Replot
Redesenhaoenredoatual.Normalmentenonecessriousaresteboto,umavezquesevocalterarqualquerumadascaractersticas
datramacomoscontrolesnestajanelaoenredovaiserredesenhadoautomaticamente.Noentanto,sevoctiveralteradoosdados,por
exemplo,aoeditarasclulasnajaneladedados,oenredonoredesenhadoautomaticamente(umavezqueeste,potencialmente,uma
operaocaraevocnopodeexigirisso).Aoclicarnestebotoredesenhaoenredotendoemcontatodasasalteraesaosdadosda
tabela.
ConfigureAxeseTtulo
Abreumdilogoparapermitiraconfiguraomanualdasfaixasdeeixo,rtulosdoseixosettulotramaverApndiceA.5.1.2.
ExportarcomoPDF
AbreumdilogoquevaiescreveratramaatualcomoumarquivoPDF.Emgeral,esteumfieledealtaqualidadederenderizaodo
queexibidonajaneladoenredo.Noentanto,seplotagemestsendofeitousandoosmarcadoresdetransparncia,osmarcadoressero
processados
comosefossemopacas.ParcelascommuitospontospoderesultarembastantegrandesPDFsdesada.

http://127.0.0.1:2525/doc/sun253/sun253.html

111/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ExportarcomoGIF
AbreumdilogoqueirimprimiroenredoatualparaumarquivoGIF.Oarquivodesadaomesmoqueaimagemplotadaquevoc
v.RedimensionarajaneladeplotagemantesdaexportaoparacontrolarotamanhodoGIFdesada.
Redimensionar
Redimensionaoseixosdoplanoatualparaqueelecontmtodosospontosdedadosemsubconjuntosselecionadosnomomento.Por
padro,oenredovaiserescaladocomoesse,maselepodetermudadoporcausademudanasnaseleosubconjuntooudezoominou
out.
Grade
Defineseumagradedesenhadasobreasuperfciedatramaouno.
Mostrarlegenda
Defineseumalendamostrandocomocadaconjuntodedadosrepresentadovisveldireitadatrama.Inicialmente,alegenda
mostradasomentesehouvermaisdeumconjuntodedadosestsendomostradoaomesmotempo.
DesenhesubconjuntoRegio
PermitequevocdesenheumaregionateladefinindoumnovosubconjuntoRow.Quandovocterminardedesenhlo,clique
novamentenestebotoparaindicarquevocestfeito.VejaApndiceA.5.1.6paramaisdetalhes.
Subconjuntodevisvel
DefineumnovosubconjuntoRowconsistindoapenasospontosqueestoatualmentedisponveisnasuperfciedatrama.Veja
ApndiceA.5.1.6paramaisexplicaes.
Abarradeferramentasdoconjuntodedadoscontmasseguintesopes:
/
/

Adicionar/Removerdataset
Adiciona/removeabasemqueosdadosparaconjuntosdedadosadicionaispodemserinseridos.VejaApndiceA.5.1.1.
Adicionar/Removereixoauxiliar

Adiciona/removeumseletorparaaentradadeumeixoauxiliarparamodificarascoresdepontoetcSeeApndiceA.5.1.5.
RotulagempontoAlternar
/

Permitequeosrtulosdetextoaserdesenhadoprximopontostraados.VejaApndiceA.5.1.4.
barrasdeerroAlternarX/Y
AlternaentredesenhobarrasdeerrossimtricosesembarrasdeerronasdireesXeY,respectivamente.Outrasopesesto
disponveisnoErrosmenu.VejaApndiceA5.1.3.

Voctemumaconsidervelliberdadeparaconfiguraraformacomoospontossoplotadosincluindoaforma,coretransparnciadesmbolos,
otipodelinhasqueosunem,sehouver,earepresentaodebarrasdeerroseativo.Estasopessodescritasnaseguintesubseo.
EstiloA.5.3.1Loteeditor
Aoplotarpontosemumgrficodedisperso,existemmuitasmaneirasdiferentesquecadapontopodeserexibido.Porpadro,TOPCAT
escolheumconjuntodemarcadorescombaseemquantospontosexistemnatabelaeusaumdiferenteparacadaconjuntoplotados.Omarcador
paracadaconjuntoexibidoemumbotodireitadoseunomenopainelseletordeconjuntodedadosnaparteinferiordajaneladoenredo.
Sevocclicarnestebotooseguintedilogoirapareceroquelhepermitealteraraaparncia.

Dilogoeditordeestilopara2dgrficodedisperso
http://127.0.0.1:2525/doc/sun253/sun253.html

112/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ALendacaixadefinecomooconjuntoselecionadoseridentificadonalegendaqueapareceaoladodoenredo(emboraalendasservisvel
seMostrarlegenda(
)estligado):
cone
Exibeoconequesermostradoparaidentificarospontosnoconjuntoselecionado.Suaaparnciadependedasseleesquevocfazno
restodajaneladedilogo.
Etiqueta
Donomeescritonalegendaparaidentificarosubconjunto.Porpadro,estederivadodonomedosubconjuntoRowe,seissonofaz
partedoconjuntodedadosprincipal,onomedoguiadoconjuntodedados.Vocpodedigitarumnovovalorparamudaroqueest
escritonalegenda.
OcultarLegenda
Seestaopoforselecionada,nenhumaentradaparaoconjuntoselecionadoaparecernalegenda.
Omarcadorcaixadefinecomoosmarcadoresplotadosparacadapontodedadosserexibida:
Forma
Escolhadeumavariedadedeformas,taiscomocrculosabertosoupreenchidos,quadrados,etccruzes
Tamanho
Escolhaotamanhodomarcadorovalordadooraioaproximadoempixels.Seumtamanhodezeroforescolhido,entoaformano
importa,ospontosseroplotadoscomonicopixels.
Cor
Escolhaacoremqueosmarcadores,etodaalinhaseforfeito,seroplotados.
Transparncia
Escolhatransparnciadossmbolostraados.Aescaladabarralogartmica,comumanaextremidadedoladoesquerdo.Ovalorreal
escolhidoumnmerointeiroescritonadireitadabarra.Estenmeroindicaonmerodemarcadoresparaesteconjuntoqueprecisaser
plotadosnamesmaposioderesultarempixelstotalmenteopacosqualquermenoseofundo,ououtrosmarcadoresplotadosporbaixo,
vaimostraratravsdealgumaforma.Configurandooparaalgumvalormaiorque1muitotilsevoctemumnmeromuitograndede
pontosqueestosendoplotados(especialmentesecomparvelcomonmerodepixelsnatela),umavezquepermiteavocdistinguir
asregiesondehgrandequantidadedeapontaemcimaunsdosoutrosapartirdaquelesemquehapenasalguns.
Barrasdeerro
Seasbarrasdeerrosoativasparaesteenredo,permitequevocselecioneaformacomoelesseroexibidos.Asopesquepodemser
selecionadasaquivaidependerseerrosXe/ouYestoemuso.
OcultarMarcadores
Estacaixadeverificaosativadoseumalinhae/ouerrobaresestosendoplotadosquepermitequeosmarcadoresdeserinvisvel,
demodoqueapenasasbarrasdelinha/errosovistos.
ALinhadecaixadeterminaseaslinhassodesenhadasassociadocomoconjuntoatualeseassimoseuaspectoser.
Espessura
Selecionaaespessuradalinhaempixels.
Trao
Selecionaumpadrodetrao(slido,pontilhado,tracejadooupontotracejada)paraalinha.
Tipo
Osoutrosbotesderdiodeterminarquetipodelinha,sehouver,seroplotadosparaestespontos.Existemtrsopes:
Nenhum
Nenhumalinhadesenhadaesteopadro.
Pontoparapontilhar
Umsegmentoderetadesenhadaentrecadaumdospontos.Seospontosefectivamenteformarumconjuntoordenadode
amostrasdeumafuno,istoirresultaremumdesenhomaisoumenoslisodoqueemfunodoterreno.Notequeaslinhasso
desenhadasnaordememqueospontosaparecemnatabelabsica,eseestenocorresponderordem"ordenada",oresultado
serumabaguna.Realmente,aordemdedesenhodeveseratualordemdeclassificaodatabelaquenoumamisfeatureque
podesercorrigidaemalgummomento.Notetambmquesevoctentarissocomumaenormemesaprovvelquevocobterum
resultadoque(a)confusoe(b)levamuitotempoparadesenhar.
CorrelaoLinear
Sevocselecionaressaopo,emseguida,umalinhaderegressolinearseroplotados.Oscoeficientesdecorrelaotambm
serexibidodireitadobotoderdio(vocpodeprecisarredimensionarajanelaparavlostodos).Osvalorescitadossom
(inclinao),c(interceptar)er(coeficientedecorrelaodomomentodoproduto).Vocpodecortarecolarapartirdestetexto.
Observeque,tantoparaalinhatraadaeoscoeficientescitadososdadossotomadassomenteapartirdospontosqueesto
atualmentedisponveisoquesignificaque,sevocoseixosampliadaparaexcluiralgunsdospontosdedados,elesnovoestar
acontribuirparaocalculadoestatsticas.
Todasasalteraesfeitasnestajanelasorefletidasnatramadeimediato.SevocclicarnoOKbotonaparteinferior,ajanelairdesaparecer
easmudanaspermanecem.SevocclicaremCancelarajanelairdesapareceretodasasalteraesfeitasserodescartadas.
Voctambmpodealterartodososestilosdeplotagemdeumasvez,usandooestilodemarcadordemenunajaneladoenredo.Aquivoc
podeselecionarumgrupopadrodeestilos(porexemplo,todososmarcadoresde2pixelsabertascomdiferentescoreseformas)paraos
conjuntosdetraados.Damesmaforma,osestilosdeerropodeseralteradodeumasvezusandooestilodeerromenu.

A.5.4Stackedenredo(modaantiga)
Estaseodescreveumajaneladeplotagemdeestiloantigo.AsjanelasdeplotagempadrosodescritosnoApndiceA.4,emboranoteque
nomomentodaescrita(v4.1)nenhumajanelaplotagemequivalentenovoestiloestdisponvelparatraarlinhasempilhadas.
http://127.0.0.1:2525/doc/sun253/sun253.html

113/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

EmpilhadosJanelaLines
Ajaneladegrficodelinhaempilhadospermiteplotarumaoumaisordenada(Y)quantidadescontraumaabscissamonotnica(X)a
quantidade.Paramaiorclareza,asdiferentesparcelassoexibidosemgrficosverticalmentedeslocadasquecompartilhamomesmoeixoX.
Vocpodeexibirestajanelausandoaslinhas( )itensnajaneladecontrole'sGrficosmenu.
AtelainicialtemumnicogrficoXY,geralmentecomlinhasqueligampontosadjacentes.Ospontospodemserreordenadasantesdese,se
necessrio,demodoquealinhaapresentadacomoumafunodeX,emvezdeumaterceiravarivelindependenteinvisvel(naDisperso
istonofeito,quepodelevaralinhasrabiscadatodooterreno).Seumadascolunasnatabelaparecerepresentarumvalordetempo,esteser
selecionadocomooeixoXpadro.Casocontrrio,a"magia"ndicevarivelserusada,oquerepresentaonmerodalinha.Naturalmente,
estespodemseralteradosapartirdeseusvaloresdedefeitoutilizandoosselectoresdamaneirausual.
ParaadicionarumnovogrficocomdiferenteseixoY,useoAdicionarConjuntodeDados(

boto)nabarradeferramentasdo

conjuntodedadosnaparteinferiordajanela.Istotemumefeitoligeiramentediferentedoqueaconteceemoutrasjanelasdeenredo,na
medidaemqueinsereumanovaregiodeplotagemcomoseuprprioeixoYnotopodatramaemqueosdadosespecificadadesenhada,e
noapenasfazendoumnovoconjuntodepontosaseremplotadosemregiotramaexistente.Assim,todososconjuntosdedadosaparecemem
seusprpriosgrficoscomseusprprioseixosY(emborasevoctivervriossubconjuntosdelinhastraadasparaomesmoconjuntodedados
queiroaparecernamesmapartedoenredo,comodecostume).Pararemoverumdosgrficos,selecioneoseuguiaeusaroRemoveDataset
( boto)comodecostume.
Zoomingspodeserfeitoemumeixodecadavez,emvezdearrastarumaregioXYnasuperfciedatrama,jquenohumnicoeixoY
paraaumentardiante.ParaampliaroeixoXin/out,posicioneomouselogoabaixodoeixoXnaparteinferiordogrficoearrasteparaa
direita/esquerda.ParaampliarumdoseixosYdentroouparafora,posicioneomouseapenasparaaesquerdadoeixoYquevocest
interessadoearrasteparacima/baixo.Paradefinirasfaixasmanualmente,useoConfigureAxeseTtulo(
boto),comodecostume,mas
notequehumaetiqueta/caixaconfiguraodointervaloparacadaumdoseixosY.Essascoisasfuncionamemgrandepartecomodescrito
noApndiceA.5.1.2,contantoquevoctenhaemmentequeafaixadecadaumdoseixosYtratadodeformaindependentedosoutros.
Aoclicaremqualquerumdospontosirativarloverseo8.
Osseguintesbotesestodisponveisnabarradeferramentas:
Rachadodajanela
http://127.0.0.1:2525/doc/sun253/sun253.html

114/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Permitequeoseletordeconjuntodedadosparaserredimensionadaarrastandoumseparadorentreeleeareadeplotagem.Bompara
telaspequenas.
Redesenhaoenredoatual.Normalmentenonecessriousaresteboto,umavezquesevocalterarqualquerumadascaractersticas
datramacomoscontrolesnestajanelaoenredovaiserredesenhadoautomaticamente.Noentanto,sevoctiveralteradoosdados,por
exemplo,aoeditarasclulasnajaneladedados,oenredonoredesenhadoautomaticamente(umavezqueeste,potencialmente,uma
operaocaraevocnopodeexigirisso).Aoclicarnestebotoredesenhaoenredotendoemcontatodasasalteraesaosdadosda
tabela.
ConfigureAxeseTtulo
AbreumdilogoparapermitiraconfiguraomanualdagamaertuloparaoeixoXecadaumdoseixosY,bemcomoumttulotrama
verApndiceA.5.1.2.
ExportarcomoPDF
AbreumdilogoquevaiescreveratramaatualcomoumarquivoPDF.
ExportarcomoGIF
AbreumdilogoqueirimprimiroenredoatualparaumarquivoGIF.Oarquivodesadaomesmoqueaimagemplotadaquevoc
v.RedimensionarajaneladeplotagemantesdaexportaoparacontrolarotamanhodoGIFdesada.
Redimensionar
Rescalestodasastramas,demodoquetodosospontosnosconjuntosdedadospodemserrepresentadosgraficamentevisto.OeixoXe
todososeixosYsoredimensionadasparaajustarosdados.
RedimensionarEixoX
RedimensionaapenasoeixoX.OeixoXredimensionadaparacobrirosmenoresemaioresvaloresemqualquerumdosconjuntosde
dadosplotados,masasfaixasdeYsodeixadoscomoesto.
RedimensionarYEixos
RedimensionaoYeixoss.CadaumdoseixosYplotadossoredimensionadasdeformaindependente,demodoqueelescobremos
menoresemaioresvaloresdentrodafaixaXatualmentedisponveis.
Gradecompleta
DefineseaslinhasXeYdagradesodesenhadassobreasparcelasouno.Seestaopoforselecionada,oy=0linhadegrade
simples(vejaoprximoitem)serautomaticamentecancelada.
Mostrarlegenda
Defineseumalendamostrandocomocadaconjuntodedadosrepresentadovisveldireitadatrama.Inicialmente,alegenda
mostradasomentesehouvermaisdeumconjuntodedadosestsendomostradoaomesmotempo.
y=0Linhasdegrelha
Defineseumanicalinhahorizontalemy=0desenhado.Seestaopoforselecionada,agradecompleta(veritemanterior)ser
automaticamentecancelada.
MostrarVerticalCrosshair
Defineseumalinhaverticalsegueomousequandoposicionadosobreoenredo.Istopodesertilparacompararascaractersticasde
diferentesgrficosaomesmoXposiodecoordenadas.
Antialias
Defineseaslinhassodesenhadascomsuavizao.Antialiasingsignificasuavizaodelinhasparaqueapareammenospixelised,e
geralmentemelhoraaaparnciaestticadatrama,masemalgumascircunstnciaspodeparecermelhornosuavizados.Oestadodeste
botonoafetaasimagensexportadosparapostscript.
SubconjuntodeXGama
DefineumnovosubconjuntoFilaemcadaumadastabelasplotadosconsistindosomenteospontosnointervaloactualmente
disponveisnoeixohorizontal.Ospontosseroincludas,mesmoqueestejamforadasfaixasatuaisdoseixosY.
Abarradeferramentasdoconjuntodedadoscontmasseguintesopes:
/

Adicionar/Removerdataset

Adiciona/removeumconjuntodedadosparaplotagem,quetantoadiciona/removeumaguianoseletordeconjuntodedadose
adiciona/removeumatramanapilhaatualmentedisponveisnareadeplotagem.Vejaacimaparamaisexplicaes.
/ barrasdeerroAlternarX/Y
AlternaentredesenhobarrasdeerrossimtricosesembarrasdeerronasdireesXeY,respectivamente.Outrasopesesto
disponveisnoErrosmenu.VejaApndiceA5.1.3.
Vocpodedeterminaraformacomoosdadossoplotadosusandolinhase/oumarcadores,conformedescritonasubsecoseguinte.
A.5.4.1EditordeLinhasEstilo
Oestilodeplotagempadroparaaslinhasdeenredoempilhadosumalinhapretasimplesparacadagrfico.Desdeasparcelasnormalmente
nosesobrepemunsaosoutros,isto,emmuitoscasosadequados,talcomoest.Noentanto,vocpodeconfiguraroestilodeplotagempara
queospontossoplotadoscomosmarcadores,bemcomoouemvezdelinhas,ealterarascores,formas,estilosdelinhamarcadoretcOestilo
decadasubconjuntodelinhaexibidaemumbotodireitadeseunomenocantoinferiordireitodajaneladeplotagem.Sevocclicarneste
botooseguintedilogoiraparecerqueentablesconfiguraroestilodeplotagem.

http://127.0.0.1:2525/doc/sun253/sun253.html

115/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

EmpilhadosLoteLinhaStyleEditor
ALendacaixadefinecomooconjuntoselecionadoseridentificadonalegendaqueapareceaoladodoenredo(emboraalendasservisvel
seMostrarlegenda(
)estligado):
cone
Exibeoconequesermostradoparaidentificarospontosnoconjuntoselecionado.Suaaparnciadependedasseleesquevocfazno
restodajaneladedilogo.
Etiqueta
Donomeescritonalegendaparaidentificarosubconjunto.Porpadro,estederivadodonomedosubconjuntoRowe,seissonofaz
partedoconjuntodedadosprincipal,onomedoguiadoconjuntodedados.Vocpodedigitarumnovovalorparamudaroqueest
escritonalegenda.
OcultarLegenda
Seestaopoforselecionada,nenhumaentradaparaoconjuntoselecionadoaparecernalegenda.
Aexibiocaixadefinecomoosmarcadoresplotadosparacadapontodedadosserexibida:
Cor
Escolhaacornaqualaslinhase/oumarcadoresseroplotados.
Linha/Marcadores
Selecioneapartirdosbotesderdiosevocquerapenaslinhasentreospontosdedados,oumarcadoresemcadaponto,ouambos.
Barrasdeerro
Seasbarrasdeerrosoativasparaesteenredo,permitequevocselecioneaformacomoelesseroexibidos.Asopesquepodemser
selecionadasaquivaidependerseXe/ouYerorsestoemuso.
ALinhadecaixadefinecomoaslinhasqueunemospontosvaiolhar.Essescontrolessestarativoseaseleodeexibiodelinhaou
ambos.
Espessura
Determinaaespessuradalinha.
Trao
Determinalinhapadrodetrao.
OMarcadorescaixadefinecomomarcadoresnospontosdedadosvaiolhar.EssescontrolessestarativoseaseleoDisplayMarkers
ouambos.
Tamanho
Determinaotamanhodosmarcadoresempixels.Seumtamanhodezero,entoescolhidodaforma,noimporta,ospontosvoser
representadoscomonicospixels.
Forma
Determinaaformadosmarcadoresapartirdeumaseleco,taiscomocrculosabertosoupreenchidos,quadrados,etccruzes
Todasasalteraesfeitasnestajanelasorefletidasnatramadeimediato.SevocclicarnoOKbotonaparteinferior,ajanelairdesaparecer
easmudanaspermanecem.SevocclicaremCancelarajanelairdesapareceretodasasalteraesfeitasserodescartadas.
Voctambmpodealterartodososestilosdeplotagemdeumasvez,usandooestilodalinhademenunajaneladelinhasdeenredo
empilhadas.Aquivocpodeselecionarumgrupopadrodeestilos(porexemplo,linhastracejadas,linhascoloridas)paraosconjuntosde
traados.Damesmaforma,osestilosdeerropodeseralteradodeumasvezusandooestilodeerromenu.

A.5.53DPlot(modaantiga)
Estaseodescreveumajaneladeplotagemdeestiloantigo.AsjanelasdeplotagempadrosodescritosnoApndiceA.4.
http://127.0.0.1:2525/doc/sun253/sun253.html

116/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Janela3Ddedisperso
Ajaneladeplotagem3Ddesenhagrficosdedispersoem3dimensesdeumaoumaiscolunasdatabeladetriplos(ouquantidadesderivadas)
emeixoscartesianos.Vocpodeexibilousandoo3D( item)najaneladecontrole'sGrficosmenu.
Novisorummarcadorplotadaparacadalinhanoconjuntodedadosselecionado(s)emumaposiodeterminadapelosvaloresdascolunas
databelaselecionadasparaforneceraX,YeZvalores.UmmarcadorsseroplotadossenenhumdoseixosX,YeZvaloresestoem
branco.Selecioneasquantidadesatramaeossmbolosdeplotagemcomoseletordeconjuntodedadosnaparteinferior.
Oespao3Dpodeserrodado,arrastandooratosobreasuperfciequevairodaremtornodopontonocentrodocuboprojectado.Osrtulos
doeixotentarexibirsenaposiocorrectaedeumaformaquepodeserlidoapartirdopontodeobservao,sepossvel,oquesignificaque
elessemovemaoredor,enquantoarotaoestacontecendo.Porpadro,ospontossoprocessados
comoseoespao3Dpreenchidocom

um"nevoeiro",demodoqueospontosmaisdistantesparecemmaislavadasesteforneceumapistavisualquepodeajudaradistinguira
profundidadedepontostraados.Noentanto,vocpodedesligarissosequiser.Sehouvermuitospontos,entovocpodeacharqueelesno
sotodosplotadosenquantoogestodearrastoarotaoestemandamento.Istofeitoparareduzirotempoderenderizaodemodoquea
respostaGUIficarpido.Quandoaresistnciaestterminado(ouseja,quandovocsoltarobotodomouse)todosospontosvovoltar.
Ampliaotambmpossvel.Vocpodeaumentarozoomemtornodocentrodatrama,demodoqueajaneladevisualizaocobreapenaso
meio.Amaneiramaisfcildefazerissousararodadomouse,sevoctemumrodaparaafrenteparaaumentarozoomeparatrspara
diminuirozoom.Alternativamente,vocpodefazlo,arrastandoaregioesquerdadatrama,comooZoomAxisemalgumasdas2D
parcelas.Arrasteomouseparabaixoparaaumentaroudiminuirozoomataestapartedajanela.Atualmentespossveldarzoomin/out
emtodoocentrodatrama.Quandoozoomvocpodeusarosubconjuntodevisvel(
boto)dabarradeferramentasparadefinirumnovo
subconjuntoRowconsistindoapenasumdospontosqueestoatualmentedisponveis.VejaApndiceA.5.1.6paramaisexplicaes.
Clicandoemqualquerumdospontostraadosirativarloverseo8.
Osseguintesbotesestodisponveisnabarradeferramentas:
Rachadodajanela
Permitequeoseletordeconjuntodedadosparaserredimensionadaarrastandoumseparadorentreeleeareadeplotagem.Bompara
http://127.0.0.1:2525/doc/sun253/sun253.html

117/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

telaspequenas.
Replot
Redesenhaoenredoatual.Normalmentenonecessriousaresteboto,umavezquesevocalterarqualquerumadascaractersticas
datramacomoscontrolesnestajanelaoenredovaiserredesenhadoautomaticamente.Noentanto,sevoctiveralteradoosdados,por
exemplo,aoeditarasclulasnajaneladedados,oenredonoredesenhadoautomaticamente(umavezqueeste,potencialmente,uma
operaocaraevocnopodeexigirisso).Aoclicarnestebotoredesenhaoenredotendoemcontatodasasalteraesaosdadosda
tabela.
ConfigureAxeseTtulo
Abreumdilogoparapermitiraconfiguraomanualdasfaixasdeeixo,rtulosdoseixosettulotramaverApndiceA.5.1.2.
ExportarcomoPDF
AbreumdilogoquevaiescreveratramaatualcomoumarquivoPDF.Emgeral,esteumfieledealtaqualidadederenderizaodo
queexibidonajaneladoenredo.Noentanto,seplotagemestsendofeitousandoosmarcadoresdetransparncia,osmarcadoressero
processados
comosefossemopacas.ParcelascommuitospontospoderesultarembastantegrandesPDFsdesada.

ExportarcomoGIF
AbreumdilogoqueirimprimiroenredoatualparaumarquivoGIF.Oarquivodesadaomesmoqueaimagemplotadaquevoc
v.RedimensionarajaneladeplotagemantesdaexportaoparacontrolarotamanhodoGIFdesada.
Redimensionar
Redimensionaoseixosdoplanoatualparaqueelecontmtodosospontosdedadosemsubconjuntosselecionadosnomomento.Por
padro,oenredovaiserescaladocomoesse,maselepodetermudadoporcausademudanasnaseleosubconjunto.
Reorientar
Reorientaoseixosdatramaactualparaasuaposioinicial.Istopodesertilsevocperdeuocontroledeondevocgirouoplanopara
comomouse.Issotambmredefineonveldezoomaonormalsevocmudouisso.
Ficaremp
Botodealternnciaque,quandoselecionadogarantequeoeixoZorientadoverticalmentenatelaotempotodo.Porpadrooff,o
quesignificaquevocpodearrastaroseixosevoltaparaqualquerorientao,maspodeserconvenienteparaligloparamantero
enredoapontandoemumadireosensata.
Grade
Defineseaestruturacbicadelimitadoraatramadesenhadaouno.
Mostrarlegenda
Defineseumalendamostrandocomocadaconjuntodedadosrepresentadovisveldireitadatrama.Inicialmente,alegenda
mostradasomentesehouvermaisdeumconjuntodedadosestsendomostradoaomesmotempo.
Nevoeiro
Alternaseoprocessamentofeitocomoseoespaopreenchidocomnevoeiro.Seestaopoforselecionada,ospontosdistantes
aparecermaisdesbotadadoqueentesprximos.
DesenhesubconjuntoRegio
PermitequevocdesenheumaregionateladefinindoumnovosubconjuntoRow.Quandovocterminardedesenhlo,clique
novamentenestebotoparaindicarquevocestfeito.Osubconjuntoirincluirpontosemtodasasprofundidadesnadireode
visualizaoquecaemnaregioquevocdesenhou.VejaApndiceA.5.1.6paramaisdetalhes.
Subconjuntodevisvel
DefineumnovosubconjuntoRowconsistindoapenasospontosqueestoatualmentedisponveisnasuperfciedatrama.Veja
ApndiceA.5.1.6paramaisexplicaes.
Oitemseguinteadicionalestdisponvelapenascomoumitemdemenu:
Antialias
Defineseoseixoseassuasanotaessoatradossuavizados.Linhassuavizadassomaissuavesegeralmenteolharmaisagradvel,
especialmenteparatextoemumnguloagudo,maspoderetardaraprestaoumpoucoparabaixo.
Abarradeferramentasdoconjuntodedadoscontmasseguintesopes:
/
/

Adicionar/Removerdataset
Adiciona/removeabasemqueosdadosparaconjuntosdedadosadicionaispodemserinseridos.VejaApndiceA.5.1.1.
Adicionar/Removereixoauxiliar

Adiciona/removeumseletorparaaentradadeumeixoauxiliarparamodificarascoresdepontoetcSeeApndiceA.5.1.5.
RotulagempontoAlternar
/

Permitequeosrtulosdetextoaserdesenhadoprximopontostraados.VejaApndiceA.5.1.4.
/ barrasdeerroAlternarX/Y/Z
AlternaentreasbarrasdeerrodedesenhosimtricoesembarrasdeerronoX,YeZ,respectivamente.Outrasopesestodisponveis
noErrosmenu.VejaApndiceA5.1.3.

Voctemumaconsidervelliberdadeparaconfiguraraformacomoospontossoplotadosincluindoaforma,coretransparnciadesmbolos
earepresentaodebarrasdeerroseusado.Estasopessodescritasnaseguintesubseo.
A.5.5.13DEditordeestilodeplotagem
Aoplotarpontosemumatramaem3D,existemmuitasmaneirasdiferentesquecadapontopodeserexibido.Porpadro,TOPCATescolheum
conjuntodemarcadorescombaseemquantospontosexistemnatabelaeusaumdiferenteparacadaconjuntoplotados.Omarcadorparacada
http://127.0.0.1:2525/doc/sun253/sun253.html

118/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

conjuntoexibidoemumbotodireitadoseunomenopainelseletordeconjuntodedadosnaparteinferiordajaneladoenredo.Sevoc
clicarnestebotooseguintedilogoirapareceroquelhepermitealteraraaparncia.

Dilogoeditordeestilopara3dparcelas
ALendacaixadefinecomooconjuntoselecionadoseridentificadonalegendaqueapareceaoladodoenredo(emboraalendasservisvel
seMostrarlegenda(
)estligado):
cone
Exibeoconequesermostradoparaidentificarospontosnoconjuntoselecionado.Suaaparnciadependedasseleesquevocfazno
restodajaneladedilogo.
Etiqueta
Donomeescritonalegendaparaidentificarosubconjunto.Porpadro,estederivadodonomedosubconjuntoRowe,seissonofaz
partedoconjuntodedadosprincipal,onomedoguiadoconjuntodedados.Vocpodedigitarumnovovalorparamudaroqueest
escritonalegenda.
OcultarLegenda
Seestaopoforselecionada,nenhumaentradaparaoconjuntoselecionadoaparecernalegenda.
Omarcadorcaixadefinecomoosmarcadoresplotadosparacadapontodedadosserexibida:
Forma
Escolhadeumavariedadedeformas,taiscomocrculosabertosoupreenchidos,quadrados,etccruzes
Tamanho
Escolhaotamanhodomarcadorovalordadooraioaproximadoempixels.Seumtamanhodezeroforescolhido,entoaformano
importa,ospontosseroplotadoscomonicopixels.
Cor
Escolhaacornaqualosmarcadoresseroplotados.
Transparncia
Escolhatransparnciadossmbolostraados.Aescaladabarralogartmica,comumanaextremidadedoladoesquerdo.Ovalorreal
escolhidoumnmerointeiroescritonadireitadabarra.Estenmeroindicaonmerodemarcadoresparaesteconjuntoqueprecisaser
plotadosnamesmaposioderesultarempixelstotalmenteopacosqualquermenoseofundo,ououtrosmarcadoresplotadosporbaixo,
vaimostraratravsdealgumaforma.Configurandooparaalgumvalormaiorque1muitotilsevoctemumnmeromuitograndede
pontosqueestosendoplotados(especialmentesecomparvelcomonmerodepixelsnatela),umavezquepermiteavocdistinguir
asregiesondehgrandequantidadedeapontaemcimaunsdosoutrosapartirdaquelesemquehapenasalguns.Seatransparncia
finitodefinido,vocpodeacharquetilparadesligarnebulizao(vejaacima).
Barrasdeerro
Seasbarrasdeerrosoativasparaesteenredo,permitequevocselecioneaformacomoelesseroexibidos.Asopesquepodemser
seleccionadasaquivaidependerseX,Ye/ouerrosdeZestoemuso.
OcultarMarcadores
Estacaixadeverificaosativadoseasbarrasdeerroestosendoplotadosquepermitequeosmarcadoresdeserinvisvel,demodo
queapenasasbarrasdeerrosovistos.
Todasasalteraesfeitasnestajanelasorefletidasnatramadeimediato.SevocclicarnoOKbotonaparteinferior,ajanelairdesaparecer
easmudanaspermanecem.SevocclicaremCancelarajanelairdesapareceretodasasalteraesfeitasserodescartadas.
Voctambmpodealterartodososestilosdeplotagemdeumasvez,usandooestilodemarcadordemenunajaneladoenredo.Aquivoc
podeselecionarumgrupopadrodeestilos(porexemplo,todososmarcadoresde2pixelsabertascomdiferentescoreseformas)paraos
conjuntosdetraados.Damesmaforma,osestilosdeerropodeseralteradodeumasvezusandooestilodeerromenu.

A.5.6SphericalPlot(modaantiga)
Estaseodescreveumajaneladeplotagemdeestiloantigo.AsjanelasdeplotagempadrosodescritosnoApndiceA.4.
http://127.0.0.1:2525/doc/sun253/sun253.html

119/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JaneladeplotagemSpherical
Ajaneladeplotagemesfricaatraigrficosdedisperso3dimensionaldeconjuntosdedadosapartirdeumaoumaistabelasemeixospolares
esfricas,porissoadequadoparaexibiraposiodecoordenadasnocuoualgumoutrosistemadecoordenadasesfrico,comoasuperfcie
deumplanetaouasol.VocpodeexibilousandooSphere(
item)najaneladecontrole'sGrficosmenu.
Namaioriadosaspectos,estajanelafuncionacomoogrfico3Djanela,maseleusaeixospolaresesfricasaoinvsdascartesianas,voctem
quepreencheroseletordeconjuntodedadosnaparteinferiorcomelongitudedotipolatitudecoordenadasdamesa.Selectoressoincludos
paraindicarasunidadesdessascoordenadas.SeTOPCATpodelocalizarcolunasnatabelaqueparecemrepresentarAscensoRetae
Declinao,estasseropreenchidasautomaticamente.Seapenasestesdoissopreenchidos,emseguida,ospontosseroplotadossobrea
superfciedaesferaunitriaesteadequadosevocquiserapenasparainspecionarasposiesdeumconjuntodeobjetosnocu.
SeaRadialCoordenadas(

boto)ativado,vocpode,opcionalmente,preencherumvalornaRadialEixoseletortambm.Nestecaso,

ospontosvoserrepresentadosnointeriordaesfera,aumadistnciaapartirdocentrodadopelovalordacoordenadaradial.
Oespao3Dpodemsergirados,arrastandoomousesobreasuperfciequevaigiraremtornodocentrodaesfera.Porpadro,ospontosso
processados
comoseoespao3Dpreenchidocomum"nevoeiro",demodoqueospontosmaisdistantesparecemmaislavadasestefornece

umapistavisualquepodeajudaradistinguiraprofundidadedepontostraados.Noentanto,vocpodedesligarissosequiser.Sehouver
muitospontos,entovocpodeacharqueelesnosotodosplotadosenquantoogestodearrastoarotaoestemandamento.Istofeito
parareduzirotempoderenderizaodemodoquearespostaGUIficarpido.Quandoaresistnciaestterminado(ouseja,quandovocsoltar
obotodomouse)todosospontosvovoltar.
Ampliaotambmpossvel.Vocpodeaumentarozoomemtornodocentrodatrama,demodoqueajaneladevisualizaocobreapenaso
meio.Amaneiramaisfcildefazerissousararodadomouse,sevoctemumrodaparaafrenteparaaumentarozoomeparatrspara
diminuirozoom.Alternativamente,vocpodefazlo,arrastandoaregioesquerdadatrama,comooZoomAxisemalgumasdas2D
parcelas.Arrasteomouseparabaixoparaaumentaroudiminuirozoomataestapartedajanela.Atualmentespossveldarzoomin/out
emtodoocentrodatrama.Quandoozoomvocpodeusarosubconjuntodevisvel(
boto)dabarradeferramentasparadefinirumnovo
http://127.0.0.1:2525/doc/sun253/sun253.html

120/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

subconjuntoRowconsistindoapenasumdospontosqueestoatualmentedisponveis.VejaApndiceA.5.1.6paramaisexplicaes.
Clicandoemqualquerumdospontostraadosirativarloverseo8.
Osseguintesbotesestodisponveisnabarradeferramentas:
Rachadodajanela
Permitequeoseletordeconjuntodedadosparaserredimensionadaarrastandoumseparadorentreeleeareadeplotagem.Bompara
telaspequenas.
Replot
Redesenhaoenredoatual.Normalmentenonecessriousaresteboto,umavezquesevocalterarqualquerumadascaractersticas
datramacomoscontrolesnestajanelaoenredovaiserredesenhadoautomaticamente.Noentanto,sevoctiveralteradoosdados,por
exemplo,aoeditarasclulasnajaneladedados,oenredonoredesenhadoautomaticamente(umavezqueeste,potencialmente,uma
operaocaraevocnopodeexigirisso).Aoclicarnestebotoredesenhaoenredotendoemcontatodasasalteraesaosdadosda
tabela.
ConfigureAxeseTtulo
Abreumdilogoparapermitiraconfiguraomanualdasfaixasdeeixo,rtulosdoseixosettulotramaverApndiceA.5.1.2.A
nicafaixaeixoconfigurvelolimitesuperiordoeixoradial.
ExportarcomoPDF
AbreumdilogoquevaiescreveratramaatualcomoumarquivoPDF.Emgeral,esteumfieledealtaqualidadederenderizaodo
queexibidonajaneladoenredo.Noentanto,seplotagemestsendofeitousandoosmarcadoresdetransparncia,osmarcadoressero
processados
comosefossemopacas.ParcelascommuitospontospoderesultarembastantegrandesPDFsdesada.

ExportarcomoGIF
AbreumdilogoqueirimprimiroenredoatualparaumarquivoGIF.Oarquivodesadaomesmoqueaimagemplotadaquevoc
v.RedimensionarajaneladeplotagemantesdaexportaoparacontrolarotamanhodoGIFdesada.
Redimensionar
Redimensionaoseixosdoplanoatualparaqueelecontmtodosospontosdedadosemsubconjuntosselecionadosnomomento.Por
padro,oenredovaiserescaladocomoesse,maselepodetermudadoporcausademudanasnaseleosubconjunto.
Reorientar
Reorientaoseixosdatramaactualparaasuaposioinicial.Istopodesertilsevocperdeuocontroledeondevocgirouoplanopara
comomouse.Issotambmredefineonveldezoomaonormalsevocmudouisso.
Ficaremp
Botodealternnciaque,quandoselecionadogarantequeoplonorte(latitude=90graus)orientadoverticalmentenatelaotempo
todo.Porpadroon.
Grade
Defineseofioquadroesfricodelimitadoraatramadesenhadaouno.
Mostrarlegenda
Defineseumalendamostrandocomocadaconjuntodedadosrepresentadovisveldireitadatrama.Inicialmente,alegenda
mostradasomentesehouvermaisdeumconjuntodedadosestsendomostradoaomesmotempo.
Nevoeiro
Alternaseoprocessamentofeitocomoseoespaopreenchidocomnevoeiro.Seestaopoforselecionada,ospontosdistantes
aparecermaisdesbotadadoqueentesprximos.
DesenhesubconjuntoRegio
PermitequevocdesenheumaregionateladefinindoumnovosubconjuntoRow.Quandovocterminardedesenhlo,clique
novamentenestebotoparaindicarquevocestfeito.Osubconjuntoirincluirpontosemtodasasprofundidadesnadireode
visualizaoquecaemnaregioquevocdesenhou.VejaApndiceA.5.1.6paramaisdetalhes.
Subconjuntodevisvel
DefineumnovosubconjuntoRowconsistindoapenasospontosqueestoatualmentedisponveisnasuperfciedatrama.Veja
ApndiceA.5.1.6paramaisexplicaes.
Oitemseguinteadicionalestdisponvelapenascomoumitemdemenu:
Antialias
Defineseoseixoseassuasanotaessoatradossuavizados.Linhassuavizadassomaissuavesegeralmenteolharmaisagradvel,
especialmenteparatextoemumnguloagudo,maspoderetardaraprestaoumpoucoparabaixo.
Abarradeferramentasdoconjuntodedadoscontmasseguintesopes:
/
/

Adicionar/Removerdataset
Adiciona/removeabasemqueosdadosparaconjuntosdedadosadicionaispodemserinseridos.VejaApndiceA.5.1.1.
Adicionar/Removereixoauxiliar

Adiciona/removeumseletorparaaentradadeumeixoauxiliarparamodificarascoresdepontoetcSeeApndiceA.5.1.5.
RotulagempontoAlternar
Permitequeosrtulosdetextoaserdesenhadoprximopontostraados.VejaApndiceA.5.1.4.
AlternarRadialCoordenadas
Quandoativado,umseletordecolunadenominadaRadialAxisservisvelabaixoosseletoresdelongitudeelatitudedoEixo.Isso
permitequevocinsiraumvalorparaacoordenadaradialdecadaponto.Seesteestdesativado,ouseeletemumvalorembranco,em
http://127.0.0.1:2525/doc/sun253/sun253.html

121/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

seguida,todosospontosterocoordenarumaradialassumidodaunidadeeseroplotadossobreasuperfciedaesfera.
Alternarbarrasdeerrotangenciais
Quandoativado,umseletordecolunaadicionalexibidonopaineldoconjuntodedadosparaadireitadealongitudeelatitudeseletores,
juntamentecomoseuprprioseletordeunidade.Podeencherestecomumvalordeerroisotrpicarepresentandooraiodeumcrculo
pequenoassociadocomospontosescolhidos,emunidadesdesegundosdearco,arcmin,grausouradianos.Issofarcomquebares2d
deerroaserplotada.Vocpodeconfiguraroseuaspecto(porexemplo,mira,elipses,retngulos,...),utilizandooeditordeestiloda
maneirausual.VejaApndiceA5.1.3paramaisinformaes.
BarrasdeerroradialAlternar
Switchesradialbarrasdeerroedesliga.VejaApndiceA5.1.3.Estebotosserativadoseascoordenadasradiaisestoemuso.
Voctemumaconsidervelliberdadeparaconfiguraraformacomoospontossoplotadosincluindoaforma,coretransparnciadesmbolos
earepresentaodeerrosseutilizado.Issofuncionaexatamentecomoparaoenredocartesiano3D,conformedescritonoApndiceA.5.5.1.

A.5.7DensidadeMap(modaantiga)
Estaseodescreveumajaneladeplotagemdeestiloantigo.AsjanelasdeplotagempadrosodescritosnoApndiceA.4.

MapadedensidadejanelanomodoRGB
Ajanelademapadedensidadetraaummapadedensidadede2dimensionaldeumoumaisparesdecolunasdatabela(ouquantidades
derivadas)acordecadapixelexibidodeterminadapelonmerodepontosnoconjuntodedadosquecaemdentrodosseuslimites.Outra
maneiradepensarestecomoumhistogramadeumagrelhade2dimensional,aoinvsdeuma1dimensionalcomonajaneladohistograma.
Vocpode,opcionalmente,pesoessascontagensbinnedcomoutrovalordatabela.
Mapasdedensidadesoadequadosquandovoctemumnmeromuitograndedepontosatrama,jque,nestecaso,importantesercapazde
vernoapenassehumpontoemumdeterminadopixel,masquantospontoscairnessepixel.Emgrandemedida,ascaractersticasde
transparnciadasoutrasjanelasdeplotagem2De3Dabordarestaquesto,masomapadedensidadepermitequevoccontroleumpouco
http://127.0.0.1:2525/doc/sun253/sun253.html

122/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

mais.EletambmpodeexportaroresultadocomoumaimagemFITS,quepodeentoserprocessadoouvisualizadoutilizandosoftware
especficodeimagem,taiscomoGAIAouAladin.
Estajanelapodeseroperadoemdoismodos:
Modoindexado
Cadapixelrepresentaumnicovalorescalar,correspondendoaumacontagemdesomaouconformeindicadopeloconjuntodedados
seleccionado(s).Sevriosconjuntosdedadosestosendotraadosdeumasvez,osvaloresdecadaumserosomadosparadaro
resultadoemcadaponto.Omapeamentodevalornumricoparacordopixelemcadapontonogrficodeterminadapelomapacor
selecionadanaindexadoColoursseletorabaixodatrama.Nestecaso,osseletoresdecoresestiloeditornotmefeitoeesto
desativados.Agamabastanteamplademapasdecoresfornecidoporpadro.Seestesnoatenderemssuasnecessidades,possvel
fornecerosseusprpriosmapasdecorespersonalizadasusandoolut.filespropriedadedosistemavejaSeo10.2.3.
ModoRGB
Cadapixeltemattrscontribuiesindependentes,asuaintensidadeemvermelho,verdeeazulcanais.Estespodemvirdediferentes
conjuntosdedados,conformeconfiguradonoeditordeestilo.Semaisdeumconjuntodedadosatribudoamesmacor,as
contribuiessosomadasparaessecanal.Nestecaso,oseletordemapadecoresindexadocoresnotemefeitoeestdesativado.
AlternarentreosmodosusandooRGB(

boto).

Vocpodeconfiguraroseixos,incluindozoomineout,comomouse(arrastarnoenredoouoseixos)oumanualmente,conformedescritono
ApndiceA.5.1.2.
Doiscontrolesespecficosparaestajanelasomostradosabaixodaprpriatrama:
Cortenveispercentis
Estecontrolacomoonmerodecontagensemcadapixelmapeadoparaumbrilho.Existemduasbarras,umparaolimiteinferioreum
limitesuperiorparaa.Elessorotulados(logartmica)comvalorespercentuais.Seasuperiorajustadapara90,issosignificaquea
qualquerpixelacimadopercentil90dospixelsnaimagememrelaoaonveldecontagemsermostradocombrilhomximo,ede
formasemelhanteparaoinferior.Estesvaloresaplicamsedeformaindependenteparacadacanaldecor,semaisdoqueumaestem
uso.Imediatamenteabaixodoscontrolesdeslizantes,osvaloresdepixel,quecorrespondemaobrilhomnimoemximosoexibidos.No
modoindexadoexisteumintervalo,eemmododeRGBpodemexistirattrs.Seaimagemnobastantecompletamentecoberto,este
controlenolhedtantaliberdadequantovocpodegostarainterfacedousuriopodesermelhoradaemfuturasverses.
Corescadastradas
Quandoestivernomodoindexado(noRGB)apenas,issopermitequevocselecioneummapadecoresquedeterminacomoosvalores
depixel(contagensousomasporescaninho)sotransformadasemcoresnatela.Ovalormaisbaixocorrespondecor,aoladoesquerdo
doconeeovalormaisaltoparaoladodireito.NomodoRGBesteestdesativado.
Osseguintesbotesestodisponveisnabarradeferramentas:
Rachadodajanela
Permitequeoseletordeconjuntodedadosparaserredimensionadaarrastandoumseparadorentreeleeareadeplotagem.Bompara
telaspequenas.
Replot
Redesenhaoenredoatual.Normalmentenonecessriousaresteboto,umavezquesevocalterarqualquerumadascaractersticas
datramacomoscontrolesnestajanelaoenredovaiserredesenhadoautomaticamente.Noentanto,sevoctiveralteradoosdados,por
exemplo,aoeditarasclulasnajaneladedados,oenredonoredesenhadoautomaticamente(umavezqueeste,potencialmente,uma
operaocaraevocnopodeexigirisso).Aoclicarnestebotoredesenhaoenredotendoemcontatodasasalteraesaosdadosda
tabela.
ConfigureAxeseTtulo
Abreumdilogoparapermitiraconfiguraomanualdasfaixasdeeixo,rtulosdoseixosettulotramaverApndiceA.5.1.2.
ExportarcomoPDF
AbreumdilogoquevaiescreveratramaatualcomoumarquivoPDF.
ExportarcomoGIF
AbreumdilogoqueirimprimiroenredoatualparaumarquivoGIF.Oarquivodesadaomesmoqueaimagemplotadaquevoc
v.RedimensionarajaneladeplotagemantesdaexportaoparacontrolarotamanhodoGIFdesada.
ExportarcomoFITS
AbreumdilogoqueirimprimiromapaplotadocomoumamatrizFITS.Seapenasumcanalvisvel(ouummodoindexadocanalde
corou),entoasadaFITSarquivoserumamatriz2Dcomdimensesdamesmaformaqueaimagemapresentada.Seexistiremvrios
canaisRGB,entoamatrizdesadaseroem3Dcomaterceiradimensotemumaextensode2ou3,dependendodonmerode
canaisdecoresvisveis.EmambososcasosoarquivoFITSterumanica(primrio)HDU.Bsicocoordenarasinformaesdo
sistema,bemcomoDATAMINeDatamaxcartes,serescritoparaocabealho.Otipodamatrizdesadaserodobrodeprecisopara
valoresponderados,oualgumtipointeirodecomprimentosuficienteparaosnoponderadas.
Redimensionar
Redimensionaoseixosdoplanoatualparaqueelecontmtodosospontosdedadosemsubconjuntosselecionadosnomomento.Por
padro,oenredovaiserescaladocomoesse,maselepodetermudadoporcausademudanasnaseleosubconjuntooudezoominou
out.
EntrarIntensidade
Alternaentrelinearemapeamentologartmicaparaaintensidadedacoremfunodonmerodecontagens.
Cor
AlternaentreosmodosindexadoseRGB(vejaaexplicaoacima).
http://127.0.0.1:2525/doc/sun253/sun253.html

123/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Mostrarlegenda
Defineseumalendamostrandocomocadaconjuntodedadosrepresentadovisveldireitadatrama.Inicialmente,alegenda
mostradasomentesehouvermaisdeumconjuntodedadosestsendomostradoaomesmotempo.
MaioresPixels
Aumentaotamanhodopixeldatelacorrespondenteaumadensidademapabin.
MenoresPixels
Diminuiotamanhodopixeldatelacorrespondenteaumadensidademapabin.
DesenhesubconjuntoRegio
PermitequevocdesenheumaregionateladefinindoumnovosubconjuntoRow.Quandovocterminardedesenhlo,clique
novamentenestebotoparaindicarquevocestfeito.VejaApndiceA.5.1.6paramaisdetalhes.
Subconjuntodevisvel
DefineumnovosubconjuntoRowconsistindoapenasospontosqueestoatualmentedisponveisnasuperfciedatrama.Veja
ApndiceA.5.1.6paramaisexplicaes.
Abarradeferramentasdoconjuntodedadoscontmasseguintesopes:
/

Adicionar/Removerdataset

Adiciona/removeabasemqueosdadosparaconjuntosdedadosadicionaispodemserinseridos.VejaApndiceA.5.1.1.
CountsPeso
Seestebotodealternnciaestligada,umadicionaldepesodoeixoseletorapareceabaixodoeixoXselector.Seestepreenchido
comumnomedecolunaoudeexpresso,emseguida,emvezdesimplesmenteacumularonmerodepontosporbin,cadapixelir
representarasomasobreaquantidadedeponderaoparaospontosemcadacompartimento.Noterumeixodepesoequivalentea
preencheroseuvalorcomaquantidade1.Observeque,componderao,afiguratraadajno,estritamentefalando,umhistograma
oumapadedensidade.
OExportmenuforneceumasriedemaneirasparaexportaraimagemexibidaparavisualizaoouanliseexterna.Bemcomoasopespara
exportarcomoGIF,JPEG,EPSeseencaixa,htambmaopodetransmitiraimagemFITSparaumaoutodasasaplicaesdeescuta
usandooSAMPouplsticoprotocolointeroperabilidadeferramentaqueirreceberimagens.Destaforma,vocpodetransmitiraimagem
diretamenteparaSAMP/ferramentasdemanipulaodeimagemPLASTICawarecomoGAIAouAladin.VejaSeo9paraobtermais
informaessobreainteroperabilidadedeferramentas.
Comodefinirocanaldecorcorrespondenteacadaconjuntodedadosexplicadonasubsecoseguinte.
EstiloA.5.7.1Densidadeeditor
ParaummapadedensidadenomodoRGB,cadaconjuntodedadosatribudoumcanaldecorparaaqualcontribui.Arepresentaodesta
exibidoemumbotodireitadoseunomenopainelseletordeconjuntodedadosnaparteinferiordajaneladomapadedensidade.Sevoc
clicarnestebotooseguintedilogoiraparecer,quepermitequevocmudeocanaldecor.

Dilogoeditordeestiloparamapadedensidade
ALendacaixadefinecomooconjuntoselecionadoseridentificadonalegendaqueapareceaoladodoenredo(emboraalendasservisvel
seMostrarlegenda(
)estligado):
cone
Exibeoconequesermostradoparaidentificarospontosnoconjuntoselecionado.Suaaparnciadependedasseleesquevocfazno
restodajaneladedilogo.
Etiqueta
Donomeescritonalegendaparaidentificarosubconjunto.Porpadro,estederivadodonomedosubconjuntoRowe,seissonofaz
partedoconjuntodedadosprincipal,onomedoguiadoconjuntodedados.Vocpodedigitarumnovovalorparamudaroqueest
escritonalegenda.
OcultarLegenda
Seestaopoforselecionada,nenhumaentradaparaoconjuntoselecionadoaparecernalegenda.
OCanalseletorpermitequevocselecioneoVermelho,VerdeouAzulcanalparaesteconjuntodedadosparacontribuir.Notequeistos
esthabilitadonomodoRGBnomodoindexadonotemnenhumefeitoeestdesativado.
http://127.0.0.1:2525/doc/sun253/sun253.html

124/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaA.6Carga

Janeladecarga
AJaneladecargautilizadoparacarregarastabelasdeumlocalexterno(porexemplo,discoouURL)emTOPCAT.Elaobtidausandoo
CargaTabelaboto(
)najaneladecontroledabarradeferramentasoudoArquivomenu.
Estedilogopermitequevocespecifiqueumanovatabelaparaabriremumasriedemaneirasdiferentes,descritosaseguir.Sevocexecutar
umacargabemsucedidausandoqualquerumadessasopes,umanovaentradaouentradasseroadicionadosnalistadetabelanajanelade
controle,quevocpodeusarnoscaminhoshabituais.Sevocescolherumlocalquenopodesertransformadoemumatabela(porexemplo,
porqueoarquivonoexiste),umajanelapopupdizendooquedeuerrado.Opainelnaparteinferiordajanelaexibeoprogressoparaas
tabelasatualmentecarregamentoeleusadoparamostraroprogressoparaosquadroscarregadosdeoutrasfontestambm,porexemplo,
recebeuviaSAMPouespecificadonalinhadecomando.
Nocasomaissimples,vocpodedigitarumnomeparaaLocalizaodecampoebateuretornoouoOKboto.Esselocalpodeserumnome
dearquivoouumURL,possivelmenteseguidoporum'#carter"eum"fragmentoidentificador'paraindicaremquelugardoarquivoou
URLatabelaestlocalizadaosdetalhesdoqueessesidentificadoresdefragmentossignificapodemserencontradosnasubseorelevante
dentroSeo4.1.1.PermitidostiposdeURLsodescritosemSeo4.2.Vocdeveselecionaroformatodetabelarelevantedoformato
caixaseletorvocpodedeixloligado(automtico)paraocarregamentoFITStabelasouVOTables,masparaoutrosformatos,comoASCII
ouCSVvocdeveselecionarapessoacertaexplicitamente(novamente,consulteaSeo4.10,1paramaisdetalhes).
Hmuitasoutrasmaneirasdecarregartabelasnoentanto,descritosnassubseesaseguir.ONavegadorFileStoreenavegadordosistema
botessosemprevisveisabaixodocampolocal.Dependendodasopesdeinicializao,podehaveroutrosbotes.Htambmumnmero
debotesdabarradeferramentasqueexibemvriosdilogosdecargaosDataSourcescontmtodosestes,juntamentecomalgunsmais
menosutilizadas.Assubseesseguintesdescrevemamaioriadasopesdisponveis,emboraosoutrospossamestardisponveisemsua
instalao.
Asopesdisponveisnabarradeferramentas,porpadro,soestes:
FilestoreNavegador
Navegadordosistema
NavegadorHierarquia
SQLQuery
ConePesquisa
SimplesAcessoImagem(SIA)Consulta
Acessoespectralsimples(SSA)Consulta
TabelaAccessProtocol(TAP)Consulta
VizirCatlogodeServiodeConsulta
GAVOMilnioDatabaseQuery
TeoriaBastiDatabaseQuery
TodosessesdilogosdecargatemumOKboto.Umavezquevocclicarnele,sejaqualforacargaquevocespecificouseriniciado.Sea
cargademoramaisdoquealgunscentsimosdesegundo,umabarradeprogressoiraparecernaCarregandoTabelaspaineldajanelade
carga,comonaimagemacima.Istoirinformarsobrequantaslinhasforamcarregados,eseconhecido,quantossonototal.Sevocquiser
interromperacargaporqualquermotivoenquantoestiveremandamento,cliquenoCancelarboto,eacargacessar.Seacargacompleta,sem
http://127.0.0.1:2525/doc/sun253/sun253.html

125/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

cancelamento,umanovatabelaserexibidonaTabelaListadosprincipaisjaneladecontrole,prontoparauso.
Porpadro,quandoumacargademesafoiconcluda,tantoaprpriajaneladecargaequalquerjaneladedilogodecargaespecficausadaser
fechada.Sevocnoquerqueissoaconteausaraficaraberto(
)itemnajanelademenuoubarradeferramentasdajaneladecargae/
oudilogocargaespecfica.Seestaopoforselecionada,ajanelanoserfechadaautomaticamente.Istopodesermuitoconvenientesevoc
quisercarregarvriastabelasapartirdeumlugarsemelhante,porexemplo,vriosarquivosdomesmodiretrioouvriaspesquisasdecone
paradiferentesservios.

A.6.1FileStoreNavegador

Filestorejaneladonavegador
AoclicarnonavegadorFileStorebotoouobotodabarradeferramentas(

)najaneladecarga,possvelobterumnavegadorde

arquivosqueirexibirosarquivosemumdeterminadodiretrio.Aformacomoistofuncionajanelaquasecertamentefamiliaravocapartir
deoutrasaplicaes.
Aocontrriodeumnavegadordearquivospadronoentanto,tambmpodeprocurararquivosemfilestoresremotas:atualmentesuportadosso
MySpaceeSRB.MySpaceumsistemadearmazenamentodistribudodesenvolvidoparausocomoObservatrioVirtualpeloAstroGrid
projetoeSRB(StorageResourceBroker)umsistemadepropsitogeralsemelhantedesenvolvidonoSDSC.Parafazerusodessas
instalaes,selecioneaentradacorrespondentenacaixadeseletornotopodajanela,comoilustradoacimaissovaimostrarumaSessoboto
quelhepedeonomedeusurio,senha,etc,eentovocvaisercapazdenavegarnafilestoreremotocomosefosselocal.Omesmoboto
podeserusadoparafazerlogoutquandovocestacabado,masasessoserdesconectadoautomaticamentequandoTOPCATterminaem
qualquercaso.OacessoasistemasdearquivosremotosdependentedecertoscomponentesopcionaisdeTOPCAT,epodenoestar
disponvelsevoctiveraconfiguraotopcatlite.
Onavegadorexibeinicialmenteodiretrioatual,masissopodeseralterado,digitandoumnovodiretrioparaonomedoarquivodecampo,
ousubirnahierarquiadediretriosusandoacaixadeseletornotopo,ounavegarnosistemadearquivosclicandonobotoupdiretrioou
clicandoduasvezesemdiretriosexibidos.Odiretriopadroinicialpodeseralterado,definindoouser.dir propriedadedosistema.
Todososarquivossomostrados,enohnenhumaindicaodequeosrepresentamtabelasequaisno.Paraabrirumdosarquivosexibidos
comoumatabela,cliqueduasvezessobreeleouselecioneoclicandoumavezecliquenoOpenTableboto.OFormatodatabelaseletor
deveserajustadocorretamente:adefinio"(automtico)"irdetectarautomaticamenteoformatodeVOTableouFITStabelas,casocontrrio
vocterdeescolheraopoquedescreveoformatodoarquivoquevocesttentandocarregar(verSeo4.10,1).Sevocpegarum
arquivoquenopodeserconvertidoemumatabelaumajaneladeerroserexibida.
Namaioriadoscasos,selecionandoonomedoarquivoe,possivelmente,oformatotudoquevocprecisafazer.Noentanto,aposiono
arquivodecampopermitequevocadicioneinformaessobreondenoarquivodatabelaquevocdesejaestsituado.Osignificadodesta
variadeacordocomoformatodearquivo:paraarquivosFITS,ondiceouextnamedoHDUquecontmatabelaquevocestdepois(ver
Seo4.1.1.1paramaisdetalhes),eparaVOTablesondicedoelementoTABLE(aprimeiratabelaencontradanumerado0).Sevoc
deixarestecampoembranco,vocrecebertodasastabelasnoarquivoissogeralmenteapenasumamesa,umavezqueamaioriados
formatosdearquivonopodeacomodarmaisdeumatabelaporarquivo,emesmoparaaquelesquepodem(FITS)eVOTablemaioriados
arquivoscontmapenasumnicoarquivoemqualquercaso.
Paraumavisomaisconscientedatabeladosistemadearquivos,useonavegadordehierarquiaemseulugar.

NavegadorA.6.2Sistema
http://127.0.0.1:2525/doc/sun253/sun253.html

126/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Aoclicarnonavegadordosistemaouobotodabarradeferramentas(

)najaneladecarga,vocpodeusaronavegadordearquivos

nativodoseusistemaoperacionalparaescolherumarquivoparacarregarapartir.Oqueistoparecetotalmentedependentedoseusistema
operacionalelepodeounopodeconterrecursosespecficosdosistema,comoatalhosparadiretrioscomumenteusados.
DesdeTOPCATnotemcontrolesobreaformacomoestedilogoparece,elenopodeconteroFormatodatabelaselector,ealgumas
outrascoisas,comocargacancelarpodenofuncionartobemcomoparaosoutrostiposdedilogo.Paraselecionaroformatodetabela,voc
vaiprecisarusaroselectornaprincipaljaneladecarga.

HierarquiaA.6.3Navegador

Hierarquiajaneladonavegadordearquivosdecarga
AoselecionaroNavegadorHierarquiaboto(

)dacargaJaneladabarradeferramentasou'sDataSourcesmenu,vocpodeobterum

navegadorqueapresentaumavisohierrquicadatabelacientedosistemadearquivos.(Notesequeumaversoindependentedestepainel
comfuncionalidadeadicionalestdisponvelnoseparadaTreeviewdaaplicao).
EstenavegadorlembraonavegadorFileStoreemalgunsaspectos,mascomdiferenasimportantes:
Elemostraosistemadearquivosemuma"rvorelike'moda,paraqueosvriosnveisdahierarquiasoexibidasdeumasvez
Eleentendequeositensnahierarquiarepresentamtabelasquepodemserautomaticamentedetectadosequerepresentamoutrostiposde
objeto(porexemplo,diretrios,arquivoszipouarquivosdetextosimples)
Elepodeolharparadentrodearquivoshierrquicos,paraque,porexemplo,elepodeinvestigarumarquivoZipouTarquepodeconter
entradasdatabelaouexibirmltiplasHDUstabularemumarquivoFITS,ouvrioselementosdatabelaemdiferentesnveisemum
documentoVOTable
Aparteprincipaldajanelamostraumarepresentao"rvore"dahierarquia,inicialmenteenraizadanodiretrioatual(odiretrioinicialpode
seralterado,definindoouser.dir propriedadedosistema).Cadalinhaexibidarepresentaum"n",quepodeserumarquivooualgumoutro
tipodeitem(porexemplo,umaHDUemumFITSouumarquivodeentradaemumarquivotar).Alinhacontmumpequenoconequeindica
otipodenqueeumtextocurto,quedoseunomeetalvezalgumadescrio.Nodesquerepresentamtabelassoindicadospelo cone.
Paraosnsquetmumaestruturainterna,htambmuma"pega",queindicaseelesestiveremrecolhidos( )ouexpandido( ).Vocpode
examinarespaosdearquivoremoto(MySpace,SRB),bemcomooslocaisdamesmaformacomocomoNavegadorFileStore.
Sevocselecionarumn,clicandosobreela,elaserrealadaealgumadescrioadicionalserexibidanopainelabaixodovisorhierarquia.
Otextoestemnegritoseonemquestopodeserabertocomoumatabela,enonegrito,seforalgumitemnomesa.
Nota:umarestrioimportantedestenavegadorqueelesvaipegarastabelasquepodemseridentificadosautomaticamenteissoinclui
FITSearquivosVOTable,masnoincluiosformatosbaseadosemtexto,comoASCIIevaloresseparadosporvrgula.Sevocdeseja
carregarumdosltimostiposdetabela,vocvaiprecisarusarumdosoutrosmtodosdecargaeespecificarformatodetabelaexplicitamente.
http://127.0.0.1:2525/doc/sun253/sun253.html

127/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Vocpodevercomoestenavegadorfuncionaemumdiretrioexemplodetabelas,conformedescritonoApndiceA.6.12.
NotesequeestajanelarequercertoscomponentesopcionaisdainstalaoTOPCAT,enoestardisponvelsevoctiveraconfigurao
topcatlite.
A.6.3.1Navegao
Anavegaoumpoucodiferentedanavegaononavegadordearquivosjanela.Paraexpandirumneverseucontedo,cliqueemsua
ala(clicandonopunhoquandoeleexpandidovairecolhlanovamente).Quandovoctiveridentificadoatabelaquevocdesejaabrir,
selecioneoclicandosobreelee,emseguida,cliquenoOpenTablebotonaparteinferior.
Paramoverparaumdiretriodiferente,ouseja,paramudararaizdarvorequeexibido,useumdosbotesacimadaexibiodervore:
CaixaSelector
Permitemoveremlinharetaparaqualquerdiretriomaisaltodoqueoatual.
Paracima
Moveseparaopaidodiretrioatual.
Parabaixo
Moveparaonatualmenteselecionado(realado).
Casa
Moveseparaodiretriohomedousurio.
Alternativamente,vocpodedigitarumnovodiretrionoIrparacamponaparteinferiordajanela.
(Naverdade,asopesdenavegaoacimanoserestringemamudararaizparaumnovodiretrio,elespodemsedeslocarparaqualquern
narvore,porexemplo,umnvelemumarquivotar.)
PesquisasTabelaA.6.3.2
Hmaisdoisbotesnonavegador,pesquisaselecionadosePesquisarvore.Estesfazemumapesquisarecursivaparatabelasemtodosos
nsapartirdeoqueestselecionadoouaraizatual,respectivamente.Oqueistosignificaqueoprogramavaiinvestigartodaahierarquia
olhandoparatodosositensquepodemserusadascomotabelas.Seeleencontraralgumaelevaiabrirarvoredemodoqueelessovisveis
(notequeissonosignificaqueosnicosnsreveladassertabelas,ancestraiseirmosserreveladotambm).Issopodesertilsevoc
acreditaquehalgumasmesasenterradosemalgumlugaremumaestruturadediretriosprofundaouarquivotar,masvocnotemcertezade
onde.Notesequeestepodeserdemoradoumcursordeocupadoexibidaenquantoapesquisaestacontecendo.Alterandoaraizdarvore
vaiinterromperaprocura.

A.6.4SQLQuery

SQLQueryDilogo
SevocquiserlerumatabeladeumbancodedadosSQL,vocpodeusarumdilogoespecializadaparaespecificaraconsultaSQL,
selecionandoconsultaSQLbotodacargaJaneladabarradeferramentas's(
)ouDataSourcesmenu.
Istoproporcionalheumalistadecamposparapreencher,quecompemaconsulta,conformesegue:
Protocolo
OnomedasubprotocoloJDBCapropriado.IssodefinidopelodriverJDBCquevocestusando,e,porexemplo,"mysql"para
Connector/JmotoristadoMySQLou"postgresql"paradriverJDBCdoPostgreSQL.
http://127.0.0.1:2525/doc/sun253/sun253.html

128/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Hospedeiro
Onomedohostdamquinanaqualresideobancodedados(podeser"localhost"seobancodedadoslocal).
Nomedobancodedados
Onomedebancodedados.
Nomedeusurio
Onomedeusuriosobaqualvocdesejaacessarobancodedados.Istonoestritamentenecessrio,senohouvercontroledeacesso
paraobancodedadosemquesto.
Senha
Asenhaparaonomedeusurio.Maisumavez,seissofornecessriodependedapolticadeacessodobancodedados.
SQLQuery
Otextodaconsultaqueirdefiniratabelaresultante.SevocquerolharparaumatabelachamadaXXX,talcomoexistenobancode
dados,vocpodeescreveralgocomo"SELECT * from XXX".Emprincpio,qualquerconsultaSQLnobancodedadospodeserusado
aqui,masosdetalhesdoqueasintaxeSQLpermitidopodeserrestringidopelodriverJDBCquevocestusando.
HumasriedecritriosquedevemsersatisfeitosparaacessoSQLparatrabalhardentroTOPCAT(instalaodedriversapropriadoseassim
pordiante)verSeo10.3.Sevocnotomaressasmedidas,essedilogopodeserinacessvel.
AmaneiraqueoscontatosdestedilogoobancodedadosfazalgumassuposiessobrecomoodriverJDBCfuncionaquenemsempreso
verdadeiras,entoparaalgunsbancosdedadosedriverspodenoserpossvelfazlofuncionar.Podesermelhoradonofuturosevoctem
problemasespecficos,porfavor,entreemcontatocomoautoroualistadediscusso.

A.6.5ConePesquisa
VejaApndiceA.9.2paramaisdetalhes.

A.6.6SIAConsulta
VejaApndiceA.9.3paramaisdetalhes.

A.6.7SSAConsulta
VejaApndiceA.9.4paramaisdetalhes.

A.6.8TAPConsulta
VejaApndiceA.9.8paramaisdetalhes.

A.6.9vizirCatlogodeServiodeConsulta

http://127.0.0.1:2525/doc/sun253/sun253.html

129/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Dilogocargavizir
OdilogoconsultavizirpodeserabertousandoovizirCatlogodeServioboto(

)nacargaJanela'sbarradeferramentasouajanelade

controledoVOmenu.ElepermitequevocfaaconsultasdiretamenteaovizirserviooperadopeloCDS.Vizirumabibliotecaabrangente
demuitoscatlogosastronmicospublicados.Essesitenspodemigualmenteseracessadoapartirdawebououtrasinterfaces,masessedilogo
cargatornaconvenienteparacarregarosdadosdiretamentedoviziremTOPCAT.
Notesequeaidiadevizirdeumcatlogomaiscomplexadoqueumanicatabelaissosignificaque,emalgunscasosconsultarumdos
catlogosdovizirpoderesultaremmaisdeumatabelaqueestsendocarregadonoTOPCAT(oSubTableDetalhescheckboxdescritoa
seguirpodeajudaracontrolarisso).
Odilogoconsisteemquatropartes:oservidorvizir,seleodelinha,seleodecolunaeseleodecatlogopainis,organizadosde
cimaparabaixonajanela.Estesencontramsedescritosabaixo.
OvizirServidorpainelpermitequevocespecifiquequalservidorvizirquedesejausarparaodownloaddedados.Porpadro,oservidorno
CDSusado,mashespelhosemoutroslugares,cujosURLspodeserescolhidoapartirdoselector.Sevocverumajanelapopupse
queixandodequeoservidornopodesercontactado,vocpodeescolherumdiferentevoctambmpodequererescolherumqueestperto
devoc,porrazesdedesempenho.
Aseleodelinhapainelespecificaquaislinhasvocdesejarecuperarapartirdocatlogoquevocirselecionar.Vocpodeescolherumdos
doisbotesderdiodeacordocomotipodeconsultaquevocquerfazer:
ConeSeleo
Nestecaso,vocdevedarumaposiocucentraleoraiodepesquisaparadefinirumaregioemformadeconedeinteresse.Linhas
dentrodesseintervaloserdevolvido.Paraaposiocentral,vocpodepreencherosRAedezembrocamposdiretamente,ouvoc
podepreencheronomedoobjetodecampoebateuoResolvebotonoltimocaso,umaconsultaSIMBADserfeitoparadeterminar
ascoordenadascorrespondentesparaoobjectonomeado.
http://127.0.0.1:2525/doc/sun253/sun253.html

130/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

TodasasLinhas
Alternativamente,vocpodeoptarporbaixartodoocatlogosemrestriesespaciais.
Emambososcasos,amximaRowCountseletorindicaomaiornmerodelinhasqueseroretornadas.Seaconsultasolicitamaislinhasdo
queolimitedado,linhasextrasserosimplesmenteomitidadoresultadoretornado(olimitepareceseraproximado).possvelescolher
qualquervalorparaestecampo,incluindoosmuitograndesouovalorespecial"ilimitado"noentantoconsiderarantesdefazerissosevoc
quiserbaixarumpotencialmuitograndeconjuntodedados.Oservidorpode,emqualquercaso,otemponocasodeumtempomuitolongode
conexo,porissoprovavelmentenopossvel,mesmoquefossedesejvel,paradownload,porexemplo,todoocatlogofontepontual
2MASS.
ASeleodecolunapaineldlhealgumcontrolesobrequaiscolunasseroincludosnatabelacarregado.Issoirincluiralgumasoutodasas
colunasdatabelatemnoarquivovizir,etalvezalgunsmaisconvencionaisadicionadosautomaticamentepeloservio.Asopesso
atualmente:
padro
Contmumaseleodessascolunasconsideradasmaisinteressantepeloservio.
omisso
Contmascolunas"padro"mais"_RAJ2000"numricoe"_DEJ2000"colunasposicionaisinseridospeloservioseaconsultauma
SeleoCone,emvezdetodasaslinhas,eletambmcontmumacoluna"_r"inseridopeloservio,dandoadistnciaentreaposio
selecionadaedaposiodalinha.
tudo
Contmtodasascolunasdocatlogoarquivado.
Especialistasvizirpodempreencherosrequisitosdecolunapersonalizadasaquidigitandoosnacaixadeseletoremvezdeescolherumadas
opesprdefinidas,porexemplo-out.add = _GLON, _GLATacrescentariagalcticocoordenadasparaoconjuntopadroverhttp://vizier.u
strasbg.fr/doc/asusummary.htxparamaisdetalhessobrevizirpirataria.(Naverdade,estetruquepodeserusadoparaadicionarparmetrosvizir
norelacionadosseleodecolunatambm).
OCatlogoSeleopaineloferecevriasmaneirasdiferentesparaidentificarqualdoscatlogosnoarquivovizirquevocdesejaconsultar.
Emtodososcasos,vocserpresenteadocomumaJTabledecatlogosdevizir,evocdeveselecionarumclicandonalinhacorrespondente.
Vocpodeclassificardentrodatabelaexibida,clicandonocabealhodacoluna.Nota:paraalgumasdessasopes,necessriopreenchero
paineldeseleodelinhaantesquevocpossaoperlos(oscontrolesserdesativadosenenhumaseleolinhafoifeita).Issoporqueos
catlogoslistadosdependerdaregioquevocestindoparaconsultaVizirinteligenteosuficienteparasaberqueoscatlogostmalguma
coberturanaregioemquesto.Asopesparaaselecodecatlogosodaseguinteforma:
Porcategoria
Vocpodeselecionarumoumaistermosdeumaoumaisdaslistasapresentadasdepalavraschaveprdefinidasnascategoriasde
comprimentodeonda,MissoeAstronomiapararestringiroscatlogosquevocestinteressadopolegadasComovocselecionar
vriasentradasdamesmalistadependentedeplataforma,masCTRLcliquepodetrabalhar.Quandovoctiverfeitosuasselees,
bateuoProcurarCatlogosboto,eessescatlogosnascategoriasdeteridentificado,ecomcoberturanaregiodefinidapelopainelde
seleodelinha,serolistadosabaixodopaineldeseleodecategoria.Selecioneumadelas,clicandosobreela.OSubTableDetalhes
opocontrolasealistaexibecatlogosvizirdenvelsuperiorapenas(cadaumdosquaispodecontervriastabelas)ouentradaspara
cadatabeladentrodecadacatlogotambm.Ainclusodetabelasobsoletosopocontrolaseapenasosmaisatuais,outodasas
versesdecadacatlogosomostrados.
Porpalavrachave
APalavraschavecampodetextomostradavocpodeentraremumalistaseparadaporespaosdepalavrasquesercomparadocom
nomesdecatlogoedescries.Depoisdeterintroduzidoostermosdepesquisa,bateuoProcurarCatlogosboto,eessescatlogos
quecorrespondemaosseustermos,ecomcoberturanaregiodefinidapelopaineldeseleodelinha,serolistadosabaixodocampode
palavraschave.Selecioneumadelas,clicandosobreela.OSubTableDetalhesopocontrolasealistaexibecatlogosvizirdenvel
superiorapenas(cadaumdosquaispodecontervriastabelas)ouentradasparacadatabeladentrodecadacatlogotambm.Aincluso
detabelasobsoletosopocontrolaseapenasosmaisatuais,outodasasversesdecadacatlogosomostrados.
Surveys
Umalista(bastantecurto)degrandespesquisasrealizadaspelovizirapresentadoemumatabela.Umaindicaodotamanhodecada
um,emtermosdenmerodemilharesdelinhas,dada.Selecioneumadelas,clicandosobreela.
Misses
Umalista(bastantecurto)deexploraesdedadosemvizirprovenientedegrandesmissesapresentadoemumatabela.Uma
indicaodotamanhodecadaum,emtermosdenmerodemilharesdelinhas,determinado.Selecioneumadelas,clicandosobreela.
Dependendodotipodepesquisadecatlogoquevocfaz,vriosatributosdoscatlogosemquestoserolistadosnatabelaparaaseleo:
Nome
Identificadornicovizirparaocatlogo
Descrio
Brevedescriodocontedo
KRows
Nmeroaproximadodemilharesdelinhas
Linhas
Onmeroaproximadodelinhas
Tabelas
Nmerodesubtabelascontidasnocatlogovizir
Popularidade
Amedidadonmerodeconsultasnocatlogoservidoporvizir
Densidade
Umamedidadonmerodefontespornguloslidounidadenocu
Oscomprimentosdeonda
http://127.0.0.1:2525/doc/sun253/sun253.html

131/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Palavraschavequedescrevemregimesdecomprimentodeondacobertos
Astronomia
Palavraschavequedescrevemdomnioassunto
Quandovoctiverfeitoasuaselecodelinhas,colunasecatlogovocpodebateroOKbotoeTOPCATtentarentraremcontatocomo
serviodevizirparacarregaratabelaoutabelasresultante.VocpodecancelarumpedidoemandamentocomoCancelarboto.
CDSfazeroseguintepedido:
Seoacessoaoscatlogoscomvizireratilparaoseutrabalhodeinvestigao,aseguintedeclaraoseriaapreciada:"Esta
pesquisafezusodaferramentaviziracessocatlogo,CDS,emEstrasburgo,Frana."Adescriooriginaldoserviovizirfoi
publicadaemA&AS143,23(2000).

A.6.10GAVOMilnioDatabaseQuery

DilogocargaGAVOcomumexemplodeconsultanobancodedadosmiliMilnio
Estedilogo,seleccionadosdacargaJanelabotodabarradeferramentas's(

)ouoprincipalVOmenupermiteconsultasdiretasaos

serviosprestadospelaGAVO,oObservatrioVirtualAstrophysicalalemo.Asprincipaisbasesdedadosdeinteressegeraldisponveispor
meiodessesserviossoosdoMilnioSimulaoresultados,documentadosemhttp://gavo.mpagarching.mpg.de/Millennium/Help.
Parafazerumaconsulta,preenchaoscamposconformenecessrio:
URLbase
Issodeterminaobancodedadosaserconsultado.Asseguintesopesestodisponveis:
MillidoMilnio(http://gavo.mpa-garching.mpg.de/Millennium)
BancodedadosderesultadosdasimulaoPblica,contendoumafraodosresultadosdasimulaocompleta.Nonecessrio
umnomedeusurioousenha(ascaixasdeUsurioeSenhaserdesativado).
Milnio(http://gavo.mpa-garching.mpg.de/MyMillennium)
Completa,bancodedadosprotegidoresultadosdasimulao.Onomedeusurioesenhadevemserpreenchidosparaessas
consultas.RegistoatravsdaaplicaodeGAVO.
Outro
OutrosserviosdisponibilizadosGavopodeseracessadoapartirdestedilogo,digitandooURLbaserelevanteaquiosusurios
dessesserviosvaisaberoqueelesso.Elespodemounoexigirumnomedeusurioesenha.
Usurio
Senha
Informaesderegistro,senecessrio(dependendodoURLbasecomoacima).
SQLQuery
OtextodeumaconsultaSQLnobancodedadosemquesto.
Emseguida,cliquenoOKboto,eaconsultairexecutarecarregarosresultadosemTOPCAT.ClicandoCancelarenquantoeleestiverem
progressoirparloemexecuo.
OsHaloSampleseGalaxySamplesmenusforneceralgunsexemplosdeconsultasnobancodedadosMillidoMilnio(estesforamcopiados
dapginadeconsultaGAVO).SevocselecionarumdelesoSQLQuerypainelserpreenchidoemconformidade.
Muitomaisdocumentao,incluindotutoriaisedescriesdosesquemasdebancodedados,estdisponvelnositedoGAVO,pelo
http://gavo.mpagarching.mpg.de/Millennium/Help.
http://127.0.0.1:2525/doc/sun253/sun253.html

132/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.6.11BastiTeoriadeconsultadebancodedados

GuiadeconsultadilogocargaBasti
Estedilogo,seleccionadosdacargaJanelabotodabarradeferramentas's(

)ouoprincipalVOmenupermiteconsultasdirectasparao

Basti(BagofTracksestelareiscronos)bancodedadosorganizadopeloObservatrioAstronmicoINAFTeramo.Vocpodeencontrar
documentaomaisdetalhadasobreowebsite.
Estedilogocargatemduasguias:umaconsultaguiaparaosparmetrosdepesquisadeentrada,eumResultadoguiaparaexibiratabelade
resultadoscomumalinhaparacadatabelaresultantedaconsultadousurio.
Aconsultaguiacontmumconjuntodeparmetrospelosquaisaconsultaserrestrita,algumasajudasparaajudarousuriodurantea
preparaodaseleoedoisbotes.Oresetbotosimplesmentelimpaentradasdeconsultae(sehouver)seleesdousurionoguia
Resultados.OEnviarbotoexecutaaconsultaemudaodilogoparaaguiaResultados.Comoauxlioparapermitirumaconsultarefinada
semdemaisetapasrecursivas,nocentroinferiordaguia,umcontadorexibeonmerodelinhas(ouseja,tabelasresultantes),asadavaicontar.
Lembrandoqueosresultadosiroconter30linhas,nomximo,ousuriopoderefinardoqueseus/suasrestriesparareduzironmerode
resultados.
Paraissoaconsultaajudaousuriodeduasmaneiras,principalmente:desmarcandoautomaticamenteosparmetrosnodisponveisparauma
consultaespecfica(porexemplo,afaixademassaparaumapesquisaisochrone)eexibio,paraosparmetrosdelongoalcance,oslimitesde
valorparaesseparmetro,issoaconteceapenasmoverocursordomousesobreareadeentrada.
Aquisegueumabrevedescriodosparmetrosdeconsulta,paramaisdetalhesconsulteoBastilocalprincipal.
Tipodedados
Otipodesimulaodesejada:iscronas,faixasoutabelasderesumo.Estecampoobrigatrioonicoaapresentarumaconsulta.
Cenrio
Cenriodeevoluoestelar,ouseja,simulaooucannicaincluindoclculosultrapassagem.
Tipo
Tipodesimulaopista:normalouinclusiveasimulaoAsymptoticgiganteBranch(AGB).
Perdademassa
Selecionaquaisvalorizamoparmetroperdademassadeveter:0.2ou0.4soasopesdisponveis.
Sistemafotomtrico
Umconjuntodesistemasfotomtricosusadoparacolorirasfaixassimuladosestelaresparacomparaocomosdadosobservacionais.
Estaentradasuspensapermiteumaselecodentrodelas.
Mistura
Abundnciasestelaresmistura:escaladovaloressolaresoualfareforada.
Idade
Faixaetria,emvaloresdeGyr,paraasiscronas.
Massa
Faixademassa,emvaloresdemassassolares.
Z
Gamaabundnciademetalinicial.
Y
GamaabundnciaHlioinicial.
[Fe/H]
http://127.0.0.1:2525/doc/sun253/sun253.html

133/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Ferrosobreproporologartmicahidrognio.
[M/H]
Metaismaisproporologartmicahidrognio.
Umavezqueopaineldeconsultafoipreenchido,bateuoEnviarboto.IstoirmostraroResultsguia.Issoexibeumatabelaondecadalinha
refereseaumresultadodisponvelapartirdobancodedadosBastitoconstrangidosporconsultadousurio.Emcimadamesaonmerode
resultadosidentificadospelaconsultarecordado.Ousurioagorapodevoltarpararefinaraconsultaouselecionada(cliquedomouse)amesa
/sele/elaquercarregaremTOPCAT.Umavezqueaseleoestpronta(CTRL+cliqueouShift+cliqueparavriasselees)pressionando
oOKbotoircarregarastabelasemTOPCAT.

TabelasA.6.12Exemplo
FornecidocomTOPCATalgumastabelasdeexemplo,quevocpodeacessaremumnmerodemaneiras.Acoisamaissimplescomeara
seTOPCATcomo"demo-bandeira"nalinhadecomando,oquefarcomqueoprogramainiciesecomalgumasmesasdedemonstraoj
carregadosdentro
VoctambmpodecarregarexemplosdoExemplosdemenunajaneladecarganoentanto.Estecontmasseguintesopes:
CarregarTabelaExemplo
Cargasemumanicatabelaexemplo.
Procurardadosdedemonstrao
AbreumnavegadorHierarquiaolhandoparaumahierarquiadetabelasemdiferentesformatos.Estaopodestinaseamostrarum
poucodacomplexidadeorganizacionalqueTOPCATpodelidarquandosenavegatabelas.
Observeestesexemplossoumpoucodeumsacomisturado,enosotodosqueexemplaresnanatureza.Elessoapenaspresentepara
permitirquevocbrincarcomalgunsdosrecursosdoTOPCATsevocnotemquaisquerdadosreaismo.

A.7SalvarJanela

SalveJanela
AjanelaSalvarusadoparagravarquadrosparafora,eeleacessadousandooSalvartabelaboto(

)najaneladecontroledabarrade

ferramentas'souarquivomenu.
Ajanelaconstitudaporduaspartes.NotopoestoPaineldecontedo,queusadoparadeterminarexatamenteoquetabelaoutabelas
vosersalvos,eabaixodeleoPaineldeDestino,queutilizadaparadeterminarondeelesserosalvos.Estespainissodescritos
separadamentenassubseesabaixo.
Paragrandestabelas,umabarradeprogressoserexibidaindicandoquopertoosalvamentoaconcluso.Noaconselhvelparaeditar
tabelasqueestosendosalvosduranteumaoperaodesalvamento.
Emalgunscasos,salvaratabelaparaumarquivocomomesmonomequeelefoicarregadoapartirdepodecausarproblemas(porexemplo,
umacidentedeaplicaoqueperdeosdadosdeformairrecupervel).Emoutroscasos,perfeitamenteOK.Oprincipalcasoemque
problemticoquandoaediodeumdescompactadoFITSmesabinrianodisco.TOPCATtentaravisloseelepensaquevocest
fazendoalgoquepoderialevaraproblemasignorarissoporsuacontaerisco.
Sevocsalvarumatabelaparaumformatodiferentedaqueleapartirdoqualelefoicarregado,ouseforamadicionadosalgunsnovostiposde
http://127.0.0.1:2525/doc/sun253/sun253.html

134/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

metadados,podenoserpossvelexpressartodososdadosemetadadosdatabelanonovoformato.Algunsmensagemparaesteefeitopodeser
produzidoemtaiscasos.
Nohopoparacompactararquivosnasada.Pode,claro,comprimilosasimesmodepoisdeteremsidoescritos,masnotequeesteno
geralmenteumaboaidiaparaarquivosFITS,umavezqueostornamuitomaislentoparaler(paraTOPCATpelomenos).

PainelA.7.1contedo
OPaineldeContedoapartesuperiordajanelasalvar,eusadoparaselecionaroquetabelaoutabelasquevocdesejasalvar.Asopes
sodescritasnassubseesaseguir.
A.7.1.1TabelaAtual
Atabelaatualsaveoposalvaatabelaatualmenteselecionadanajaneladecontrole.OqueestescritoaTabelaaparentecorrespondente
tabelaatual,quelevaemcontaasmodificaesquevocfezaosseusdadosouaparnciadestasesso.OatualsubconjuntoRoweOrdem
soexibidosnestajanela,comoumlembretedequevocestprestesasalvar.InformaessobreSubconjuntosRowprpriosecolunasocultas
noserosalvas,masvocpodesalvarinformaessobreaadesosubconjuntoatravsdacriaodenovascolunasbooleanascombaseem
subconjuntosusandoo"ParaColuna"boto( )apartirdajanelaSubconjuntos.Alternativamente,vocpodeusaraopoSalvarSesso
descritoabaixo.
VriastabelasA.7.1.2
Asvriastabelassalvaropopermitequevocsalvevriastabelasparaomesmoarquivo.SeumFITSouformatodesadacombase
VOTableusado,issosignificaquequandooarquivocarregadodevoltaparaTOPCAT,todasastabelassalvasserocarregados
individualmentedentro
Alistadetabelascarregadosmostrada,comumacolunadecaixasdeseleoesquerda.Porpadroestessoselecionados,masvocpode
selecionaroudesmarcarlosclicando.Quandooarquivosalvo,somenteastabelascomaoposelecionadasersalvo.
Talcomoacontececomatabelaatualsalvar,aTabelaaparenteemcadacaso,quesalvo,demodoqueapenasascolunaselinhasunhidden
nosubconjuntoatualseroincludos.Noladodireitodatabelaainformaoparalembrloquesubconjuntodelinhaseordenaosersalvo.
A.7.1.3Session
OSessionsaveopopermitequevocsalvegrandepartedasinformaessobreastabelascarregadasnasuasessoTOPCATatual.Ao
contrriodatabelaatualouvriastabelasopes,atotalidadedecadamesacarregado,juntocomoutrasinformaessobreoseuuso,
salvo,enoapenasaTabelaaparente.Ositenssalvosincluem:
Todasaslinhas,enoapenasosdoatualsubconjuntoRow
Todasascolunasvisveiseocultos,juntamentecomsuaordemestatusdevisibilidade
Todosossubconjuntosdelinhadefinidos
Aatualordemdeclassificao
AcorrentesubconjuntoFila
Aetiqueta
SeaseleodelinhaprovocaumatransmissoSAMP
Alistadetabelascarregadosmostrada,comumacolunadecaixasdeseleoesquerda.Porpadroestessoselecionados,masvocpode
selecionaroudesmarcarlosclicando.Quandooarquivosalvo,somenteastabelascomaoposelecionadasersalvo.
Astabelassoguardadascomoummultitableencaixaplus(recomendado)ouVOTablearquivo.Esteumarquivonormalmultimesaemque
quaisquerataquesouleitorVOTablepodelerastabelasqueelecontm,mascontmalgumasinformaesdecodificaodemetadados
especializadadesignificadoespecialparaTOPCAT,marcandoacomoumasessosalva.Oresultadoquesevocsalvarumarquivodesta
formae,emseguida,carreglodevoltaparaTOPCAT,astabelasqueelecarregaapareceremmuitoomesmoestadodequandovocsalvou,
emtermosdedefinioesubconjuntosemcurso,afimdelinha,visvelecolunasinvisveis,eassimpordiante.Sevocprocesslocomalgum
aplicativoquenosejaTOPCAT,elevaiolharmuitocomoatabelaquevocsalvou,mascomalgunsdadosemetadadosadicionais.
Note,porm,queoEstadorecarregadonoidnticoaoqueantesdesalvar.Umadiferenaimportantequeascolunasesubconjuntosde
linhasqueforamdefinidosalgebricamentesosalvaserestauradascomovaloresfixos,porissonomaispossveleditarasexpresses.Outra
quesestadopertencentesatabelassalvo,demodoqueparaasparcelasdeinstncianoserrestaurada.Aesdeativaodatabelano
sosalvostambm.possvelquealgumasdelaspodemseralteradosemversesfuturas.

PainelA.7.2Destino
OPaineldeDestinoaparteinferiordajaneladesalvar,eusadoparaselecionarondeecomoatabelaoutabelasdevemsersalvos.
Oformatodesadadoseletorusadoparaescolheroformatonoqualatabelaserescritoapartirdeumdosformatosdesadasuportados.
Asseleesdisponveissoumpoucodiferentes,dependendodoquequevocestsalvandoporexemplo,algunsformatosnopodem
acomodarvriastabelas,deformaqueestesformatosnosooferecidosparaaMesaMltiplasave.Seo"(automtico)"opoforusada,
feitaumatentativadeadivinharoformatobaseadonoarquivoinformadoporexemplo,sevocespecificaronome"out.fits"umFITSmesa
binriosergravado.
Vocpodeespecificaralocalizaodatabeladesadadessasformas,quesodescritosnasseesaseguir:
http://127.0.0.1:2525/doc/sun253/sun253.html

135/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

DigiteolocaldiretamentenocampoLocaldesadacomoumnomedearquivoouumURLcomodescritonaseoSeo4.2
UseonavegadorFileStorebotoouobotodabarradeferramentas( )paraobterumnavegadorquemostraolocaleremotode
arquivos
Useonavegadordosistemaouobotodabarradeferramentas(
arquivopadrodoseusistemaoperacional
UseatabeladeSQLbotodabarradeferramentas(

)paraobterumnavegadornativoqueusainterfacedesalvaro

)paraobterodilogodesadaSQL

A.7.2.1DigiteLocalizao
VocpodeespecificarondedesejasalvarumatabeladigitandoasualocalizaodiretamentenolocaldesadadecampodajanelaSalvar
tabela.Estasergeralmenteonomedeumnovoarquivoparagravar,maspoderia,emprincpio,serumaURLouumespecificadordeSQL.
II.A.7.2.2FileStoreNavegador

Filestorenavegadorparasalvaratabela
AoclicarnoBrowseFileStorebotonoSalvartabelajanela,vocpodeobterumnavegadorqueirexibirosarquivosemumdeterminado
diretrio.
Onavegadorexibeinicialmenteodiretrioatual,masissopodeseralterado,digitandoumnovodiretrioparaonomedoarquivodecampo,
ousubirnahierarquiadediretriosusandoacaixadeseletornotopo,ounavegarnosistemadearquivosclicandonobotoupdiretrioou
clicandoduasvezesemdiretriosexibidos.Odiretriopadroinicialpodeseralterado,definindoouser.dir propriedadedosistema.
Onavegadorpodeexibirarquivosemfilestoresremotas,comoemservidoresdoMySpaceouSRBvejaaseosobreonavegadordacarga
filestore(AnexoA.6.1)paradetalhes.
Parasalvarumarquivoexistente,selecioneonomedoarquivoecliquenoOKbotonaparteinferiorissovaisubstituiressearquivo.Para
salvarumnovoarquivo,digiteononomedoarquivodecampoissovaisalvaratabelacomessenomeparaodiretrioqueexibido.Voc
pode(re)definiroformatonoqualoarquivosergravadousandooFormatodesadacaixaseletordireita(verSeo4.1.2paradiscusso
deformatosdesada).
NavegadorA.7.2.3Sistema
Aoclicarnonavegadordosistemaouobotodabarradeferramentas(

)najanelaSalvar,vocpodeusaronavegadordearquivos

nativodoseusistemaoperacionalparadecidirondesalvarumarquivo.Oqueistoparecetotalmentedependentedoseusistemaoperacional
elepodeounopodeconterrecursosespecficosdosistema,comoatalhosparadiretrioscomumenteusados.
DesdeTOPCATnotemcontrolesobreaformacomoestedilogoparece,elenopodeconteroFormatodeSadaseletor,ealgumasoutras
coisas,comosalvarcancelarpodenofuncionartobemcomoparaosoutrostiposdedilogo.Paraselecionaroformatodetabeladesada,
vocvaiprecisarusaroselectornajanelaSalvar.
A.7.2.4SQLDilogodesada

http://127.0.0.1:2525/doc/sun253/sun253.html

136/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

DilogoescritatabelaSQL
SevocquiserescreverumatabeladeumbancodedadosSQL,vocpodeusarumdilogoespecializadaparaespecificarodestinotabela
clicandonoTabelaSQLbotonoSalvartabelajanela.
Istoproporcionalheumalistadecamposparapreencher,emquedefinemanovatabelaparaescrever,comosesegue:
Protocolo
OnomedasubprotocoloJDBCapropriado.IssodefinidopelodriverJDBCquevocestusando,e,porexemplo,"mysql"para
Connector/JmotoristadoMySQLou"postgresql"paradriverJDBCdoPostgreSQL.
Hospedeiro
Onomedohostdamquinanaqualresideobancodedados(podeser"localhost"seobancodedadoslocal).
Nomedobancodedados
Onomedebancodedados.
Novonomedatabela
Onomedeumanovatabelaparaescrevernobancodedadosfornecido.Assuntoparaosprivilgiosdousurio,esteirsubstituir
qualquertabelaexistentenobancodedadosquetemomesmonome,porissodeveserusadocomcuidado.
Nomedeusurio
Onomedeusuriosobaqualvocdesejaacessarobancodedados.Istonoestritamentenecessrio,senohouvercontroledeacesso
paraobancodedadosemquesto.
Senha
Asenhaparaonomedeusurio.Maisumavez,seissofornecessriodependedapolticadeacessodobancodedados.
EscreverModo
Opesparaescreveratabelanobancodedados.Escolhaumdosseguintes:
criar
Anovatabelacriadaparaasada.Sealgumcomonomedadojexistir,ocorrerumerro.
dropcreate
Anovatabelacriadaparaasada.Sealgumcomonomedadojexistir,eledescartadoemprimeirolugar.
anexar
Osresultadossoacrescentadosaumatabelaexistentecomonomedado.Seatabelatemonmeroerradooutiposdecolunas,
ocorrerumerro.
HumasriedecritriosquedevemsersatisfeitasparaacessoSQLparatrabalhardentroTOPCAT(instalaodedriversapropriadoseassim
pordiante)vejaaseosobreconfiguraodeJDBC.Sevocnotomaressasmedidas,essedilogopodeserinacessvel.

A.8jogodoWindows
Estasecodocumentaasjanelasutilizadasparaprovacruzadalinhasouentreduasoumaismesasdelocaisoudentrodeumanicatabela.
EstetpicodiscutidocommaisdetalhesnaSeo5.Windowsparaoutrostiposdejuntasodescritosemoutrolugar:aconcatenaoem
anexoA.10.1ecombinandocomtabelasremotasatravsdeserviosVOnoApndiceA.9.
Aprximasubseodescreveascaractersticasquesocomunsaosdiferentestiposdejanelapartida,eassubseesseguintesdetalheso
funcionamentodecadajaneladejogodistintos(interno,paremultitable).

A.8.1Caractersticascomuns
A.8.1.1correspondemaoscritrios

Paineldecritriosdecorrespondncia.Osdetalhesvariamdeacordocomotipodecorrespondnciaescolhido.
http://127.0.0.1:2525/doc/sun253/sun253.html

137/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Acaixadecritriosdejogopermitequevocespecifiqueoquecontacomoumjogoentreduaslinhas.Eletemduaspartes.Primeiro,voc
deveselecionarumadasopesnoAlgoritmoselector.Issoselecionaefetivamenteoespaodecoordenadasemqueaslinhassero
comparadosentresi.Dependendodovalorescolhido,umnmerodecamposserexibidaabaixo,quevocdevepreenchercomosvaloresque
determinamoquopertoduaslinhastemqueseremtermosdeumamtricaemqueoespaoparacontarcomoumapartida.
Osseguintestiposdecorrespondncia(valoresalgoritmo)sooferecidos:
Cu
Comparaodeposiessobreaesferaceleste.Nestecaso,vocterdeespecificarcolunasdandoAscensoRetaeDeclinaopara
cadatabelaparticipardojogo.Ovalordeerromximodevepreencheraseparaomximodepontoscombinadosemtornodeum
grandecrculo.
Cucomerros
AcorrespondnciaassimparaoCuopoacima,masumraiodeerro(incertezaposicional)dadaparacadalinhanastabelasde
entrada,aoinvsdeapenasumnicovalorparatodaapartida.JuntocomaAscensoRetaeDeclinaocolunas,voctambm
especificaumacolunadeerroquedoraiodeerrocorrespondenteaessaposio.Aslinhassoconsideradasparacoincidirquandoa
separaoentreasduasposiesdeRA,dezembronomaiordoqueasomadosdoisvaloresdeerroparaasfilascorrespondentes.O
valordeescaladeveserdefinidocomoumamdiaaproximadadoserrosporlinha.Eleusadoapenasparadefinirumpadrorazovel
paraoparmetrodeajusteHealpixk,eseuvalornoafetaoresultado.SeHealpixkdefinidodirectamente(verApndiceA.8.1.3),
Escalaignorado.Nota:asemnticadestacorrespondnciadetermudadoumpoucodesdeaverso3.8doTOPCATeanteriores.Em
versesanteriores,onicoparmetrofoichamadoMaxerroeforneceuumarestrioadicionalsobreaseparaomximaaceitaentreos
objetosencontrados.Paraamaioriadosusos,osantigoseosnovoscomportamentossoesperadosparadarosmesmosresultados,mas
emcasosdediferena,onovocomportamentomaisprovvelquevocquer.
SkyEllipses
Compararegieselpticasnocuparasobreposio.Vocprecisarespecificarcolunasquefornecemaposiocentral,raiosmaiore
menor,engulodeposiodaelipse.Duaslinhassoconsideradasparacombinarsehouverqualquersobreposioentreaselipses.A
bondadedejogoumageneralizaonormalizadadocasosimtricausadopelaSkycomerrosdeopoacima.Ongulodeposio
medidaapartirdenorteparaosemieixomaior,nadireoparaoeixoRApositivo.Ovalordeescaladeveserdefinidocomouma
mdiaaproximadadosprincipaisraiosEleusadoapenasparadefinirumpadrorazovelparaoparmetrodeajusteHealpixk,eseu
valornoafetaoresultado.SeHealpixkdefinidodirectamente(verApndiceA.8.1.3),Escalaignorado.Osclculosso
aproximados,poisemalgunscasos,elesdependemdeprojectaraselipsesemumplanocartesianotangenteantesdeavaliarojogo,ento
paraelipsesmaioresocritriosermenosexata.Paraobjetosdotamanhodamaioriadasestrelasougalxiasobservadas,noseespera
estaaproximaoaserproblemtico.
Sky3D
Comparaodeposiesnocu,tendoemcontaadistnciadoobservador.Nestecaso,vocterdeespecificarcolunasdandoAscenso
RetaeDeclinaoemunidadesangulares,bemcomodistnciadaorigememunidadesarbitrriasparacadatabelaparticipardojogo.O
valordeerroumaseparaomximanoespaocartesianodepontoscombinadosnasmesmasunidadesqueadistnciaradial.
ValorExato
Requercorrespondnciaexatadevalores.Nestecaso,vocprecisarespecificaracolunaquecontmachavedepartidaparacadatabela
participandodapartidaissopodenormalmenteserumnomedeobjetoounmerodendice.Duasfileirascontamcomocongruentes,se
elestmexatamenteamesmaentradanocampoespecificado,excetoaslinhascomumvalornulonacoluna,quenocombinamcom
qualqueroutralinha.Observequeosvalorestambmdevemserdomesmotipo,porisso,porexemplo,umlongo(64bit)valorinteiro
noircorresponderaumvalorInteger(32bit).
Ndimensionalcartesiano
AcomparaodasposiesdeumespaoCartesianoNdimensionalisotrpico.Nestecaso,vocterdeespecificarcolunasNdandoas
coordenadasparacadatabelaparticipardojogo.Ovalordeerroaseparaoespacialmximadepontoscombinados.Atualmente,o
maiordimensionalidadevocpodeselecionar3dalgumquerumnmeromaior?
Ndimensionalcartesiano,anisotrpica
AcomparaodasposiesdeumespaoCartesianoNdimensionalcomumamtricaanisotrpica.Nestecaso,vocterdeespecificar
colunasNdandoascoordenadasparacadatabelaparticipardojogo,eumadistnciadeerroparacadaumadessasdimenses.Ospontos
P1eP2soconsideradosparasecombinarcomP2caidentrodoelipsidecomraiosdadaspelasdistnciasdeerro,centradasemP1.
Estetipodejogoirtipicamenteserusadoparaespaosno'espacial',porexemplo(magnitude,desvioparaovermelho)doespao,em
queasmtricasdedimensesdiferentes,noestorelacionadosunscomosoutros.Atualmente,omaiordimensionalidadevocpode
selecionar4dalgumquerumnmeromaior?
CuboidsNdimensionais
EstacorrespondnciacomoqueparaNdimensionalcartesianoacima,masospontossoconsideradosparacombinar,secairdentro
domesmocubideaoinvsdeelipside.Osvaloresdeerrosooscomprimentosmetadedoeixodocubide,como"raios"retangulares.
Estetipodejogoapropriadoparaagruparitensempixelsregularmenteespaados,emboranosejaumamaneiramuitoeficientede
fazerisso.
Ndimensionalcartesianocomerros
AcorrespondnciaassimparaocartesianoNdimensionalopoacima,masumraiodeerro(incertezaposicional)dadaparacada
linhanastabelasdeentrada,aoinvsdeapenasumnicovalorparatodaapartida.Juntamentecomascolunasdecoordenadas
cartesianas,tambmpossvelespecificarumacolunadeerroqueproporcionaoraiodeerrocorrespondentesaessaposio.Aslinhas
soconsideradasparacoincidirquandoaseparaoentreasduasposiesnomaiordoqueasomadosdoisvaloresdeerroparaas
filascorrespondentes.Oparmetrodeescala,devemser,aproximadamente,otamanhocaractersticodosvaloresdeerroporobjeto.O
seuvalor,emconjuntocomoparmetrodeajusteBinFactor,afectaodesempenhodapartidamasnooresultado.
2dcartesianoEllipses
Compararegieselpticasnoplanodesobreposio.Vocprecisarespecificarcolunasquefornecemaposiocentral,raiosmaiore
menor,engulodeorientaodaelipse.Aslinhassoconsideradasparasesobrepem,seexistequalquersobreposioentreaselipses.
Abondadedejogoumageneralizaodocasosimtricausadopelocartesiano2dcomerrosdeopoacima.Ongulode
orientaomedidonosentidocontrrioapartirdoeixoXemrelaoaoeixomaiordaelipse.Oparmetrodeescaladeveserdefinido
comoumamdiaaproximadadosprincipaisraios.Oseuvalor,emconjuntocomoparmetrodeajusteBinFactor,afectaodesempenho
dapartidamasnooresultado.
Sky+X
Comparaodeposiessobreaesferacelestecomumarestrionumricaadicional.EstaumacombinaodoCue1djogos
http://127.0.0.1:2525/doc/sun253/sun253.html

138/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

cartesianasacima,entoascolunasquevocprecisafornecersoRA,Deceumextra,eoserrossoaseparaoangularnocuequeo
erronacolunaextra.Apartidaserregistradoseelecorrespondeemambosostestesconstituintes.Vocpodeusareste,porexemplo,
paracoincidircomobjetosqueestoambospertodocuetmluminosidadessemelhantes.
Sky+XY
Comparaodeposiessobreaesferacelestecomumarestrioadicionalcartesiano2danisotrpica.EstaumacombinaodoCue
2danisotrpicacartesianocorrespondeacima,entoascolunasquevocprecisafornecersoRA,Decedoisextra,eoserrossoa
separaoangularnocueosraiosdeerrocorrespondentescolunasextras.Apartidaserregistradoseelecorrespondeemambosos
testesconstituintes.Vocpodeusareste,porexemplo,paracoincidircomobjetosqueestoambospertodocuetmluminosidadese
redshiftssimilares.
HTM
ExecutacucorrespondentenoexatamentedamesmamaneiracomoaSkyopoacima,masusandoumalgoritmodiferente
(pixelizaodaesferacelesterealizadautilizandoHierarchicalTriangularMeshemvezdoesquemaHEALPix).Osresultadosem
ambososcasosdeveseridntico,masHTMmuitomaislenta.Porisso,essaopostilparadepurao.Elepodeserretiradoem
versesfuturas.
Dependendodotipodecorrespondncia,asunidadesdovalordo(s)erroquevocdigitapodesersignificativo.Nestecaso,haverumselector
daunidadeexibidaaoladodacaixadeentrada.Vocdeveescolherasunidadesqueestocorretosparaonmeroquevocentra.
MaisinformaesestodisponveisnaGUIcomoumadicaaopassarcomoponteirodomousesobreocampoemquesto.
VejaApndiceA.8.1.3parainformaessobreopcionaisparmetrosdeajustequesvezessoexibidosnestepainel.
Oquadrodecorrespondnciacapazderealizaraindamaiscomplicadotiposdejogo,porexemploSky+6dimensionalanisotrpica
cartesiano.EstesnosooferecidosapenasparaevitarcomplicaroGUI.Requisitosrelacionadosmaisflexveisdestaeoutrosaspectospodem
seralcanadosusandooscomandoscorrespondentesnoSTILTSvez.
A.8.1.2Colunacaixasdeseleo

CaixadeSeleodeColuna.Osdetalhesvariamdeacordocomotipodecorrespondnciaescolhido.
Ascaixasdeseleodecolunapermitequevocselecionequaldascolunasnastabelasdeentradairfornecerosdados(ascoordenadasque
devemcombinar).Paracadatabela,vocdeveselecionarosnomesdascolunasnecessriasoquevocprecisaparaselecionarvaidepender
doscritriosdecorrespondnciaquevocescolheu.
Paraalgumascolunas,comoAscensoRetaeDeclinaonocupartidas,asunidadessoimportantesparaascolunasselecionadas.Neste
caso,haverumacaixaselectorparaasunidadesdecaixajuntamentecomoselectorparaaprpriacoluna.Vocdevegarantirqueasunidades
corretasforamselecionadas,ouosresultadosdojogoserumlixo.
Emalgunscasos,estascolunase/ouunidadesdeseletorespodeterumvalorpreenchidoautomaticamente(seoprogramapensaquepode
adivinharosapropriados),masvocdevegarantirqueeletenhaadivinhadocorretamentenessecaso.Apenasascolunasadequadasesto
disponveisparaescolherapartirdestesseletoresdecolunanamaioriadoscasos,istosignificaqueasnumricas.
Emvezdeselecionarumnomedecolunanalistafornecidanessascaixas,vocpodedigitarumaexpresso.Issopodeserumnomedecoluna
ouumaexpressoalgbricacombaseemnomesdecolunas,ouatmesmoumaconstante.Asintaxedalinguagemdeexpressodescritona
Seo7.
A.8.1.3Sintonia
Estasubseodescreveousodedoisbotesdabarradeferramentasdisponvelnasjanelasjogo:
ParmetrosdeSintonia
Exibeoajusteparmetrosaoladodeparmetrosdecorrespondncianopaineldecritriosdecorrespondncia.
Profilingcompleta
AumentaaquantidadedetempoeasinformaesdeusodememriaexibidonoPaineldeLogging.
Osparmetros,taiscomoMaxerrovisvelporpadronocritriosdecorrespondnciapaineldefiniroquecontacomoumjogoedeveser
preenchidoparaojogoparacontinuar.
Opcionalmente,vocpodevereajustarumoutroconjuntodeparmetrosconhecidoscomoparmetrosdeajuste.Estesnoirafetaro
resultadodojogo,maspodeafetaroseudesempenho,emtermosdequantotempodeCPUememriaquepreciso.Namaioriadasvezes,
vocpodeesqueceressaopo,umavezqueTOPCATtentapegarpadresrazoveis,masseoseujogomuitolenta(especialmentesefor
inesperadamentelentodadootamanhodastabelasenvolvidas),ouseeleestfalhandocommensagenssobreaexecuodesemmemria,em
seguida,ajustarosparmetrosdeajustepodeajudar.
Paravisualizarosparmetrosdeajuste,useosParmetrosdeSintonia(

boto)dabarradeferramentasouitemdemenu.Istoiradicionar

exibiodosparmetrosdeajusteparaosparmetrosdejogonopaineldecritriosdecorrespondncia.Osvaloressugeridossopreenchidos
http://127.0.0.1:2525/doc/sun253/sun253.html

139/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

porpadro,epodeserafetadopelosparmetrosdejogoquevocpreenchervocpodebrincarcomvaloresdiferenteseveroefeitosobreo
desempenhodojogo.Sevocfizerisso,tilusartambmacompletaProfiling(
botodabarradeferramentas)paraligarprofiling
completo.IssofarcomqueinformaesadicionaissobreaquantidadedetempodeCPUememriautilizadaporcadapassoaserexibidano
painelderegistronaparteinferior.HumapequenapenalidadeemtempodeCPUnecessriopararecolherestainformao,oqueumarazo
quenoativadoporpadro.
Oajustedeparmetrosestodisponveisdependedotipodejogoquevocescolheu.Algunsdescrioadicionalestdisponvelcomodicasde
ferramentas,sevocpassaromousesobreocampodeconsulta.Namaiorpartedoscasos,elessodeumaououtradasseguintes
caractersticas:
HEALPixk
Usadoparapartidasculike.kumvalorinteiroquedeterminaotamanhodepixelsemqueaesferacelestedecompostoparabinning
linhas.Ointervalolegalentre0(correspondendoaumtamanhodepixeldecercade60graus)ede20(cercade0,2segundosdearco).
EmlinguagemHEALPix,klog2 (Nlado ).
FatordeEscala
Usadoparapartidascartesianolike.Ofactordeescalaumvalordepontoflutuante,quedeterminaotamanhodospixelsN
dimensionaisnocionalemqueoespaodecompostoporlinhasbinning,comoummltiplodoerrodepartida.Omenorvalorlegal1.
Emambososcasos,onmerodelinhasporbinnodevesermuitogrande,nemmuitopequeno(emboraexatamenteoqueissosignificaem
termosquantitativosoutroassunto).Caixasmaiores/pixelsgeralmentesignificamenosusodememriaemaistempodeCPU,noentanto,
quenemsempreocaso.
Mesmoseacontecerdevocterumaboacompreensodecomofuncionaoalgoritmodecorrespondncia(evocprovavelmenteno),estetipo
deajusteumpoucodeumaartenegra,edependeconsideravelmenteosdetalhesdojogoparticular.Emalgunscasos,noentanto,bastante
possvelmelhorarotempolevadoporumfsforo,ouotamanhodatabelaquepodesercombinadonumadadaquantidadedememria,porum
factordevrios.Sevocquertentarmelhorarodesempenho,tenteopadro,ajustarosparmetrosdeajusteumpouco,vejacomoasalteraes
dedesempenho,examinandoasadadelog,etalvezrepetiragosto.
OutracoisaquepodeafetaravelocidadeeusodememriaseasuamquinavirtualJavaestsendoexecutadonomodode64bitsoude32
bits.Hprsecontrasdecadaumsvezesumvaisermelhor,svezesooutro.Sevocprecisaparamelhorarodesempenho,experimentar!

A.8.2ParJogoJanela

ParJogoJanela
OjogoJanelaParpermiteunirduastabelasjuntos,ladoalado,alinhandoaslinhasporvalorescorrespondentesemalgumasdesuascolunas
entreastabelas.Elepodeserobtidousandoopardejogo( boto)najaneladecontroledabarradeferramentasoujuntamenu.
http://127.0.0.1:2525/doc/sun253/sun253.html

140/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Emumcenriotpicoquevocpodeterduastabelas,cadaumarepresentandoumcatlogodeobjetosastronmicos,evocquerumaterceira
tabelacomumalinhaparacadaobjetoquetemumaentradaemambasastabelasoriginais.Umobjetodefinidocomosendoomesmoem
ambasastabelas,seascoordenadasemambasaslinhasso"semelhantes",porexemplo,seadiferenaentreasposiesindicadasporcolunas
RAedezembrodiferempornomaisdoqueumnguloespecificadonocu.Linhasparaproduzirajunocorrespondnciarequerquevoc
especifiqueoscritriosdelinhasemambasastabelasparasereferiraomesmoobjetoeoquefazerquandoseencontraasopesso
discutidosemmaisdetalhesnaSeo5.2.
Oresultadocriadoapartirdosaparentesversesdastabelasqueestosendounidas,demodoquequalquersubconjuntodelinhas,colunas
escondidas,ouotipoatualmenteemvigorserorefletidasnasada.Informaessobreoandamentodojogo,oquepodedemorarumpouco,
fornecidanajaneladeregistroeporumabarradeprogressonaparteinferiordajanela.Quandoeleforconcludo,vocserinformadoporuma
janelapopupqueindicaqueumanovatabelafoicriada.Estatabelaseradicionadalistanajaneladecontroleepodeserexaminado,
manipuladoeguardadocomoqualqueroutro.Emalgunscasos,algumascolunasadicionaisseroadicionadostabeladesadaquelhedar
maisinformaessobrecomoeleprogrediu(verApndiceA.8.2.1.
AJaneladejogoforneceumconjuntodecontrolesquepermitemquevocescolhaaformacomoojogofeitoequaissoosresultadosser
semelhante.compostoporestaspartesprincipais:
Caixadecritriosdecorrespondncia
Permitedefiniroquecontacomoumjogoentreduaslinhas.
Caixasdeseleodecoluna
Permiteselecionarquaistabelasdevemserunidaseascolunasquenelesfornecerascoordenadascorrespondentes.
Linhasdesadadoseletor
Permiteaseleodequaislinhasdevemserincludosnatabeladesada(porexemplo,seapenasaslinhascorrespondentesemambasas
tabelasdevemserasadaouno).
JanelaLog
Relatriossobreoprogressoqueojogoestocorrendo.Abarradeprogressonaparteinferiordajanelatambmforneceumaindicao
dequolongeatravsdecadafasedetransformaotem.
Osbotesdecontrole
OGobotoiniciaabuscaquandovocestfelizcomasseleesquevocfez,eoPararbotointerrompelonomeiodocaminho,se
vocdecidirquenoquermaisosresultados(fechandoajaneladejogotambminterrompeoclculo).
ParaobterinformaessobreosParmetrosdeSintonia(

)ecompletaProfiling(

)botesdabarradeferramentas,consulteo

ApndiceA.8.1.3.
LinhasdesadaA.8.2.1SelectorBox

ParjogolinhasdesadaSelectorBox
Quandoojogoestcompletoumanovatabelasercriada,quecontmlinhasdeterminadaspelosjogosquetiveramlugar.Alinhasdesada
caixaseletorpermitequevocescolhaemquebaseaslinhasseroincludasnatabeladesadaemfunodosjogosqueforamencontrados.
Emtodososcasoscadalinhavaisereferiraapenasumcombinado(oupossivelmenteincomparvel)"objeto",demodoqueascolunasno
brancoemumadeterminadalinhavmdeapenasaslinhasnastabelasdeentradaquecorrespondemdeacordocomosespecificadoscritrios.
Noentanto,voctemduasescolhasafazersobrequaislinhassoproduzidos.
OJogoSeleoseletorpermitequevocescolhaoqueacontecequandoumalinhaemumatabelapodeserigualadapormaisdeumalinhana
outratabela.Existemquatroopes:
Todososjogos
Cadajogoentreasduastabelasincludonoresultado.Linhasdeambasastabelasdeentradapodemaparecervriasvezesnoresultado.
Melhorjogo,simtrico
Osmelhoresparessoseleccionadosdeformaquetrataasduastabelassimetricamente.Qualquerlinhadeentradaqueapareceemum
parresultadodesclassificadodeapareceremqualqueroutroparresultado,demodoquecadalinhadeambasastabelasdeentrada
apareceremnomximoumalinhanoresultado.
MelhorjogoparacadaTabela1linha
Paracadalinhanatabela1,apenasomelhorjogodatabela2serexibidonoresultado.Cadalinhadatabela1aparecer,nomximo,
umaveznoresultado,masaslinhasdaTabela2podemaparecervriasvezes.
MelhorjogoparacadaTabela2linhas
Paracadalinhanatabela2,apenasomelhorjogodemesa1aparecernoresultado.Cadalinhadatabela2aparecer,nomximo,uma
veznoresultado,masaslinhasdaTabela1podemaparecervriasvezes.
O"melhor"jogonestasopesgeralmentesignifica"maisprximo"onicocomapontuaomaisbaixajogo,ondeadefiniodesta
pontuaodeterminadapeloscritriosdecorrespondnciaquevocselecionou.AsdiferenasentreasvriasMelhorresultado...asopes
soumpoucosutil.Noscasosemquebvioqueobjetoemcadamesaomelhorjogoparaqualobjetonooutro,escolhaentreestasopes
noafetaroresultado.Noentanto,emcamposlotados(ondeadistnciaentreosobjetosdentrodeumaouambasastabelasnormalmente
semelhanteoumenordoqueoraiodecorrespondnciaespecificada)quevaifazeradiferena.Nestecaso,umadasopesgeralmente
assimtricasmaisadequado,masvocprecisapensarsobrequaldelesseadaptassuasnecessidades.Odesempenho(tempoeusodememria)
dojogotambmpodemserdiferentesentreessasopes,especialmenteseumatabelamuitomaiordoqueooutro.
http://127.0.0.1:2525/doc/sun253/sun253.html

141/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

OJoinTiposeletorpermitequevocescolhaquaislinhasdesadadoresultadodeumjogonastabelasdeentrada.
1e2
Atabeladesadacontmapenasaslinhasquetmumaentradadeambasastabelasdeentrada,demodoquecadalinhadesada
representaumarealparcombinado.
Todososprodutosda1
Todasaslinhasencontradasestopresentesnasadacomopara1e2,mas,adicionalmente,aslinhascorrespondentesdaprimeiratabela
estopresentescomascolunasapartirdasegundamesabranco.
Todososprodutosda2
QuantoTudoapartirde1,masocontrrio.
1ou2
Cadalinha,combinadoseincomparvel,deambasastabelasdeentradaaparecenasada.EstaauniodelinhasdeTudoapartirde1
e2deTudo.
1no2
Esteapresentatodasaslinhasnaprimeiratabelaquenonotmjogosnasegundatabela.Consequentemente,elecontmapenas
colunasdaprimeiratabela,umavezquetodasasentradasdosegundoseriaembrancoemqualquercaso.
2no1
Omesmoque1eno2,masocontrrio.
1xor2
O"exclusivoou"dojogoasadascontmlinhasdaprimeiratabelaquenotemcorrespondncianasegundatabelaeviceversa.a
uniode1eno2e2no1.
NotesequeasescolhasdequejogodeSeleoeJunteseTipodeusarsoumpoucointerligadas,ealgumascombinaespodemnoser
muitosignificativa.
Namaioriadoscasos(todososacimaexcetopara1eno2e2no1),oconjuntodecolunasnatabeladesadacontmtodasascolunasda
primeiratabelaseguidoportodasascolunasdasegundatabela.Seissocausarumchoquedenomesdecolunas,colunasofensivossero
renomeadoscomumafuga"_1"ou"_2".Dependendodosdetalhesdojogonoentanto,podemseradicionadasalgumascolunasadicionais
teis:
PontuaoJogo
Paralinhasquerepresentamumapartida,umvalornumricoquerepresentaoquobomojogofoisergeralmentepresente.Esta
tipicamenteumaseparaonoespaorealoufictciaporexemplo,paraumcujogoadistnciaentreasduasposiescelestes
compensadasemsegundosdearcoaolongodeumgrandecrculo.Sersempremaiordoqueouigualazero,eumvalormenor
representaumamelhorcorrespondncia.Onomeeosignificadoexatodestacolunadependedoscritriosdecorrespondnciaexaminar
suadescrionajanelaColunasparamaisdetalhes.
GroupSize,GroupID
Sealgumasdaslinhascorrespondermaisdoqueumavez(oquepodeacontecerparaqualquerumadasopesdeseleodejogoacima
almdeMELHOR),duascolunaschamadasGroupIDegroupSizeseradicionado.Estessistemaspermitemidentificarquaisjogos
somltiplas.Nocasodelinhasquerepresentamumaocorrncianica,queestoembranco.Masparaaslinhasquerepresentamum
conjuntodevriascorrespondncias,ovalorgroupSizeinformaquantaslinhasparticiparnestejogo,eovalorGroupIDuminteiroque
omesmoparatodasaslinhasqueparticipamnamesmapartida.Ento,sevocfazumaespcienovalorGroupID,vocvaivertodasas
linhasdoprimeirogrupofsforonoexclusivoemconjunto,seguidoportodasaslinhasdosegundogruponoexclusivo...edepois
delestodososjogosexclusivos.
Aquiumexemplo.Sesuastabelasdeentradasoosseguintes:
XY Vmag
-----1134.822 599,247 13,8
659,68 1046 .874 17,2
909,613 543,293 9.3

e
XY BMAG
-----909,523 543,800 10.1
1832.114 409,567 12,3
1135.201 600,100 14,6
702,622 1004 .972 19,0

emseguida,umapartidacartesianodosdoisconjuntosdevaloresdeXeY,comumerrode1,0usandoa1e2opolhedariaumresultado
comoeste:
X_1 Y_1 Vmag X_2 y_2 BMAG Separao
-----------------------------1134.822 599,247 13,8 1135,201 600,100 14,6 0,933
909,613 543,293 9,3 909,523 543,800 10,1 0,515

utilizandoTudoapartirde1iriadarlheoseguinte:
X_1 Y_1 Vmag X_2 y_2 BMAG Separao
-----------------------------1134.822 599,247 13,8 1135,201 600,100 14,6 0,933
659,68 1046 .874 17,2
909,613 543,293 9,3 909,523 543,800 10,1 0,515

e1no2iriadarlheoseguinte:
http://127.0.0.1:2525/doc/sun253/sun253.html

142/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

XY Vmag
-----659,68 1046 .874 17,2

A.8.3JogoInternoJanela

JanelaJogoInterno
AJaneladejogointernopermitequevocexecutecorrespondnciaentreaslinhasdamesmatabela,agrupandolinhasquetmosmesmosou
similaresvaloresemcolunasespecificadaseproduzindoumanovatabelacomoresultado.Elepodeserobtidousandoojogointerno(
item)najaneladecontroledajuntamenu.
Vocpodequererusaressafuncionalidadepararemovertodasaslinhasquesereferemaomesmoobjetoapartirdeumcatlogodeobjetos,ou
paragarantirqueapenasumaentradaexisteparacadaobjeto,ouparaidentificargruposdevriosobjetos"prximos"dealgumaforma.
Oresultadocriadoapartirdosaparentesversesdastabelasqueestosendounidas,demodoquequalquersubconjuntodelinhas,colunas
escondidas,ouotipoatualmenteemvigorserorefletidasnasada.Informaessobreoandamentodojogo,oquepodedemoraralgumtempo,
fornecidanajaneladeregistroeporumabarradeprogressonaparteinferiordajanela.Quandoeleforconcludo,vocserinformadopor
umajanelapopupqueindicaqueumanovatabelafoicriada.Estatabelaseradicionadalistanajaneladecontroleepodeserexaminado,
manipuladoeguardadocomoqualqueroutro.
Ajanelatemasseguintespartes:
Caixadecritriosdecorrespondncia
Permitedefiniroquecontacomoumjogoentreduaslinhas.
Caixadeseleodecoluna
Permitequevocselecionequaltabelaparaoperarequaiscolunasfornecerascoordenadascorrespondentes.
CaixadeAoJogo
Permitequevocselecioneoqueserfeito(oquenovatabelasercriada),quandoforamidentificadososgruposcorrespondentesde
linhas.
EntrarPainel
Exibeoprogressocomoojogoestocorrendo.Abarradeprogressonaparteinferiordajanelatambmforneceumaindicaodequo
longeatravsdecadafasedetransformaotem.
Osbotesdecontrole
OGobotoiniciaabuscaquandovocestfelizcomasseleesquevocfez,eoPararbotointerrompelonomeiodocaminho,se
vocdecidirquenoquermaisosresultados(fechandoajaneladejogotambminterrompeoclculo).
ParaobterinformaessobreosParmetrosdeSintonia(

)ecompletaProfiling(

)botesdabarradeferramentas,consulteo

ApndiceA.8.1.3.
http://127.0.0.1:2525/doc/sun253/sun253.html

143/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.8.3.1JogoInternoBoxAo

BoxAoInternaJogo
AcaixadeAoJogointernodumalistadeopesparaoquevaiacontecerquandoumclculojogointernofoiconcluda.Emcadacaso,
umanovatabelasercriadacomoumresultadodojogo.Asopesparaoqueelevaiolharcomosoestas:
Marcargruposdelinhas
Oresultadoumatabelaamesmaqueatabeladeentrada,mascomduascolunasadicionais:GroupIDegroupSize.Cadagrupode
linhasquecombinamatribudoumnmerointeirompar,registadanacolunaGroupId,eotamanhodecadagruporegistadona
colunagroupSize.Linhasquenocorrespondemquaisqueroutros(singles)tmvaloresnulosemambasascolunas.Assim,porexemplo,
ordenaratabelaresultanteemGroupIDpossvelagruparlinhasquecorrespondemaoladodaoutraouclassificandoemgroupSizevoc
podevertodosospares,seguidoportodosostriplos,...
Vocpodeusaressasinformaesdeoutrasformas,porexemplo,sevoccriarumnovosubconjuntoRowusandoaexpresso"
groupSize == 5"vocpodeselecionarapenasaslinhasquefazempartedosgrupos5aobjetos.
Eliminartodasaslinhasagrupadas
Oresultadoumanovatabelacontendoapenasaslinhas"nico",ousejaosquenocorrespondemanenhumoutroregistronatabelade
acordocomoscritriosdecorrespondncia.Quaisquerlinhasquecorrespondemsojogadosfora.
Eliminartodos,masprimeirosdecadagrupo
Oresultadoumanovatabelaemqueapenasumalinha(oprimeironaordemdetabeladeentrada)apartirdecadagrupodeuns
correspondentesretida.Umapartidainternaposteriorcomosmesmoscritrios,portanto,nomostramresultados.
NovatabelacomgruposdetamanhoN
Oresultadoumanovatabelade"grande",queconsistedelinhasencontradasnatabeladeentradaempilhadosaoladodooutro.Apenas
gruposdeexatamentenlinhasnatabeladeentradasousados
paraformaratabeladesadacadalinhadatabeladesadaconsistenas

colunasdoprimeiromembrodogrupo,seguidodascolunasdosegundomembrodogrupoeassimpordiante.Assim,atabeladesada
temNvezesmaiscolunascomoatabeladeentrada.Osnomesdascolunasnanovatabelatem"_1","_2",...anexadosaelesparaevitar
duplicaes.

A.8.4JanelamltiplaJogo
AJanelamltiplajogopermitequevocexecutecorrespondnciaentremaisdeduastabelas.Elepodeserobtidousandoosfsforotriplo,
qudruplojogoetc(
itens)najaneladecontroledajuntamenu.
Oresultadocriadoapartirdosaparentesversesdastabelasqueestosendounidas,demodoquequalquersubconjuntodelinhas,colunas
escondidas,ouotipoatualmenteemvigorserorefletidasnasada.Informaessobreoandamentodojogo,oquepodedemoraralgumtempo,
fornecidanajaneladeregistroeporumabarradeprogressonaparteinferiordajanela.Quandoeleforconcludo,vocserinformadopor
umajanelapopupqueindicaqueumanovatabelafoicriada.Estatabelaseradicionadalistanajaneladecontroleepodeserexaminado,
manipuladoeguardadocomoqualqueroutro.
Ajanelatemasseguintespartes:
Caixadecritriosdecorrespondncia
Permitedefiniroquecontacomoumjogoentreduaslinhas.
Caixadeseleodecoluna
Permitequevocselecionequaltabelaparaoperarequaiscolunasfornecerascoordenadascorrespondentes.
CaixadeAoJogo
Permiteaseleodequaislinhasdevemserincludosnatabeladesada(porexemplo,seapenasosjogosqueaparecememtodasas
tabelasdeentradadeveresultaremlinhasdesada).
JanelaLog
Relatriossobreoprogressoqueojogoestocorrendo.Abarradeprogressonaparteinferiordajanelatambmforneceumaindicao
dequolongeatravsdecadafasedetransformaotem.
Osbotesdecontrole
OGobotoiniciaabuscaquandovocestfelizcomasseleesquevocfez,eoPararbotointerrompelonomeiodocaminho,se
vocdecidirquenoquermaisosresultados(fechandoajaneladejogotambminterrompeoclculo).
ParaobterinformaessobreosParmetrosdeSintonia(

)ecompletaProfiling(

)botesdabarradeferramentas,consulteo

ApndiceA.8.1.3.
A.8.4.1MltiplaAoBoxJogo

http://127.0.0.1:2525/doc/sun253/sun253.html

144/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

MltiplaAoBoxJogo
AMltiplaAoBoxJogopermitequevocescolhaquaislinhasaparecemnatabeladesadaapsumjogodesucessomultimesa.Paracada
tabeladeentrada,voctemduasopesparaescolher:
Linhasigualadoapenas
Linhasaparecernatabeladesadasomentesecontiveremumaentradadatabelaemquesto(masvejaabaixo).
TodasasLinhas
Linhasaparecernatabeladesadasecontiveremumaentradadatabelaemquesto,independentementederestriesemoutrastabelas
deentrada(substituiaopoanterior).
Actualmente,asopesdemultimesadisponveisdentroTOPCATnosotoabrangentescomoasfornecidaspelocorrespondentecomando
STILTStmatchn.Istopodesermelhoradonofuturo.

A.9VOacessoadadosdoWindows
VriasjanelasemTOPCATpermitiroacessoaosservios(VO)ObservatrioVirtualpadro.Estescompartilharaidiadeconsultaro
Registroparaserviosdedadosadequados,aseleodeumdosservios,assim,devolvidos,emseguida,aapresentaodeumoumais
consultasparaoserviodedadosparagerarumresultadotabular.EstasideiassoexplicadasemmaisdetalhenaSeco6,enquantoquea
secocorrentedescreveasjanelas.Aprximasubseodescreveoscomponentesapartirdoqualessasjanelassocolocadosjuntos.Todasas
janelascontmumpaineldeconsultaderegistroparaselecionarumserviodeacessodedadosadequado.Asjanelasdeconsultaposicionais
tambmconterumnicoouummltiplopaineldepesquisa,eajaneladaTAPcontmseuprpriopainelpersonalizado,paradefiniraconsulta
realouconsultasparaapresentaraoservioselecionado.Asprpriasjanelassodescritasnassubseesaseguir.

A.9.1Caractersticascomuns
EstaseodescreveoscomponentesgrficosquecompemasjanelasdeacessoadadosVO.
A.9.1.1PaineldeConsultadeRegistro

PaineldeConsultadeRegistro
OPaineldeConsultadeRegistroapareceemtodasasjanelasdeconsultaVOepermitequevocprocureporentradasdoRegistroque
representamosserviosdedadosdotipoapropriadoparaajanela.NotequesevocsouberaURLdoservioparaoservioquevocquer
usar,vocnoprecisausaressepainelemtudovocpodesimplesmentepreencheraURLnaparteinferiordajanela.
Apartesuperiordestepainelcontmoscamposquevocpodepreencherparaconsultaroregistrodeserviosquesatisfazemosseus
constrangimentos.Esteconstitudopelasseguintespartes:
Registro
EstecontmoURLparaoregistro,queserconsultadoparaserviosdedadosadequados.Vocpodeselecionarentreasopes
http://127.0.0.1:2525/doc/sun253/sun253.html

145/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

disponveis,oudigiteumaURLquecorrespondeaalgumoutroservioderegistroquevocsabesobre.OpadrooregistroAstroGrid,
quenomomentodaescritageralmentefuncionamuitobem,masoutrosregistrospodemterumpoucodiferentesexploraesdedados.
Algunsregistrosnofuncionammuitobem,entovocpodeterproblemassevocusaroutros.AatualizaoListaRegistryitemno
Registrodomenuconsultaoregistroselecionadoparaoutrosregistros,eadicionamaisentradasparaacaixadeseletor.Emboraeste
devefuncionar,parecequeosregistrosquerepresentamosprpriosregistrossomuitasvezesmalconfigurado,porissoamaioriados
itensreultingnomomentodaescritafalharporumarazoououtra.Massevocumentusiastadoregistro,sintaselivrepara
experimentarcomele.
Palavraschave
Preenchaestecompalavraschaveadequadasparaosserviosquevocdesejaencontrar.Oformatopalavrasseparadasporespao,e
nohcuringa.Assim,porexemplo,sevocquiserencontrarserviosrelacionadoscomosquasaresemdadosSloanvocpodeinserir
ostermos"SDSSQSO".Essestermossocomparadoscomcertoscamposdecadaentradaderegistro(comodeterminadopelascaixas
Jogocamposabaixo)decadaentradaderegistroparaverseelecorresponde.Normalmenteumaouduaspalavrascurtasonvelde
detalheapropriado.Senenhumapalavrachavesopreenchidas,todososserviosapropriadossorecuperadas.Algumaexperimentao
podesernecessriaparaespecificarumaconsultacomumnmerorazovelderesultadossesuaconsultanoretornanenhumresultado,
tentemenosoumaistermosgerais,eseeleretornamuitos,tentaroutrosmaisoumaisespecficas.
E/Ouboto
Issodeterminaseumaentradaderegistroconsideradoparacoincidircomaspalavraschaveescolhidasseelecorrespondeatodoseles,
oupelomenosumdeles.Clicandoalternaentre"E"e"Ou".Opadro"E",oquesignificaquetodasaspalavraschavedevemser
combinados(contraqualquerumdoscamposdecorrespondnciaselecionados)paraumaseleo.
CamposJogo
Estalinhacontmumnmerodecaixasquelhepermitemdefinirquaisoscamposemcadaregistrodoregistrosercomparadocomas
palavraschavequevocdigitouquandoseolhaparaosjogos.Ocontedodonomecurto,Ttulo,assuntos,identificaoeEditor
campossovisveisnatabeladeresultados.Descrioumaformalivre,muitasvezeslongo,descriodorecursoelepodesertil,mas
muitasvezespodeconteracidentalmentetextoquefazcomquejogosindesejados.Porpadro,onomeabreviado,ttulo,assuntose
camposdeidentificaosocorrespondidoscliquenascaixasdeseleoparaalteraraseleo
BotoEnviarConsulta
Quandoosoutroscamposforampreenchidos,aperteobotoEnviareoregistroserprocuradoparaencontrarserviosdedadosque
coincidemcomasrestriesquevocdeu.
Emalgunscasos,quandoajanelaapareceemprimeirolugar,eleirconsultarautomaticamenteoregistrodetodososserviosconhecidosdo
tipoapropriado.EsteactualmenteocasodosserviosSIAeSSA,jquehumnmerorazoveldeessas.Existemmilharesdepesquisasde
conenoentanto,portanto,paraasjanelasdebuscaconevocprecisapreencherumaconsultaesubmetloasimesmo.Emambososcasos,
vocpodeenviarnovamenteumaconsulta(bateuoCancelarconsultaprimeirobotosenecessrio)parafazerumaoutraselecodeentradas
doRegistro.
Quandoaconsultaforconcluda,umatabeladeentradascorrespondentesexibidaabaixodobotoEnviar.Estecontmumalinhaparacada
entradacorrespondente,ouseja,cadaserviodotipoapropriadoquevocpodeenviarsuaconsultadedados.Ascolunasnatabeladumnome
curto,ttulo,descrioealgumasoutrasinformaessobrecadaservio.Vocpodeclassificaraslinhasdatabeladeacordocomasentradasem
colunasdiferentes,clicandonocabealhodacolunacliquenovamentenomesmocabealhoparainverteraordemdeclassificao.Uma
pequenasetaparacima/baixoemumcabealhodecolunaindicaqueessacolunaestdeterminandoaordemdeclassificao.Vocpode
ajustarascolunasquesovisveisusandooColunasdomenu,ouarrastarascolunasparaosladosparamudarsuaordemnamaneirausual.
Vocdeveselecionaroservioquevocdesejaparaconsultardados,clicandosobreela.Quandoissofeito,vocverumaoumaislinhas
aparecememumasegundatabelaporbaixodoprimeiro.Namaioriadoscasos,estecontmumalinhanica,queserselecionado
automaticamente.Noentanto,algumasentradasderegistrotervriosserviosdedadosassociadosaumnicoregistronestecaso,vocdeve
selecionaraentradaapropriadanatabelaabaixotambm.
Depoisdeterseleccionadoumserviodedados,destaforma,oseuURLdoservioserinseridonaparteinferiordajanela(nomostradona
figuraacima)evocestprontoparaexecutaraconsultarealnicaoumltipladedados.
SeumhubSAMPestemexecuo(verSeo9),possvelatrocadelistasderecursosentreestajanelaeoutrasaplicaes.Seoutro
aplicativoenviaumamensagemadequadaparaTOPCAT,eosrecursossodeumtipoapropriado,eajanelaestvisvelnomomento,alista
recebidapodesercarregadaeexibidaaqui,substituindoqualquerqueatualmenteexibida.Vocpodecontrolarseaslistasdeentradaso
aceitoseexibidodestamaneirausandoosAceitarlistasderecursosdealternncia,ouusandoacaixadeseleologoacimadopainelde
exibioderecursos,ouusandooitemcorrespondentenaInteropmenu.Sevocquiserenviarasuaseleoparaumaoumaisoutras
aplicaesquepodemfazerusodeles,useorecursodetransmissoList(
)ouEnviarListaderecursos(
)opesnaInteropmenu.
A.9.1.2nicoposicionalPesquisaPanel

nicoposicionalPesquisaPanel
http://127.0.0.1:2525/doc/sun253/sun253.html

146/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

OnicoposicionalPesquisaPanelapareceemdilogoscargamesabaseadosemVOeusadoparaespecificarconsultasdedadosemuma
nicaregiodocu.Oobjetivocarregarumanovatabela(contendoentradasrepresentandoentradasdecatlogo,imagensouespectros).Para
uslovocdevepreencheroURLcampoeadefiniodeposio,eemseguida,bateuoOKboto.
URL
EstedeveconteraURLdoservioparaoserviodedadosquevocestconsultando.Normalmente,esteserpreenchido,selecionando
umdosserviosobtidospelaconsultaderegistro.Noentanto,vocpodepreenchlomanualmentecomoURLdeumservioquevoc
sabesobresevocpreferir.Sevocsabeoqueestfazendo,tambmpossvelparaomdicoumaURLdeserviopreenchidapela
seleoderegistro,porexemplo,adicionando& name = valorparmetrosparaisso.
Nomedoobjeto
VocpodepreencherestecomonomedeumobjetoaserresolvidoporSIMBAD,ebateuoResolveboto,queirpreencheras
coordenadasnoscamposRAedezembroabaixo.SevocdigitaroRAedezembromanualmente,vocnoprecisausarestecampo.
RAedezembro
PreenchaaposiocentralemtermosdeJ2000AscensoRetaeDeclinaoquevocestinteressadoemaqui.Vocpodefazlo
manualmente,ouusandoonomedoobjetocampoacima.Selecioneasunidadesconformeocaso.
Raio
IndicaoquograndearegioquevocestinteressadopolegadasEstecampotemaparnciaumpoucodiferenteesignificadoparaos
diferentestiposdeserviosdedadospairarsobreelecomomouseparaverumadicadeferramentacomosdetalhes.ParaSIAeSSA,
masnoparaConePesquisa,permitidodeixloembranco(apesardecertosserviosnoparecemgostardisso).Selecioneasunidades
conformeocaso.
Quandooscamposestopreenchidos,bateuoOKbotoeesperarqueanovatabeladefinidaporseusparmetrosdeconsultaparacarregar.Se
vocficarentediadodeespera(oserviopodeserparabaixo,ouapenasmuitolento,ouvocpodeterapresentadoumaconsultacomum
conjuntomuitograndederetorno),vocpodebateroCancelarbotoe,talvez,ajustarosparmetrosetentenovamente.
SeumhubSAMPestemexecuo(verSeo9),emseguida,outrosclientesqueexecutampodesercapazdepreencherascoordenadasRA
edezembro.Porexemploclicaremumaposionocuemumaferramentadevisualizaodeimagempodepreencheraposionocuque
vocclicou.Normalmenteistoaconteceautomaticamente.Issomuitasvezesconveniente,maspodenoseroquevocquiser.Vocpode
controlarseasdefiniesdascoordenadasrecebidassoaceitesnestecaminhousandoosAceitarSkyPosiesalternarabaixodoboto
Resolve,ouusandooitemcorrespondentenaInteropmenu.
A.9.1.3mltiplaposicionalPesquisaPanel

VriasposicionalPesquisaPanel
OMultipleposicionalPesquisaPanelaparecenabasedeVOmltiplasjanelasdeconsultaqueespecificamumprocedimentoemqueuma
consultafeitaparacadalinhadeumatabeladeentrada.Cadaumadaslinhasdeentradadefineum(provavelmentepequeno)regionocu.O
objetivoencontrarregistrosdedados(cercadeentradasdecatlogo,imagensouespectros)emumcatlogoremotocorrespondenteacada
linhadeumcatlogolocal.Comotal,eleutilizadoparadefinirumtipodejuno,deumlocaldeTabelaaparentecomumremoto,emqueo
remotoestexpostaatravsdeumserviodedadosdeVO.
ParauslovocdevepreencheroURLcampoparaselecionaroservioremoto,eoscamposdedefiniodecomocadalinhadatabelade
entradapodesertransformadoemumaconsultadeposio.VoctambmprecisadefiniraformaqueoresultadoserdevolvidodentroEstas
peassodescritosabaixo.
OcampodeURLespecificaoserviodedadosqueestaserconsultado:
URL
EstedeveconteraURLdoservioparaoserviodedadosquevocestconsultando.Normalmente,esteserpreenchido,selecionando
umdosserviosobtidospelaconsultaderegistro.Noentanto,vocpodepreenchlomanualmentecomoURLdeumservioquevoc
sabesobresevocpreferir.Sevocsabeoqueestfazendo,tambmpossvelparaomdicoumaURLdeserviopreenchidapela
seleoderegistro,porexemplo,adicionando& name = valorparmetrosparaisso.
Osseguintescamposdefinemoqueasconsultassoparaserenviadaparaoservio:
Tabeladeentrada
SelecioneumadasmesascarregadasemTOPCATcujasposieslinhaquevocdesejapesquisarpora.
ColunasRAedezembro
http://127.0.0.1:2525/doc/sun253/sun253.html

147/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

PreenchacomascolunasnatabeladeentradaquecontmJ2000AscensoRetaeDeclinao(vocpoderealizarconversesde
coordenadasutilizandoajanelaSkyCoordenadassenecessrio).Selecioneasunidadesconformeocaso.Seatabeladeentradatem
metadadosapropriados,osvalorescorretospodemserpreenchidosporpadro,mas,ocasionalmente,podemerrar,porisso
aconselhvelverificarseestopreenchidoscorretamente.
ColunaBuscaporraio
Preenchaestecomumvalorquerepresentaotamanhodebuscaquevocquerfazeremtornodaposiodecadalinha.Ouvocpode
usarumvalorconstante,ouumnomedecoluna,ouqualquerexpressoalgbricanumricocombasenatabela(verseo7).Escolha
unidadesconformeapropriado.Estecampotemaparnciaumpoucodiferenteesignificadoparaosdiferentestiposdeserviosdedados
pairarsobreelecomomouseparaverumadicadeferramentacomosdetalhes.ParaSIAeSSA,masnoparaConePesquisa,
permitidodeixloembranco(apesardecertosserviosnoparecemgostardisso).Selecioneasunidadesconformeocaso.
OseletordeMododesadaindicaoqueserfeitocomoresultado.
Mododesada
Quandoasconsultasforamrealizadas,hdiferentesmaneirasqueosresultadospodemserdevolvidos.Desdeaoperaoaqui
basicamenteumcrossmatchentreumatabelalocaleumremoto,estedescreveefetivamenteotipodejunoquedeveserfeito.As
opessoasseguintes:
Novatabelajuntadacomosresultadosmais
Anovatabelasergerada,contendoumalinhaparacadalinhadatabeladeentradaqueretornoupelomenosumresultadode
pesquisanatabelaremota.Omelhor(maisprximo)jogoserincludoquaisqueroutrasserorejeitadas.Anovatabelatertodas
ascolunasdatabeladeentradaetodasascolunasretornadaspeloserviodedados.
Novajuntoutabelacomtodososjogos
Anovatabelasergerada,contendoumalinhaparacadaresultadodepesquisaretornado.Linhasdetabeladeentradaser
duplicadaondemaisdeumresultadodepesquisafoidevolvidocorrespondenteaessalinha.Anovatabelatertodasascolunasda
tabeladeentradaetodasascolunasretornadaspeloserviodedados.
Novatabelaunida,umalinhaporlinhadeentrada
Umanovatabelasergeradocontendoomesmonmerodelinhascomoatabeladeentrada.Sequalquerresultadodapesquisa
foramdevolvidosparacadalinha,amelhor(maisprximo)seestincludo.Todososoutrosserodescartados,easclulasestar
vazioparalinhascomnenhumresultadodepesquisa.Anovatabelatertodasascolunasdatabeladeentradaetodasascolunas
retornadaspeloserviodedados.
Adicionarsubconjuntodelinhasencontradas
Semnovatabelasergerado,masumnovosubconjuntoseradicionadatabelaqueincluiapenasaslinhasqueretornoupelo
menosumresultadodepesquisa.
Oscontrolesfinaisajustarosdetalhesdecomoasconsultasindividuaissoapresentadosaoservioremoto.
Paralelismo
Controlaquantosbuscasconeestofuncionandoaomesmotempo.Aofazervriasconsultasaoservioaomesmotempo,otempoque
levaparapreenchertodaatabelapodesermuitomaisrpidodoquefazeraconsultaparaaprimeiralinha,esperadoresultado,
tornandoaconsultaparaasegundalinha,etcOvaloraquideaproximadamentequantasconsultasseroexecutadasaomesmotempo.
Aumentarovalorpodefazerasuacorridaconsultamltiplamaisrpidooupodesobrecarregaroservidoretornloimpopularcomo
administradordoservio,ouresultarnasuaconsultalevandomaistempoounocompletamente,ouambos.Ovalorpadrode5
provavelmenterazovel,masexperimentarcomajustandoosequiser.
Tratamentodeerros
Determinaoqueaconteceseumadasconsultasfalharcomumerro.Asopesso:
abortar
terminaraoperaotodaapesquisamltiplafalha
ignorar
tratarumaconsultafalhouomesmoqueumqueretornazerolinhas
repetirNvezes
tentarNvezesparaobterumresultadonofail
repetirindefinidamente
continuartentandoparaumresultadonofail
Omelhorcenrioparaissodependedaformacomooservioconfiguradoopadroabortar,masparaserviosnoconfiveis
ou

malimplementados,podesermelhorparacontinuaraoperaoemfacedealgumasfalhas.
Quandotodososcamposestopreenchidos(opadropodeserusadoparamuitosdeles),bateuoGoboto,eabuscaseriniciada.Podeser
bastantelentoumabarradeprogressomostradonaparteinferiordajanela.Quandoeleforconcludo,umajanelapopupqueresumeo
resultadosermostrado.Sevocficarentediadodeespera,vocpodebateroCancelarbotoe,talvez,ajustarosparmetrosetente
novamente.

A.9.2ConePesquisa

http://127.0.0.1:2525/doc/sun253/sun253.html

148/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

DilogocargamesaCone
OdilogocargabuscaconepodeserabertousandoaPesquisaConeboto(

)nabarradeferramentasdajaneladecargaoudaJanelado

ControleVOmenu.Elepermitequevocconsulteumdeumasriedeservioswebexternosparaobjetosdeumdeterminadocatlogoemuma
determinadaregiodocu.Osdadosmantidosporserviosdebuscadeconesoefetivamentecatlogosdeorigemcomcolunasdeposiono
cu.
Ajanelaconstitudaporumpaineldeconsultaderegistronotopo,eumPaineldePesquisanicoposicionalabaixo.

A.9.3simplesdeacessoaImagem(SIA)Consulta

http://127.0.0.1:2525/doc/sun253/sun253.html

149/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

DilogocargaconsultaSIA
OdilogocargaconsultaSIApodeserabertousandooSIAConsultaboto(

)nabarradeferramentasdajaneladecargaoudaJanelado

ControleVOmenu.Elepermitequevocconsulteumdeumasriedeservioswebexternosparaimagensquecobremumadeterminada
regiodocu.
Ajanelaconstitudaporumpaineldeconsultaderegistronotopo,eumPaineldePesquisanicoposicionalabaixo.Otamanhoangular
podeserdefinidoparazeroistosignificaquequalquerimagemquecobreaposioescolhidairserseleccionado.HtambmumFormato
daimagemseletorquepermiterestringiroresultadodeconterapenasimagensemcertosformatos(opadroestdefinidoparaapenasFITS).
Oresultadodeumaconsultabemsucedidaumatabelaemquecadalinharepresentaumaimagemquepodeserbaixadoapartirdeumlocal
remotoumadascolunasincluioURLdaimagem,easoutrascolunascontmmetadadosassociados,taiscomoformatodeimagem,o
tamanho,formaeassimpordiante.Diferentesserviosdefornecerdiferentestiposderespostaaestasperguntasalgunspodemterumalista
estticadearquivosFITSobservadosoureduzidos,eoutrospodemgerarimagensemtemporeal.VejaoSIApadro,eregistrosderegistro
individuais,paramaisdetalhes.UmacoisatilparafazercomatabelaresultantepodeserparadefinirsuaaodeativaoparaaURLda
ImagemVercomoopousarajaneladeativao.

AcessoespectralA.9.4Simples(SSA)Consulta

http://127.0.0.1:2525/doc/sun253/sun253.html

150/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

DilogocargaconsultaSSA
OdilogocargaconsultaSSApodeserabertousandooSSAConsultaboto(

)nabarradeferramentasdajaneladecargaoudaJanelado

ControleVOmenu.Elepermitequevocconsulteumdeumasriedeservioswebexternosparaespectrosemumadeterminadaregiodo
cu.
Ajanelaconstitudaporumpaineldeconsultaderegistronotopo,eumPaineldePesquisanicoposicionalabaixo.AespecificaoSSA
dizqueodimetrodocampopodeserdeixadoembranco,nocasoemqueoservio"devefornecerumvalorpordefeitodestinadoaencontrar
objectosprximos".Noentanto,aexperinciamostraqueissonemsemprefunciona,porissopodesermelhorparapreencherestadentroH
aindaumFormatoSpectrumseletorquepermiterestringiroresultadoaconterapenasespectrosemcertosformatos.Porpadro,oservio
escolhequaisformatosdevoltar.
Oresultadodeumaconsultabemsucedidaumatabelaemquecadalinharepresentaumespectroquepodeserbaixadoapartirdeumlocal
remotoumadascolunascontmaURLdedownloaddeespectro,easoutrascolunascontmmetadadosassociados,taiscomooformatode
espectro,WCS,informaesdeprocednciaeassimpordiante.VejaoSSApadroparamaisdetalhes.Umacoisatilparafazercomatabela
resultantepodeserparadefinirsuaaodeativaoparaaURLcomoSpectrumopousandoajaneladeativao.

A.9.5mltiplaConePesquisa

http://127.0.0.1:2525/doc/sun253/sun253.html

151/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Vriasjaneladebuscacone
Ajaneladepesquisaconemltiplapodeserabertousandoomulticoneboto(

)nabarradeferramentasdaJaneladoControle,ouoseu

VOoujuntamenus.Elepermitequevocselecioneumdosvriosservioswebexternosqueoferecemconsultasdecatlogoremotoe
executarumaconsultaparacadalinhadeumatabeladeentrada.Issopermitequevocefetivamenterealizarumcrossmatchposicionalentre
umatabelalocaleumremoto.
Ajanelaconstitudaporumpaineldeconsultaderegistronotopo,eumapesquisaposicionalPainelmltiplaabaixo.
OpaineldepesquisaincluiumVerbosityseletor,bemcomoascaractersticasnormais:istopermitelheescolherasopesparaquantas
colunasapareceronatabeladesada,apartirde1(mnimo)a3(mximo).Algunsserviosvotomarconhecimentodesseparmetroe
retornarmesasmaisestreitasoumaislargas,respectivamente,eosoutrosvoignorlo.
Oseguinteitemestdisponvelnabarradeferramentasepesquisadomenu:
UsedeCoberturadoServio
Seestaopoforselecionada,apesquisatentaconsultaroservioparaacoberturadocuquerepresenta,seessainformaoest
disponvel.Emseguida,elesenviaconsultasparaposiesnatabeladeentradaqueseenquadramnaquelaregiodecobertura,uma
vezquetodasasconsultasexternasqueregiosoobrigadosadevolverumresultadovazio.Dependendodacobertura,istopodereduzir
substancialmenteonmerodeconsultasrealizadas,e,consequentemente,otemponecessrio.Senohsobreposioentreatabelade
entradaedecoberturadoservio,aconsultaobrigadoaretornarnenhumresultadoemtudo,eotemposerreduzidodeformaeficaz
parazero.
Quandoestiveremoperao(ouseja,quandoessaopoforselecionadaeoservioforneceinformaesdecobertura)acoberturado
servio,atabeladeentradaesuasobreposioresumidacompequenos(Mollweideequatoriais)conesdetodoocuemazul,
vermelhoemagenta,respectivamente,comoemcapturadetelaacima.Istotornamaisfcilparaverasregiesdocuemqueos
resultadospodemserobtidos,etambmovalorpeloqualessaoporeduzconsultasinteis.
Atualmente,essaopofuncionadeformaeficazapenasparapesquisasconefornecidospeloserviovizirdeCDS(editor"CDS")que
forneceminformaesdecoberturaatravsdemapasdecoberturaMultiOrder(MOCs).Paraosserviosnovizirestaoponotem
efeito.
http://127.0.0.1:2525/doc/sun253/sun253.html

152/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.9.6mltiplaSIAConsulta

JanelamltiplaSIA
AjaneladeacessosimplesimagemmltiplapodeserabertousandooMultipleSIAboto(

)apartirdaJaneladoControleVOoujunta

menus.Elepermitequevocselecioneumdosvriosservioswebexternosqueoferecemconsultasemexploraesimagemremotamente
acessveis,eexecutarumaconsultaparacadalinhadeumatabeladeentrada.
Ajanelaconstitudaporumpaineldeconsultaderegistronotopo,eumapesquisaposicionalPainelmltiplaabaixo.AcolunaBuscapor
raiopodeserajustadoparazeroistosignificaquequalquerimagemquecobreaposioescolhidairserseleccionado.Htambmum
Formatodaimagemseletorquepermiterestringiroresultadodeconterapenasimagensemcertosformatos(opadroestdefinidopara
apenasFITS).
Oresultadodecadaconsultaindividualbemsucedidaumatabelaemquecadalinharepresentaumaimagemquepodeserbaixadoapartirde
umlocalremotoumadascolunasincluioURLdaimagem,easoutrascolunascontmmetadadosassociados,taiscomoformatodeimagem,o
tamanho,formaeassimpordiante.Diferentesserviosdefornecerdiferentestiposderespostaaestasperguntasalgunspodemterumalista
estticadearquivosFITSobservadosoureduzidos,eoutrospodemgerarimagensemtemporeal.VejaoSIApadro,eregistrosderegistro
individuais,paramaisdetalhes.
Observequealgunsserviosderetornarvriasimagensnasmesmasposies,masemdiferentescomprimentosdeonda.Nestecaso,ocritrio
deTOPCATparao"melhor"jogo(omaisprximodaposiodeconsultacentral)podenofazermuitosentido.Porestemotivo,tome
cuidadoseutilizara"novatabelaassociadacommelhoresresultados"ou"Newjuntoumesa,umalinhaporlinhadeentrada"modosdesada.
UmusodestafunoadicionaralgumascolunasdeumatabelaexistentequecontmURLsdeimagensdeumdeterminadoservidor
correspondentesposiescudessaslinhas.Tendofeitoisso,vocpodequererdefiniraodeativaodatabelaresultanteparaaURLda
ImagemVercomoopousarajaneladeativao.

A.9.7mltiplaSSAConsulta
http://127.0.0.1:2525/doc/sun253/sun253.html

153/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelamltiplaSSA
AjaneladeAcessoespectralsimplesmltiplapodeserabertousandooMultipleSSAboto(

)dajaneladoControleVOoujuntamenus.

Elepermitequevocselecioneumdosvriosservioswebexternosqueoferecemconsultassobreremotamenteacessveiscolecesdedados
espectrais,eexecutarumaconsultaparacadalinhadeumatabeladeentrada.
Ajanelaconstitudaporumpaineldeconsultaderegistronotopo,eumapesquisaposicionalPainelmltiplaabaixo.AespecificaoSSA
dizqueaBuscaporraiocolunapodeserdeixadoembranco,casoemqueoservio"devefornecerumvalorpadroaintenodeencontrar
objetosprximos".Noentanto,aexperinciamostraqueissonemsemprefuncionaassim,podesermelhorparapreencherestadentroHainda
umFormatoSpectrumseletorquepermiterestringiroresultadoaconterapenasespectrosemcertosformatos.Porpadro,oservioescolhe
quaisformatosdevoltar.
Oresultadodecadaconsultaindividualbemsucedidaumatabelaemquecadalinharepresentaumespectroquepodeserbaixadoapartirde
umlocalremotoumadascolunascontmoURLspecturm,easoutrascolunascontmmetadadosassociados,taiscomoformatodeespectro,
WCS,informaesproveninciaeassimpordiante.VejaoSSApadroparamaisdetalhes.
UmusodestafunoadicionaralgumascolunasdeumatabelaexistentequecontmURLsdeespectrosdeumdeterminadoservidor
correspondentesposiescudessaslinhas.Tendofeitoisso,vocpodequererdefiniraodeativaodatabelaresultanteparaaURL
comoSpectrumopousandoajaneladeativao.

A.9.8TabelaAccessProtocol(TAP)Consulta

http://127.0.0.1:2525/doc/sun253/sun253.html

154/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

ProtocoloJanelatabeladoAccess
AjaneladecargaTabelaAccessProtocol(TAP)podeserabertousandoaTAPConsultaboto(

)nabarradeferramentasdajanelade

cargaoudaJaneladoControleVOmenu.ElepermitequevocuseoprotocoloTAPparafazerconsultasdeformalivredeserviosdebanco
dedadosremotosusandoumalinguagemSQLlike.Esteumrecursopoderoso,dandolheplenoacessosexploraesdedadosremotos
semelhanteasistemascomoodoSDSSCasJobs,masusandoopadroTAPaprovouIVOAsignificaquevocpodeusaramesmainterface
paramuitosconjuntosdedadosremotosdiferentes.
TAPmaiscomplexodoqueosoutrosprotocolosVOimplementadaspeloTOPCAT,eestajanelacorrespondentementemaiscomplicado
doqueosdilogosCone,SIAeSSA,emboraelenocompartilhamalgumascaractersticascomeles.
AfimdeinterrogarobancodedadosremotoquevocterqueescreverconsultasemAstronmicadadosQueryLanguage(ADQL).Esta
umaferramentapoderosa,masparafazercoisascomplicadasemquenotrivial.ADQLessencialmenteumdialetoparticulardeSQL,ento
sevocsabeSQL,jquevocdevesercapazdeescreverconsultasADQL.SevoctemsistemascomoCasJobsdoSDSSutilizado,o
conceitodeveserbastantefamiliar.UmtutorialsobrecomoescreverADQL/SQLestforadoescopodestemanual,masoDigiteConsulta
guiaforneceumaExemplosdemenuquelhedarumbomcomeonasuautilizao.Vocpodeencontrarumaboaintroduoescritopor
MarkusDemleitnerdeGAVOemhttp://docs.gvo.org/adql.
Umavezquesuaconsultaescrito,vocpodeenviloemqualquersncronaouassncronamodo.Consultassncronoscomearaexecutar
imediatamenteedeveserrelativamentecurtoconsultasassncronassoenviadasaumservidor,executadoporumpotencialmuitotempo,e
recuperaroresultadodepois.
Ajanelacompostaporquatroguias,dosquaisvocpodeverumdecadavez.Vocvaiusardoisoutrsdelesaosubmeterumaconsulta
TAP.Cadaseparadordescritoemmaisdetalhenasseguintessubseces,masumavisogeraldoseufuncionamentodaseguinteforma:
SelecioneServiodeguia
EscolheoservioTAPquedesejaconsultar,utilizandoumapesquisaderegistrooudigitandoaURLdoserviodiretamente.Depoisde
terescolhidoumservioquevocpodepassarparaaEnterConsultaguia.
DigiteConsultaguia
Exibeinformaessobreoservioeastabelasquedetm,epermitequevocdigiteotextodaconsultaeenviaratarefa.Seotrabalho
enviadodeformasncrona,acargavaicomeardiretamente,masnocasoassncrono,vocvaipassarparaacorrenteJobsguia.
CorrendoJobsguia
Mostraumalistadospostosdetrabalhoconsultaassncronalheforamapresentados,comdetalhessobreoseuprogresso.
RetomarJobguia
http://127.0.0.1:2525/doc/sun253/sun253.html

155/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Opcionalmentepermiteretomarumaconsultaassncronacomeouemalgumasessoanterior.
Quandovocvisitarestajanela,oSelectServiodeguiaservisvel,equandoumaconsultaassncronafoisubmetidoatrabalhosem
execuoguiaservisvel.Sevocquiserenviaroutraconsultaparaomesmoservio,ouutilizarumserviodiferente,bastaselecionarDigite
consultaouSelecionarservio,respectivamente,clicandonaguiaapropriadanotopo.
EstajanelaofereceummenuadicionalparaopadrodoWindowsVOmenus:
MenudeSupresso
Permitequevocescolhaquandoostrabalhosdeformaassncronaapresentadosporpadroserexcludodoservidor.Umavezqueeles
soexcludosquenosermaisvisvelnoJobsCorrendoguia.Seelesnosoexcludosdestaforma,elesvoficarnoservidoratque
sejamexcludosdeacordocomapolticadeexclusodoservidor.Escolhaumadasopesdisponveis:
Emconcluso:excludoquandoelefoiconcludacomsucessooustatusdeerro
NoExit:excludoquandoTOPCATdesliga
Nunca:noexcludos(excetodeacordocomapolticadeservidor)
Vocpodesubstituiressasconfiguraesumavezqueumtrabalhofoiiniciadousandooscontrolesnaparteinferiordoempregode
funcionamentoguia.AsconfiguraesnestemenuafetamovalorpadrodaExitExcluiremcaixa.Sevocquiserretomarotrabalho
emumasessoposterior,voctemquetercertezadequeotrabalhonoexcludodaboaexecuooudesada.
Ositensdemenuso:
:Continueaberto
Fazsedequeajanelanoserfechadaautomaticamenteapselecarregaumatabela.
:Atualizar
Recarregaasinformaesexibidasnajaneladoservidor.Istopodeestaratualizandoasinformaesdestatusdeempregoouderecarga
demesaoumetadadosdeservioocomportamentoexatodependedequalguiaestvisvel.
Nota:OdilogoTAPfoiintroduzidonaverso3.8doTOPCAT,nummomentoemqueosserviosdaTAPmaisdisponveissomuitonovo
enopodemconformartotalmenteaopadro,eospadresdeusoaindaestoseestabelecendo.Porestarazo,vocpodeacharquealguns
serviosdaTAPvisveisnosecomportamcomooesperadotambmpossvelqueemfuturasversesdainterfacedousurioirmudarde
acordocomamudanadosperfisdeservioouluzdaexperinciadousurio.
GuiaA.9.8.1Selecionarservio

http://127.0.0.1:2525/doc/sun253/sun253.html

156/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaTAPcomguiaSelectServiovisvel
ASelectServiodeguiadodilogocargaTAPpermitequevocescolhaqualoservioTAPvocdesejaconsultar.Vocprecisafazerisso
antesdeenviarumanovaconsultaTAP.Essaguiaessencialmenteomesmoqueopaineldeconsultaderegistrodasoutrasjanelasdeconsulta
VO.Tendoconsultadooregistro,cliqueemumadaslinhasparaentrarnoURLdoservionoURLTAPcamponaparteinferior.
SevocsouberoURLdoservioTAPquedesejaconsultar,vocpodedigitlodiretamentenaURLTAPcamposemumapesquisade
registro.
Nomomentodaescrita,hapenasumpardeserviosdaTAPdziaregistrados,epossvelconsultaroregistrodetodoseles,clicandono
SubmitQuerybotosemdigitarostermosdepesquisa.Note,porm,que,porrazestcnicas(osregistrosderegistrodealgunsdesses
serviossograndes)abuscapodedemorarumpouco(normalmente30segundosemumlinkrpido).
UmavezqueumURLdeserviofoiescolhidoemumadessasformas,vocpodeclicarnoEnterconsultabotonaparteinferior(ou
equivalentementeocabealhoguianapartesuperior),evocsertransferidoparaoDigiteConsultaguia.
A.9.8.2DigiteguiaConsulta

JanelaTAPcomEnterguiaConsultavisvel
AEnterConsultaguiadodilogocargaTAPexibeinformaessobreoservioquevocselecionouparaconsultar,principalmentequais
tabelasestodisponveisequaisascolunasqueelestm,epermitequevocdigiteotextodaconsultaealgumasopesadicionaissobrecomo
aconsultaserexecutado.Opaineltemtrspartes:tabelademetadados,recursosdeservioseADQLtexto.
Atabelademetadadospainelexibeinformaessobreastabelasmantidaspeloservioselecionado.Quandoopainelexibidopelaprimeira
vezoserviocontactadoparaobteressasinformaes,eumabarradeprogressoirapareceratqueelechegou.Seoservionofornecla
deumaformaadequada,nadapodesermostradoaindapossvelsubmeterumaconsulta,masvocvaiprecisardealgumaoutraformade
saberoqueastabelasecolunasestodisponveis.Umavezqueosmetadadosfoicarregado,asseguintesinformaesestarodisponveis:
Servio
AURLdoservioselecionadonaguiaSelectService.Eletambmobservaonmerodemesasdisponveisapartirdesteservio.
Mesa
Esteseletorcontmumaentradaparacadaquadroqueconstanobancodedadosremoto.Podehaverapenasum,oupodehavercentenas
depessoas.Quandovocselecionaum,informaessobreeleexibidoabaixo.Umttuloexpandidooudescriotambmpodeser
http://127.0.0.1:2525/doc/sun253/sun253.html

157/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

exibidaaoladodoseletorpairandosobreestadescriocomomousepodefornecermaisdetalhesemumadicadeferramenta.
Colunas
Tabulametadadossobrecadaumadascolunasdatabelaremotaselecionadanoseletordetabelaacima.Osnomesdascolunas,tipos,
descriesUCDsetcsomostrados.Colunasquesoconhecidosporseremindexadosnobancodedadosremototemacoluna
"indexado"assinaladaissopodeajudaraformularconsultaseficientes.
ChavesEstrangeiras
Seoservioforneceinformaessobreaschavesestrangeiras(ligaesentreoscamposemtabelasdiferentesnobancodedados)que
serotabuladosaqui.Elespodemajudloaformularconsultaseficientes.
ACapacidadedeServiopainelmostrametadadoscapacidadequeoserviofornecesobresimesmonovamente,issotemquesercarregado
apartirdoservidorepodenoaparecerimediatamente.Elecontmasseguintesinformaes:
QueryLanguage
Mostraoqueconsultaraslnguas,equeverses,estodisponveis.Sehouvermaisdoqueumalista,vocpodeescolheroidiomaque
vocquerenviarasuaquesto,massevocescolheralgoquenoumavariantedoADQLelepodenofuncionar.
Mx.nmerodelinhas
Selectorquemostraonmeromximodelinhasdesadaqueoservioestdispostoparaentregar,comooresultadodeumaconsulta,
emcircunstnciasnormais.Asentradasnestalistavalorpodesermarcado"(padro)"ou"(max)".Vocpodealteraressevalor,digitando
umnmerodiferente,desdequenoultrapasseomximodoservidor.Estevaloraquiparaprotegeroutilizador,bemcomooservio,a
partirde,inadvertidamente,solicitandoumatabeladesadademasiadogrande.Observeque,seaconstruo"TOP nnn"usadono
ADQL,onnnlimitepodesubstituirovalorfornecidoaqui.
Uploads
Indicasesopermitidosenviosdemesae,talvez,oqueomaiortamanhodeupload(emtermosdelinhase/oubytes),queseraceito.
Vejaabaixomaisinformaessobreenviosdemesa.
OtextoADQLpainelondevocpodedigitarotextodaconsultarealparaasolicitao.Eletemasseguintespartes:
CheckboxSynchronous
Determinaseseutrabalhoserexecutadonoservidoremmodosncronoouasychronous(marqueacaixasncrona).Sncronasignifica
queTOPCATenviaaconsultaaoservidoreaguardaoresultadocomoarespostadomesmopedidoHTTP.maissimplesemais
rpido,masseotrabalholevamuitotempo,opedidopodeexpirareosresultadosseroperdidos.NomodoassncronoTOPCATenviaa
consultaparaoservidorerecebeumamensagemdevoltadizendoqueondeprocurarinformaessobreoandamentodotrabalho
TOPCATentomantmpollingdoservidorparasaberquandoelefoiconcludo.Sncronoadequadoparatrabalhosdecurtas(que
tipicamentepodeserexecutadacomumatrasodealgunssegundosamenos),masparaostrabalhosmaislongosaysnchronousmais
fivel.possvelenviarumatarefaassncronanoprimeirodiadeumamquina,epegarosresultadosemumdiadiferentedeoutra
mquina,utilizandooutrainvocaodeTOPCAToudeumaltogtheraplicaodiferente.
Exemplosboto
Estebotoapresentaocomumpequenomenudeconsultasdeexemplo.Estessoadaptadosparaosmetadadosdatabelaobtidoporeste
servio,bemcomo,eventualmente,atabelaatualmenteselecionadapeloseletordemesae/oualistadetabelanajaneladecontrole,de
modoquedeve,namaioriadoscasos,serexecutvelcomoesto(emboranohgarantiadequeelesvoproduzirresultadosteis).A
melhoridiaqueparausloscomopontosdepartidaparaassuasprpriasconsultas.Aoescolherumquealgoparecidocomoque
vocquerfazer,vocpodeesperotrabalharasintaxeparaaconsultaquevocprecisasemterqueleraespecificaoADQL.Algumas
dasopesdalistapodeserdesativado,dependendodoqueascapacidadesdoserviodeclarou.Emalgunscasos,especialmenteaqueles
queutilizamfunesgeomtricas,oserviopoderejeitaroexemplo,jqueTOPCATnopodesempredizerqueasfunesso
suportadaspeloservidor.
BotoLimpar
Aoclicarnestebotoapagaqualquertextoatualmenteexibidonocampodeentradadetexto.
ParsebotoErros
SeumerrodesintaxedetectadonotextoADQLinserido,eleserdestacadonocampodetexto,eestebotoserhabilitado.Aoclicar
nestebotoirmostrarumajanelapopupcommaisdetalhessobreoerro.
Campodeentradadetexto
IstoondevocinsiraotextodaconsultaADQLvocdesejafazer.AsintaxedeADQL(AstronomicaldadosQueryLanguage)
definidaporumaRecomendaoIVOAeleefetivamenteumdialetodoSQL,masumaboamaneiradeescreverumaconsulta
comearcomumdosexemplosdaExemplosbotoacima.SeforemdetectadoserrosnasintaxedoADQLcomoentrou,elesso
destacadosemrosacomonafiguraacima.
AlgunsserviospermitemTabelaUploads(nomomentodeescreverapenasoservioGAVOimplementaesserecurso,masesperoquemais
irfazlonofuturo).OqueistosignificaquevocpodefazeruploaddetabelasdeTOPCATnobancodedadosremotoeexecutarconsultas
emsuatabeladiretamente.Destaforma,vocpodeexecutarasuniesentreseusprpriosquadros(nadacarregadonaTOPCAT)equalquer
umadastabelasnobancodedadosremoto.Esteumrecursoextremamentepoderoso.Paraaproveitlo,vocsprecisausarumformulrio
especialparaonomedatabelaparafazerrefernciaaumatabelabaseadaemTOPCAT:vocescreve"TAP_UPLOAD.t <n>",onde<n>o
nmerodeIDdatabelaemTOPCAT,queonmeroantesdosdoispontosnajaneladecontroleListaTable.Assim,seumatabela
identificadacomo"1: messier.xml"nalistadetabela,vocpodereferenciloemADQLcomo"TAP_UPLOAD.t1".Noteseatabela
carregadodestamaneiraaTabelaaparentecorrespondenteaonmerodeidentificaodada.
Assimqueentrarnotextodaconsulta,sermarcadaporerrosdesintaxe.Seumerroforencontrado,olocalnotextoqueparecetercausadoele
serdestacadoemrosa(comonafiguraacima).Paravermaisdetalhessobreoerro,cliquenoErrosParseboto.Averificaoemsi
razoavelmenteconfivel,masaposiodoerrodestacado,eotextodamensagemdeerro,svezespodeserumpoucoenganador,portanto,
notomeosdetalhesmuitoasrio.Orealcedeerrousadoapenascomoumaviso,vocnoestimpedidodeapresentarumaconsulta
marcadacomoerrnea,umavezque,emalgunscasos,osserviosdaTAPpodemaceitarADQLquenoestritamentecorreto,eemalguns
casosaverificaodeerrosnopodeserperfeito.
Tendoentradotextodeconsultaadequado,cliquenoOKbotonaparteinferiordajanelaparaapresentarotrabalho.Quandovocfizerisso,
umadasduascoisasvaiacontecer.Nomodosncrono,ajaneladecargaaparecer,eoprogressoirindicarquandoacargaestcompletana
maneiranormal.Nomodoassncrono,vocserlevadoparaacorrenteJobsguiaondevocpodeveroprogressodeseutrabalhosubmetido.
http://127.0.0.1:2525/doc/sun253/sun253.html

158/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.9.8.3guiaTrabalhosCorrendo

TAPcomjanelaExecutarguiaTrabalhosvisvel
AcorrenteJobsguiadodilogocargaTAPmostraumalistadospostosdetrabalhoassncronoslheforamapresentados,cominformaes
sobreoseuprogressoatual.
Apartesuperiordatelamostraumalistadostrabalhosenviados,juntamentecomumresumodeumapalavradoseustatus(suaFase).Seum
destespostosdetrabalhoselecionado,osdetalhesseromostradosnaparteinferior.Porpadrootrabalhomaisrecentementeapresentadoser
mostrado,masvocpodeselecionarumtrabalho,clicandosobreela.
Asinformaesapresentadassorecuperadosdoservidor,espodeservisto,desdequeotrabalhonotenhasidoexcludo,porvoco
usurio,oucomoresultadodapolticadoservidor(porexemplo,umtempodevidamximodetrabalho).Osseguinteselementos,sefornecido
peloservio,somostrados:
URL
OURLnoqualasinformaesdotrabalhorealizadanoservidor.Estevalorpodeserusadomaistardenoresumodotrabalhode
tabulao,ouinseridodiretamenteemumnavegadorparaverasinformaesdotrabalho.
Fase
Oestgioatualdeprocessamentodotrabalho.IssogeralmenteprogridenaseqnciaQUEUED,execuo,CONCLUDO(ouerro).
CdigodaVaga
Identificadordetrabalho,originalparaoservidor.FazpartedaURL.
RunID
Identificadordecorrer,muitasvezesembranco.
DonoId
Identificadordoproprietrio,embranco,amenosqueaautenticaodeusurioestemuso.
Duraomxima
Aquantidademximadetempoemsegundosqueoservidorpermitirqueotrabalhosejaexecutadopor.Esteo"relgiodeparede"
tempoaoinvsdetempodeCPU.
HoradeIncio
Horaemqueiniciouoprocessamentorealdotrabalho(aocontrriodefilas).
http://127.0.0.1:2525/doc/sun253/sun253.html

159/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

EndTime
Horaemqueoprocessamentodotrabalhoconcludo.
DestruioTempo
Momentonofuturoemqueoservidorirexcluirotrabalho,senotiversidoremovidamanualmente,ento.
Erro
Mensageme,possivelmente,outrasinformaessobreoestadodeerroseocorreuumerroduranteoprocessamento.Esteser
normalmenteembrancoamenosFasetemovalor"ERRO".
Parmetros
Exibeosparmetrosqueforamfornecidosparadefinirotrabalhoparaoservidor.IstoirnormalmenteincluirotextodaADQLsendo
executado.
Vocpodecortarecolarapartirdessesitens,entoporexemplo,sevocquertomarecolloemumnavegadordaWebquevocpodefazera
URL.
Htrsbotesnaparteinferiordatelaqueafetamostatusdotrabalhoatualmenteexibido:
Abortar
Estebotoparaotrabalhosejaexecutado.Elenopodeserreiniciado.Otrabalhoaindaexistenoservidornoentanto,paraqueelepossa
serexaminadonestajanela.
Excluir
EstebotoparaotrabalhocomoparaAbort,mastambmremovetodososvestgiosdequeapartirdoservidor.Nenhumdetalhepode
servistomais.
ExcluiremExit
EstacaixadeverificaodeterminaseotrabalhoserexcludodoservidorquandoTOPCATsai.Sevocquiservoltaraumtrabalhode
longaduraoemumasessoposterior,vocdevedesmarcarissoparaqueotrabalhopermanecenoservidor.Aaopadro
normalmentequeosempregossoeliminadosnasada(ouseja,estacaixacomeamarcada),masvocpodealteraropadrousandoa
Supressomenu.
Senenhumtrabalhoestoatualmentedisponveis(nenhumfoisubmetidooutodoselesforamexcludos),esteguiainacessvel.
GuiaA.9.8.4resumodotrabalho

JanelaTAPcomguiaJobResumevisvel
OJobResumeguiadodilogocargaTAPpermitecontinuaraexecuodeumtrabalhoassncrono,quefoiiniciadoforadesteprazode
TOPCAT,sejaduranteumacorridaTOPCATanteriormente,ouusandoalgumoutromecanismo.Istopodesertilsetiverenviadoum
trabalhodelongaduraoemumdiamaiscedooumaisemumamquinadiferenteequiseracompanharseuprogressooupegarosresultados.
Parauslo,digiteaURLdotrabalhonaURLcamponapartesuperiorecliquenoVerboto.SeumtrabalhocomessaURLexiste,seus
detalhesseroexibidosnopainelabaixo,nomesmoformatoqueparaoJobsCorrendoguia.
http://127.0.0.1:2525/doc/sun253/sun253.html

160/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Dependendoseotrabalhofoiconcludoouno,ouocurrculooucargaresultadobotonaparteinferiordajanelaserhabilitado.Voc
podeclicaromaisadequadotantoparamonitorarseuprogressomaisouparapegaroresultadocompleto.

A.10OtherWindows
A.10.1concatenaoJanela

Janelaconcatenao
AJaneladeconcatenaopermitejuntarduasmesasjuntasdecimaparabaixo.ElepodeserobtidousandooConcatenateTabelasboto(
)najaneladecontroledabarradeferramentasoumenudejunta.
Quandoduasjanelasestoconcatenadastodasaslinhasdatabelaprimeiro("Base")soseguidasportodasaslinhasdasegunda("anexado")
mesa.Oresultadoumanovatabela,quetemumasriedelinhas,igualsomadosdoistemsidofeitoapartirde.Ascolunasnatabela
resultantesoasmesmasqueasdatabelabase.Pararealizaraconcatenao,voctemqueespecificarquaiscolunasdatabelaanexada
correspondemaquaisnatabelabase.claro,estetipodeoperaosfazsentidosepelomenosalgumasdascolunasemambasastabelastm
omesmosignificado.EsteprocessodiscutidoemmaisdetalhenaSeco5.1.
Ajaneladeconcatenaopermiteselecionarabaseequadrosanexos,eparacadacolunanatabelabaseparaespecificarqualcolunadatabela
anexacorresponde.Vocpodeselecionarumespaoembrancoparaeste,casoemqueacolunaemquestotertodasasentradasnulasna
tabelaresultante.Emalgunscasosestesseletoresdecolunapodeterumvalorpreenchidoautomaticamenteseoprogramapensaquepode
adivinharosadequados,masvocdevegarantirqueeletenhaadivinhadocorretamentenessecaso.Apenasascolunasadequadasesto
disponveisparaescolherapartirdestesseletoresdecolunanamaioriadoscasos,istosignificaqueasnumricas.
Quandovoctiverpreenchidooscamposparaasuasatisfao,bateuoConcatenatebotonaparteinferiordajanela,eumanovatabelaser
criadaeadicionadalistadetabelanajaneladecontrole(umajanelapopupirinformloqueissoaconteceu).
Oresultadocriadoapartirdosaparentesversesdabaseetabelasemanexo,afimdequequalquersubconjuntodelinhas,colunas
escondidas,ouotipoatualmenteemvigorserorefletidasnasada.

JanelaAtivaoA.10.2

http://127.0.0.1:2525/doc/sun253/sun253.html

161/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaAtivao
AjaneladeativaopermitequevocconfigureumaaoparaexecutarquandoumalinhadatabelaativadaaoclicaremumalinhanaJanela
deDadosouumpontonajanelaPlot.ElepodeserobtidoclicandonoAoAtivaoseletornaparteinferiordopaineldepropriedadesna
janeladecontrole.
Voctemvriasopesdecomodefiniraao.esquerdadajanelaestumalistadeopesvoctemqueescolherumdelesparadeterminar
quetipodeaoocorrer.Quandovocclicaemumadessasopesoscontrolescorrespondentesnoladodireitovaisetornarhabilitado:us
losparaselecionarosdetalhesdaaoe,emseguida,cliquenoOKbotoparaqueoseventosdeativaosubseqentesfarcomqueaao
tenhadefinido(ouCancelardemodoqueelesnovo).AoclicaremOKaaodeativaonajaneladecontroleirindicaraaoquevoc
configurou.
Asopesdisponveissoasseguintes:
NenhumaAo
Seestaopoforselecionada,nenhumaaoespecialserrealizadaquandoumalinhaativada.Esteopadro.
RecorteVisordeimagens
Estaopoapresentaumamaneirafcildeusarimagemdeumrecortesurgindoapartirdeumservidordeimagensexibindoumaregio
docuemtornodeumalinhaativada.VocprecisaselecionarascolunasnasuatabelaquerepresentamAscensoRetaeDeclinao,
incluindoasunidadesemquesoinseridosnatabela(TOPCATpodesercapazdeadivinharalgumasoutodasessasinformaescom
baseemnomesdecoluna,UCDsevaloresunitrios,casoemqueentrarseuspalpitesnosseletoresparavocaceitaroumudar).Voc
tambmprecisaselecionarotamanhoempixelsdaimagemquevocquervereonomedapesquisaqueirforneceraimagemdeum
doslistados:
SuperCOSMOSAllBlueSky
SuperCOSMOSAllSkyRed
2MASSQuickOlheJband
2MASSQuickOlheHband
2MASSQuickOlheKband
SDSSCorImagens(notanofornececoberturadetodoocu)
http://127.0.0.1:2525/doc/sun253/sun253.html

162/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Quandovocativaalinha,oprogramatentarcontataroservidorwebqueforneceessasimagens,recuperaraimagemeexibilaemuma
janeladovisualizadordeimagens.Infelizmente,nomomentoajaneladevisualizaointernoelenoexibeemumvisualizadorde
SAMP/plsticoexterno.
VerURLcomoImagem
Estaopoadequadaseumadascolunasnasuatabeladalocalizao(nomedoarquivoouURL)deumarquivodeimagem.A
imagempodeestarnaFITS,GIF,JPEGouPNG,opcionalmentecompactadoscomogzip,Unixcomprimirouformatobzip2.Selecione
acolunaquecontmalocalizao,eativaralinhairaparecerumvisualizadordeimagensparaexibilo(seatabelaoresultadodeuma
consultasimplesoumltiplaSIA,acolunacorretaprovavelmenteserpreenchidoautomaticamente).OImageViewerseletorpermite
quevocescolhaumadasopesnoApndiceA.10.2.1ou,sevocestregistradocomumhubSAMPouplstico,qualquer
visualizadordeimagensSAMP/plsticoquetambmregistradoverSeo9.
VerURLcomoSpectrum
Estaopoadequadaseumadascolunasnasuatabeladalocalizao(nomedoarquivoouURL)deumarquivodeespectro,eque
pretendeexibirosespectrosemumvisualizadordeespectroexternoSAMPouPLASTICcompatvel,comoSPLATouVOSpec.
Primeiro,selecioneacolunaquecontmalocalizaodoEspectro(seatabelaoresultadodeumaconsultasimplesoumltiplaSSA,
acolunacorretaprovavelmenteserpreenchidoautomaticamente).Emseguida,escolhaoSpectrumVisualizadordeformaadequada.
Umavezfeitoisso,ativandoumalinhatentarenviaroespectrocorrespondenteparaaaplicaodevisualizaoselecionado(s).Os
detalhesdoqueformatosdedadossoaceitveis
dependemdaaplicaoespectador,masseencaixa,VOTableealgumasvariantesde

tabelaASCIIsogeralmenteOK.NotesequeTOPCAT,bemcomoumvisualizadordeespectroadequado,deveserconectadoaum
SAMPouplsticohubexecuoparaestetrabalho(verSeo9)nohespectadorespectrointerno.
VerURLcomopginadaWeb
Estaopoadequadaseumadascolunasnasuatabeladalocalizao(nomedoarquivoouURL)deumapginawebessedeveser
normalmenteemHTMLoutextosimples,masdependendodonavegadorquevocusaoutrostiposdedocumentopodesersuportada.
Selecioneacolunaquecontmolocaleonavegadorquevocgostariadeusarparaaexposio,eativaralinhavaitentarabriruma
janeladonavegadorparaexibila.VejaApndiceA.10.2.3paramaisinformaessobreosnavegadores.
TransmitirRow
EstaopofazcomqueonmerodalinhadeumalinhaativadoparasertransmitidoaumoumaisoutrosaplicativosusandoumSAMP
apropriadaoumensagemPLSTICO.IssosvaifuncionarseTOPCATestregistradocomumhubSAMP/plstico,eporissoso
umaoumaisaplicaes,queentendemqueamensagem,eooutroaplicativo(s)sabersobreatabelaemquesto,porexemplo,porque
anteriormentefoienviadade/paraTOPCAT.Vocpodeespecificarqueumanicaaplicao,outodosaquelesapropriados,vaireceber
asmensagens.VejaSeo9paramaisexplicaes.
TransmitirCoordenadas
EstaopofazcomqueaposiodocudeumalinhaativadoparasertransmitidoaumoumaisoutrosaplicativosusandoumSAMP
apropriadaoumensagemPLSTICO.IssosvaifuncionarseTOPCATestregistradocomumhubSAMP/plstico,eporissoso
umaoumaisaplicaesqueentendemamensagem.Umexemplopodeserumaplicativodevisualizaodocu,comoAladin,quepode
apontarparaumadeterminadaregiodocusemprequevocativarumponto.Vocprecisaespecificarascolunasquerepresentam
(J2000)AscensoRetaeDeclinao,e,opcionalmente,umouvinteespecialparareceberasmensagens(casocontrrio,todosos
registradosvontade).VejaSeo9paramaisexplicaes.
Executarcdigopersonalizado
Estaopodeveserusadasenenhumdosoutros(quesobastanterestritiva)fazeroquequiser.Elealtamenteflexvel,masnoto
fcildeusar.OquevoctemafazerescreverumaexpressodeacordocomasregrasemSeo7,envolvendoalgunsdosnomesdas
colunasqueseroinvocadosquandoumalinhaativada.Estaexpressonormalmentetmoefeitodesurgirumaimagemouum
espectroemumvisualizador,mas,especialmentesevocligaremsuasprpriasfunes(verSeo7.9)quepodefazerpraticamente
qualquercoisa.
FunesquesoesperadosparasertilparaasaesdeativaoestodescritosnoApndiceB.2eincluemalgunsdosmaisdeuso
geral(displayImageedisplaySpectrumparaexibirumaimagemouespectroemumvisualizadorexterno),bemcomoalgunsqueso
relevantesparadeterminadapesquisadedados,porexemplo,ospectra2QZ ()funo,queiraparecerumvisualizadordeespectro
exibindotodososespectrosrelacionadaaumadeterminadalinhadedadosdapesquisa2QZcombasenocontedodesuacoluna
NOME.
medidaquealistaacimamostra,amaioriadasaesdeativao,vocpodedefinirresultadoemumajaneladevisualizaodealgumtipo
aparecendo.OqueexatamenteotipodeespectadorusadadependedecomoTOPCATestconfiguradoe,emalgunscasossobreassuas
escolhas.Maisdetalhessobreosprogramasdeespectadordisponveissodadasnassubseesaseguir.Seestesnofazeroquevocquiser,
vocpodeusaraexecutarcdigopersonalizadoopo,talvezemconjuntocomuserdefinedfunesouosistema exec ()funes
descritasnoApndiceB.2,parainvocaroseuprprio.
AplicaesVisualizadorA.10.2.1Imagem
SevocescolheraimagemdeexibioderecorteouVerURLdaImagemcomooponajaneladeativao,emseguida,ativandouma
linhairexibirumaimagememumvisualizadordeimagens.
OvisualizadordeimagempadroSoG,umvisualizadordeimagensastronmicascombaseemJSky,queoferecemanipulaocolourmap,
imagemzoom,sobreposiesdegrficoseoutrosrecursos.ParaqueissofuncioneJAI,tambmconhecidocomoJavaAdvancedImagingdeve
serinstalado.JAIumcomponentegratuitodisponvelapartirdeSun,masnofazpartedoJava2StandardEditionporpadro.Naoperao,
SoGparecidocomeste:

http://127.0.0.1:2525/doc/sun253/sun253.html

163/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

SoGImageViewer
SeJAIouasclassesSoGprpriosestoausentes,umvisualizadorderecursoqueapenasexibeaimagemdadaemumajanelabsicade
grficoscomnenhumafacilidadedemanipulaoutilizado.Ovisualizadordeimagensfallbackparecidocomeste:

FallbackImageViewer
OsespectadoresA.10.2.2Spectrum
SevocescolheraVerURLcomoSpectrumoponajaneladeativao,emseguida,ativandoumalinhairexibirumespectroemum
visualizadordeespectro.
OvisualizadordeespectropadroSPLAT,umprogramadeanlisemultiespectrosofisticado.Issorequerapresenadeumcomponente
chamadoJNIAST,quepodeounopodetersidoinstaladocomTOPCAT(quedependedealgunsnoJava,ouseja,cdigoespecficoda
plataforma).Nohatualmentenenhumespectadorespectrofallback,porisso,seJNIASTnoestpresente,emseguida,osespectrosno
podeserexibido.Nestecaso,noserpossvelselecionaraexibioNomeadoSpectrumitemnajaneladeativao.Umexemplodemonitor
SPLATdemltiplosespectrosmostradoabaixo.

http://127.0.0.1:2525/doc/sun253/sun253.html

164/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

SPLATSpectrumVisualizador
AdocumentaocompletaparaSPLATestdisponvelonlinedentrodoprograma,ouemSUN/243.
A.10.2.3NavegadoresWeb
SevocescolheraVerURLdapginaWebcomooponajaneladeativao,entoativarumalinhairexibirapginawebcujoURL
emumadascolunasemumnavegadorweb.Estdadaaopodenavegadorquevocgostariadeusarnestecaso.
Opadrodonavegadorbsicoopousaumnavegadorsimples,quepodeverpginasemHTMLoutextosimplesetemfrenteeparatrs
botesquefuncionamcomoseriadeesperar.Emmuitoscasos,issobomparaavisualizaodepginasHTML,eestdisponvel
independentementedosistemaquevocestexecutandoTOPCATdiante.Parecequeeste:

BrowserHTMLbsico
http://127.0.0.1:2525/doc/sun253/sun253.html

165/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Emalgumascircunstncias,possvelutilizaroseunavegadornormalparaexibiodapginawebemseulugar.Alistadosnavegadores
atualmenteincluiFirefox,MozillaeNetscape,bemcomoobsico.Selecionandoestesgeralmentesfuncionase(1)onavegadorquevoc
selecionarestinstaladoeemseucaminho,(2)vocestemalgumsistemaoperacionalUnixlike,(3)obrowserjestiversendoexecutado
quandoaaoinvocado.Nestecaso,aURLselecionadadeveserexibidoemumajaneladonavegadorexistenteemvezdeabrirumanova.
Fazendodessaforma,temavantagemdequeoseunavegadorpodeprovavelmenteexibirvriostiposdedocumento(talvezusandoplugins),
bemcomoHTML.

A.10.3SAMPJanela
AJanelaSAMPexibeostatusdemensagensSAMPepermitealgumcontrolesobresuaconfigurao.SAMPumprotocolodemensagens
quepermiteTOPCATparatrocarinformaescomoutrosaplicativosdedesktopverSeo9paramaisdetalhes.
AparteprincipaldajanelaumpainelcomabasqueexibeostatusdaconexodeSAMPemdetalhe.
AprimeiraabarotuladoClientes:

GuiaClientesJanelaSAMP
Issoexibedetalhesdetodasasaplicaes(incluindoaprpriaTOPCAT)queestoatualmenteregistradoscomohub.Sevocselecionarum
clientenalistanoladoesquerdodopainel,vocverosseusdetalhessobreoladodireito.IstoincluisuaMetadados(quepodemincluircoisas
comoseunome,autor,documentaoURLetc)esuasassinaturas,quedescrevequaistiposdemensagens(MTypes)elevairesponder.
Tambmnalistaesquerdaparacadaaplicaoumaindicaogrficademensagensrecebidasrecentementepor/enviadasapartirdele,em
queTOPCATooutroparceiro.Estessorepresentadosporpequenassetasantes/depoisdopequenocrculoseguindoonomedoaplicativo.
Nafigura,umamensagemestemandamentoapartirdeTOPCATdeAladin.Maisdetalhessobreissomostradonasoutrasguias.
Asoutrasduasguiassorotuladosmensagensrecebidasemensagensenviadas.Elesparecemmuitosemelhantesentresi:

http://127.0.0.1:2525/doc/sun253/sun253.html

166/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JanelaSAMPEnviadoguiaMensagens
ElesexibemdetalhesdemensagensSAMPrecentementeenviadasourecebidasporTOPCAT.Umamesapertodotopocontmumalinhapara
cadamensagem.Mostradoemdiferentescolunassodamensagemmtype(quedescreveasemnticadamensagem),orecebimentoapplication
/envilode/paraTOPCAT,eumresumodeseustatus.Sevocclicarsobrealinha,todososdetalhesdamensagem,incluindooseu
contedoequearespostasetiversidorecebido,sovisveisnopainelinferior.Asmensagenspermanecemnestatabelaparaalgunssegundos
depoisdeteremconcludo,mas,eventualmente,soremovidosparaevitaradesordem.
Obotodabarradeferramentasaseguirestdisponvel:
Ligar/Desligar
EstebotocontrolaaconexocomohubSAMPsemumaconexosemcommmunicationSAMPpodeterlugar.Seumhubest
funcionando,clicarnestebotoalternaseTOPCATestligadoouno.
Senenhumhubestfuncionando,clicarnestebotoirabrirumacaixadedilogoquepermitequevoccomeceaumhub.Estdadaa
opoparainiciarouuminternoouumexternohub.UminternoexecutadonomesmoJavaVirtualMachinecomoaprpria
TOPCAT,eumexternoexecutadoemumprocessoseparado.Aprincipaldiferenaimportantequeumcubointernoserdesligado
quandoTOPCATfaz,enquantoumhubexternovaicontinuarcorrendoatqueelesejadesligadodeformaexplcita.Seumhubexterno
iniciado,umajanelaquemostraoseustatusexibidonatelafecharestajanela(quenopertenceaTOPCAT)irdesligarohub.
Maisfacilidadespodemserintroduzidosparaestajanelaemversesfuturas.

A.10.4AjudaJanela

http://127.0.0.1:2525/doc/sun253/sun253.html

167/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JaneladeAjuda
AjaneladeajudaumnavegadorparaexibirajudainformaessobreTOPCATpodeserobtidoclicandonoAjuda(

boto)queaparece

nabarradeferramentasdamaioriadasjanelas.Elavotextocontidonopresentedocumento,porissopodeseroquevocestolhandoagora.
Opaineldoladodireitomostraaseoselecionadadeajudaprpriotexto.Opaineldoladoesquerdodumpardemaneirasdeselecionareste
pontodevista:
TextSearch
Permitepesquisarporpalavrasnomanual.Digiteumapalavraoupalavrascomotermosdepesquisa,eumalistadeseesquetotalou
parcialmentecorrespondemaostermosdasuapesquisaseroexibidos.Vocpodeclicaremumdelesparalevloparaaseoquefoi
encontrada.
ndiceanaltico
Avisohierrquicadostpicosdeajudadisponveis.Estaatabeladecontedodomanualclicaremumaentradairlevloparaa
seorelevante.
Obarentreosdoispainispodemserarrastadoscomomouseparaafetarostamanhosrelativosdessasjanelas.
Abarradeferramentascontmessesbotesextras:
Devolta
Moveparatrsatravsdalistadetemasnaordemquevocolhouparaeles.
Paraafrente
Avanaalistadetemasnaordemquevocolhouparaeles.
Impresso
Abreumdilogoparapermitiraimpressodapginaatualemumarquivoouimpressora(masvejaabaixo).
ConfiguraodaPgina
Abreumdilogoparafazeraconfiguraodaimpressora.
ParaNavegador
ExibeapginadaAjudaatualmenteexibidonoseubrowserWWWnormal.
Emboraosbotesdeimpressofunciona,sevocpretendeimprimirtodoestedocumento,emvezdeapenasalgumasseesquevocpodeser
melhorforadeimprimiraversoemPDF,ouimprimiraversoemHTMLdeumanicapginaatravsdeumnavegadorweb.Aversomais
recentedestesdeveestardisponvelnawebemhttp://www.starlink.ac.uk/topcat/sun253/sun253.htmle
http://www.starlink.ac.uk/topcat/sun253.pdfvoctambmpodeencontraraversoHTMLnoarquivojartopcatem
uk/ac/starlink/topcat/help/sun253.htmlou,sevoctiverumainstalaocompletaTOPCAT,em
docs/topcat/sun253/sun253.htmledocs / topcat / sun253.pdf(aversoHTMLdeumanicapginaestdisponvelaquinaverso
HTML).
OnavegadordeajudaumnavegadorHTMLealgunsdoshiperlinksnopostodeajudadocumentoparalocaisforadoprpriodocumentode
ajuda.Aseleodessasligaesvaiparaosdocumentosexternos.Quandooespectadorestexibindoumdocumentoexterno,aURLser
exibidaemumalinhanaparteinferiordajanela.Vocpodecortarecolarapartirdesteutilizandomecanismoshabituaisdesuaplataformapara
isso.
http://127.0.0.1:2525/doc/sun253/sun253.html

168/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

A.10.5novajanelaParameter

NovajaneladedilogoParameter
AjanelaNovoparmetropermitequevocinsiraumnovoparmetrodetabelaaseradicionadoaumatabela.Elepodeserobtidoclicandono
Novoparmetro(
boto)noApndiceA.3.2.Umparmetrosimplesmenteumvalorfixoanexadoaumatabelaepodeconter
informaesqueumastring,umescalar,umamatriz...naverdadeexatamenteosmesmostiposdevaloresquepodemapareceremclulasda
tabela.
Ajanelabastantesimplesdeusar:preenchaoscamposecliqueemOKparacompletaraadio.OTipodeseletorpermitequevoc
selecioneotipodevalorquevoctemdeentrada.OnicocampoobrigatrioNomedoparmetroqualquerumdosoutrospodeser
deixadoembranco,emboranormalmentevocvaiquererpreencherpelomenosoValordecampotambm.Muitasvezes,oparmetroterum
valordestring,casoemqueoUnidadesdecamponomuitorelevante.

A.10.6JanelaColunasinttico

JaneladedilogoColunasinttico
AJanelaColunasintticopermitequevocdefinaumanovacoluna"sinttico",queumcujosvaloressodefinidosusandoumaexpresso
algbricacombasenosvaloresdasoutrascolunasnamesmalinha.Aideiaqueovalordasclulasemumalinhadeterminadanestacoluna
sercalculadosobreaprocuracomoumafunodosvaloresdasclulasdeoutrascolunasnalinha.Vocpodepensarnissocomofornecendo
funcionalidadesemelhanteaodeumaplanilhaorientadaacoluna.VocpodeativarodilogousandooAddColumn( )ouSubstituir
Coluna(

)botesnajanelaColumnsouapartirdomenupopup(cliquecomobotodireito)najaneladedados.

Ajanelacompostadeumnmerodecamposquevocdevepreencherparadefiniranovacoluna:
Nome
Onomedanovacoluna.Estadeveser,depreferncianica(diferentedetodososoutrosnomesdecoluna).Sermaisfcildeusloem
expressesalgbricassetambm:
Diferentedeoutrascolunas,mesmofora/inferioresdistinesmaisculas
Sobaformadeumidentificadordejava(comeacomumaletra,continuacomcaracteresalfanumricos,incluindosublinhado)
Nomuitotempo
http://127.0.0.1:2525/doc/sun253/sun253.html

169/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Expresso
Estaaexpressoalgbricaquedefineosvaloresqueasclulasdanovacolunadatabelater.Asregrasparaescreverexpresses
algbricassodescritasnaSeo7edocumentaodetalhadadasfunesquevocpodeusarpodeservistonajanelaFunes
disponveis,quevocpodeverclicandonosMostrarFunes(
boto)nabarradeferramentas.
Unidades
Asunidadesdacoluna.Seaquantidadequeelerepresentaadimensionalouvocnosabeasunidades,issopodeserdeixadoem
branco.Seriaumaboaidiausarumformatosemelhanteparaasunidadesparaqueutilizadoparaascolunasexistentesnatabela.
Descrio
Umadescriotextualaqumdoqueosvalorescontidosnestacolunaso.Podeserdeixadoembranco.
UCD
UmdescritordecontedounificadoparaacolunaumUCDumrtulosemnticoligadascoluna,indicandoquetipodequantidade
quecontm,escolhendoumaopodeumalistadefinidapelosCDS.AlistadeconhecidosUCDsestdisponvelatravsdeumacaixa
deseleo,ouvocpodedigitarumUCDmo.Vocpodedeixarestecampoembranco,seoquevocnodesejaatribuirumUCD
coluna.UmabrevedescriodaUCDselecionadovisvelabaixodacaixadeseleoemsi.
ndice
Determinaaposionatabelaapresentadaemqueanovacolunaaparecerinicialmente.
Destes,oExpressiononicoquedeveserpreenchidos
Depoisdepreencheroformulriocomasuasatisfao,bateuoOKbotonaparteinferioreanovacolunaseradicionadatabela.Sevoc
tiverfeitoalgumenganonopreenchimentodoscampos,umajanelapopuplhedarumamensagemdescrevendooproblema.Estamensagem
podeserumpoucomisteriosotentenoentrarempnicoevejasevocpodereformularaexpressodeumaformaqueoanalisadorpodeser
felizcomele.Sevocnoconseguirsolucionaroproblema,horadeconsultaroseuprogramadorJavaamigvellocal(nasuafalta,asua
amigvelprogramadorClocalpodesercapazdeajudar),ou,portodososmeios,emcontatocomoautor.
Sevocquiseradicionarmaisitensdemetadados,vocpodeeditarasclulasapropriadasnajanelaColunas.Vocpodeeditaraexpressode
umacolunasintticoexistentenomesmocaminho.
Umavezcriada,umacolunasintticaadicionadotabelaaparenteesecomportacomoqualqueroutroelepodesermovido,oculto/
revelado,utilizadonasexpressesparaoutrascolunassintticoseassimpordiante.Seatabelaforsalvaanovacolunaeseucontedoser
escritoparaanovatabeladesada.

JanelaA.10.7SkyCoordenadas

JanelaSkyCoordenadas
AJaneladoCuCoordenadaspermiteadicionarnovascolunasaumatabela,querepresentaascoordenadasemumcuescolhidosistemade
coordenadas.Atabelajdevecontercolunasquerepresentamascoordenadasdocudescrevendoossistemasdoexistenteedasnovas
coordenadas,vocforneceinformaessuficientesparacalcularosvaloresdasnovascolunas.VocpodeativarestedilogousandooNew
SkyCoordenarColunas( boto)najanelaColunas.
Ajaneladedilogotemduasmetadesesquerdavocdascolunasexistentesquerepresentamcucoordena,oseusistema(ICRS,FK5,
FK4,galctico,supergalacticoueclptica)easunidades(graus,radianosousexagesimais)coordenarqueestodentroNotesequeascolunas
disponveisparaseleodependerdasunidadesselecionadasparagrausouradianosapenascolunasnumricasserselecionvel,enquanto
queparasexagesimal(dms/hms)unidadesapenascolunasstringserselecionvel.direita,vocfazacoordenadadosistemaeunidadesde
seleescomoantes,masinserirosnomesdosnovoscolunasnoscamposdetexto.Emseguida,sapertaroOKbotoeasnovascolunas
seroadicionadasdireitadamesa.

A.10.8AlgbricasubconjuntoJanela

http://127.0.0.1:2525/doc/sun253/sun253.html

170/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JaneladedilogoAlgbricasubconjunto
AjanelaalgbricasubconjuntopermitequevocdefinaumnovosubconjuntoRowqueusaumaexpressoalgbricaparadefinirquaislinhas
estoincludos.Aexpressodeveserumbooleano,ouseja,oseuvalorverdadeirooufalsoparacadalinhadatabela.Vocpodeativareste
dilogousandooAddsubconjunto( boto)naJanelaSubconjuntos.
Ajanelacompostadedoiscamposquedevemserpreenchidosparadefinironovosubconjunto:
NomeSubconjunto
Onomedonovosubconjunto.Estadeveser,depreferncianica(diferentedenomesdesubconjuntosexistentes).Sermaisfcilde
usloemoutrasexpressessetambm:
Diferentedeoutrascolunas,mesmofora/inferioresdistinesmaisculas
Sobaformadeumidentificadordejava(comeacomumaletra,continuacomcaracteresalfanumricos,incluindosublinhado)
Nomuitotempo
Expresso
Estaumaexpressobooleanaquedefineosubconjuntoumafunodosvaloresdequalquercombinaodascolunasapenasas
linhasparaasquaisavaliadacomoverdadeiraseroincludosnosubconjunto.Osvaloresdasoutrascolunasnamesmalinhaso
referenciadosusandoseusnomesouidentificadoresID$,eoutrossubconjuntospodemserreferenciadosusandoseusnomesou
identificadores_ID.AsregrasparaasintaxedeexpressoestodescritosnaSeo7edocumentaodetalhadadasfunesquevoc
podeusarpodeservistonajanelaFunesdisponveis,quevocpodeverclicandonosMostrarFunes( boto)nabarrade
ferramentas.
Depoisdepreencheroformulriocomasuasatisfao,bateuoOKbotonaparteinferioreonovosubconjuntoseradicionadolistaque
podeservistonajanelaSubconjuntosondeelesecomportacomoqualqueroutro.Sevoctiverfeitoalgumenganonopreenchimentodos
campos,umajanelapopuplhedarumamensagemdescrevendooproblema.

A.10.9FunesdisponveisJanela

http://127.0.0.1:2525/doc/sun253/sun253.html

171/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

FunesdisponveisJanela
Estajanelaexibetodasasfunes(mtodosJava),queestodisponveisparausoaoescreverexpressesalgbricas.Issoincluitantoas
expressesinternasequaisquerqueridosestendidasquevocpodeteradicionado.VocpodeencontraressajanelausandoosMostrar
Funes(
boto)naColunasintticoouAlgbricasubconjuntobarrasdeferramentasdajanela.
Noladoesquerdodajanelaumarepresentaodervoredasfunesquevocpodeusar.Cadaitemdestarvoreumdosseguintes
procedimentos:
Dobrador
Umgrupodeaulas.Hapenasumdeles,marcadocom"funesdeativao",equecontmfunesquesestodisponveisparauso
emaesdeativao.Aodefinirumanovacolunassintticosousubconjuntosalgbricoselesnosousados.
Classe
Umconjuntodefunese/ouconstantesnoimportaqualclasseumafunoquandovocuslo,masdesdequeasfunesemuma
classesogeralmenterelacionadasissotornamaisfcilparaencontraroquevocestprocurandonestajanela.
Funo
Umafunoquevocpodeusaremumaexpresso.
Constante
Umvalorconstantequevocpodeconsultarpelonomeemumaexpresso(desdequenocolidircomumnomedacoluna).
Destes,ositensdepastaedeclassetmum'pega'( ),oquesignificaqueelescontmoutrositens(classesefunes/constantes,
respectivamente).Aoclicarsobreaala(ouequivalentementeumduplocliquesobreonome),vocpodedefinirseoitemaberto(paraque
vocpossaverseucontedo)oufechada(paraquevocnopode).Ento,paraverasfunesemumaclasse,cliqueemsuaalaeser
revelado.
Vocpodeclicaremqualquerumdessesitenseinformaessobreeleiraparecernopaineldoladodireito.Nocasodefunesestedescreve
afuno,osseusargumentos,oquefaz,ecomouslo.Asexplicaesdevemserbastanteautoexplicativaporexemplo,adescriodafigura
acimaindicaquevocpoderiausarosinvocaoskyDistanceDegrees (RA1, DEC1, RA2, DEC2)comoaexpressodeumanovacoluna
databelaquedadistnciaangularentreduasposiescurepresentadosporcolunascomosnomesRA1,DEC1eRA2,DEC2.Exemplos
deumnmerodestasfunessodadasnaSeco7.8.
Hduasaesdemenu/barradeferramentas:
SintaxeAjuda
Exibeaseodomanualquediscuteasintaxegeralusadaparaexpressesalgbricas,incluindooqueestodisponveisoperadores,
quaissoasregrasparasereferiracolunas,etcAajudaexibidonajaneladeajuda(edelpodemserpassados
paraumnavegadorse

quemaisconveniente).OmaterialexibidosimplesmenteumatalhoparaaSeo7destedocumento.
Adicionarclasse
Permiteadicionaronomedeumaclasseparaaquelesdisponveis.Vocdevedigitaronomedaclassetotalmentequalificado(ouseja,
incluindoocaminhodopacoteseparadoporponto).Aclassequevocespecificardeveestarnocaminhodeclassequeeraatualquando
TOPCATfoiiniciada,conformeexplicadonaSeo10.2.1.Note,porm,queseriamaisusualparaespecificarestesusandoa
propriedadedosistemajel.classesoujel.classes.activationnainicializao,comodescritonaSeo7.9.
ClassesadicionadoouusandooAddClassaoacimaouosjel.classesoujel.classes.activationsistemapropriedadesservisvel
narvorenestajanela,maselespodemnoteradocumentaoadequada(clicandosobreelesnopodemrevelarumadescrionopaineldo
ladodireito).

A.10.10LogJanela

http://127.0.0.1:2525/doc/sun253/sun253.html

172/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JaneladeRegistro
AjaneladelogpodeserobtidausandooViewLogoponoarquivodemenudajaneladecontrole.
Estajanelaexibeasmensagensdelogqueopedidotenhagerados.Dependendoseo-verbosesinalizadorfoiespecificado,algumasoutodas
essasmensagenspodemtersidoescritosparaoconsole,bemcomo(sehouverumconsoleissodependedecomovocterinvocado
TOPCAT).Emalgumascircunstncias,asmensagenscaminhodevoltanalistanopodeserexibida.
ParalimparaexibiodetodasasmensagensexistentesvocpodeusaroClearLogboto(

).

AsmensagensexibidasaquisoaquelesescritospormeiodeJavasistemaderegistroemgeral,elessodestinadosparafinsdedepuraoe
noparaosusuriosaler,massealgoinesperadoestacontecendo,ousevocestaapresentaodeumrelatriodeerro,podefornecer
algumaspistassobreoqueacontecendo.Emboraeletentanoperturbardemaisascoisas,amanipulaodainfraestruturadelogdo
TOPCATafetaaformacomoeleestconfigurado,entosevoctiverpersonalizadoasuaconfiguraoderegistrousando,porexemplo,o
java.util.logging.config. *propriedadesdosistema,vocpodedescobrirqueelenoestsecomportandoexatamentecomovoc
esperava.Desculpe.

FunesBalgbricas
Esteapndicelistaasfunesquepodemserusadasemexpressesalgbricas(verseo7).Elesestolistadosemduassees:aprimeira
forneceasfunesdisponveisparausoemqualquerlugarumaexpressopodeserusada,easegundadaquelesapenasparausonadefinio
personalizadaAesdeAtivao.
Observeque,emboratodasasfunesdisponveisestolistadosaquicomumabrevedescrio,aexplicaocompleta,incluindodescriesde
parmetroseexemplos,sestdisponvelapartirdaJaneladeFunesdisponveis,obtidosutilizandoo
botodabarradeferramentas.

FunesB.1Gerais
AsseguintesfunespodemserutilizadasemqualquerlugarquevocpodeescreverumaexpressoalgbricaemTOPCAT.Eles
normalmenteserutilizadoparaadefiniodenovascolunassintticosousubconjuntosdelinhasalgebricamentedefinidos.Adocumentao
maiscompletadelasestdisponvelapartirdedentroTOPCATnajanelaFunesdisponveis.

TrigDegreesB.1.1
Funestrigonomtricaspadrocomngulosemgraus.
sinDeg(teta)
Sinedeumngulo.
cosDeg(teta)
Cossenodeumngulo.
Tandeg(teta)
Tangentedeumngulo.
asinDeg(x)
SineArc.Oresultado,nointervalode90a90.
acosDeg(x)
http://127.0.0.1:2525/doc/sun253/sun253.html

173/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

CossenoArc.Oresultado,nointervalode0,0a180.
atanDeg(x)
TangenteArc.Oresultado,nointervalode90a90.
atan2Deg(y,x)
Convertecoordenadasrectangulares(x,y)parapolar(r,theta).Estemtodocalculaafasethetacomputandoumarcotangentede
y / xnafaixade180a180.

B.1.2Tempos
Funesparaconversodevaloresdetempoentrevriasformas.Asformasutilizadassejam
ModificadoJulianDate(MJD)
Amedidacontnuaemdiasdesdeameianoite,noinciode17deNovembrode1858.BaseadonoUTC.
ISO8601
UmarepresentaodestringdaformaAAAA-MM-ddThh: mm: ss.s,ondeoTumcaractereliteral(umcaracteredeespaopodeser
usadoemseulugar).CombasenoUTC.
JulianEpoch
AmedidacontnuacombaseemumanoJuliandeexatamente365,25dias.Parafinsdeaproximadosesteseassemelhaaonmero
fracionriodeanosADrepresentadapeladata.svezes(masnoaqui),representadoporumprefixo'J'J2000.0definidocomo2000
Janeiro1.5naescaladetempoTT.
BesselianEpoch
Amedidacontnuacombaseemumanotropicaldecercade365.2422dias.Parafinsdeaproximadosesteseassemelhaaonmero
fracionriodeanosADrepresentadapeladata.svezes(masnoaqui),representadoporumprefixo'B'.
DecimalAno
NmerofracionriodeanosADrepresentadapeladata.2000,0,ou1999.99recurringequivalentemente,meianoite,noincioda
primeiradeJaneirode2000.Devidoanosbissextos,otamanhodeumaunidadedependequeanopol
Portantomeiodiade25deoutubrode2004de2004-10-25T12: 00:00noformatoISO8601,comoumvalorde53.303,5MJD,
2004,81588comoEpochJuliane2004,81726comoBesselianEpoch.
Atualmenteestaimplementaonopodeserinvocadaparamelhordoqueummilsimodesegundo.
isoToMjd(ISODate)
ConverteumaseqnciadedataISO8601paraModifiedJulianDate.OformatobsicodoISODateargumentoaaaa-mm-ddThh: mm:
ss.s,pormsopermitidosalgunsdesviosdessaforma:
A'T'queseparadatadetempopodemsersubstitudosporumespao
Ossegundos,minutose/ouhoraspodemseromitidos
Apartedecimaldossegundospodeserdequalquercomprimento,eopcional
A'Z'(queindicaUTC)podeseranexadoaomomento
Algunsexemplosso,porconseguinte,legais:"1994-1912-21T14: 18:23.2","1968/01/14",e"2112/05/25 16:45 Z".
dateToMjd(ano,ms,dia,hora,minuto,segundo)
ConverteumadataehoracalendrioparaModifiedJulianDate.
dateToMjd(ano,ms,dia)
ConverteumadatadocalendrioparaModifiedJulianDate.
decYearToMjd(decYear)
ConverteumAnoDecimalaumModifiedJulianDate.
mjdToIso(MJD)
ConverteumvalorJulianDatademodificaoparaum8601stringformatodedataehoraISO.Oformatodesadaaaaa-mm-ddThh:
mm: ss.
mjdToDate(MJD)
ConverteumvalorJulianDatademodificaoparaumadata8601stringformatoISO.Oformatodesadaaaaa-mm-dd.
mjdToTime(MJD)
ConverteumvalorJulianDatademodificaoaumstempo8601stringformatoISO.Oformatodesadahh: mm: ss.
mjdToDecYear(MJD)
ConverteumJulianDatademodificaoparaDecimalYear.
formatMjd(MJD,formato)
ConverteumvalorJulianDatademodificaoparaumadatausandoumformatodedatapersonalizvel.Oformatodefinidocomopelo
java.text.SimpleDateFormatclasse.Asadapadrocorrespondestring"AAAA-MM-dd'T'HH: mm: ss"
mjdToJulian(MJD)
ConverteumJulianDatademodificaoparaJulianEpoch.Paraefeitosaproximados,oresultadodestarotinaconsistedeumaparte
integral,quedaADanoeumapartefraccionada,querepresentaadistnciaatravsdesseano,demodoaque,porexemplo,de
aproximadamente12000.5Julhode2000.
julianToMjd(julianEpoch)
ConverteumEpochJulianparaModifiedJulianDate.Parafinsaproximados,oargumentodestarotinaconsisteemumaparteintegral
quedaADanoeumapartefracionriaquerepresentaadistnciapormeiodaqueleano,demodoque,porexemplo,2000.5de
aproximadamente1Julhode2000.
mjdToBesselian(MJD)
ConverteModifiedJulianDateparaBesselianEpoch.Paraefeitosaproximados,oresultadodestarotinaconsistedeumaparteintegral,
quedaADanoeumapartefraccionada,querepresentaadistnciaatravsdesseano,demodoaque,porexemplo,de
aproximadamente11950,5julhode1950.
besselianToMjd(besselianEpoch)
ConverteBesselianEpochparaModifiedJulianDate.Parafinsaproximados,oargumentodestarotinaconsisteemumaparteintegral
http://127.0.0.1:2525/doc/sun253/sun253.html

174/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

quedaADanoeumapartefracionriaquerepresentaadistnciapormeiodaqueleano,demodoque,porexemplo,de
aproximadamente11.950,5julhode1950.
unixMillisToMjd(unixMillis)
ConvertedemilissegundosdesdeapocaUnix(19700101T00:00:00)paraumvalordedataJulianmodificado
mjdToUnixMillis(MJD)
ConvertededatadocalendriojulianomodificadoparamilissegundosdesdeapocaUnix(19700101T00:00:00).

B.1.3Matemtica
Funesmatemticasetrigonomtricaspadro.Funestrigonomtricastrabalharcomngulosemradianos.
sin(theta)
Sinedeumngulo.
cos(teta)
Cossenodeumngulo.
tan(teta)
Tangentedeumngulo.
asin(x)
Arcosenodeumngulo.Oresultado,nointervalodepi/2atravsdepi/2.
acos(x)
Arcocosenodeumngulo.Oresultado,nointervalode0,0api.
atan(x)
Arcotangentedeumngulo.Oresultado,nointervalodepi/2atravsdepi/2.
exp(x)
Eulernmeroeelevadoaumapotncia.
log10(x)
Logaritmodebase10.
ln(x)
Logaritmonatural.
sqrt(x)
Raizquadrada.Oresultadocorrectamentearredondadaepositivo.
hypot(x,y)
Retornaaraizquadradadasomadosquadradosdosseusdoisargumentos.Fazlocomoestapodemevitarestourointermedirioou
underflow.
atan2(y,x)
Convertecoordenadasrectangulares(x,y)parapolar(r,theta).Estemtodocalculaafasethetacomputandoumarcotangentede
y / xnafaixadepiapi.
pow(a,b)
Exponenciao.Oresultadoovalordoprimeiroargumentoelevadopotnciadosegundoargumento.
sinh(x)
Senohiperblico.
cosh(x)
Cossenohiperblico.
tanh(x)
Tangentehiperblica.
asinh(x)
Senohiperblicoinverso.
acosh(x)
Cossenohiperblicoinverso.
atanh(x)
Tangentehiperblicainversa.
E
NmerodeEulere,abasedoslogaritmosnaturais.
PI
Pi,aproporoentreacircunfernciadeumcrculocomoseudimetro.
Infinito
Valordepontoflutuanteinfinitopositivo.
NaN
NotaNumbervalordepontoflutuante.UsecomcuidadooperaesaritmticaselgicassecomportardeformaestranhapertodeNaN
(porexemplo,NaN! = NaN).Paraamaioriadosfins,istoequivalenteaovalorembranco.
RANDOM
Avaliacomoumnmeroaleatrionointervalode0<=x<1.Istodiferenteparacadacluladatabela.Aqualidadedaaleatoriedade
podenoserparticularmenteboa.

ConversesB.1.4
Funesparaconverterentrestringsevaloresnumricos.
toString(fpVal)
Transformaumvalornumricoemumastring.
toString(intVal)
Transformaumvalornumricointeiroemumastring.
toString(CHARVAL)
Transformaumvalornicocaractereemumstring.

http://127.0.0.1:2525/doc/sun253/sun253.html

175/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

toString(byteVal)
Transformaumvalordebytesemumastring.
toString(booleanVal)
Transformaumvalorbooleanoemumastring.
toString(objVal)
Transformaqualquerobjetodevaloremumastring.Quandoaplicadoaosvaloresdecordasexistentesissonorealmentetil,masisso
significaquevocpodeaplicartoStringdequalquerobjetodevalorsemconheceroseutipoeobterumretornotildele.
parseByte(str)
Astentativasdeinterpretarumastringcomoumbyte(8bitsassinadointeiro)valor.Seacadeiadeentradanopodeserinterpretadadesta
forma,umvalorembrancoirresultar.
parseShort(str)
Astentativasdeinterpretarumastringcomoumvalorcurto(16bitassinadointeiro).Seacadeiadeentradanopodeserinterpretada
destaforma,umvalorembrancoirresultar.
parseInt(str)
Astentativasdeinterpretarumastringcomoumint(32bitsassinadointeiro)valor.Seacadeiadeentradanopodeserinterpretadadesta
forma,umvalorembrancoirresultar.
parseLong(str)
Astentativasdeinterpretarumastringcomoumvalorlongo(64bitassinadointeiro).Seacadeiadeentradanopodeserinterpretada
destaforma,umvalorembrancoirresultar.
parseFloat(str)
Astentativasdeinterpretarumastringcomoumvalor(32bitpontoflutuante)flutuador.Seacadeiadeentradanopodeserinterpretada
destaforma,umvalorembrancoirresultar.
parseDouble(str)
Astentativasdeinterpretarumastringcomoumvalorduplo(inteiroassinadode64bit).Seacadeiadeentradanopodeserinterpretada
destaforma,umvalorembrancoirresultar.
ToByte(valor)
Tentaconverteroargumentonumricoparaumbyte(8bitsassinadointeiro)resultado.Seeleestforadealcance,umvalorembranco
irresultar.
toShort(valor)
Tentaconverteroargumentonumricoparaumcurtoespaoderesultado(inteiroassinadode16bit).Seeleestforadealcance,um
valorembrancoirresultar.
ToInteger(valor)
Tentaconverteroargumentonumricoparaum(32bitinteiroassinado)intresultado.Seeleestforadealcance,umvalorembrancoir
resultar.
Tolong(valor)
Tentaconverteroargumentonumricoparaumlongo(64bitassinadointeiro)resultado.Seeleestforadealcance,umvalorembranco
irresultar.
toFloat(valor)
Tentaconverteroargumentonumricoparaumfloat(32bitpontoflutuante)resultado.Seeleestforadealcance,umvalorembranco
irresultar.
toDouble(valor)
Converteoargumentonumricoparaumduplo(64bitinteiroassinado)resultado.
toHex(valor)
Converteoargumentointeirodeformahexadecimal.
FromHex(hexVal)
Converteumastringrepresentandoumnmerohexadecimalemseuvalorinteiro.

B.1.5Formatos
Funesparaformatarvaloresnumricos.
formatDecimal(valor,dp)
Transformaumvalordepontoflutuanteemumastringcomumdeterminadonmerodecasasdecimaisusandoasconfiguraespadro.
formatDecimalLocal(valor,dp)
Transformaumvalordepontoflutuanteemumastringusandoconfiguraesdelocalatual.Porexemplo,sealinguagemdefinida
comofrancs,pontosdecimaisserrepresentadocomoumavrgula","emvezdeumpontofinal".".Casocontrrio,secomportao
mesmoqueocorrespondenteformatDecimalfuno.
formatDecimal(valor,formato)
Transformaumvalordepontoflutuanteemumacadeiadecaracteresformatadausandoasconfiguraespadro.Oformatostring
comodefinidopeloJavajava.text.DecimalFormatclasse.
formatDecimalLocal(valor,formato)
Transformaumvalordepontoflutuanteemumastringformatadausandoconfiguraesdelocalatual.Porexemplo,sealinguagem
definidacomofrancs,pontosdecimaisserrepresentadocomoumavrgula","emvezdeumpontofinal".".Casocontrrio,se
comportaomesmoqueocorrespondenteformatDecimalfuno.

B.1.6Aritmtica
Funesaritmticaspadro,incluindocoisascomoarredondamento,assinarmanipulaoefunesmximas/mnimas.
Roundup(x)
Arredondaumvaloratumvalorinteiro.Formalmente,retornaomenor(maisprximoaoinfinitonegativo)valorinteiroqueno
menordoqueoargumento.
ROUNDDOWN(x)
Arredondaumvalorbaixoparaumvalorinteiro.Formalmente,devolveomaior(maisprximodeinfinitopositivo)valorinteiroqueno

http://127.0.0.1:2525/doc/sun253/sun253.html

176/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

maiordoqueoargumento.
round(x)
Arredondaumvalorparaonmerointeiromaisprximo.Formalmente,retornaonmerointeiromaisprximoemtermosdevalorpara
oargumento.Sedoisinteirossoigualmenteperto,oresultadoomesmoum.
roundDecimal(x,dp)
Arredondaumvalorparaumdeterminadonmerodecasasdecimais.Oresultadoumflutuador(32bitvalordepontoflutuante),de
modoqueestesadequadoparavaloresrelativamentebaixosdepreciso.destinadoparatruncaronmerodefigurasaparentemente
significativosrepresentadosporumvalorquevocsabetenhasidoobtidoatravsdacombinaodeoutrosvaloresdeprecisolimitada.
Paramais,verasfunesnaFormatosclasse.
abs(x)
Retornaovalorabsolutodeumvalorinteiro.Seoargumentonofornegativo,oargumentoretornado.Seoargumentofornegativo,a
negaodoargumentoretornado.
abs(x)
Retornaovalorabsolutodeumvalordepontoflutuante.Seoargumentonofornegativo,oargumentoretornado.Seoargumentofor
negativo,anegaodoargumentoretornado.
max(a,b)
Retornaomaiordedoisvaloresinteiros.Seosargumentostmomesmovalor,oresultadoqueomesmovalor.
max(a,b)
Retornaomaiordedoisvaloresdepontoflutuante.Seosargumentostmomesmovalor,oresultadoqueomesmovalor.Seovalor
estiverembranco,oresultadoestembranco.
maxReal(a,b)
Retornaomaiordedoisvaloresdepontoflutuante,ignorandoespaosembranco.Seosargumentostmomesmovalor,oresultado
queomesmovalor.Seumargumentoembranco,oresultadoooutro.Seambososargumentossoembranco,oresultadoestem
branco.
min(a,b)
Retornaomenordosdoisvaloresinteiros.Seosargumentostmomesmovalor,oresultadoqueomesmovalor.
min(a,b)
Retornaomenordosdoisvaloresdepontoflutuante.Seosargumentostmomesmovalor,oresultadoqueomesmovalor.Seovalor
estiverembranco,oresultadoestembranco.
Minreal(a,b)
Retornaomenordosdoisvaloresdepontoflutuante,ignorandoespaosembranco.Seosargumentostmomesmovalor,oresultado
queomesmovalor.Seumargumentoembranco,oresultadoooutro.Seambososargumentossoembranco,oresultadoestem
branco.

B.1.7CoordsRadians
Funesparatransformaesnguloemanipulaes,combaseemradianosemvezdegraus.Emparticular,osmtodosdetraduoentre
radianosehh:mm:ss,souDDD:MM:representaessexagesimaistiposs.ssofornecidos.
radiansToDms(rad)
Converteumnguloemradianosparaumgrausformatados:minutos:segundosstring.Nenhumapartefracionriadocampodesegundos
dado.
radiansToDms(rad,secFig)
Converteumnguloemradianosparaumgrausformatados:minutos:segundosstringcomumdeterminadonmerodecasasdecimaisdo
campodesegundos.
radiansToHms(rad)
Converteumnguloemradianosparaumahoraformatados:minutos:segundosstring.Nenhumapartefracionriadocampode
segundosdado.
radiansToHms(rad,secFig)
Converteumnguloemradianosparaumahoraformatados:minutos:segundosstringcomumdeterminadonmerodecasasdecimais
docampodesegundos.
dmsToRadians(DMS)
Converteumgrausformatados:minutos:segundosseqnciadecaracteresparaumnguloemradianos.Delimitadopordoispontos,
espao,personagensdm [s],oualgunsoutros.Sopermitidosespaosadicionaiselder+/.A:segundoparteopcional.
hmsToRadians(HMS)
Converteumahoraformatados:minutos:segundosseqnciadecaracteresparaumnguloemradianos.Delimitadopordoispontos,
espao,personagenshm [s],oualgunsoutros.Sopermitidosespaosadicionaiselder+/.A:segundoparteopcional.
dmsToRadians(graus,minutos,segundos)
Convertegraus,minutosesegundosparaumnguloemradianos.
Emconversesdestetipo,deveseterocuidadodeobterosinalcertonaconversodengulosqueestoentre0e1graus.Estarotina
utilizaobitdesinaldodegargumento,tendoocuidadodedistinguirentre+0e0(suasrepresentaesinternassodiferentespara
valoresdepontoflutuante).ilegalparaosminousegargumentosparasernegativo.
hmsToRadians(hora,minuto,segundo)
Convertehoras,minutos,segundos,paraumnguloemradianos.
Emconversesdestetipo,deveseterocuidadodeobterosinalcertonaconversodengulosqueestoentre0e1horas.Estarotina
utilizaobitdesinaldahoraargumento,tendoocuidadodedistinguirentre+0e0(suasrepresentaesinternassodiferentespara
valoresdepontoflutuante).
skyDistanceRadians(ra1,Dec1,ra2,Dec2)
Calculaaseparao(distnciaemtornodeumgrandecrculo)dedoispontosnocuemradianos.
hoursToRadians(horas)
http://127.0.0.1:2525/doc/sun253/sun253.html

177/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Convertehoraspararadianos.
degreesToRadians(graus)
Convertegrausemradianos.
radiansToDegrees(rad)
Converteradianosemgraus.
raFK4toFK5radians(raFK4,decFK4)
ConverteumaposioFK4B1950.0paraJ2000.0FK5emumapocadeB1950.0rendendoAscensoReta.Issopressupeazero
movimentoprprionoquadroFK5.
decFK4toFK5radians(raFK4,decFK4)
ConverteumaposioFK4B1950.0paraJ2000.0FK5emumapocadeB1950.0rendendodeclinaoIssopressupeazero
movimentoprprionoquadroFK5.
raFK5toFK4radians(raFK5,decFK5)
ConverteumaposioFK5J2000.0paraB1950.0FK4emumapocadeB1950.0rendendodeclinao.Issopressupeazero
movimentoprprio,paralaxeevelocidaderadialnoquadroFK5.
decFK5toFK4radians(raFK5,decFK5)
ConverteumaposioFK5J2000.0paraB1950.0FK4emumapocadeB1950.0rendendodeclinao.Issopressupeazero
movimentoprprio,paralaxeevelocidaderadialnoquadroFK5.
raFK4toFK5Radians(raFK4,decFK4,bepoch)
ConverteumaposioFK4B1950.0paraJ2000.0FK5rendendoAscensoReta.Issopressupeazeromovimentoprprionoquadro
FK5.ObepochparmetroapocaemqueaposionoquadroFK4foideterminada.
decFK4toFK5Radians(raFK4,decFK4,bepoch)
ConverteumaposioFK4B1950.0paraJ2000.0FK5rendendodeclinao.IssopressupeazeromovimentoprprionoquadroFK5.
ObepochparmetroapocaemqueaposionoquadroFK4foideterminada.
raFK5toFK4Radians(raFK5,decFK5,bepoch)
ConverteumaposioFK5J2000.0paraB1950.0FK4rendendodeclinao.Issopressupeazeromovimentoprprio,paralaxee
velocidaderadialnoquadroFK5.
decFK5toFK4Radians(raFK5,decFK5,bepoch)
ConverteumaposioFK5J2000.0paraB1950.0FK4rendendodeclinao.Issopressupeazeromovimentoprprio,paralaxee
velocidaderadialnoquadroFK5.
DEGREE_RADIANS
Otamanhodeumgrauemradianos.
HOUR_RADIANS
Otamanhodeumahoradeascensoretaemradianos.
ARC_MINUTE_RADIANS
Otamanhodeumaarcminuteemradianos.
ARC_SECOND_RADIANS
Otamanhodeumsegundodearcoemradianos.

B.1.8Cobertura
Funesrelacionadascomacoberturaepegadas.UmpadrodecoberturaMultiOrderOsmapasdecobertura,descritasno
http://www.ivoa.net/Documents/MOC/.
inMoc(mocLocation,ra,dec)
IndicaseumadeterminadaposionocuestdentrodeumdeterminadoMOC(MultiOrderCoberturamapa).SeodadomocLocation
valornorepresentaumMOC(porexemplo,noexistearquivoouoarquivonoestnoformatoMOC)umavisoseremitidoa
primeiravezquereferenciado,eoresultadoserfalso.

B.1.9Tilings
FunesazulejosPixelparaaesferaceleste.
htmIndex(nvel,ra,dec)
DondicedepixelsHTM(hierrquicaTriangularMesh)paraumadeterminadaposionocu.
healpixNestIndex(k,ra,dec)
DondicedepixelparaumadeterminadaposionocunoesquemaNESTHEALPix.
healpixRingIndex(k,ra,dec)
DondicedepixelparaumadeterminadaposionocunoesquemaHEALPixANEL.
healpixK(pixelsize)
DoparmetroresoluoHEALPixadequadoparaumdeterminadotamanhodepixel.Estekvalorologaritmodebase2do
parmetroNside.
healpixResolution(k)
DaresoluoaproximadaemgrausparaumdeterminadoparmetroHEALPixresoluokEstekvalorologaritmodebase2do
parmetroNside.
htmLevel(pixelsize)
DaHTMnvelparmetroadequadoparaumdeterminadotamanhodepixel.
htmResolution(nvel)
DaresoluoaproximadaemgrausparaumdeterminadonveldeprofundidadeHTM.

B.1.10Distncias
Funesparaconverterentrediferentesmedidasdedistnciacosmolgica.
http://127.0.0.1:2525/doc/sun253/sun253.html

178/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Osseguintesparmetrossoutilizados:
z:redshift
H0:constantedeHubble,emkm/s/Mpc(valorexemplo~70)
omegaM:arelaodensidadedouniverso(exemplovalor0,3)
omegaLambda:constantecosmolgicaNormalizada(exemplovalor0,7)
Paraumuniversoplano,omegaM+omegaLambda=1
OstermoseasfrmulasutilizadasaquisotomadasapartirdopapelporDWHogg,medidasdedistnciaemcosmologia,astroph/9905116
v4(2000).
MpcToM(distMpc)
Convertedemegaparsecsdemetros.
mToMpc(distM)
Convertedemetrosparamegaparsecs.
zToDist(z)
Funorpidaesujaparaconverterderedshiftdistanciar.
Aviso:estefazalgumassuposiesrazoveis
sobreacosmologiaeretornaadistncialuminosidade.Destinaseapenasparauso

aproximado.Sevocsepreocupacomosdetalhes,useumadasfunesmaisespecficasaqui.
zToAge(z)
Funorpidaesujaparaconverterderedshiftemtempos.
Aviso:estefazalgumassuposiesrazoveis
sobreacosmologia.Destinaseapenasparausoaproximado.Sevocsepreocupacomos

detalhesusarumadasfunesmaisespecficasaqui.
comovingDistanceL(z,H0,omegaM,omegaLambda)
DistnciacomvelLineofsight.
comovingDistanceT(z,H0,omegaM,omegaLambda)
Distnciacomveltransversa.
angularDiameterDistance(z,H0,omegaM,omegaLambda)
Distnciaangulardimetro.
luminosityDistance(z,H0,omegaM,omegaLambda)
DistnciaLuminosidade.
lookbackTime(z,H0,omegaM,omegaLambda)
Lookbacktempo.Issoretornaadiferenaentreaidadedouniversonoperododeobservao(agora)eaidadedouniversonomomento
emqueosftonsderedshiftzforamemitidas.
comovingVolume(z,H0,omegaM,omegaLambda)
VolumedeComoving.Issoretornaovolumetotalcomveltodoocuparaumdadoredshiftz.
SPEED_OF_LIGHT
Velocidadedaluzemm/s.
METRE_PER_PARSEC
Nmerodemetrosdeumparsec.
SEC_PER_YEAR
Nmerodesegundosemumano.

B.1.11Arrays
Asfunesqueexecutamoperaesdeagregaodeclulascomvalordematriz.Asfunesnestaclasse,comoamdia,soma,mximoetc
spodeserusadoemvaloresquejsomatrizes.Namaioriadoscasosissosignificaemvaloresemcolunasdetabelasquesodeclaradas
comovalordearray.FITSemesasVOTablepodetercolunasquecontmvaloresdematriz,masoutrosformatoscomoCSVnopode.
Htambmumconjuntodefunesnomeadasconjuntocomvriosnmerosdeargumentos,quepermitemmontarumvalormatrizapartirde
umalistadenmerosdeescalares.Issopodeserusado,porexemplo,paraobteramdiadeumconjuntodetrsmagnitudesusandouma
expressocomo"mdia (array (jmag, hmag, kmag))".
sum(array)
Retornaasomadetodososelementosnobranconamatriz.Sevariedadenoumamatriznumrica,nuloretornado.
mdia(array)
Retornaamdiadetodososelementosnobranconamatriz.Sevariedadenoumamatriznumrica,nuloretornado.
varincia(array)
Retornaavariaodapopulaodetodososelementosnobranconamatriz.Sevariedadenoumamatriznumrica,nulo
retornado.
desvpad(array)
Retornaodesviopadrodapopulaodetodososelementosnobranconamatriz.Sevariedadenoumamatriznumrica,nulo
retornado.
mnimo(array)
Retornaomenordoselementosnobranconamatriz.Sevariedadenoumamatriznumrica,nuloretornado.
mximo(array)
Retornaomaiordoselementosnobranconamatriz.Sevariedadenoumamatriznumrica,nuloretornado.
mediana(array)
Retornaamedianadoselementosnobranconamatriz.Sevariedadenoumamatriznumrica,nuloretornado.
quantil(array,quant)
http://127.0.0.1:2525/doc/sun253/sun253.html

179/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Retornaumvalordequantildoselementosnobranconamatriz.Quequantildeterminadapelaquantvalorvaloresde0,1e0,5daro
mnimo,medianaemximo,respectivamente.Umvalorde0,99dariaaopercentil99.
tamanho(array)
Retornaonmerodeelementosnamatriz.Sevariedadenoumarray,zeroretornado.
count(array)
Retornaonmerodeelementosnobranconamatriz.Sevariedadenoumarray,zeroretornado.
join(array,marceneiro)
Retornaumastringcompostadeconcatenartodososelementosdeumamatriz,separadasporumacordamarceneiro.Sevariedadeno
umarray,nullretornado.
array(x1)
Retornaumamatriznumricaconstrudaapartirdeumdeterminadoelemento.
matriz(x1,x2)
Retornaumamatriznumricaconstrudoapartirdedeterminadoselementos.
matriz(x1,x2,x3)
Retornaumamatriznumricaconstrudoapartirdedeterminadoselementos.
matriz(x1,x2,x3,x4)
Retornaumamatriznumricaconstrudoapartirdedeterminadoselementos.
matriz(x1,x2,x3,x4,x5)
Retornaumamatriznumricaconstrudoapartirdedeterminadoselementos.
matriz(x1,x2,x3,x4,x5,x6)
Retornaumamatriznumricaconstrudoapartirdedeterminadoselementos.
matriz(x1,x2,x3,x4,x5,x6,x7)
Retornaumamatriznumricaconstrudoapartirdedeterminadoselementos.
matriz(x1,x2,x3,x4,x5,x6,x7,x8)
Retornaumamatriznumricaconstrudoapartirdedeterminadoselementos.

B.1.12Cordas
FunesdemanipulaodeStringedeconsulta.
concat(S1,S2)
Concatenaduasseqncias.Namaioriadoscasos,omesmoefeitopodeserconseguidoporescrevers1 + s2,masosvaloresem
brancosvezespodeaparecercomoastring"nulo"sevocfizerissoassim.
concat(S1,S2,S3)
Concatenatrscordas.Namaioriadoscasos,omesmoefeitopodeserconseguidoporescrevers1 + s2 + s3,masosvaloresem
brancosvezespodeaparecercomoastring"nulo"sevocfizerissoassim.
concat(S1,S2,S3,S4)
Concatenaquatrocordas.Namaioriadoscasos,omesmoefeitopodeserconseguidoporescrevers1 + s2 + s3 + s4,masosvalores
embrancosvezespodeaparecercomoastring"nulo"sevocfizerissoassim.
equals(S1,S2)
Determinaseduasseqnciassoiguais.Notequevocdeveusaressafunoemvezdes1 == s2,quepode(porrazestcnicas)
returnfalsemesmoseascordassoosmesmos.
equalsIgnoreCase(S1,S2)
Determinaseduasseqnciassoiguaisparaalmdepossveisdistinesdecaixa/menorsuperiores.
startsWith(inteiro,incio)
Determinaseumastringcomeacomumadeterminadasubstring.
endsWith(inteiro,final)
Determinaseumastringterminacomumadeterminadasubstring.
contm(inteiro,sub)
Determinaseumaseqnciacontmumdeterminadosubstring.
comprimento(str)
Retornaocomprimentodeumastringemcaracteres.
split(palavras)
Divideumastringemumarraydepalavrasseparadasporespao.Umoumaisespaosseparacadapalavradoprximo.esquerdae
espaosdireitasoignorados.
Oresultadoumamatrizdestrings,esevocquiserusaroselementosindividuaisquevocprecisausaraindexaodecolchetes,com
[0]representaoprimeiroobjeto
split(palavras,regex)
Divideumastringemumarraydepalavrasseparadasporumadeterminadaexpressoregular.
Oresultadoumamatrizdestrings,esevocquiserusaroselementosindividuaisquevocprecisausaraindexaodecolchetes,com
[0]representaoprimeiroobjeto
jogos(str,regex)
Testaseumastringcorrespondeumadeterminadaexpressoregular.
matchGroup(str,regex)
Retornaaprimeiraexpressoagrupadoscombinadosemumacadeiadefinidaporumaexpressoregular.Umaexpressoumagrupadas
entreparnteses.
replaceFirst(str,regex,substituio)
Substituiaprimeiraocorrnciadeumaexpressoregularemumastringcomumvalorsubstringdiferente.
replaceAll(str,regex,substituio)
Substituitodasasocorrnciasdeumaexpressoregularemumastringcomumvalorsubstringdiferente.
http://127.0.0.1:2525/doc/sun253/sun253.html

180/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

substring(str,posioIncio)
Retornaaltimapartedeumadeterminadacadeia.Asubstringcomeacomocaracterenondiceespecificadoeseestendeatofinal
destastring.
substring(str,posioIncio,ndiceFinal)
Retornaumasubstringdeumastringdada.AsubstringcomeacomocaracterenostartIndexecontinuacomopersonagemnondice
endIndex-1Assim,ocomprimentodasubseqnciandiceFinal-startIndex.
toUpperCase(str)
Retornaumaversomaisculadeumastring.
toLowerCase(str)
Retornaumaversomaisculadeumastring.
trim(str)
Aparaespaosembrancoapartirdeambasasextremidadesdeumacorda.
padWithZeros(valor,ndigit)
Tomaumargumentointeiroeretornaumstringquerepresentaomesmovalornumrico,maspreenchidocomzerosesquerdaparaum
perodoespecfico.

B.1.13fundentes
Funesparaconversoentrefluxoevaloresdemagnitude.FunessofornecidosparaaconversoentreofluxoemJanskyseAB
magnitudes.
Algumasconstantesparaconversesaproximadasentreasdiferentesescalasdemagnitudetambmsofornecidos:
ConstantesJOHNSON_AB_ *,paraJohnson<>conversesdemagnitudeAB,deFreieGunn,AstronomicalJournal108,1476(1994),
aTabela2(1994AJ....108.1476F).
ConstantesVEGA_AB_ *,porVega<>ABconversesdemagnitude,deBlantonetal,AstronomicalJournal.129,2562(2005),as
equaes.(5)(2005AJ....129.2562B).
abToJansky(magAB)
ConverteABmagnitudeaofluxodeJansky.
F/Jy=10(23(AB48,6)/2.5)
janskyToAb(fluxJansky)
ConvertefluxoemJanskyaABmagnitude.
AB=2.5*(23log10 (F/Jy))48.6
luminosityToFlux(lumin,dist)
Converteluminosidadeaofluxodadaumadistncialuminosidade.
F=lumin/(4xPixdist2 )
fluxToLuminosity(fluxo,dist)
Convertefluxodeluminosidadedadaumadistncialuminosidade.
lumin=(4xPixdist2 )F
JOHNSON_AB_V
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandaV.VJ~V=AB+JOHNSON_AB_V.
JOHNSON_AB_B
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandaB.BJ~=BAB+JOHNSON_AB_B.
JOHNSON_AB_Bj
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandaBj.BjJ~=BjAB+JOHNSON_AB_Bj.
JOHNSON_AB_R
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandaR.RJ~=RAB+JOHNSON_AB_R.
JOHNSON_AB_I
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandaqueeu.IJ~=IAB+JOHNSON_AB_I.
JOHNSON_AB_g
AproximadodedeslocamentoentreJohnsoneABmagnitudesemgbanda.gJ~=gAB+JOHNSON_AB_g.
JOHNSON_AB_r
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandar.rJ~=rAB+JOHNSON_AB_r.
JOHNSON_AB_i
AproximadodedeslocamentoentreJohnsoneABmagnitudesemibanda.iJ~=iAB+JOHNSON_AB_i.
JOHNSON_AB_Rc
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandaRc.RcJ~=RcAB+JOHNSON_AB_Rc.
JOHNSON_AB_Ic
AproximadodedeslocamentoentreJohnsoneABmagnitudesnabandaIc.IcJ~=IcAB+JOHNSON_AB_Ic.
JOHNSON_AB_uPrime
DiferenaentreJohnsoneABmagnitudesemu'band(zero).u'J=u'AB+JOHNSON_AB_uPrime=u'AB.
JOHNSON_AB_gPrime
http://127.0.0.1:2525/doc/sun253/sun253.html

181/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

DiferenaentreJohnsoneABmagnitudesemg'band(zero).g'J=g'AB+JOHNSON_AB_gPrime=g'AB.
JOHNSON_AB_rPrime
DiferenaentreJohnsoneABmagnitudesemr'band(zero).r'J=r'AB+JOHNSON_AB_rPrime=rAB.
JOHNSON_AB_iPrime
DiferenaentreJohnsoneABmagnitudesemi'band(zero).i'J=i'AB+JOHNSON_AB_iPrime=i'AB.
JOHNSON_AB_zPrime
DiferenaentreJohnsonemagnitudesABem'zbanda(zero).z'J=z'AB+JOHNSON_AB_zPrime=z'AB.
VEGA_AB_J
AproximadodedeslocamentoentreVega(comono2MASS)emagnitudesABnabandaJ.JVega~=JAB+VEGA_AB_J.
VEGA_AB_H
AproximadodedeslocamentoentreVega(comono2MASS)emagnitudesABembandaH.HVega~=HAB+VEGA_AB_H.
VEGA_AB_K
AproximadodedeslocamentoentreVega(comono2MASS)emagnitudesABemKbanda.KVega~=KAB+VEGA_AB_K.

B.1.14KCorrections
FunesparaclculoKcorrees.
kCorr(filtro,redshift,colorType,ColorValue)
CalculaKcorrees.IssopermitequevocdetermineKcorreesparaumagalxia,dadooseudesvioparaovermelhoeumacor.
FiltrosparaGALEX,SDSS,UKIDSS,Johnson,Cousins
e2MASSsocobertos.

Paradefiniroclculovocdeveescolhertantoumfiltro,especificadocomoumKCF_ *constante,eumacor(pardefiltros)especificado
comoumKCC_ *constante.Paracadafiltrodisponveis,apenasalgumascoresestodisponveis,comodescritonadocumentaodo
relevanteKCF_ *constante.
Oalgoritmousadodescritoemhttp://kcor.sai.msu.ru/.Estabaseiasenopapelde"AproximaesanalticasdeKcorreesempticos
edeinfravermelhoprximoBands"porI.Chilingarian,A.L.MelchioreI.Zolotukhin(2010MNRAS.405.1409C),masestendidopara
incluirbandasGALEXUVecomcoberturaredshiftat0,5comodescritona"RelaoCorCorMagnitudeUniversalUVpticade
Galxias"porI.ChilingarianeI.Zolotukhin(2012MNRAS.419.1727C).
KCF_FUV
FiltroGALEXFUV(AB).UsecomKCC_FUVNUVouKCC_FUVu.
KCF_NUV
FiltroGALEXNUV(AB).UsecomKCC_NUVgouKCC_NUVr.
KCF_u
SDSSfiltrou(AB).UsecomKCC_ur,KCC_uiouKCC_uz.
KCF_g
SDSSgfiltro(AB).UsecomKCC_gr,KCC_giouKCC_gz.
KCF_r
FiltrorSDSS(AB).UsecomKCC_grouKCC_ur.
KCF_i
SDSSifiltrar(AB).UsecomKCC_giouKCC_ui.
KCF_z
SDSSfiltroz(AB).UsecomKCC_rz,KCC_gzouKCC_uz.
KCF_Y
FiltroUKIDSSY(AB).UsecomKCC_YHouKCC_YK.
KCF_J
FiltroUKIDSSJ(AB).UsecomKCC_JKouKCC_JH.
KCF_H
UKIDSSfiltroH(AB).UsecomKCC_HKouKCC_JH.
KCF_K
UKIDSSfiltroK(AB).UsecomKCC_JKouKCC_HK.
KCF_U
JohnsonLfiltro(Vega).UsecomKCC_URc.
KCF_B
FiltroBJohnson(Vega).UsecomKCC_BRcouKCC_BIc.
KCF_V
FiltroJohnsonV(Vega).UsecomKCC_VIcouKCC_VRc.
KCF_Rc
Cousins
Rcfiltro(Vega).UsecomKCC_BRcouKCC_VRc.

KCF_Ic
Cousins
Icfiltro(Vega).UsecomKCC_VIc.

KCF_J2
Filtro2MASSJ(Vega).UsecomKCC_J2Ks2ouKCC_J2H2.
KCF_H2
2MASSfiltroH(Vega).UsecomKCC_H2Ks2ouKCC_J2H2.
KCF_Ks2
Filtro2MASSKs(Vega).UsecomKCC_J2Ks2ouKCC_H2Ks2.
KCC_BIc
JohnsonBCousins
Iccor.

KCC_BRc
http://127.0.0.1:2525/doc/sun253/sun253.html

182/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

JohnsonBCousins
Rccor.

KCC_FUVNUV
GALEXFUVcorNUV.
KCC_FUVu
GALEXFUVSDSSucor.
KCC_gi
SDSSgicolorir.
KCC_gr
SDSSgcorr.
KCC_gz
SDSSgcorz.
KCC_H2Ks2
2MASSHKsdecor.
KCC_HK
UKIDSSHKdecor.
KCC_J2H2
2MASSJcorH.
KCC_J2Ks2
2MASSJKsdecor.
KCC_JH
UKIDSSJcorH.
KCC_JK
UKIDSSJKdecor.
KCC_NUVg
GALEXNUVSDSSgcor.
KCC_NUVr
GALEXNUVSDSSrcor.
KCC_rz
RSDSScorSDSSz.
KCC_ui
SDSSuSDSSicor.
KCC_URc
JohnsonUCousins
Rccor.

KCC_ur
SDSSurcor.
KCC_uz
SDSSucorz.
KCC_VIc
JohnsonVCousins
Iccor.

KCC_VRc
JohnsonVCousins
Rccor.

KCC_YH
UKIDSSYcorH.
KCC_YK
UKIDSSYKdecor.

B.1.15CoordsDegrees
Funesparatransformaesangularesemanipulaes,comngulosgeralmenteemgraus.Emparticular,osmtodosdetraduoentregrause
hh:mm:ss,souDDD:MM:representaessexagesimaistiposs.ssofornecidos.
degreesToDms(graus)
Converteumnguloemgrausgrausformatados:minutos:segundosstring.Nenhumapartefracionriadocampodesegundosdado.
degreesToDms(graus,secFig)
Converteumnguloemgrausgrausformatados:minutos:segundosstringcomumdeterminadonmerodecasasdecimaisdocampo
desegundos.
degreesToHms(graus)
Converteumnguloemgraushoraformatados:minutos:segundosstring.Nenhumapartefracionriadocampodesegundosdado.
degreesToHms(graus,secFig)
Converteumnguloemgraushoraformatados:minutos:segundosstringcomumdeterminadonmerodecasasdecimaisdocampode
segundos.
dmsToDegrees(DMS)
Converteumgrausformatados:minutos:segundosstringparaumnguloemgraus.Delimitadopordoispontos,espao,personagensdm
[s],oualgunsoutros.Sopermitidosespaosadicionaiselder+/.A:segundoparteopcional.
hmsToDegrees(HMS)
Converteumahoraformatados:minutos:segundosseqnciadecaracteresparaumnguloemgraus.Delimitadopordoispontos,
espao,personagenshm [s],oualgunsoutros.Sopermitidosespaosadicionaiselder+/.A:segundoparteopcional.
dmsToDegrees(graus,minutos,segundos)
Convertegraus,minutosesegundosparaumnguloemgraus.
Emconversesdestetipo,deveseterocuidadodeobterosinalcertonaconversodengulosqueestoentre0e1graus.Estarotina
utilizaobitdesinaldodegargumento,tendoocuidadodedistinguirentre+0e0(suasrepresentaesinternassodiferentespara
valoresdepontoflutuante).ilegalparaosminousegargumentosparasernegativo.
http://127.0.0.1:2525/doc/sun253/sun253.html

183/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

hmsToDegrees(hora,minuto,segundo)
Convertehoras,minutos,segundos,paraumnguloemgraus.
Emconversesdestetipo,deveseterocuidadodeobterosinalcertonaconversodengulosqueestoentre0e1horas.Estarotina
utilizaobitdesinaldahoraargumento,tendoocuidadodedistinguirentre+0e0(suasrepresentaesinternassodiferentespara
valoresdepontoflutuante).
skyDistanceDegrees(ra1,Dec1,ra2,Dec2)
Calculaaseparao(distnciaemtornodeumgrandecrculo)dedoispontosnocuemgraus.

FunesB.2Activation
AsseguintesfunespodemserusadasapenasparadefinirpersonalizadosAesdeativaoamaioriadeleslidarcomacausaquealgo
acontea,comoaparecendoumajaneladeexibiodaimagem.Elesgeralmenteretornarumacadeiacurta,queserregistradoparaousurioa
darumaindicaodoqueaconteceu(ounoaconteceu,oudeveriateracontecido).Adocumentaomaiscompletadelasestdisponvela
partirdedentroTOPCATnajanelaFunesdisponveis.

B.2.1SDSS
FunesdevisualizaoespecializadosparausocomoSloaneDigitalSkyServidor.
sdssShowCutout(label,ra,dec,pixels)
ExibeumaimagemcoloridadoentalhedeumtamanhoespecificadodoSDSSemtornodeumadeterminadaposionocu.Aimagem
apresentadaquadrada,umdeterminadonmerode(0.4arcsec)pixelsdecadalado.
sdssShowCutout(ra,dec,pixels,escala)
ExibeumaimagemcoloridadoentalhedeumtamanhoespecificadodoSDSSemtornodeumadeterminadaposionocucompixels
deumdeterminadotamanho.Pixelssoquadrados,eseutamanhonocuespecificadopelaescalaargumento.Aimagemapresentada
tempixelspixelsaolongodecadalado.
sdssShowCutout(ra,dec)
ExibeumaimagemcoloridadoentalhedeumtamanhopadrodoSDSSemtornodeumadeterminadaposionocu.Aimagem
apresentadade128pixelsquadradosumpixel0.4arcsec.
SDSS_DR2_BASE_URL
URLBaseparaservioderecuperaoSkyServerJPEG,DR2.
SDSS_BASE_URL
URLBaseparaservioderecuperaoSkyServerJPEG.

B.2.2Navegadores
ExibeURLsemnavegadoresweb.
BasicBrowser(url)
ExibeumaURLemumvisualizadordeHTMLbsico.EsteprovvelquesfuncionaparadadosRTFHTML,textoou.Onavegador
podevisitarhiperlinksetemsimplesparaafrente/trsbotes,masnotemasofisticaodeumaplicativodonavegadorWWW
adequada.
systemBrowser(url)
AstentativasdeexibirumaURLnonavegadorpadrodosistema.ExatamenteoqueCoutscomoonavegadorpadrodependentedo
sistema,comoseestafunoirfuncionarcorretamente.
mozilla(url)
ExibeumaURLemumnavegadordawebMozilla.ProvavelmentesfuncionaemsistemasoperacionaisUnixlike,esomentese
Mozillajestemexecuo.
firefox(url)
ExibeumaURLemumnavegadorFirefox.ProvavelmentesfuncionaemsistemasoperacionaisUnixlike,esomentese,oFirefoxj
estemexecuo.
netscape(url)
ExibeumaURLemumnavegadorNetscape.ProvavelmentesfuncionaemsistemasoperacionaisUnixlike,esomentese,oNetscape
jestemexecuo.
mozalike(cmd,url)
ExibeumaURLemumnavegadordafamliaMozilladevesuportarbandeirasdotipo"-remoto openURL ( url)".Provavelmente
sfuncionaemsistemasoperacionaisUnixlike,eapenasseonavegadorjestemexecuo.

B.2.3SuperCosmos
FunesdevisualizaoespecializadosparausocomolevantamentoSuperCOSMOS.Estasfunesexibirimagensderecortedevrios
arquivoshospedadosemPesquisasSuperCOSMOSSky(http://wwwwfau.roe.ac.uk/sss/).Namaioriadoscasosestescobrirtodoocudo
sul.
sssShowCutout(ra,dec,pixels)
ExibeumaimagemdoentalheemumadasbandasdisponveisdosinquritosSuperCOSMOSSky.Aimagemapresentadaquadrado,e
PixelspixelsnasdimensesXeY.Pixelssocercade0,67segundosdearcoquadrado.CoberturaSkyestcompleto.
sssShowCutout(ra,dec)
ExibeumaimagemdoentalhedetamanhopadroemumadasbandasdisponveisdosinquritosSuperCOSMOSSky.CoberturaSky
estcompleto.
http://127.0.0.1:2525/doc/sun253/sun253.html

184/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

sssShowBlue(ra,dec,pixels)
ExibeumaimagemdoentalhedetamanhopadrodeumadaspesquisasazuldebandadeSuperCOSMOS.CoberturaSkyest
completo.
sssShowRed(ra,dec,pixels)
ExibeumaimagemdoentalhedetamanhopadrodeumadaspesquisasvermelhodebandadeSuperCOSMOS.CoberturaSkyest
completo.
sssShowUkstB(ra,dec,pixels)
ExibeumaimagemrecortadaretiradodosInquritosSuperCOSMOSSkyReinoUnidopesquisaBjbandTelescpioSchmidt.A
imagemapresentadaquadrado,ePixelspixelsnasdimensesXeY.Pixelssocercade0,67segundosdearcoquadrado.
CoberturaSky90<dezembro<2,5(graus).
sssShowUkstR(ra,dec,pixels)
ExibeumaimagemrecortadaretiradodosInquritosSuperCOSMOSSkyReinoUnidopesquisaRbandTelescpioSchmidt.Aimagem
apresentadaquadrado,ePixelspixelsnasdimensesXeY.Pixelssocercade0,67segundosdearcoquadrado.
CoberturaSky90<dezembro<2,5(graus).
sssShowUkstI(ra,dec,pixels)
ExibeumaimagemrecortadaretiradodosInquritosSuperCOSMOSSkyUKSchmidtTelescopepesquisaIbanda.Aimagem
apresentadaquadrado,ePixelspixelsnasdimensesXeY.Pixelssocercade0,67segundosdearcoquadrado.
CoberturaSky90<dezembro<2,5(graus).
sssShowEsoR(ra,dec,pixels)
ExibeumaimagemrecortadaretiradadoinquritoRbandSuperCOSMOSSkySurveysESO.Aimagemapresentadaquadrado,e
PixelspixelsnasdimensesXeY.Pixelssocercade0,67segundosdearcoquadrado.
CoberturaSky90<dezembro<2,5(graus).
sssShowPossE(ra,dec,pixels)
ExibeumaimagemrecortadaretiradodoCuSuperCOSMOSInquritosPalomarpesquisaEbanda.Aimagemapresentadaquadrado,
ePixelspixelsnasdimensesXeY.Pixelssocercade0,67segundosdearcoquadrado.
CoberturaSky20.5<dezembro<2,5(graus).
SSS_BASE_URL
URLBaseparaSuperCOSMOSimagemServiorecorte.

B.2.4Mgc
FunesespecializadasparausocomdadosdoGalaxyLevantamentodoMilnio.
imageMgc(mgc_id)
ExibeoselopostalFITSimagemdeumobjetoMGCemumvisualizadordeimagens.
MGC_IMAGE_BASE
CordasprefixadoMGC_IDparaaURLdaimagemFITS.
MGC_IMAGE_TAIL
CadeiaanexadoaoMGC_IDparaaURLdaimagemFITS.

B.2.5Sog
FunesparaexibiodeimagensemSOGvisualizadorexterno(http://www.starlink.ac.uk/sog/).
sog(label,loc)
Exibeoarquivoemumdeterminadolocalcomoumaimagememum(SOG)visualizadorgrfico.rtulopodeserqualquerstringque
identificaajanelaparaexibio,demodoquevriasimagenspodemserexibidasemjanelasdiferentessemficarnocaminhounsdos
outros.locdeveriaserumnomedearquivoouURL,apontandoparaumaimagememumformatoqueentendeSOG(issoincluiFITS,
FITScomprimidoeNDFs).

B.2.6BasicImageDisplay
Funesparaexibiodeimagensemformatodegrficosemumajanelasemfrescurasvisualizao(umaImageWindow).Formatosde
imagemsuportadosincluemGIF,JPEG,PNGeFITS,quepodemsercompactados.
displayBasicImage(label,loc)
Exibeoarquivoemumdeterminadolocalcomoumaimagememumvisualizadorgrfico.rtulopodeserqualquerstringqueidentifica
ajanelaparaexibio,demodoquevriasimagenspodemserexibidasemjanelasdiferentessemficarnocaminhounsdosoutros.loc
deveserumnomedearquivoouURL,apontandoparaumaimagememumformatoqueesteespectadorentende.

B.2.7TwoQZ
Funesespecializadasparausocomosdadosdapesquisa2QZ.Osdadosespectraisforamtiradasdiretamentedositeda2QZem
http://www.2dfquasar.org/.
http://127.0.0.1:2525/doc/sun253/sun253.html

185/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

image2QZ(nome)
ExibeoselopostalFITSimagemdeumobjeto2QZemumvisualizadordeimagens.
jpeg2QZ(nome)
MostraaimagemJPEGselopostalparaumobjeto2QZemumvisualizadorexterno.
get2qzSubdir(nome)
Retornaonomedosubdiretrio(como"ra03_04")paraumdeterminadonome2QZobjeto(ID).
TWOQZ_SPEC_BASE
CordasprefixadoparaonomedoobjetoparaaURLdoarquivoFITSespectros.
TWOQZ_SPEC_TAIL
CadeiaanexadoaonomedoobjetoparaaURLdoarquivoespectrosFITS.
TWOQZ_FITS_IMAGE_BASE
CordasprefixadoparaonomedoobjetoparaaURLseloFITSpostal.
TWOQZ_FITS_IMAGE_TAIL
CadeiaanexadoaonomedoobjetoparaaURLseloFITSpostal.
TWOQZ_JPEG_IMAGE_BASE
CordasprefixadoparaonomedoobjetoparaoporteURLseloJPEG.
TWOQZ_JPEG_IMAGE_TAIL
CadeiaanexadoaonomedoobjetoparaoporteURLseloJPEG.

ImagemB.2.8
Funesparaexibiodeimagensemumajanela.FormatosdeimagemsuportadosincluemGIF,JPEG,PNGeFITS,quepodemser
compactados.OprogramaSoG(http://www.starlink.ac.uk/sog/)serusadoseestiverdisponvel,casocontrrio,aimagemtelespectadorsem
frescurasserusadoemseulugar.
displayImage(label,localizao)
Exibeoarquivonolocalindicadoemumvisualizadordeimagens.

SadaB.2.9
Funesparasadadelogsimples.
print(str)
Emiteumvalorstringparaologindousurio.
print(num)
Emiteumvalornumricoparaologindousurio.

B.2.10Sistema
Executacomandosdosistemaoperacionallocal.Estessoexecutadoscomosetivessedigitadoapartirdacasca,oulinhadecomando.
exec(cmd,arg1)
Executaumcomandodosistemaoperacionalcomumargumento.
exec(cmd,arg1,arg2)
Executaumcomandodosistemaoperacionalcomdoisargumentos.
exec(cmd,arg1,arg2,arg3)
Executaumcomandodosistemaoperacionalcomtrsargumentos.
exec(linha)
Executaumastringcomoumcomandodosistemaoperacional.Quaisquerespaosnaseqnciasotomadasparadelimitarpalavras(a
primeirapalavraonomedocomando).

CNotassobreoRelease
EsteTOPCAT,Ferramentaparaoperaesemcatlogosetabelas.umvisualizadordepropsitogeraleeditorparadadostabulares
astronmicos.
Autor
MarkTaylor(UniversidadedeBristol)
Email
mbtaylor@bristol.ac.uk
WWW
http://www.starlink.ac.uk/topcat/
Comentriosdousurio,sugestes,solicitaeserelatriosdeerrosparaoendereoacima,sobemvindas.
Produtosdesoftwarerelacionadosso
STIL
AStarlinkTabelasInfrastructureLibrary,queforneceasclassesdemanipulaotabelanaqualTOPCATsebaseia.
STILTS
OSTILToolSet,quefornecealgumasdelinhadecomandodemanipulaodemesaeferramentasdeanlisecombaseemSTIL.Esta
umacontrapartenoGUIparaTOPCAT,proporcionandomuitasdasmesmasinstalaes(correspondncia,seleodelinha,converso
http://127.0.0.1:2525/doc/sun253/sun253.html

186/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

deformato,plotagem,etc),masdeumaformaquepodeserincorporadoemscripts,serviosweb,etc
VejaapginawebTOPCAT,http://www.starlink.ac.uk/topcat/paraasltimasnotciaselanamentos.

C.1Agradecimentos
TOPCATfoiinicialmente(20032005)desenvolvidonombitodoReinoUnidoStarlinkprojeto(19802005,RIP).Desdeento,temsido
apoiadapelaconcessoPP/D002486/1partirdoReinoUnidoFsicadePartculasePesquisaemAstronomiaConselho,oVotechprojeto(a
partirdo6PQdaUE),oAstroGridprojeto(dePPARC/STFC),aAIDAprojeto(apartirdo7UE),concedeST/H008470/1,
ST/I00176X/1,ST/J001414/1eST/L002388/1doConselhodoReinoUnidoCinciaeTecnologiaInstalaes(STFC),oGAVOprojeto
(BMBFBewilligungsnummer05A08VHA),aAgnciaEspacialEuropeiaeoprojetoFP7GENIUS.Tudoissooapoioreconhecido
agradecimento.
QuasetodoessetrabalhotemsidofeitonoGrupodeAstrofsicadaFaculdadedeFsica,naUniversidadedeBristol,ReinoUnido,emboraa
UniversidadedeCambridgeedaUniversidadedeHeidelbergtambmforamenvolvidos.
AinspiraoparaalgumasdascaractersticasdoTOPCATfoitomadaapartirdasseguintesferramentasprexistentes:
Mirage(BellLabs)
VOPlot(VOIndia)
ParaalmdaexcelenteJava2StandardEdition,osseguintesbibliotecasexternasfornecerpeasdefuncionalidadedoTOPCAT:
JEL(KonstantinMetlov,GNU)paraaavaliaodaexpressoalgbrica
PixTools(Nikolaykuropatkin,FermilabEAG)parabaseadaemHEALPixcelestialcorrespondenteesferalinha
IVOARegistry(NVO)paraADQL/X>Straduesempesquisasderegistro
HTM(SloanDigitalSkySurvey)parasistemasbaseadosemHTMcelestialesferalinhacorrespondente(agoraobsoletodentro
TOPCAT)
Ptplot(Ptolomeu)paraalgumatramaeixo2D
iTextparasadaPDF
EPSGraphics2D(Jibble)paraasadaPostScriptencapsulado
GifEncoder(Acme)parasadaGIF
IVOAFITSPackage(SloanDigitalSkySurvey)para(noSOG)exibiodeimagensFITSsimples
ADQL(GrgoryMantelet,CDS)paraADQLanlise
MOC(CDS)MultiOrdermapasCoberturaHEALPixparamanipulaopegada
nom.tam.fits(NASA)parapartesdaFITSI/O
Skyviewemumfrasco(NASA)paraodesenhoeixocu
JLaTeXMath(Scilab)paracomposioLaTeXemparcelas
CamadaJIDEComum(Jidesoft)paracontrolesdeslizantesduplasended
BrowserLauncher2paraolanamentodonavegadorwebpadro
Ocdigopartilhadoapartirdasseguintespessoasreconhecidoagradecimento:
ThomasBoch(CDS),paraodilogocargavizir.
GerardLemson(MPE,Garching)paraodilogocargaGAVO.
MarcoMolinaro(INAFAVEIA)paraodilogocargaBasti.
OlogotipoTOPCATemusodesdeaverso4foigentilmentedesenhadaporPhilHall.
TOPCATbeneficiousede,eemgrandepartemoldadapor,conselho,comentriosefeedbackdemuitosusurios,testadorese
desenvolvedores.Algunsdoscontribuintesnotveis
soestes:

AlasdairAllan(Starlink,Exeter)
MarkAllen(CDS)
HeinzAndernach(Guanajuato)
ThomasBoch(CDS)
LaurentBourges(JMMC)
DannyBoxhoorn(Kapteyn,Groningen)
MalcolmCurrie(Starlink,RAL)
CliveDavenhall(RoyalObservatoryEdinburgh)
LukeDavies(Bristol)
ChristophDeil(MPIHeidelberg)
MarkusDemleitner(ARIHeidelberg)
SebastienDerriere(CDS)
PeterDraper(Starlink,Durham)
PierreFernique(CDS)
ShashikiranGanesh(PRL,ndia)
DavidGiaretta(Starlink,RAL)
EduardoGonzalezSolares(IOA)
NormanGray(Starlink,Glasgow)
PhilHall(FilhodeKen)
HaggisHarris(Bath)
EvanthiaHatziminaoglou(ESO)
http://127.0.0.1:2525/doc/sun253/sun253.html

187/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

AvonHuxor(Bristol/ARI)
JonathanIrwin(Cambridge)
TimJenness(JACH)
JJKavelaars(NRC)
GerardLemson(MPEGarching)
BobMann(RoyalObservatoryEdinburgh)
BenMaughan(Bristol)
RichardMcMahon(IOA)
GuillaumeMella(JMMC)
DavidMills(Bristol)
DouglasMorgan(Bristol)
AgostoMuench(AFC)
SimonMurphy(ANU)
FranoisOchsenbein(CDS)
ClivePgina(Leicester)
RoyPlaton(RAL)
JamesPrice(Bristol)
AnitaRichards(JodrellBank)
AaronRobotham(Bristol)
YannickRoehlly(OAMP)
MikeRead(ROE)
JuandeSandanderVela(IAACSIC)
MikeWatson(Leicester)
IvanZolotukhin(SAIMSU)
JonathanZwart(Columbia)
Sevocusarestesoftwareemtrabalhopublicado,aseguintecitaoseriaapreciada:
2005ASPC..347...29T:MBTaylor,"TOPCAT&STIL:StarlinkTable/VOTableSoftwaredeProcessamento",no
AstronomicalDataAnalysisSoftwareeSistemasXIV,eds.PShopbelletal.,ASPConf.Sor.347,p.29(2005)

HistricodeversesC.2
Lanamentosatdataforamasseguintes:
Verso0.3b(4deJunho2003)
Primeiraversopblica
Verso0.4b(8deJulho2003)
Rowsubconjuntocolunacontagemnajanelasubconjuntos.
CorrigidoemelhoradojanelaParameterquebrado.
Sadafixodenomedetabelaeparmetros.
Sadaaoltextabularambientejestdisponvel.
BotesdeacessoSQLagoraacinzentadoquandohdriversJDBCestopresentes.
UCDseleojestdisponvelapartirdeNovadilogoColunasinttico.
ExibiodemetadadosColunafezmaislgicoeflexvel.
ColunacardinalidadeagoracalculadonajanelaEstatsticas.
ExpressesdecolunaSytheticemaisoutrosmetadadoscolunaagoraeditvel.
Apoiovalornuloemexpressesavaliadas.
Dadosexemplointegraisfornecida.
Navegadorhierrquicaparaastabelasdisponveisnodilogodecarga.
Verso0.41b(10Julhode2003)
CorrigidoumerrodesadaVOTable(noescaparcaracteresespeciaisdeXML).
CorrigidoumerrodesadaFITSsrio.
ValorruimMelhoramentonoprocessamentodosFITStabelas.
Verso0.5B(20Outubrode2003)
Agorapodelertabelasformatodetextosimples.
FITSarquivosdetamanhoarbitrrioagorapodeserlido(elesnosocarregadosnamemria).
TOPCATagorapodeserexecutadosemerrosemumambienteseguro(porexemplo,comoumarquivojarassinadosob
WebStart).Claroquealgumasaes,comoSalvartabelanoestodisponveisnestecontexto.
ArquivoscompactadoscomUnixcomprimiragoratrabalhar(bemcomogzipebzip2).
Adicionadonavegadorhierarquiadedilogocarregar.
Adicionadodadosdedemonstraointegrais(acessvelapartirdedilogodecarga).
AgorapodearrastartabelasdeTreeviewemdilogocargaTOPCAT(ouobotodecarga).
Algumascorreesdebugs.
Verso0.51(18Novembro2003)
RewritedoFITSacessobinriomesaparagrandesmelhoriasdeeficincia.
http://127.0.0.1:2525/doc/sun253/sun253.html

188/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Agorapossvelconectaremmtodosalgbricosdefinidospelousurioemtempodeexecuo.
Melhorouotestedeunidadelevaaalgumascorrees.
Verso1,10(21Abril2004)
Interfacedeusurioredesenhadaagoraemtornodejaneladecontrolenonavegadormesa(muitomaisfciltrabalharcomvrias
tabelas).
Extensasinstalaesparamesajuntandoporlinhascorrespondentesentrevriastabelasoudentrodeumnico.
DocumentaomelhoroumuitoedisponvelonouofflinecomoSUN/253.
BibliotecadeacessoatabeladeautocontidoSTILagorafornecidocomoumprodutoseparado.
Astabelaspodemserconcatenadas.
Melhorcontroledealtonvelsobreaproliferaojanela.
Colunasnopodemagoraserescondido/reveladoapenasexcludo.
Osformatosdesada/variantesadicionaissuportados:
VOTableusandoBINRIOouFITScodificao,inlineouporreferncia
FluxoASCIIlegvelpormquina
ElementooudocumentoHTML<TABLE>
HbridoDOM/SAXanlisedeVOTablesparamelhorutilizaodaeficincia/memria.
Novabandeira-democomeacomdadosdedemonstrao.
Diversosmelhoriasdeeficinciaecorreesdebugs.
Verso1.13(5deMaio2004)
Funesprevistasradianos<>conversosexagesimal
Verso1.3(20Outubro2004)
Estaversointroduziumuitasmelhoriasnaescalabilidade,eficinciaefuncionalidade.TOPCATagoramuitofelizcommesasdeum
milhodelinhasoumais(ecentenasdecolunas),mesmoemsistemascomrecursosdememriabastantemodesto/CPU.Asprincipais
melhoriassoasseguintes:
Plotagem
Plotagemmuitomaisrpidoepodelidarcommuitosmaispontos
Subconjuntospodemserseleccionadosapartirdajanelatrama,traandoseumaregionorectangular
Voctemmaisescolhasobresmbolosdeplotagem(incluindoossemitransparentes)
FinalmenteeixosXouYpodeservirado!
ExportarparaPostScriptencapsuladodemelhorqualidade(emboraparamuitospontosdetamanhosdearquivopodeficar
grande)
ExportarparaoformatoGIFestdisponvel
Linhasderegressopodemserplotadosecoeficientesexibidos(capacidadeexperimentalpoderiasermelhorado)
FormatosdeMesa
"disco"bandeirapermiteousodearmazenamentodebackupdediscoparagrandestabelas
Novo'FITSplus'lojasdeformatorichmetadadosdatabela/colunaemumarquivoFITS
ManipuladorVOTableagoratotalmenteVOTable1.1e1.0compatvel
AnliseVOTableagoratrabalhacomJava5.0plataforma
FormatoCommaSeparatedValueagorasuportadaparaentradaesada
ManipuladordeentradaASCIIreescritoparalidarcomtabelasmuitomaiores
ManipuladorASCIIagoraentended/Dcomocartaexpoente,bemcomoe/E
ManipuladorASCIIagorausacurto/FloatnoInteger/Duploquandonecessrioparaeconomizarmemria
FormatoASCIIfixobugpara0graus/horaemngulossexagesimais
ManuseioNullmelhoradoparaFITSeformatosVOTable
ArquivosFITSdescriesdascolunasdelojaemcabealhosTCOMMx
Melhoresmensagensdeerroparaastabelasnoanalisvel
Tabelajunta
Vriasmelhoriasdeeficinciaereduonosrequisitosdememria
Emcasosdevriascorrespondnciaspossveis,omaisprximoagoraescolhidoemvezdeescolherumaleatoriamente
Parjogoagoraadicionacolunaquecontmpontuaoparacadapartida(distnciaentrepontos)
AsunidadespodemserselecionadascolunasRA/dezembroeerrosdejogo(porissonoprecisasertudoemradianos)
Novostiposdecorrespondnciaadequadasparacorrespondnciamultivariada(anistropiccartesiano,Sky+X,Sky+XY)
Dados/MetadadosManipulao
Podeadicionar/removerparmetrosdatabela
Umpassodilogosubstituiodacolunadedadosoujanelasdecoluna
Expressesdecolunasintticosagoraescritoparadescriesdascolunas
GUINavigationandDisplay
Melhoriadaprestaodenmerosemtabelas(especialmenteFloats)
Melhordetecodeapresentadasaslargurasdascolunasdatabela
OpoNovaJaneladeControleemmenusArquivo
Melhorredimensionamentojanelaparaalgumascaixasdedilogo

http://127.0.0.1:2525/doc/sun253/sun253.html

189/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Mensagensdeerromenosconfusoemmuitoslugares
Expressesalgbricas
TodasasfunesdisponveisestoagoratotalmentedocumentadonodocumentodeajudaeJanelamtodointerativo
Muitosnovostrig,coordenar,conversodetipo,asfunesdemanipulaodestrings
Grandesmelhoriasdedesempenhoparavaloresnulos
AesdeAtivao
Clicandoemumpontonatramadestacaalinhacorrespondentenajaneladedadoseviceversa
SeleoRowpodedesencadearexibiocuregiorecorteexibio
SeleoRowpodedesencadearaesdefinidaspelousurionaativao
Almdisso,osseguintesincompatibilidadesemodificaesforamintroduzidasdesdealtimaverso:
Oformatodeentradaparaastabelasagorapodeserespecificadanajaneladecarga(atravsdeumacaixadeseleo)ounalinha
decomando(usandoo"-fflag").FITSarquivoseVOTablesaindapodemseridentificadosautomaticamente(ouseja,no
necessrioespecificaroformato,nestecaso),masastabelasASCIInopode:vocdeveagoraespecificaroformatoaocarregar
tabelasASCII.Estamudanapermitemelhoresmensagensdeerroesuporteparamaisformatosdetextolike.
Asexpressesalgbricasreferenciandosubconjuntoslinhaagorausarocaracteresublinhado("_")emvezdocaracter("#")para
indicarumIDsubconjunto.
Asclassesquecontmfunesfornecidaspelousurioparaexpressesalgbricassoagoraespecificadasutilizandoas
propriedades"jel.classes"e"jel.classes.activation",no"gnu.jel.static.classes".
OformatodesadapadroparaFITStabelasagoraochamadoformato"ENCAIXAplus",quetemumBINTABLEemsua
primeiraextensocomoantes,masotextodeumaVOTablearmazenadoemsuaHDUprimrio.Issopodearmazenarmaisde
metadadosparaTOPCAT,masdevesecomportardamesmaparaoutrasaplicaesfitscompatveis.Ocomportamentoantigo
podeserrestaurado,sedesejado,especificandoformato"FITSbase".
Verso1.31(10deNovembro2004)
Pequenasalteraes:
Servidoresrecorte2MASSagoradisponveisapartirdajaneladeativao
LogotipoStarlinkAdicionadoatodasasjanelas
Verso1.32(6Dez2004)
Bugfix:
ErronaanlisevazioselementosTDVOTablefixos.
Verso1.4(4Fev2005)
Dilogosdecarga
Odilogocargamesagrficafoireformulado,eagoratemdoisprincipaisnovosrecursos.Emprimeirolugar,foireescrita,de
modoqueainterfacenocongelarduranteumlongocargaaindaactualmentenopossvelinteragircomoutrasjanelas
TOPCATenquantoumacargaestocorrendo,masagoravocpodecancelarumacargaqueestemandamento.
Emsegundolugar,aprestaodedilogosdecargafoimodularizado,eumasriedenovosdilogosfornecido.Osnovosso:
ConePesquisa
MySpaceNavegador
RegistrodeConsultas
SIAPConsulta
Seasclassesnecessriasestopresentes,vocpodeadquirirmesasapartirdestasfontesexternas,bemcomoosmtodos
tradicionaisdecarregamentodediscoetcNovossinalizadoresdelinhadecomandocorrespondentesacadaumadelasforam
adicionadosparagarantirqueelesestopresentesefazlosdedestaquenaodilogodecarga.Almdisso,possvelconectarem
dilogosdecargaadicionaisemtempodeexecuousandoostartable.load.dialogspropriedadedosistema.
OaparecimentodoindicadordecargafoialteradaagorasoFileBrowserbotovisveljuntocomaLocalizaocampono
corpodajanela,masaDataSourcesmenupodeserusadoparaexibiroutrosdilogosdeimportaodemesadisponvel.
Acondicionamento
Oprogramapodeagoraserobtidadeduasformasautnomas:topcat-full.jaretopcat-lite.jar.Oprimeiromuitomaior
doqueantes(11Mbyte),umavezquecontmumnmerodeclassesparaapoiardilogosdecargapersonalizados,comoo
navegadordoMySpaceeinteraodeservioweb,bemcomoasclassesSoG.Esteltimocontmapenasasclassesparaa
funcionalidadedoncleo,emuitomenor(3Mbyte).
ExplodeaoColunaMatriz
ExisteagoraumnovobotonajanelaColunasquesubstituiumacolunacomvalordematrizcomumacolunadeescalarparacada
umdosseuselementos.
Paste'n'Load
Agoravocpodecarregarumatabela,colandoseunomedearquivoouURLcomotextoparaalistadetabelanajanelade
controle(usandoaseleoXemXwindowsnoseiseoucomoissofuncionaemoutrasplataformas).
Mensagemdeajuda
Oresultadodatopcat-ajudaagoramaisabrangente,descrevendobrevementeoquecadaopofazelistandoaspropriedades
dosistema,bemcomoosargumentos/flagsadequada.
http://127.0.0.1:2525/doc/sun253/sun253.html

190/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Verso1,41(8deFevereiro2005)
AdicionadoItemdepesquisaColunajaneladeDadosdomenupopupcoluna
Verso1.5(17deMaro2005)
Acessoaarquivos
Cargadilogosmudaramnovamenteumpouco,esalvarosdilogostambm.Onavegadordearquivospadroemambososcasos
agoraumnavegadorFileStore,quemuitoparecidocomonavegadordearquivospadro,maspodeprocurararquivosem
sistemasdearquivosremotos,bemcomo,atualmentesuportadossoarquivosemAstroGriddoMySpaceouemumSRBservidor
(StorageResourceBroker).Agoravocpodesalvararquivosparaesseslocaisremotosassimcomoacargadeles.
Almdisso,odilogosalvaragoraexibeosubconjuntolinhaatualeordemdeclassificaooquetornamaisfcildevere/ou
alterarosdadosdatabelaquevocestprestesasalvar.
Correesdebugs
Maisalgumaspequenasalteraesforamfeitas.
Exibiodeerrocaixasdedilogoforammelhoradosemalgunslugares
VriosbugsrelacionadoscomJDBCacessarbancodedadosforamcorrigidos
AlgunspequenosproblemasrelacionadoscomVOTablescomcolunasdecaracteressimplesforamabordados
Verso1.6(30deJunho2005)
AesdeAtivao
Algunsmaisfuncionalidadedeativaofoiadicionado:
NovaVisoURLdapginaWebcomoopointroduzidaemjaneladeativao
NovoSistemadeclassedefunesdeativaocontendoexecfunesqueexecutamcomandosnosistemaoperacional
local
NovaBrowsersclassedefunesdeativaoparaexibirURLsembrowsers(fallbackexternoouumbsico)
Funesalgbricas
NovoNmerodeclasseadicionadaquecontmfunesparaconverterentreModifiedJulianDayeISO8601pocasdeformato.
SkyMatching
OcualgoritmodecorrespondnciapadroagorausaHEALPixinvsdeHTMparaatribuircupixelsdeRA,asposiesde
dezembro.Istodpartidascumuitomaisrpidos,namaioriadoscasos,eusaumpoucomenosdememriadeformapodemser
utilizadosemtbuasgrandes.Eletambmfixouumbugqueficoudeforaalgunsjogospossveis.CorrespondentebasedeHTM
estaindafornecidocomoumaopo,masissoprincipalmenteparafinsdedepuraoepodeserretiradanofuturo.
Logging
Oregistrodemensagensfoiarrumada.Aprincipalconseqnciaobservveldissoquemenosmensagensdesarrumadosso
gravadasnoconsolequandoTOPCATexecutadoapartirdeumarquivojarindependenteaoinvsdeumainstalaocompleta
starjava.Aoespecificaranova-verbose(ou-v)flagumaoumaisvezesvocpodeobteressasmensagensdevolta.As
mensagens(naverdadetodasasmensagensdelogemqualquernvel)tambmpodeservistoapartirdaGUIusandoonovo
Arquivo|MostrarLogopodemenudaJaneladoControle.
ServiosSOAP
TOPCATagoraatuacomoumservidorSOAPSolicitaesSOAPagorapodeserfeitoparaumainstnciaemexecuode
TOPCATparaobtloparaexibirtabelasporlocalouatravsdoenviodeXMLparaumdiretoVOTable.Devidoslimitaesdo
Eixo,esteltimomtodonovaifuncionarparaarbitrariamentegrandesmesas.
Alteraesnadocumentao
OTableCopyferramentajnoabordadonestedocumentosubstitudopelotcopyferramentanoseparadaSTILTSpacote.
Houvetambmumareorganizaododocumento,principalmentenosapndices.
Pequenasmudanas
Adicionadoversobandeira
Adicionado(simulado)ImprimiropodejanelaData.Istoapenasapresentaumamensagemnosentidodequevocdeve
salvaremumformatodeimpresso.
CorrigidoumbugquedeuerrosaoexpressescontinhaumaNULL_testenaprimeiracolunadeumatabela.
ModificadoemumadasmesasdedemonstraoparaconterumacolunacomURLsnamesma.
Verso1.61(7deJulho2005)
Correesdebugs:
ContornarAstroGrid/SunbugqueimpediaocarregamentoVOTablescurtasdoMySpace.
CertifiquesedequeosnavegadoresFileStoresomantidosatdataemqueosdilogossoexibidos.
Verso1.7(30Setembro2005)
ReaesCruzadas
Houvegrandesmelhoriasnaflexibilidadeepequenasmelhoriasparaodesempenho,dedoismesaReaesCruzadas.
NovojogoalgoritmoCucomerrosintroduzidos.Issopermitequevocespecifiqueumacolunadandooerromximo
admissveldejogo(porissopodevariarporlinha)emvezdeumvalorfixoparaatabelainteira.
Nocasodevriascorrespondnciaspossveisentreasduastabelas,emvezdeautomaticamentedandolheapenasa
correspondnciamaisprxima,agoravocpodeselecionarsevocquiserapenasomaisprximodeumoutodosaqueles
queseencaixamseuscritrios.

http://127.0.0.1:2525/doc/sun253/sun253.html

191/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Agoravocpodeespecificarqueaslinhasquevocquervernasada:.1e2,1ou2,apartirde1Tudo,tudodo2,1eno
2,2no1,1xor2Issomuitobonitotodasaspossibilidadesquefazersentido,eemparticular,permitequevocfaa
'externaesquerdajunta'(1no2).
Acolunadepontosdaprovaqueresultadamaioriadosjogosagoravem(a)emunidadessensveis,semprequepossvel
(porexemplo,noarcsecondsradianos)e(b)commetadadosquelhedizqueoseusignificadoeasunidadesso.
Maisinformaesestodisponveisemcolunasadicionadasapsojogobemcomoapontuaodapartida,informaes
sobreosgruposcombinadosinseridosemprequenecessrio.
Oalgoritmodejogo"SphericalPolar"agorarenomeadocomoesperamosmenosconfuso"Sky3d".
Alteraessimilaresparaumamesaejogosmultimesadeveseguiremfuturasverses.
AcessoMySpace
MySpaceI/OfoireimplementadoparausaroACR,emvezdeos(agoraobsoleto)aulasCDKqueestavausandoantes.Almde
provavelmentesermaisconfivelemenospropensosaquebrarcomalteraesfuturasnosprotocolosdeservidordoMySpace,o
quedavantagemdesinglesignon.OefeitodissoquevocterdeteroambientedetrabalhoAstroGridrodandoemsua
mquinaantesdepoderacessaroMySpacedaTOPCAT.
Funesalgbricas
AdicionadoJulianEpocheBesselianEpochfunesdeconversoparaTemposclasse.
AdicionadoRANDOMfunoespecial.
Diverso
QuandovocselecionaumacolunanajanelaColunas,agorarolaatabelanajaneladedadosdemodoqueacoluna
selecionadavisvel.Esteumbenefcioaolidarcomtabelasquetmmuitascolunas.
String"nulo"interpretadocomoumvalorembrancoemtabelasASCII.
Adicionadonovaaodeativaoparainiciaronavegadorpadrodosistema.
Correesdebugs
Corrigidoalgunsbugsrelativamenteinofensivosparafazercomasaesdisponveisquandovocselecionaacoluna
manequim"Index".Agoravocpodeunsortpartirdeummenupopupnajaneladovisualizadordemesa.
AcreditasetrabalharbemcomJava1.5agora(haviaanteriormentealgunsproblemascomoMySpaceemJava1.5).
CorrigidooerronomanipuladordeentradaASCIIquemisidentifiedlinhasembrancooulinhaDOSformatotermina,como
ofimdoarquivo.
Verso1,71(4deOutubro2005)
Correesdebugs:
AcessoMySpacequebradofixaemMSWindows.
Verso1.8(13Outubro2005)
AdicionadoJanelaSkyCoordenadasagoramaisfcilparaadicionarnovocucoordenarcolunascombaseemantigosem
diferentessistemasdecoordenadas.
roundDecimaleformatDecimalfunesintroduzidasparamaiscontrolesobreaaparnciavisualdevaloresnumricos.
Agoralidacom'K'noformatoFITScolunasdatabeladebinrios(inteirosde64bits).
ModificaesarquivosJNLP.
Verso2.0(3Fevereiro2006)
UmagrandeatualizaodecapacidadesdevisualizaodeTOPCATocorreunestaverso.Hmelhoriasconsiderveis
emtermosde

funcionalidade,flexibilidadeeeficinciaemrelaosversesanteriores:
Novasjanelasgrficas
Almdo2ddedispersoapartirdeversesanteriores,asseguintesjanelasdevisualizaoestoagoradisponveis:
Histograma(1d)
3dcartesianogrficodedisperso
3dSphericalgrficodedisperso(comdimensoradialopcional)
2dDensidademapa(2dhistograma)
Anovafuncionalidade3dquenorequerainstalaodeJava3Douqualqueroutroterceiroconjuntodeferramentas3Dparao
trabalho(nemtirarproveitodequalquerconjuntodeferramentasquepodeestarpresente).
PlotagemMultidataset/multitable
Asjanelastramajnoestoassociadoscomumanicatabela.Todoselespermitemquevocexibadadosdediferentestabelas,
ouapartirdediferentestuplasdecolunasdamesmamesa,namesmaparcela.Vocpodecamadatantasparcelasquantoquiser
sobreosmesmoseixos,utilizandodiferentesestilosdeplotagemparaosdiferentesconjuntosdedados.Comoantes,vocainda
podeexibirdadosdediferentessubgruposdamesmatabelaeasmesmascolunascomdiferentesestilos.
EstilosdePlotagem
Todasasjanelasdegrficospermitemquevocdefiniroestilodeplotagemparacadaconjuntodedadosindividualmente,usando
umaamplagamadeopes,incluindocor,espessuradalinha,tamanhodomarcador,(histograma)estilobar,etcIssopermiteque
voccontroleconsidervelsobreosdetalhesvisuaisdeasparcelas.
Marcadorestransparentes
Todosos2De3Dgrficosdedispersopermitemtornarpontosutilizandomarcadoresdetransparnciavarivel.Emumenredo
lotado,oquelhepermitevermuitomaisinformaesdoqueousodepontosopacos,jquevocpodeterumaidiadequantos
pontos(dediferentesconjuntosdedados)foramelaboradasemumdeterminadopontonasuperfciedatrama.
http://127.0.0.1:2525/doc/sun253/sun253.html

192/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Desenhodelinhaedecorrelaolinear
Ogrficodedisperso2dpodemagoralinhasdeenredo,opcionalmenteassociadocomconjuntosdedados.Elapodedesenhar
segmentosderetaunindotodosospontostraadosemumset,oudesenharlinhasdecorrelaoperconjuntodedadoslineares.
Nesteltimocaso,eleirinformargradientelinha,interceptarecoeficientedecorrelao.
Melhoraraselecocoluna
Ascaixasdeseletorparaselecionarquaiscolunasparaplotarsoagora'editvel'isto,emvezdeselecionaracolunadeuma
listadropdownquetambmpossveldigitarumaexpressoparaelesemseulugar.Istopodesermaisconvenientesehouver
umalistamuitolongadecolunas.Issotambmsignificaquevocpodeusarumaexpressoalgbricacombasenosnomesdeuma
oumaiscolunas,emvezdeumnomedecolunasimples.Osseletorestambmtmpequenascaixasdesetaaoladodelesquetorna
maisfcilparapercorreralistadecolunasconhecidos.Essesrecursostambmestodisponveisemalgunsoutroslugaresdo
programaondeumvalordecolunanecessria.
Configuraodeeixosmanual
Assimcomozoomineoutusandoomouse,agoravocpodedefiniroslimitesdoseixos,digitandoosemumacaixadedilogo
eixo.Voctambmpodedefinirotextoqueirformaraanotaoeixosobreoenredo.
Linhadeestado
Amaioriadosterrenosapresentamagoraumpainelnaparteinferiordajanelaqueindicaquantospontosforamtraadoseaposio
atualdoponteirodomouse(sehouver)nasuperfciedeplotagem.
Atuao
Grficosdedispersodegrandesconjuntosdedadosagorausammuitomenosmemriaeemtornodeumaordemdemagnitude
menostempodeCPUdoqueanteriormente(a2milhesdpontoreplotagoralevacercade1segundotraandoaprimeiravez
podeserumpoucomaislongo,umavezquenecessitadeadquirirodadosquepodemser/Sintensiva).
Algumasmelhoriasnogrficosrelacionadostambmforamfeitasdaseguinteforma:
AseleodeumsubconjuntonaJaneladeControleagoradesencadeiasuaseleoemoutrasjanelas(enredo,estatsticas,
subconjuntos).Amesmacoisanoaconteceocontrrio,umavezquepodelevaraconseqnciasdesconcertantes.
Colunasbooleanosagoramostrarvaloresnulosdistintamentedefalsos.Almdisso,nulos/falsasdistinessotratadoscommais
cuidadonaFITSearquivosVOTable.
AJaneladoCuCoordenadasagorasugerenomesparanovascolunas.
ONavegadorFileStoreagorapermitequevocinsiraaposioemumarquivodatabelaparacarregar(porexemplo,ndiceHDU
paraFITSoundiceTABLEparaVOTable).
AdicionadoOcultartudo&RevelarTodasasaesparaajanelaColunas.
Aoassociartabelas,comparaonomedacolunaparadeterminarseadesduplicaoexigidoagoracaseinsensitive.
CorrigidoumproblemaqueestavacausandoTOPCATafalharaotentarsalvarumacpiaalteradadeumFITSarquivocomo
mesmonome.
Omanualfoireorganizadoumpouco,eumnovoQuickStartseoacrescentou.
ExisteumaaplicaoexperimentaldainterfaceinteroperabilidadeAladin.Issorealmentenofoitestadonoentanto,issopodeno
funcionar.MelhorinteroperabilidadeAladinesperadoemversesfuturas.
CorrigidoumerronaalgoritmosReaesCruzadascartesianasquenoconseguiucorresponderseoerroexigidoemqualquer
dimensoerazero.
Verso2.1(7deAbril2006)
Umasriedemelhoriasgrficaseoutrasforamfeitasnesterelease.
EmpilhadosLoteLinha
Umnovolotedelinhasempilhadasfoiadicionadodajaneladevisualizao.Istoespecialmenteadequadoparautilizaocomos
dadosdesriesdetempo.
Leituradedadosassncronosemjanelasgrficas
Todasasjanelasdegrficosagoralerosdadosparatraardeformaassncrona.Oqueistosignificaquequandovocmudaro
enredodeumaformaqueexigequeosdadossejamlidosoureler,entoainterfacegrficanoirtravarevocpodefazeroutras
coisas,incluindomudandoatramadeoutrasformasantesdeterconcludoodesenho.Umabarradeprogressonaparteinferiorda
janelaindicaoprogresso.Issosperceptvelparagrandesarquivos(lentoparaler).
EixoZooming
Ohistogramaexistente,2DdedispersoedensidadeMapajanelas,bemcomoonovolotedelinhasempilhadas,agorapermitem
quevocfaaumzoom1d,arrastandoomousepertodoeixo,bemcomoozoom2dporarrastandonasuperfciedatrama.
Interoperabilidadeferramentadeplstico
TOPCATagoraenviamensagensdeeserviosutilizandoaplataformaparaprotocolodeinterconexoastronmicoTool.Veja
Seo9.
FormatodedadosIPAC
OsarquivosdedadosdoIPACformatodefinidopeloinfravermelhoProcessamentodaCalTecheCentrodeAnlisepodemagora
serlidos.EstaaformacomoosdadosdosatliteSpitzerentreoutrosnormalmentefornecido.
CoordenarStringdigitadocolunas
Sedevidamenteidentificados(porexemplo,UCDouunidades),ascolunasquerepresentamdadosemcertasformasconhecidas,
atualmentengulossexagesimaisedatas8601formatoISOcadeiadevalor,podemagorasertratadosdiretamentecomovalores
numricosnascaixasdeseletordecoluna,comoosnasjanelasdeplotagem,emvezdeterquedefinirumanovacolunausando
umconversornumricocorda>.
Relatriodeerrosdamemria
QuandoaJVMficarsemmemria,eleagoratentapostarumajanelapopupexplicandoisso,emvezdeapenasescreveruma
mensagemconcisaparaoconsole.Estepopuptambmlhedaoportunidadedeverumanovaseoadicionadadocumentao:
Dicasparatabelasgrandes.
ServioSABOobsoleto
TOPCATnoporpadroexecutaumservidorSOAPparaaceitartabelas.Vocpodeoptarporexecutloespecificandoosabo
bandeiranalinhadecomando.Estafacilidadepodeserretiradoemfuturasverses,tendoemvistaofatodequeoserviode
plsticopodeproporcionarumafuncionalidadesemelhante.
http://127.0.0.1:2525/doc/sun253/sun253.html

193/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Logodesaparecer
OlogotipoStarlinknotopodecadajaneladefinidaadesaparecergradualmenteaolongodoperodode1APR2006a1
setembro2006.
Correesdebugsepequenasalteraes
ExportaodeGIFeEncapsulatedPostScriptimagensdasjanelasdegrficosfoimelhoradafundoscinzentosindesejados
arredondarasbordasagorasotornadastransparentesemGIFsebrancoemEPS.UmaseosobreGrficosExportadores
tambmfoiadicionadoaomanual.
UmcertonmerodeanomaliasgrficascomooenredolimitaaserrepostoquandoumbotoVirareixofoialternadoforam
resolvidos.
OcomportamentoJDBCfoimelhorada:algunsbugsforamcorrigidoseagorajnopedeumaSQLnomedeusurio/
senhaduasvezes.
ContornarbugintermitenteaocarregararquivospequenosdeMySpace.
MapasdedensidadesoexportadosemformatoFITScommelhorescabealhosWCSseforcasodisso.
OSDSSJPEGURLaodeativaorecortefoiatualizadoapartirdeDR2DR4.
Umbugquecausouaprimeiralinhadeumatabelaparaserincludoerroneamenteemseleesdesubconjuntosgrficasfoi
corrigido.
Adicionadoumbotodealternnciaseletorcompensarajaneladohistograma.
Verso2.11(13deabril2006)
SphereZoom
AgoravocpodeampliaroLoteesfrico.
PLSTICO
Halgumasmelhoriasparaafuncionalidadedeplsticoedocumentao.
AlmdeTransmissoaesparaosdiversostiposdetransmissodemensagensdeplstico,hagoracorrespondente
Enviaraesquepermitemdirecionaramensagemparaapenasumnicoaplicativoouvinteselecionado.Essasaesesto
agoraativado/desativadodeacordocomsealgumouvinteplsticosadequadossoregistrados.
VocpodeagoraabrirumapequenajaneladajaneladecontroledoInteropmenuqueexibeosouvintesPLSTICO
atualmenteregistrados.Afuncionalidadedestajanelapodeserprorrogadoemversesfuturas.
QuandoTOPCATrecebeumshowObjectsmensagem,elaagoraverificaseumsubconjuntocorrespondenteexisteao
invsdesemprecriareadicionarumnovo.Seissoacontecer,eleapenasdefineatualexistente.Issopodereduzirotempo
(umpouco)sobreaproliferaodeSubconjuntosdeLinha.
AseoPLSTICOdomanualfoimelhorada.
Algumasdasimagensforamatualizadosparaincluirfuncionalidadesrelacionadascomplstico.
URLsusandooarquivo:esquemaenviadoporTOPCATem
mensagensPLSTICOagoraconformarcorretamentea

RFC1738.
MySpace
AsoluofoiintroduzidaparaproblemasdedesempenhodenavegaoMySpace.Corracom-Dmyspace.cache = truepara
acelerlocustadepreciso.
Verso2.12(21deabril2006)
Istoprincipalmenteumaversodecorreo.
AdicionadoexplodiropocolunasaomenupopupdajanelaData.
Fixbugpresentedesdev2.0,quefoi,porvezes,desenhortuloserradonumricospertodezeroemparcelas2D.Umefeito
colateralqueosmultiplicadoresexponenciaissermaisfrequentementeusadoemrtulosdoeixo(comonasversesanterioresa
v2.0).Esperemosumpoucomelhorrotulagemeixoestarpresentenasversesfuturas.
CorrigidooerroqueestavaaescreveroselementosLINKnofechadasemVOTables.
CorrigidoalgunsbugsNullPointerExceptionnaseleodecolunaseenredo2D.
CorrigidooerronarolagemparacorrigircolunanajaneladedadosquandoacolunaestselecionadanoColunasJanela.
Verso2.13(11deMaio2006)
Correesdebugsealgumaspequenasmelhorias.
ImplementosenviarereceberdePLSTICOivo :/ / votech.org / votable / highlightObjectmensagem.
Adicionadonovocsv-noheaderformatodesada.
AdicionadoinclinaoeclculoscurtosedeEstatsticaJanela.
Melhorou,emboraaindaimperfeita,retenodemetadadosdetodooquadroemVOTables.
Corrigidooerronaescritavotable-fits-hrefevotable-binary-hrefformatartabelasapartirdonavegadordearquivos.
mark.workaroundpropriedadedosistema,consulteaSeo10.2.3.
Verso2.2(7deJulho2006)
ArmazenamentoorientadasparaaColuna
Novosrecursosparapermitiroarmazenamentoorientadasparaacoluna(colfitsformato,startable.storagepoltica"de lado
")foramintroduzidos.Estespodemfornecermelhoriasdeeficinciaconsiderveis
paradeterminadastarefasaotrabalharcom

tabelasmuitograndes(eespecialmentedelargura).
Correesdebugs
Corrigidooerroquecausoualgunspontosparaserdesperdiadaemparcelasesfricas.
CordasISO8601permitemagoratemposde24:00:00comodeveriam.
Valoresunitrioscotadossoexaminadosparadeterminarostiposdedadosdecolunaprovveis.
http://127.0.0.1:2525/doc/sun253/sun253.html

194/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Outrositens
Adicionadofunesdeconversodefluxo(Jansky<>magnitude).
Verso2.21(3deAgosto2006)
NovosistemadecoordenadasAdicionadoICRSparacucoordenarasconverses.
Eliminadoalgumaslixeiraspilhafeiasmasinofensivosquepossamocorrerduranteaplotagem.
TUCDnncartesdeencabeamentoagorausados
emarquivosFITSparatransmitirUCDs(mecanismonopadro).

AdicionadoTST(TabelaTabSeparated)formatodeentradaesadademanipuladores.
Melhoriasdeeficinciadeacessoorientadaacoluna.
Melhorcapacidadederespostaaoexibirdadosdetabelaparatabelasextremamentegrandes.
Verso2.3(5Outubro2006)
Vriasmodificaesemelhorias:
RemovidologotipoStarlinkapartirdocantosuperiordireitodetodasasjanelasTOPCAT,incluindoscreenshotsna
documentao.Novoslogos(Starlink,Astrogrid,Votech,Bristol)soadicionadosemSobrejanela.
AdicionadanovaAdicionarAmostraSubconjunto,AdicionarCabeasubconjuntoeAdicionarCaudasubconjuntobotes
deferramentasutilitriasparaoJanelasubconjunto.
MySpaceacessodiretousandoivo:oumyspace:URLsagorafornecidovejanovoSeo4.2.
FunesdeconversodetempoentreAdicionadoMJDeDecimalYear.
ValoresnumricosdacolunaISO8601(porexemplo,emparcelas)soagoraporpadroDecimalAnoemvezdeJulianEpoch.
Osvaloresnumricossomuitoprximos,masDecimalAnoprovavelmentemaisquevocesperariadeformaintuitiva.
AdicionadotoHexeFromHexfunesdeconversonumrica.
Adicionado-JbandeiraparaTOPCATscriptdeinicializaoparaapassagemdebandeirasdiretamenteparaJava.
AmostraAdicionado(emoposioPopulao)AsopespadrodeclculoDesvio/desvioparaajaneladeestatsticas.
MelhoriadalistagemdefunesnoApndiceBdodocumentodousurio(subseoparacadaclassedefuno).
ApresentaomodificadadaversoHTMLdodocumentousuriousandoCSS.
Correesdebugs:
Corrigidooerro(introduzidonov2.21)quefezexibiodetabelaeadicionarcolunaslento,elargurasdecolunadotamanho
errado.
Corrigidooerro(introduzidonov2.0)queimpediuExactcorrespondeusandocolunasnonumricas.Acorrespondnciaexata
agoratambmlidacomcolunascomvalordematriz.
BugPLASTICfixoqueestavaignorandoargumentoIDdeivo :/ / votech.org / votable / loadFromURLmensagem.
Corrigidooerronaconversodecoordenadasquecausouomaucomportamentonapresenadecoordenadasdeentrada
malformados.
Corrigidooerrocomplotagemrtulosdoeixomuitograndesoumuitopequenosem3Dparcelas.
CorrigidoumpardeerrosReaesCruzadasmenores(oquenoteriaresultadosafetados).
Verso2.31(releaseStarlinkHokulei)
SadaparaMySpacepodeagorasertransmitido,seestiverrodandosobJ2SE1.5ouposterior.
OutOfMemoryErrorsInterceptdurante3Dconspirarparadarumpopupexplicativo.
Corrigidooerronoeixoverificaodeintervalo.
CorrigidooerronamanipulaodeaspassimplesnoFITSmetadadosdoarquivo.
Atribuiescolunadeconcatenaoagoramaisinteligenteparatabelasdeentradatotalmentecompatveis.
Algumasotimizaesparaarquivosmuitograndes.
AdicionadoVega<>constantesdeconversomagnitudeABparafundentesfunes.
PostScriptencapsuladoexportadodejanelasdegrficosmelhorada.Estesarquivosagoradeveimprimirquandoenviados
diretamenteparaumaimpressora,eotamanhodaimagemestagoragarantidosensataparaumapginaA4/letterretrato.
Adicionadofunestrigonomtricashiperblicas(sinh,cosh,tanheinversas)Mathsclasse(sinh,cosh,tanheinversas).
Adicionadoclculosdedistnciaemcosmologiaclassedistncias.
AtualizaesGrficas
Painisdoseletordecolunaemjanelasdegrficosestoagoraemscrollers.
Verso3.0(05dejulhode2007)
Estaversoincluimelhoriasimportantesdevisualizaoealgumasmudanasnainterfacedousurioplotagem:
Asbarrasdeerro
Plotagemcompletadebarrassimtricaseassimtricasdeerro(emiraecaixaseelipses,...)em1,2e3parcelasdimensionaisagora
fornecidoverAnexoA5.1.3.
Auxiliares(cor)eixos
Agorapossvelmodificaracordospontostraadosdeacordocomosvaloresemumoumaiseixosadicionaisaosespaciais
vejaApndiceA.5.1.5.
HistogramadePonderao
OsHistogramaedensidadeMapajanelastmagoraaopodeponderaoaquantidaderepresentada,demodoqueosvalores
binnedsosomasemvezdeapenasconta.
DensidadeMapScaleCor
Quandoomapadedensidadeestnomodoindexado(noRGB)agoravocpodeselecionarapartirdevriosmapasdecores
pararepresentarocupaobin.Issofazcomqueasdiferenasdenvelmaisfcildever.
http://127.0.0.1:2525/doc/sun253/sun253.html

195/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Lotejanelarearranjo
Botesqueafetamaseleodedadosagorasodispostosemsuaprpriabarradeferramentasabaixodaparcela(Apndice
A.5.1.1).Otamanhodareadecontroledelotepodemserredimensionadosmanualmenteparadarmaisespaoparaatramaem
si,usandoajaneladeSplit( boto),quetilemtelaspequenas.
Melhoriaslinguagemdeexpresso
Parmetrosdatabelapodemagoraserreferenciadonasexpressesusandoparam $notao(Seo7.3),eambasascolunase
parmetrospodeserreferenciadoporUCDusandoUCD $notao(Seo7.1).
EstatsticaseHistogramaresultadoreuso
AsestatsticasehistogramajanelasagoraambosfornecemSalvareImportaraes,quelevamosdadosapresentadosnajanelae
permitemqueelesejasalvoemumarquivoouimportadosdiretamentenoTOPCATcomoumanovatabela.
Cartesianozoom3D
Agorapossvelparaaumentarogrfico3DparaocentrodamesmaformacomooLoteesfrico.
GAVOMilniodilogocargadebancodedadosdesimulao
AgoravocpodeconsultardiretamenteobancodedadosGAVOMilnioservio(ApndiceA.6.10).GraasGerardLemson
deGAVOparacontribuircomcdigoparaisso.
MelhoriassubconjuntoRow
Nomesdesubconjuntodelinhaagorapodemserreutilizados,equandolheforperguntadoparaselecionarumnovonomede
subconjuntoquevocestautorizadoaescolherumdalistadosjexistentes.Quandoumaseleodelinharecebidodeoutro
aplicativoviaPLASTIConomesubconjunto(onomedoaplicativodeenvio)reutilizadodestaforma.Istoajudaamantero
nmerodesubconjuntossobcontrole.
Recevingumsubconjuntofileiradoplstico,destaforma,ealgumasoutrasaes,agorafazercomqueosubconjuntoaser
mostradodeimediato(eatualizado,senecessrio)emquaisquerparcelasjexistentes,oquetornaestetipodeinteraoPLASTIC
maisgil.
Otamanhodecadasubconjunto,etambmaporcentagemcorrespondentedatabelaquerepresenta,agoracalculado
automaticamenteeexibidonajaneladesubconjunto.Ovelhocomportamentodeapenascalculartamanhosapedidopodeser
reintegradousandoaslinhasAutoCount( )doitemdemenu,senecessrio.
FixVerticalemparcelas3D
Aficaremp( boto)fornecidonoscartesianaseesfricasparcelas3DquelhepermitemmanteroeixoZ/plonorte
verticalduranterotaes.
ClculoQuantile
Ajaneladeestatsticaspodemagoracalcularquantis(mediana,quartis,.001,.01,.99e.999),apedido.
Pequenasalteraesecorreesdebugs
JPEGePNGagoratraarexportaodisponvelapartirdetodasasjanelasgrficas.
Melhoriadedesempenhodramticoporplotagemdepixeltransparenteemparcelas3Demalgumasplataformas.
AdicionadoespecficadelocalidadeformatDecimalLocal ()funesnaclasseFormatos.
AdicionadofluxToLuminosityeluminosityToFluxfunesnaclassefundentes.
Melhoriadadeduplicaodenomesdecolunasaojuntartabelas.
Terrenosem3Dagorarelatarcorretamenteonmerodepontosvisveis.
MelhoriadamensagemdeerroparaarquivosCSVquebrados.
Melhorouorelatriodeerros,napresenadeumaJVMdeficiente(talcomoGNUgcj).
TrabalhouemtornodeumbugMacOSXJavaquecausouexibiomesaparairengraadoquandocolunasforam
eliminados.
CorrigidoerronasadadoFITStabelaTNULL ncartesdeencabeamentoescrevloscomovaloresnoseqncia
numrica.
CorrigidoumnmerodebugsemresponderamensagensPLSTICO(threading,faltaderesposta).
Terrenosem3Dagoratraarsmbolosparatodosossubconjuntosnoapenasum,comoparaasparcelas2D.
Corrigidooerroqueimpediuosvaloresdosparmetrosnostringdesertransferido.
Verso3,01(releaseStarlinkPuana)
BarrasdeerroAdicionadotampadoporsetas.
CorrigidooerroquecausoubarrasdeerronalegendaparadesenharcomacorerradanasadaEPS.
Verso3.1(29Agostode2007)
Agoravocpodeanotarpontostraadosutilizandortulosdetextoemgrficosdedisperso2De3Duseortulosorteio(
boto)paraatribuirumacolunacontendotextodortulo.
ControleeixoRadialemesferatramaagoranovisvelporpadrovocprecisaclicarascoordenadasradiais(

boto)na

barradeferramentasconjuntodedadosparahabilitlo.
NewMostrarlegenda( boto)emjanelasdeenredodeterminaseumalendaserexibidoaoladodoenredo.
NovaEsconderLendacheckboxemjanelasdoeditordeestiloquepermiteentradassubconjuntodalegendaparaserexcludoda
lendaapresentadaindividualmente.
Verso3.2(28Janeiro2008)
Melhoriasdefuncionalidade
Consideravelmentemelhoradoexibiodemetadadosportabelanajaneladeparmetros.Agorapossvelvisualizaros
http://127.0.0.1:2525/doc/sun253/sun253.html

196/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

valoresdosparmetrosdelongooudevriaslinhas.
FITScartesdecabealhonatabelaHDUestoagoraler(masnoescrita)comoparmetrosdatabela.
Adicionarratozoomrodasparaterrenosem3D.
AdicionarmodoWriteseletorparaSQLDilogodesada,parapermitiraanexaoesoltaropcionalantesdecriardenova
tabelanobancodedados.
AgoraTOPCATirregistrarautomaticamentecomumhubPLASTICqualquermomentoapessoasetornadisponvelo
hubnotemqueestaremexecuoquandoTOPCATcomea.Comocorrollary,sevoccomearumhubinternoou
externodoInteropmenu,vocnoprecisamaischamarexplicitamenteoRegisterartigodepois.
Adicione-exthubbandeira,queseiniciaumnovohubPLASTICexterno.
JaneladeativaopermiteaseleodediferentesvisualizadoresdeimagemparaVerURLcomoImagemopo.Noteque
estenoactualmenteasseguradapelaImagemrecortedeexibioopooquepodeserabordadonofuturo.
Correesdebugsepequenasmelhorias
Adicionado-palafitasbandeiradeconveninciaparaquevocpossafacilmenteexecutarSTILTSdeumainstalao
TOPCAT.
CorrigirerrodeclculoemfluxToLuminosityfuno.
Corrigiralgunsbugsrelacionadoscomrtulodetextodeplotagem.
Asbarrasdeerroparavaloreszero/negativosagorasocorretamenteestendidoparaoeixo(aoinvsdeseromitido)em
parcelas2Dcomeixoslogartmicas.
Modificadootamanhodealgumasjanelasagorapublicajanelasumpoucomenores,seumatelapequenaestemuso.
Aspropriedadesdosistemaespecificadosexplicitamentenalinhadecomandoagoratomarprecednciasobreosda.
starjava.propertiesarquivo.
EspaosincorporadosnoformatoASCIInomesdecolunasdatabeladesadasoagorasubstitudosporsublinhados,oque
impedeaescrevertabelasASCIIquenopodemserlidos.
RebaixadodeAVISOaINFOregistrarmensagenssobreo(extremamentecomum)errodesintaxeVOTabledeomitirum
elementoCAMPO/PARAMtipo de dadosdoatributo.
Comearumhubexternoagoratrabalhadeformamaisconfivel.
Verso3.3(19Agostode2008)
Melhoriasdefuncionalidade:
OponormalizaoAdicionado(

)ajaneladohistograma.

Emoverplotsusandotabelasdiferentes,umatentativafeitaagoraausarasmesmascolunas/expressesparavaloresdo
eixocomoparaamesaprincipal.Istopodeserconvenientequandooverplottingdadosdevriastabelassimilares.
FITSarquivoscomcolunasusandomatrizesdecomprimentovarivel('P'oudescritoresdetipodedados'Q')agorapodeser
lido(emmododeacessoaleatrio,ouseja,apartirdeumFITSdescompactadosarquivonodisco,apenas).
Olut.filespropriedadedosistemaagorapodeserusadoparaconfigurarosmapasdecorespersonalizadasparaeixos
auxiliaresemapasdedensidadevejaSeo10.2.3.
NovaclasseArraysadicionadosfunesalgbricas.
HistogramaoffsetcontroleagoratrabalhaparaaescalalogartmicaX,bemcomolinear.
Correesdebugseoutrasalteraes:
Melhoriasdeeficincia(~25%?TantotempodeCPUeusodememria)paracuReaesCruzadasbaseadoem
HEALPix.GraasaNikolayKouropatkinenoFermilabparaumanovaversodoPixToolsbibliotecaqueproporcionou
essamelhoria(estaversotambmfixaamenorHEALPixbug).
IdentificaodecampoSexagesimalparaarquivosdeentradaASCIItornousemaisindulgenteagoraaceitaminutosou
segundosiguaisa60semumerrodesintaxe.
Corrigidoumbugdesempenhoparcorrespondente(maislentoseastabelasnoforamdadasnaordemcerta)introduzidono
v1.4.
OdiscobandeiraagorahonradoaocarregartabelasdoJDBC,oquetornapossvelaentradademaioresconjuntosde
dadosdeRDBMS.
CorrigidooproblemaquecausouosistemadegrficosparatravaroufalharquandodesenhoDotapontoemlinhasde
enredo2Dparaospontosdeumcaminhomuitolongoparaforadatela.
Corrigidooerroquecausouplotagemincorretadehistogramascumulativoscompequenospesos.
LigeiramodificaobardeestilopicodedesenhonoHistograma,agoratemaaparnciamaisarrumadaquandoutilizar
linhastracejadas.
Interno
Houveextensareorgamisationinternadasclassesdeplotagem.Nodevehaverefeitosvisveisaousuriodeste,masporfavor
relatarqualquercoisaquepareceestarsecomportandomal.
Verso3.4(23Dezembro2008)
SAMP
TOPCATagorausaSAMPcomoumaalternativa(depreferncia)aoplsticoparaainteroperabilidadeentreasferramentas.
SAMPagorageralmenteopadroocomportamentoantigopodeserrecuperadausandooplstico-flagdelinhadecomando.
Emboragrandepartedocomportamentodemensagenscontinuaomesmo,vriasmelhoriasparaoGUIacompanharessa
mudana:
NovoPaineldeSAMPnaparteinferiordajaneladecontroledestatusresumindo
NovaEstadoSAMP( botobarradeferramentas)najaneladecontrole,queaparecenovajanelaSAMP
http://127.0.0.1:2525/doc/sun253/sun253.html

197/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

OutraspequenasrerrangementsdebotesdabarradeferramentaseitensdemenunajaneladeControle
TransmissoRowcheckboxadicionadopertoAoAtivaonajaneladecontrole
Paramaisdiscusso,verSeo9.
AcessoaoRegistro
AcessoaoregistrodoTOPCATfinalmentefoiatualizadoparausarVOResource1,03eoRegistrodeInterface1,01(eleestava
usandomuitodeprotocolosdedata).IstosignificaqueabuscadodilogoCone(bemcomoosSIAPeRegistrodilogossemi
suportado)agoravaipegarmuitomaisatualizadoconjuntodeservios.Almdisso,vocpodeescolheroseuprprioserviode
registro,easpesquisasderegistronessesdilogosagoraapresentampesquisasdepalavraschave,emvezdepegartodosos
servioscone/SIAPconhecidos.VejaApndiceA.9.2.
Outrasmelhorias
ColunasdatabelaeparmetrospodemagoraserreferenciadoporuTypeusando$sintaxeutypedeumaformasemelhante
aousoUCDsvejaSeo7.1.
Quandoumnovosubconjuntocriadoporqualquermtodo,ousurioagorapodeoptarportransmitiloparaoutros
aplicativosusandoSAMP/plsticocomoumaalternativaparaaadiodeumnovosubgrupoparalistasubconjuntoda
tabela.
AdicionaritensAjudademenuparavisualizarajudaparaonavegadorpadroemvezdenavegadordeajudado
TOPCAT.
AdicionarumaopodeformatodesadaenredoparaescreverPostScriptcompactado.
-Versocomandobandeiralinhaagorarelatarevisosubverso,bemcomoonmerodaversosimblica.
Correesdebugs
Corrigidooerrohistograma(enredoembranco)paravalorespequenosquandoseutilizaeixoYlogartmica.
Correodeerrostacktraceemparcelas3Dquandonohdadosdisponveis.
OSIMBADresolvedordenomesfixonajaneladepesquisacone(eleestavausandoumformatodeservioapoiadono
mais).
Verso3.41(27deMaro2009)
NotaSybaseASEfunciona(documentaoedioapenas)
CorrigidooerroquecausouconsultasSIAPafalharcadavez.
DilogocargaSIAPagoratemcapacidadederesoluodenomes.
AdicionadodilogocargaSSAP.Afuncionalidadebsicaapenas.
AdicionadodocumentaoanteriormenteunadvertiseddilogoscargaSIAP/SSAP.
Corrigidooerroquecausouconsultasderegistro(Cone,SIA,SSA)afalharparaJava1.6.
CorrigidooerroquecausouembrancocampoContatonosresultadosdaconsultaderegistro.
Agorapodeconsultarregistroparamaisserviosderegistro.
ServeparamelhoriasleituravalorBINTABLETZero/TSCAL:
ColunascomvaloresinteirosTZeroagoralercomointeirosemvezdevaloresdepontoflutuantesemprequepossvel.Isto
incluilongsnoassinados("K"),queforamanteriormenterepresentadoscomodobracomprecisoperdido.Longsno
assinados,quesomuitograndesnoentanto(>263 )solidoscomonulos.
Colunascomvalordebytepodeagoraserescritaporfits-bsicosmanipuladordesadacomovaloresdebytesassinados
(TForm=B,TZero=128),emvezdecalesassinados(TForm=I).
Testesmaisabrangentes.
Corrigidooerronovalordeclculoescaladovaloresduplas('D').
Corrigidooerronovalordedigitaoparaflutuaremescala('E')arrays.
AdicionadoseletordecolunadocumentaoApndiceA.1.4.
Corrigirerroaodecodificararquivo:URLsdotipocontendo% xxfugas.
Correodeerrorelatandoerronapesquisaderegistro.
NomedoaplicativoRelatrioeversonocabealhoUserAgentdesolicitaesHTTPdesada.
Forneceraliases-siae-ssapara-SIAPe-SSAPsinalizadoresdelinhadecomando.
FixconsultasSIAeSSAparaevitaranotaoexponencialnosparmetrosnohatualmentenenhumanormasobre
representaesnumricas,masissoevitaproblemascomalgunsservidores.
AConvenoSubstringmatrizdecomprimentofixoparaArrays(TFORMnn = RAW)agoraentendidaporFITStabelasbinrias.
Fixa-noservbandeira.
Fixa,demodoqueatentativadeexecutarserviosemcondiesdesfavorveis
defirewallnocausaoarranqueparapendurar.

SAMPerrosmenoresfixo(JSAMPatualizadopara0,31).
Verso3.42(17deJulho2009)
JanelasdeplotagempermitemagoraumttulotramaaserdefinidoapartirdoConfigureAxesettulodajanela(Apndice
A.5.1.2).
Carregandomensagemagoraexibidonalistadatabelajaneladecontrolequandoatabelaestasercarregadoapartirdeplstico
ouSAMP,ouduranteainicializao.
SAMPentradaesadaload.tablemensagensagorausaronomedoparmetro,oquedumamelhorchancedeumnomelegvel
tilestarligadoatabelastransmissveis.
DelimitadoressexagesimaispodemagoraserespaoscomoalternativaaosdoispontosnoCone/SSA/SIAdilogosdecarga.
DilogocargaGAVOactualizadaemconsonnciacomoserviodebancodedadosmodificados.
ContornarmarcaJ2SE/reseterroaocarregaratabeladiretodeURL.
ProduzirnuloaoinvsderesultadossemsentidodecucoordenarconversescomlatitudesUnphysical.
Produzirnuloaoinvsderesultadosduvidososdeconversessexagesimaiscommin/segforadointervalo.
ScriptdeinicializaomelhoradaparaproporcionaralgumasmelhoriascosmticasparausuriosdeMac:oconeTOPCAT
mostradonobancodosrusemvezdoconeJavagenrico,eonomedoaplicativodomenudefinidocomo"TOPCAT"aoinvs

http://127.0.0.1:2525/doc/sun253/sun253.html

198/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

donomedaclasse.Observeestesnotmefeitoseestiverrodandodiretamenteusandojava-jar.
PrazoSTILTSusandoTopcat-palafitasdofrascoautnomoagorapodereportarcorretamentestarjavareviso.
Verso3.43(31Julho2009)
Fixosdoisbugsrelacionadosparaarrastaresoltar:falhaintermitentedequeda(sMac?)Eaplicaoacidenteaofazerumaqueda
queno.
Verso3.5(6deNovembro2009)
Hvriasmelhoriasnestaverso,muitosdelesparafazercommelhorfuncionalidadeeusabilidadeparaocarregamentoouaaquisio
dedados,tantodearquivoslocaisedevriosserviosObservatrioVirtual.
Cargamultitabelas
TOPCATvaiagoracarregarvriastabelasapartirdeumnicoarquivo,sevriastabelasestopresentes,emvezdeapenaso
primeiro.IstoaplicaseavriosextensoFITSquecontmmaisdoqueumatabeladeHDU,eaosdocumentosVOTableque
contmmaisdoqueumelementoTABELA.ElaafetaodilogoFileStore,nomeararquivosnalinhadecomando,eonovo
dilogocargavizir.
Nasversesanteriores,quandovocselecionouummultiextensoFITSarquivoouVOTabledeumdosdilogosdecargaouna
linhadecomando,apenasoprimeiroquadroconstantedoqueiriasercarregado,equaisqueroutrosforamsimplesmente
ignorados.Taisarquivos,muitasvezescontmapenasumanicatabela,masnemsempre.Agora,sevriastabelasestopresentes
noarquivorecipiente,cadaumvaiaparecercomoumanovatabelanalistadetabelas.Outrosformatosdearquivodatabelano
soatualmenteafetadas,umavezquenohnenhummecanismoparaoarmazenamentodevriastabelas,digamos,emum
arquivoCSV.
VriasCone,SIAeSSApesquisas
Nasversesanteriores,erapossvelusaroObservatrioVirtualConePesquisa,SimpleAcessoImagemesimplesserviosde
acessoespectralparalocalizarregistrosdecatlogo,imagenseespectros,respectivamente,emumnico(emformadecone)regio
docu,comaposioeoraioentroumanualmente.Nestaversopossvelexecutaressaconsultaparacadalinhadeumatabela
deentrada,comaposioeoraioobtidoapartirdedadosdetabelaemcolunasapropriadas.Issod,efetivamente,umaassociao
entreumatabelalocaleumremotoexpostoporumainterfaceVOpesquisvelconelike.
Dilogocargavizir
UmnovodilogocargavizirfoiintroduzidoparafazerconsultasdiretamenteaoserviovizirdoCDS.GraasThomasBoch
paracontribuircomcdigoparaisso.
MenuVO
UmnovomenuchamadoVO(porObservatrioVirtual)foiadicionadoJaneladoControle.EsteatualmentecontmCone
simplesemltipla,consultasSIAeSSAeosdilogosdecarregamentoespecficosdeservios,nomeadamenteasviziredo
Milnio.TodasessascaractersticastambmestodisponveisemoutroslugaresdoGUI,masosnovosgruposdemenujuntos
funcionalidaderelacionadacomoVOporconvenincia.
Posicionaismelhoriasdilogopesquisa
UmasriedemelhoriasforamfeitasparaosdilogosConePesquisa,SIAeSSAestesseaplicatantoaosvelhosnicaregio
dilogosdebuscaeasnovaspesquisasmultiregio.
AURLdoservioagorapodeserintroduzido(ex.cut'n'pasted)diretamentecomoumaalternativaparaaobtenodeuma
pesquisaderegistro.Istopermiteautilizaodeserviosnoregistradas,bemcomotornandomaisfcilparaselecionara
URLdoservioparacolaremoutrolugar.
Atabeladerecursosretornadosdapesquisaderegistrojpodeserclassificadoporcontedodacoluna,clicandono
cabealhodacolunaselecionada.
Enquantoprocuraoregistro,algumaindicaodonmerodeserviosencontradoatagoraexibido.
Pesquisandooregistromenosprovvelderesultaremumerrodefaltadememria.
O(nomuitotil,epotencialmenteconfuso)registroAtualizaobotofoiretiradosuafunoestdisponvelapenasa
partirdoRegistrodemenuemseulugar.
Ometadadoscontidosnastabelasdevoltardeumabuscabemsucedidamelhorada.
OsdilogosSIAeSSAagoratmumseletorparaescolheroformatodeimagem/espectrodesejado.
OsdilogosSIAeSSAagorajnoexigementradaexplcitadeumparmetrodetamanho(estesprotocolosdefinemo
comportamentopadroparaquandonenhumtamanhodiferentedezerofoiespecificado).
ASIAeSSAagoraconsultarautomaticamenteoregistroparatodososserviosadequadosquandoexibidopelaprimeira
vez.Esseumcomportamentosensatonomomento,umavezqueexistenomomentodeescreverumnmerorazovel
delas.Apesquisadirigidapodeserdadaemvezporopodousurio.
AjanelaConeSearchfornecemelhoresinstruessobreousoquandoexibidapelaprimeiravez.
UmanovaseoSeo6foiadicionadaaomanualcomumaintroduoaosconceitosdeacessoadadosVO,eumanovaseo
apndiceApndiceA.9descreveasvriasjanelasdeconsultamltiplasinglee.
Armazenamentodemudanapoltica
AmaneiraqueaslojasTOPCATgrandesmesasmudou.Nasversesanteriores,osdadosdatabelafoirealizadoemmemria(o
padrodaPolticadeArmazenamentofoi"memria"))amenosqueodiscobandeirafoiespecificada(parausaro"disco de
polticadearmazenamento"),casoemqueelefoiarmazenadoemarquivostemporriosemdisco.Sevocnocolocoudiscona
linhadecomando,eracomumficarsemmemriaaotrabalharcomgrandesmesas.
Agora,apolticadearmazenamentopadro"adaptvel".Issosignificaquerelativamentepequenasmesassomantidosna
memria,easmaioressoarmazenadosemarquivostemporrios.Oefeitodeveserquenamaioriadasvezes,vocnoprecisa
especificarnenhumaopoespecial,evocpodetrabalharcomtabelaspequenasougrandes,semficarsemmemria.Utilizandodiscoaindapermitido,epodeajudaremcircunstnciasincomuns.Faltadememriaaindaumapossibilidade,masdeveser
muitomenoscomum.
http://127.0.0.1:2525/doc/sun253/sun253.html

199/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Ocomportamentoantigopodeserrestauradousandoanovamemriaflagdelinhadecomando.
Asnicasdiferenasquevocobservadessamudanadeveserbons,noentanto,umpoucoexperimental.Entreemcontatocom
oautor,sevocsuspeitarqueintroduziuquaisquerproblemas.
MelhoriasrelacionadascomoSAMP
EspectrodeexibioaodeativaoagorausaSAMPouplsticoparaexibiremumvisualizadordeespectroexterno
adequadamentecompatvel.OcomportamentoantigoeraparaexibiroespectrodeumajanelaSPLATinterna,masno
funcionoumuitobem.
AbibliotecaJSAMPfoiatualizadoparav1.0,dandoalgumasmudanasdecomportamentoSAMP,melhoriasecorrees
debugs.ControledecoisascomoportadoservidorTOPCATeendpointservidorhostnameagorasoconfigurveis
usando

jsamp. * propriedadesdosistema.
A-jsampflagdelinhadecomandofoiadicionadoporconveninciaparaqueoarquivojarTOPCATpodeserfacilmente
utilizadocomoumkitdeferramentasJSAMP.
AprimoramentosrelacionadosVOTable
NamespacingdedocumentosVOTablefezmaisinteligentes,econfigurvelusandoovotable.namespacingpropriedade
dosistema.
VOTable1,2suportado.
OVOTable1,2xtypeatributousadoagoraparatentaridentificarcolunascontendoISO8601formatardatas,oque
permitequeelessejamtratadoscomovaloresnumricosparaplotagemetc
Comodescritoacima,aocarregarumdocumentoVOTablequecontmvrioselementosdatabela,todasastabelascontidas
socarregadosseparadamenteemTOPCATaoinvsdeapenasoprimeiro,queoquecostumavaacontecer.
Carregandomudanas
AJaneladecargaagoratembotesdabarradeferramentas,bemcomoositensnaDataSourcesMenudeacessomais
convenienteparaosvriosdilogosdecarga.
Asbandeirasdelinhadecomandocorrespondentesparacarregardilogos(de rvores,em arquivo,-SQL,de cone,Gavo,-Registro,-sia,-ssa)foramretiradosdousoelesprovavelmentenoeramamplamenteutilizados,esode
utilidademnimacomosnovosbotesdabarradeferramentasdajaneladecarga.
EnquantoumamesaestacarregarumaentradaagoravisvelnalistadetabelaJanelaControle.Anteriormentenoera
sempreclaroseumacargalentaestavaemandamentoouno.
Correesdebugsepequenasmelhorias
Hmelhorias(epossivelmentenovosproblemas)nombitododilogodecarregamento.Umitemqueumacargano
menosvezesfechaodilogo.
SadadatabelaHTMLagoraHTML4.01porpadro(incluiTHEADeTBODYmarcas).
ExisteumasoluoparadeclaraesdetipotruncadoilegalmenteemtabelasIPAC.
XML,incluindoVOTable,aproduotratadacommaiscuidadocorrigircodificaodesadaVOTableserUTF8,e
garantirquenohajacaracteresXMLilegaissoescritos.
ErrosdeplotagemfixoscausoucorrupoGUIintermitente(porexemplo,faltandobotesdabarradeferramentas),
especialmentenoMacOS.
Bugcorrigidoemreaocruzadadesada:asentradasquedeveriamtersidonulosvezeseramescritoscomononulos
(normalmentegrandesnmerosnegativos)naFITSeemnoTableDatasadaVOTable.Esteclulasafetadasemcaso
contrriocolunasnoanulveis
ondetodaalinhaestavaausente.Ocomportamentoanteriornosusceptveldetersido

confundidocomresultadosconcretos.
* analisarcorda>funesdeconversonumricaagoralidarcomesquerdaoudireitaespaosembranco.
AlistadeexemplosdebuscasnodilogocargaGAVOfoiprorrogadoparacoincidircomosdesuainterfaceweb.
Corrigidoumbugquepoderiaobscurasobrarascircunstnciascausartruncamentodecordascomlder/espaosembranco
lerapartirdearquivosemformatotexto.
Verso3.51(21dedezembro2009)
Estaversopossuiumacaractersticanovaesignificativa:
JanelasdeplotagemagorapodeexportarparaPDF,bemcomooutrosformatos.
Foraisso,estprincipalmenteodesempenhoemelhoriasdeusabilidadeecorrees:
Corrigidoumbugquecausavaumerroaotentarcarregarvriosarquivosapartirdalinhadecomando.
Melhoraradocumentaodejanelasem3D,incluindoasopesdezoom.
Corrigidoumbugquecausavaumerroaotentarfazercone/searchSIA/SSAapartirfornecidosdirectamenteURLservio.
Melhorarrelatriosdemulticone(etc)janeladeerro.
Agoravocpodecortarecolarapartirdovisordocoeficientedecorrelaolinearno2deditordeestilodeplotagem.
FasterexibiodajaneladecargaeopesdemenuVO.
Corrigidooerrodeinternacionalizaoquepoderiacausarconepesquisasetcfalharemlocalidadesqueusam","porumponto
decimal.
Pesquisasderegistrosoagoramaisrpidoemenospropensosaficarsemmemria.OperaesbaseadasemRegistrosearch
(buscadilogosconeetc)agoracorremnaconfiguraotopcatlite,bemcomotopcatcheio.
Agoraadvertesobrerecursosnoativosdevolvidosapartirdepesquisasderegistro(quenodeveacontecer).
Melhoriadautilidadedemensagensdeerronomulticoneetcjanelas.
MelhoriasdedesempenhoduranteocarregamentodedocumentosVOTablequecontmmuitastabelaspequenas,tantoemgerale,
http://127.0.0.1:2525/doc/sun253/sun253.html

200/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

nocasoespecialdosresultadosSIA/SSA.Issofazumagrandediferenaemalgunscasos.
Verso3.52(24Maro2010)
Adicionarmonitordememriaindicadornajaneladecontrole.
Desempenhoeescalabilidademelhoriasconsiderveis
paraosalgoritmosReaesCruzadas.Durantevriosregimescomuns,

usandoasconfiguraespadro,ousodememriafoireduzidoporumfatordecercade5,etempodeCPUreduzidoporumfator
decercade3.
Adicionarcontrolesdeajusteopcionais(parmetrosdeajusteecompletadeperfil)paraasjanelasReaesCruzadas.A
experimentaocomestespodemlevaramelhoriassignificativasdedesempenhoparadeterminadosjogos.
Corrigidoumbugcrossmatcheleestavadandoapossibilidadedesubtima"MelhorSMatch"atribuiesjogoquandopar
correspondenteemcamposlotados.Resultadoscrossmatchpode,assim,variarentreasversesanterioreseumpresente.Ambos
sorazoveis,masocomportamentomaisrecentemaiscorreto.Emcamposnolotados,nodevehavermudana.
Adicionenovasfunesparamatrizes:matrizfunesparaaconstruodematrizesenovasfunesdeagregaomedianae
quantis.
AdicionadoVerbosityseletornajanelamulticone.
Melhorouoregistrodepesquisasderegistro.
AjustadoamaneiraqueostiposdedadossolidosapartirdebancosdedadosJDBC.Data,HoraecolunasdotipoTimestamp
agoraseroconvertidosparastringsquesignificaqueelespodemserescritosparaamaioriadosformatosdesada(anteseles
foramomitidostabelasdesada).
DocumentaoJanelaJogoestendidoeumtantoreorganizado(elesagoratmsuaprpriasubseoapndice).
conesMacOSmelhorado:graasaSimonMurphy(ANU)paraestacontribuio.
Ogerenciamentodememriamaisajustadodefault(Adaptive)polticadearmazenamentoagorausaalocaodireta(=malloc
())parabuffersdetamanhointermedirioparaevitarafaltadeespaodepilhajava.
MelhoriadedesempenhoadicionalparadocumentosVOTablecommuitastabelas.
FixbugnocdigoparamanipularmuitograndemapeadoarquivosFITS.Estefoiprovocandoerrosdeleiturafatalemalguns
casos.
CorrigirproblemanoenviodealgumasmensagensSAMP(reutilizaointildeetiquetasdemensagem).
Corrigidopequenoerroquandoumdiretriononavegadordearquivosfoideletadoenquantovisvel.
Fixmenorbugrolagememtabelasecolunasjanelas.
Fixhistogramasave/exportbug:atabelaexportadaagoratemosmesmoslimitesXcomoohistogramaexibidoatualmente.
RetireaplicaoSPLATincorporado.SPLATanteriormentepodiamserusados
emalgumascircunstncias,paraexibioem

JVMdeespectros,masessafacilidadenofuncionoubemefoipresumivelmentepoucoutilizado.Vocaindapodeverespectros,
configurandoumaaodeativaoparafalarcomumvisualizadordeespectroexterno(SPLAToualgumaoutraescolha)via
SAMPouplstico.
RetireafuncionalidadedoservidorSOAP.Estefoipreteridodesdev2.1.OcontroleexternomelhortratadasusandoSAMP(ou
plstico).Sealgumperdeessafuncionalidade,entreemcontatoeeuvouconsiderarumaalternativasabosemelhante,mas
menos.
Verso3.6(6deagostode2010)
Estaversocontmalgumasnovasfuncionalidadesemelhoriasdeusabilidade,eumasriedecorreesdebugs.
Carregar/SalvarmelhoriasDilogo:
Humnovonavegadordosistemaopoaocarregaresalvar.Issofazessencialmentemesmotrabalhoqueovelho
navegadorFileStore(aindadisponveis),aseleodeumarquivoparacarregarousalvar,maseleusaainterfacegrfica
padrodosistemaparafazlo.ParausuriosdeMaceWindows,issopodeapresentarumainterfacemaisfamiliare
funcionalparaosistemadearquivos(parausuriosdeLinux,provavelmentenoumamelhoria).Ambasasopesesto
disponveis,assimvocpodeescolheroquevocpreferir.
Agoravocpodesalvarvriasmesasaomesmotempo.AjanelaSalvaragoraoferecetrsmaneirasdesalvar:tabelaatual,
vriastabelasedesesso.TabelaatualsalvaaTabelaaparenteatualcomoantes.TabelaMultiplesalvaalgumasoutodas
astabelasaparentescarregadosemumarquivocontainer(tipicamenteMultiExtensionFITSoumultimesaVOTable).
Sessosalvaalgumasoutodasastabelastambm,masalmdisso,economizamuitosaspectosdoestadoTOPCAT,como
subconjuntosdatabela,aordemdeclassificao,colunasescondidasetc
Outrasmelhoriassignificativas:
FinalmentevocpodeapagarerenomearsubconjuntosdelinhanoJanelasubconjunto!Desculpasquelesquejforam
pedindoqueissotenhalevadotantotempoparaimplementar.
HnovasaesnajaneladecontrolemenuArquivoparaalteraraordemdastabelascarregadasnalistadetabela(movlos
paracimaeparabaixo).VocpodeusarteclasALTup/downafazeramesmacoisa.Istopodesertilemconjuntocomo/
multitablenovasessosalvarfacilidade.
ItensdemetadadosuTypesoagoravisveisnasjanelasdeparmetroseColuna.
AbibliotecaJSAMPfoiatualizadoparaaverso1.1.Issosignificaqueocentrovaiaparecerna"bandejadosistema",
semprequepossvel(quandousandojava1.6+,equandoseusaumgerenciadordeexibioadequado).Eletambm
reconheceavariveldeambienteSAMP_HUBparalocaisdehubnopadro.
Humpardemelhoriasnodilogocargavizir:temopesparaexibirsubtabelasdentrodecatlogoseparaincluirou
excluircatlogosobsoletos.
Pequenasmelhorias:
OquadroatualjpodeserdescartadoporbateraExcluirchavenalistadatabelaJanelaControle.
SDSSDownloadsrecorteatualizadosparaDR7(eraDR4).
Otipodecolunanooficial"longo"reconhecidaemformatartabelasIPAC.
UmavisodeeficinciaagoraemitidaparagrandesarquivosFITScompactados.
http://127.0.0.1:2525/doc/sun253/sun253.html

201/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Contagensdelinhasdeformatosoexibidoscomseparadoresdegrupo(porexemplo,milharesseparadosporvrgulas)em
algunslugaresparamelhorlegibilidade.
Correesparabugseseusinconvenientes:
Osvaloresdosparmetrosdemesaemexpressesalgbricasagoraavaliaroseuvaloratual,emvezdovalorquandoa
expressofoiinserida.
TabelasemTOPCATagoratmcpiasprivadasdecolunaemetadadosdatabela.Istosignificaqueamudanadeumnome
decolunaouparmetroemumatabelanoafetaroutrastabelas.Tambmdeveevitarumbugrelacionadoquepermitiuque
osttulosdascolunasnonavegadordamesaparasairdaetapacomosdajanelacolunaseemoutroslugares.
OrecebimentodeumSAMPtable.highlight.rowmensagemnovaimaiscausarumamensagemsemelhanteaser
enviadodevolta(edamesmaformaparaoplsticoivo :/ / votech.org / votable / highlightObjectmensagem).
Ocomportamentoanterioreraumefeitocolateralindesejadoimplementaoque,porvezes,podecausarproblemasna
interaocomoutrasferramentas.
CorrigidooerronaFITSplussadametadados(parmetrosdatabelaforamseperder).
Comportamentomelhor(advertir+failover)aotentarlerarquivosgrandesnosistemaoperacionalde32bitouJVM.
Refernciasbibliogrficascorrigidonofundentesdocumentaodaclassedeconverso(graasaMattiaVaccari).
Corrigirproblemasdeusodememria(arquivosdesadadegrficosdesnecessariamentegrandes,possveiserrosde
memria)paragrficosdedensidadecomgrandestamanhosdepixel.
CorrigidooerronoarquivoCSVdeanlisequepoderiaignorarlinhadecabealhoemausnciadecolunasnonumricas.
CorrigiralgunspequenosbugscomCanceleaoperaoduranteamesasalvar.
ReintegrarbotesdeajudadabarradeferramentasSalvarJanela(erroneamenteremovidodesdeaverso2.0).
Certifiquesedequeacarganodetabelasemlinhasrelatacomotalaoinvsdefalharsilenciosamente.
Carregandotabelas,digitandooseunomediretamentenajaneladecargaagoracarregavriastabelassepresentenoapenas
oprimeiro,emcomumcomamaioriadosoutrostiposdedilogodecarga.
AtualizadosbibliotecaPixToolsHEALPixparaaverso2010/02/09.Issocorrigeumbugquepoderia,teoricamente,causar
resultadoscrossmatchdeficientes,emboraeunotenhaconseguidoproduzirtaiserros.
Fixo(espero)"Tabelanocarregado"erroduranteoenviodetabelasviaSAMP.
Finalmente,apartirdestaTOPCATliberaorequeraverso1.5(aka5.0)doJavaJ2SERuntimeEnvironmentnosermais
executadoemverso1.4,queagoramuitoantiga.Eunoesperoqueestaacausarproblemasdecompatibilidadeparaqualquerum,
masestouinteressadoemsaberseessenoocaso.
Verso3.7(23Dezembro2010)
Estaversocontmalgumasmelhoriassignificativaseumasriedepequenasmelhoriasecorreesdebugs.
Dilogosdecarga:
Tabeladecargateveumagrandereformulao.Dilogosdecarganosomaismodal,ouseja,agoravocpodeinteragircomo
restodaaplicao,enquantoelesestoabertos.Istotemumnmerodevantagens:
Umacargalentanooimpededefazeroutrascoisas.
Podesercarregadovriastabelasdiferentesdeumasvez,querapartirdomesmooudediferenteslugares.
Vocpodeusarosistemadeajudaaomesmotempoumdilogodecargaaberta(dilogosdecargatmagoranoboto
AjudadecostumecomooutrasjanelasTOPCAT).
Eletambmpermitiualgumasmudanasrelacionadas:
Oprogressorelatadoparacadacargademesavocpodeverquantaslinhastmcarregadoe,seconhecido,quantos
existemnototal
Cancelarumacargaemandamentomaissimplesefuncionadeformamaisconfiveldoqueemversesanteriores
Algunsbugseidiossincrasiasrelacionadosforamcorrigidosaomesmotempo.
Consultasdoregistro:
AinterfacedepesquisaderegistrousadoemjanelasdeacessoVOsimplesemltiplasfoimelhorada:
AoespecificarumapesquisadepalavraschaveparaCone,SIAouserviosSSA,vocpodeselecionarquaiscamposde
registroderegistroparacombinar(ShortName,RG,Ttulo,Editora,assuntosetc).Issotornamuitomaisfcildeobteros
registrosquevocestinteressadopolegadas
OcampodeAssuntosagoraexibidopararegistrosrecuperados.
Aslistasderegistrosderegistro(ouseja,serviosCone,SIAouSSA)podeagoraserenviadopara/recebidasdeoutras
ferramentasviaSAMP(voresource.loadlist{,. cone,. SIAP,SSAP.}MTypes).
CoordenadasdocupodeserrecebidoapartirdeoutrasferramentasviaSAMPeusadoparadefinirCone,SIAouposio
SSA(coord.pointAt.skymtype).
BastiCargaDialogue:
UmnovodilogodecargaestdisponvelparaacessaroINAFAVEIABasti(BagofTracksestelareiscronos)Serviocdigo
contribudoporMarcoMolinaro.
AjudaBusca:
OnavegadorAjudaagoratemumguiaPesquisar,bemcomooseparadorndice,deformaquevocpodefazerbuscasdetextono
extensodocumentodeajuda.
Pequenasmelhorias:
Melhoriasdegerenciamentodearmazenamentorestrioremovidoemgrandes(>2GB)noFITSconjuntosdedadosem
algumascircunstncias.
http://127.0.0.1:2525/doc/sun253/sun253.html

202/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

FixassimFITStabelas>2Gbpodeserutilizadonomodode32bits(emboramaislentodoque64bits).
TodasasjanelastmumanovaopoderolagememseumenuArquivo.Geralmentenorecomendadousarestaopo,
umavezque,emgeral,asjanelassoorganizadasdemodoqueoredimensionamentodelesvairedimensionarpartes
sensveisdeles,maspodesertilseestiverusandoalgumasdasjanelasmaioresemumatelamuitopequeno.
FITSarquivosagoragravarnomesdetabelaemextname(epossivelmenteEXTVAR)cartesdecabealho.
Colocaodajanelaagoradevesecomportarumpoucomaiscomoasnormasdeplataforma,aoinvsdesentarnocanto
superioresquerdo.
Quandoumatabeladescartada,agoradesmarcadaapartirdequalquerseletordetabela(porexemplo,emumajanelade
plotagem,jogoouconcatenao).
SadadatabelaHTMLagoraescreveocontedodasclulasqueseparecemcomURLsemtagsdeHTML<A>.
AutorizaoBsico(http://user:pass @ host / path)emURLsdemesatratadas.
Logsversoatualeseeleestatualizadocomomaisrecentelanamentonainicializao.Estecomportamentopodeser
controladopelo[no]bandeiraCheckVersion.
TardiamenteadicionadologotipoSTFCparaSobreajanela.
Adicionarrecomendaodeusode64bitjavanaseodedicasdetabelagrande.
Correesdebugs:
CorrigirerronatabeladeresultadosdoregistroqueexibiuidentificadorderecursosemvezdeeditornacolunaPublisher.
FixSAMPmesacargabugquetropeouemcaracteres"+"emURLs.
Corrigirerroderegressov3.6carregartabelasJDBCdelinhadecomandooudeentradadetextoagorafunciona
novamente.
PonteirodearquivofixointestourobugnoFITSMultiMappedFiles.
CorrigidoumpardeerrosrelacionadoscomomodoestritoVOTable.
Possivelmentereparadoumbugnobemcaracterizadaembuscadoregistro.
Verso3.8(9demaiode2011)
TAP
UmanovacargaTAPdilogoapoiararecuperaodedadosusandoaTabelaAccessProtocol(TAP),foiintroduzido.Isto
permiteoacessodeformalivreSQLcomoaquaisquerbancosdedadosremotosexpostoscomoprotocoloTAP.
MudanasSAMP
UmhubSAMPinternaagoraporpadrocomeouquandoTOPCATiniciasenenhumhubexistenteestaparentemente
funcionando,assim,emcircunstnciasnormaisopainelSAMPnocantoinferiordireitodajaneladocontroledeveestarativoo
tempotodo.Issosignificaquevocnoprecisafazernenhumapreparaoexplcitaparasecomunicarcomoutrasaplicaes
SAMPaware.Sevocquiservoltarparaocomportamentoanterior(hubscomeouporaoexplcitadousurio),useo-nohub
bandeiranalinhadecomando.Vocpodeligaredesligarcomohub,clicandonologotipoconexodireitadopaineldeSAMP.
AbibliotecaJSAMPatualizadoparaJSAMPv1.2,quecorrigeumoudoisbugseapoiaaWebperfilexperimental,emborao
apoioPerfildaWebnoestativadoporpadro.
Outrasmelhorias
AleatriasGruposHDUsestoagoratolerada,emboranointerpretada,dentroarquivosFITS.
Adicionaropodecorrespondnciaquintuplicarajanelajogomultitable(algumpediuisso!).
Agoravocpodereativarumalinhanajaneladovisualizadordemesa,desmarcandoeentoreselecionandolo.
Expressesemseletoresdecolunaestoagoraesquerda(ecinzacolorido),emvezdeexcludonocasodeumerrode
sintaxe.
Melhorararenderizaodetextonajaneladefunesdisponveis.
DilogocargaGAVOagorausafontedetamanhofixoparaaentradaSQL.
PesquisaRegistroagoraincluicampoPublisherporpadro.
Correesdebugsesoluesalternativas
JDBCmanipuladorentradamesaagoradowncastsefetivamentetiposBigInteger/BigDecimalparaLong/Duplo.Odriver
JDBCdoPostgreSQLpareceusarosgrandestipos*rotineiramenteparavaloresnumricos(oqueeunoachoqueele
costumavafazer).
AdicionarsoluoparaJ2SEbug#4795134,oquepodecausarerrosnaleituracomprimidoarquivosFITS.
FixFITScartermanipulaobugquepoderiacausarcorrompidoarquivosFITSnasadanapresenadecaracteresno
ASCII.
Fix(alguns)JDBCvazamentosdeconexo.
Tentativademaisculaseminsculascorrespondnciaantesdemaisculaseminsculasparanomesdecoluna.
Verso3.9(27outubrode2011)
ReaesCruzadas:
OpesdejogoadicionaisassimtricasforamadicionadosjaneladoPardojogoassimcomoavelhaopoBestMatch
simtrica,agoravocpodeescolherfazerumjogoqueidentificaamelhorcombinaoparacadalinhadeumaououtra
tabeladeentrada(verlinhasdesadaSelectorBox).ElescorrespondemaencontraramelhorcorrespondncianatabelaB
paracadalinhanatabelaA,eemcamposlotados,muitasvezesfornecersemnticamaisintuitivodoqueoanteriorsimtrica
melhoropo(emcamposnoaglomeradasgeralmentenohdiferena).Estareplicaacorrespondnciarealizadapor
algumasoutrasferramentas,incluindoAladin.
NovoJogoAlgoritmos,2dcartesianaselipseseSkyelipses,foramintroduzidasparapermitiraadequaodasregies
elpticas,enoapenascirculares,emgeral,tantoplanarecucoordena.Outra,Ndcartesianocomerros,foiadicionada
http://127.0.0.1:2525/doc/sun253/sun253.html

203/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

paralidarcomerrosporobjetoemcoordenadascartesianas(anteriormenteerrosporobjetospoderiasertratadonocu
coords).
CorrigidoumerrosignificativonocuReaesCruzadas.Setodosospontosdeumatabelaforam,porumladodalinhade
RA=0,masoraiodeerroqueseestendiaatravsdalinha,corresponde,poroutroladopodeserdispensada.Jogostambm
podeserperdidasediferentestabelasusadasvriascategoriasconvencionaisparaRA(porexemplo180..180emumcaso
e0..360emoutro).Essacorreopode,emalguns,masnoamaioria,doscasosresultamemcorrespondnciamaislento
doqueanteriormente.
Semnticadocucomerrosalgoritmojogomudaramligeiramente.
Melhoriasdeusabilidadenotveis:
AgoravocpodealteraraordemdeumatabelacolunaarrastandoaslinhasparacimaeparabaixonajanelaColunas.
Funesalgbricasenvolvendongulosso,nasuamaioriadisponveisusandograus,bemcomoradianos.OCoordsclasse
foisubstitudaporCoordsDegreeseCoordsRadiansaulasfornecendocufunescoordenar,eumanovaclasse
TrigDegreesfornecefunesnormaisbaseadosemgraustrigonomtricasjuntamentecomasversesbaseadasemradianos
emMatemtica.Asfunesnasdiversasclassesdeaodeativaoagoratomargrausenoradianos.Algunsdosnomes
defunesantigasmudaramparadeixarclaroqueelesusamradianosenograus.
OArquivo|TabeladeDescarteaonaJaneladeControleagorapoderemovervriasmesasaomesmotempo,semais
deumselecionado.
ADQLanliseesintaxehighligtingfoiadicionadoaodilogocargaTAP,graasdeGrgoryManteletbibliotecaADQL.
ConsultasTAPestoagorasncronoporpadro(oSynchronouscheckboxestmarcadaporpadro).
ODilogoSQLQuery(finalmente)temumcampodeentradademultilinhaparaotextodaconsultaSQL.
AdicionarNavegadorParabotoparaajudarajanelaesteexibeapginadaAjudaatualmenteexibidoemseunavegador
normal.
NovobotomaiorcomodidadeparaDisponveljanelaFunesqueumatalhoparaexibirasintaxedeexpressono
navegadordaAjuda.
Outrasatualizaesemelhorias:
JSAMPfoiatualizadoparaaverso1.31.AprincipalmudanaqueoWebProfileagoraestativadoporpadronohub
SAMPqueTOPCATlana.HtambmmaisopesnosmenusdeHub,evaisubstituirqualquermoribundosamp.
arquivonainicializao,oquedeveeliminarirritantepersistente"404NomanipuladorparaURL"avisos.
AdicionarExcluiremExitopoparaCorrendoguiaTrabalhosdedilogocargaTAP.Jobsagorasocriadosporpadro
comoExcluirExitnosettrue(vocpodealteraropadrocomomenudeeliminao).
AgoravocpodeexecutarapartirdosJyStilts. jar Topcat-*jardamesmaformaapartirdestilts.jar.
Adicionarpropriedadesdosistemaexperimentaisstar.basicauth.userestar.basicauth.password.
Adicionadooexperimentaltopcat.exttools propriedadedosistemaparapermitirqueferramentaspersonalizadaspara
seradicionadobarradeferramentasprincipalemtempodeexecuo.
MelhoraracapacidadederesistnciadeoperaomulticonenapresenadeserviosDALfalveisouinconsistentes.
AdicionadonovasconstantesdelinguagemdeexpressoPOSITIVE_INFINITY,NEGATIVE_INFINITYeNaN.
Adicione-runningbandeiraquecarregatabelasespecificadasnalinhadecomandoemumainstnciaexistentedo
TOPCATseumjestemexecuo.
Adicionarnovajuntarfunoparamatrizesclassedecombinarelementosdamatrizemumastring.
DilogocargaTAPutilizamodificadoIDcarregamentoconformeprojectoTAPRegExtmaisrecente.Issopodecausar
algunsserviosdaTAPincorretamenteaaparecernoapoiaruploadsseelesnofizeramumaatualizaosimilar.
Correesdebugs:
Melhoroualgumasquestes(Reportagemcontagemsubconjuntodelinhaserradoeadeso)relacionadossmudanas
definiessubconjunto.
FixconeparmetrodepesquisaverbosidadeparaqueVERBO=3noerroneamenteignorado.
Corrigirerrointroduzidonov3.7relacionadorotulagemcarregadoarquivos(manipulaoepropagaodeimprprio
LOAD_SOURCEparmetrodetabela).
UmelementoPARAMrefsemreferentenumVOTablejnocausaumNullPointerExceptionnocapturada.
Corrigirumpequenobugrelacionadoaoenablednessdebotesnajaneladecontroleeconexodehub.
Trabalharemtornodeummisfeaturejavaobscurooquepoderiafazercomqueaclulaerradaparasereditadoseuma
espcieinterrompeumaedio.
Verso4.0b(28Marode2013)
TOPCATverso4incluiumareescritacompletadaplotagem(verdetalhesabaixo).Anovafuncionalidadedeplotagem,noentanto,
experimentaleasmudanaspodemserfeitasparaoGUIseguintefeedbackdousurio.Porestarazo,asjanelasdeenredoclssicos
permanecemdisponveisapartirdeseusbotesdabarradecostumeeasnovasjanelasdeplotagemsoatualmenteescondidono
Grficosmenu.O"b"designaodestaversoreconheceanaturezaexperimentaldasmudanasdevisualizao,masoutrasnovas
funcionalidadessoconsideradasestveis.
Logo:
EufinalmenteumadeusafetuosocomogrficodosdesenhosanimadosTopCatHannahBarbera.Notendoqualquerdireito
legalalgumparausarestelogominhaconscinciaacabouporlevaramelhorsobremimeTOPCATagoratemumexcelentenovo
logotipogentilmentetiradapelomeuamigoPhilHall.Aindaumgatoamarelo.
Plotagem:
Quatronovasjanelas"Camadaenredo"estodisponveisapartirdogrficodomenu:Avio,Cu,Cubeecamadaparcelas
Sphere.Estesapresentamumnovoemaispoderoso(e,sim,maiscomplicado)interfacedeusurio,eestototalmente
documentadosnoApndiceA.4.Anovafuncionalidadeinclui:
NewSkyCoordenarPlot
http://127.0.0.1:2525/doc/sun253/sun253.html

204/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Escolhadeprojeo:Sin(rotativo),Aitoff,placaCarre
Opessoequatorial,galctico,supergalactic,eclptica:Cudedadosesistemasdevisoselecionados
separadamentecoordenar
GradedecoordenadasSkyrotuladosevisvelemtodososzooms
Novasopesdeplotagemdedados
vetores
elipses(comngulodeposio)
pares,triplos,...Linhasdepontosdedados/polgonos
contornos
marcadoresdetamanhovarivel
Respostainterativamelhorada
Nasparcelas2decurodadomouseampliaemtornodaposiodocursor
Nasparcelas2dedocu,vocpodearrastaroenredoemtornode
Em3dparcelasbotodireitodomouserecentrescubonopontoselecionado
Em3dparcelaszoomdadosampliaocuboemvezdeampliaroprpriocubowireframe
Muitoscontrolessocontrolesdeslizantesqueatualizamoenredoquevocdeslize
Novosmodosdeenredoparacolorir
Densidadecdigodecoresparatodosostiposdegrficos,comomapacordensidadeemfunoquerdecorconjuntode
dadosouescolhidosapartirdeumconjuntofixo.Codificaoplano,transparenteeauxcoraindaestdisponvelcomo
antes.
Melhorsuporteparagrandesconjuntosdedados
Vriascaractersticasforamintroduzidasparafornecerumavisualizaomaissignificativadegrandesconjuntosdedados.
Melhoriatramasecontornosdedensidadesemelhantedarlhemelhoresmaneirasdeentenderparcelascontendomuitosmais
pontosdoquehpixelsparaplotarlos.Hseparadamentealgumasmelhoriasnaescalabilidade:atcercade10milhesde
pontosactualmentepossvel,dependendodisponveletcmemria,porm,dependedoquevocestfazendo.Noentanto,
esperomelhoraresselimitenofuturo.
Rotulagemeixomelhorado
Aescolhadotamanhodafonteeestilo
OpodeentradadoLaTeXparacaracteresnoASCII,etc
Entrareixosrotuladomelhor
OpocarrapatoMinor
OpesLegend
Colocaointernaouexternaposicionadamanualmente.
Plotagemfunoanalticaem2D
FunesenredodeXouYcoordenarusandoTOPCATlinguagemdeexpresso.
(Notequeestalistamudanaenredoestavafaltandoaliberaov4.0ev4.0retrospectivamenteadicionadoem1).
Outrosnovosrecursos:
UsepegadasMOCparaaceleraraspesquisasmulticone,incluindopegadaexibiodoconenajanelamulticone.
AdicionarformatodesadaIPAC.
AdicionarnovaclasseKCorrectionsparaalinguagemdeexpresso,quecontmummtododeclculodeKcorrees
seguindoomtododeChilingarianeZolotukhin.
EntradaesadaVOTablesoagorasuportadasparaaverso1.3dopadroVOTable.
AversodoformatoVOTableusadaparasadaVOTableagorapodeserselecionado,usandoapropriedadedosistema
votable.version.VersosadaVOTable1.2porpadro.SadaVOTablenoincluimaisschemaLocationatributo.
AgoravocpodefazerrefernciaatabelasemmultiextensoarquivosFITSpelonome(extnameouextnameEXTVER)
comoumaalternativaparapelondiceHDU.
Outrasmelhorias:
ADQLanalisarnajaneladoTAPpodemagoradestacartodosossmbolosdesconhecidosenoapenasumdeles.Isso
possvelcomaatualizaoparaav1.1oficialdabibliotecaADQLdeGrgoryMantelet,oquemelhoraalgunsoutros
aspectosdaADQLanlisetambm.
Adicionarnovafunohypot(=sqrt(x*x+y*y))paraaMatemticaclassenalinguagemdeexpresso.
AdicionarnovosdividirfunesparacadeiarepartioaoCordasclassenalinguagemdeexpresso.
AlgumasalteraesnotoStringfuno:agorafuncionaemvaloresnonumricos,darespostacertaparalongas
inteirosevaloresdecaractereseretornaumvalorembrancoemvezdastring"nulo"ou"NaN"paraentradasembranco.
Sexagesimalparafunesdeconversodengulonumricospermitemagoraapartesegundosdacordasexagesimalestar
faltando.
MudanasnadefiniodoformatoIPACsoacomodados:o"longo"/tipo"l",que,aparentemente,agoraoficial,jno
geraumaviso,eoscabealhosagorapodemusarsinaisdemenos,emvezdeespaosembranco.
FixaSAMPcargasdemesaparahonrar"nome"parmetro.
PNGsadagrficanotemfundotransparente.
AtualizebibliotecaJSAMPaverso1.33.
Trabalharemtornodemudananasadavizirparaquevizircatlogobuscafuncionanovamente.Estapodeseruma
mudanatemporria.
AtualizeURLsparaoserviodebancodedadosGAVOdoMilnio,apedidodeGerardLemson.
http://127.0.0.1:2525/doc/sun253/sun253.html

205/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

AdicionarnovaclassedecoberturaparaalinguagemdeexpressoquecontmfunesrelacionadascomoMOC
(atualmente,apenasinMoc).
AdicionarseoexplicativaaomanualsobreJogosMultiobjeto.
Adicione-debugflagparagerenciarmensagensdelogmelhor.
Correesdebugs:
Corrigirerrograveedelongadata(cabealhoTZeroruim,fazcomqueasleiturassubsequentesafalhar)paraFITSsadade
colunasdematrizbooleanos.
Fixpequeno,masgenunobugcucorrespondente.Oefeitofoiquepertodosploscorrespondepertodolimite
especificadopoderiaserdesperdiada.ObugestavanabibliotecaPixTools,fixadanolanamento20120728.
FixbugquefalhouaotentarlerarquivosFITScomcolunasdematrizcomplexos(TFORMn = RC / RM).
Corrigirafalhaaocarregartabelasmuitograndesseqenciais.
Concatenaodetabelafixaparaquetamanhodematrizcolunatipodedadosetcconsistentecomasduastabelasde
entradanoapenasoprimeiro.
AjusteescritorSQLparaevitartipodeerroparaMySQL.
Fixplotagembugquepodetercausadofalhasmisteriosasparaatualizaratrama.Outalvezno.
FixADQLanalisarnajanelaTAPparaqueastabelasTAP_UPLOADsotratadoscorretamente.
FixbugquepoderiacausarotruncamentodascordasemFITSepossivelmentesadaVOTablequandoastabelasforam
moeditadoparaadicionarcadeiasmaislongasdoqueocomprimentopreviamentedeclarado.
Corrigidooerroemjogosmultimesa(>2mesas),quepoderesultaremlinhasdesadacomcolunasapartirdeapenasuma
nicatabela,ouseja,norepresentaumjogointermesa.
CorrigirerronaformataosexagesimalHMS:sinaldemenosfoiomitidaapartirdengulosnegativos.Agora,asada
foradapositiva.
Fixpequenobugassociadoaoexcluirosubconjuntolinhaatual(esteagorafaztudoparasetornaratual).
Lidecom1colunaarquivosCSV.
Fix(alguns,emboraprovavelmentenotodos)possvelbug(s)relacionadaexecuoemJava1.7noMac.
Useascorretasformam"linhas"/"bytes"emvezde"linha"/"byte"paravaloresunitrioscapacidadeTAP.
ValoresdepontoflutuanteinfinitosagorasocorretamentecodificadosemsadaVOTable("+ Inf"/"-Inf",no"
Infinito"/"-Infinity",comonasversesanteriores).
CorrigidoalgunsproblemasdelayoutquepoderialevaracamposdeentradadetextodelargurazeroparaRA/Dec.
Corrigidooerroaotentarexplodirumacolunaconjuntoescondido.
Fixbarradeerroderenderizaobugquepoderiaresultaremlinhasdiagonaissendocompensados
pertodabordade

parcelas.
CorrigirproblemacomGUItravandoaoplotarhistogramasdescomunais.
CorrigidooerronalinhadeenredoempilhadosquecausoudesenhoscribblynapresenadenulosvaloresdoeixoX.
Corrigidooproblemacommensagensdedestaquedalinhasaltandoparasempreentreasaplicaes,quandoaaode
ativaodetransmissoRowestemuso.
Melhorarocomportamentoaoexcluirumparmetronajaneladeparmetros.
Verso4,01(1deJulhode2013)
Novafuncionalidade
AdicionarsuportesomenteleituraparaCDF(NASACommonDataFormat)arquivos.Atualmente,nofeitaqualquer
tentativadeapresentarosvaloresdetemposemelhantedeumaformaamigvelhumano,masissopodemelhoraremuma
versofutura.OSAMPtable.load.cdfmtypetambmsuportadoparareceberarquivosCDF.
MelhoraramanipulaodeHTTPautorizaobsico.401SHTTPagoraaparecerumajaneladedilogodeusurio/senha,
amenosqueostar.basicauth. *propriedadesdosistemaforamcriadas.
Adicionaropesparacalcularo(escaladoousemescala)DesvioMedianaAbsolutanajanelaEstatsticas.
Pequenasmelhorias
AgorasubscreveSAMPvoresource.loadlist.tapmtype,aceitandolistaderecursosnaTAPdilogocargaguia"Select
Service".
AjanelaColunasagorafazumamelhortentativadeexibionopadrodemetadadosporcolunadetiposincomuns,em
especialosvaloresdamatriz.
PlotagemLinhamelhorouemparcelascamada(incluindomelhorarrojado,novasopoantialias).
Correesimplementadasparareduzirachancedeusurios,inadvertidamente,sobrecarregandoosserviosCone/SIA/
SSAexternoscomconsultasmulticonelike.Primeiro,corrigiloparaqueasconsultasabandonadosestodevidamente
encerrado,emvezdecontinuarabateroservidorataconclusooudesligamentoJVM.Emsegundolugar,implementar
umvalorrazovelmximopadroparaoparalelismocamponomulticone(etc)painel(emboraissopossaserajustadocom
umapropriedadedosistema).
Ocdigofonteagorageridopelogitenosubverso.Oformatodastring"revisoStarjava"relatadopelaversode
bandeiraeaAjuda|Sobreoitemdemenumudounessesentido.
Correesdebugs
CorrigirerroderegressoCSVintroduzidonov4.0barquivosCSVagoratrabalharnovamentecomquebrasdelinha
MSDOSestilo.
ExemploTAPconsultaagoramesacitaoecolunanomes,quandonecessrio.Issocorrigeumbugquefoiparticularmente
evidentecomoserviovizirTAPparaaqualquasetodososnomesdetabelasnosoidentificadoresADQLlegais.
CitandoocomportamentomudouaogerarSQLparaescreverastabelasRDBMS.Issodevereduzirosproblemas
relacionadoscomidentificadorescasomisto.Noentanto,possvelqueissopoderialevaranovasanomaliasimprevistas.
Fixbugcomaleituradearquivosdesessocontendotabelas1coluna.
http://127.0.0.1:2525/doc/sun253/sun253.html

206/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

FixaFITSsadabugquepoderiaresultaremmalformadoscartesdeencabeamentocomvalordeseqnciadecaracteres
(semcotaodefechamento).
Desligueotimizaoenredocamadaquepoderesultaremperdadeprecisoparavaloresdeduplas.
Fixcamadaenredobugquequebrouoenredoseambasasalasdeumcontroledeslizantegamaforamarrastadosparaa
mesmaposio.
FixaloparaesseeixodatramadacamadavariamconfiguraessorepostasquandoobotoRescaleusado.
Corrigidoumbugquecausouumaexceoquandoumatabelaemumatramacamadafoiexcludadoaplicativo.
Corrigidoumbugquandoozoomsadaapartirdeumenredocu.
Verso4.1(7deMarode2014)
Nestaverso,asnovasjanelasdeplotagemaparecempelaprimeiraveznabarradeferramentasJaneladecontroloprincipal,ejnoso
consideradosexperimentais.Houvemuitasmudanasnasuainterfacedeusurioefuncionalidadedesdealtimaverso.Asvelhas
janelasdeplotagemaindaestodisponveisapartirdajaneladecontroleGrficosmenu,masagorasoconsideradosumtantoobsoleto,
enovaiserdesenvolvidooufixomais.
Mudanasdenavegaoparaasnovasjanelasdeplotagem:
Nasparcelas2d,botodireitodomousearraste(ouctrlarrastar)fazumzoomanisotrpica2dvocpodeesticarou
espremeroenredoemambasasdirees.
Em3Dparcelas,botodireitodomousearraste(ouctrlarrastar)fazumzoomanisotrpica2daolongodosdoiseixosmais
defrente.
Em3Dparcelas,botodomeioarrastar(ouShiftarrastar)deslizaoenredoaolongodosdoiseixosmaisdefrente.
Nasparcelas2d,asaespan/zoom(roda,panarrastar,zoomarrastar)podeserfeitoforadaparcelaaafectarapenasum
eixo.
Amaioriadasaesdenavegaodomouseagoramostramfeedbackvisualnatela.
UmanovaguiadenavegaoadicionadaaoscontrolesdoEixo.Istopermitelheconfiguraraeszoom/pan,por
exemplo,aseleodefatordezoomeopesdezoomX/Y/XYparaquandoarodadomouseusado.
Umpaineldedicasadicionadaabaixodatrama,mostrandoaesatuaisdenavegaodomouse.
Removidozoomin/outbotesnabarradeferramentasdasjanelasdatramadacamadahmelhoresformasparaampliar.
OutrasmudanasparaonovoWindowsplotagem:
TipoHistogramaenredoacrescentou.Voctambmpodeadicionarhistogramasparaumplotnormalavio,sevocquiser.
JanelasCamadatramaagoratemumabarradeprogressonaparteinferiorparaocarregamentodedadose,opcionalmente,
paraoutrasoperaespotencialmentelentoscomoreplotting,identificandoumponto,pontosdeviragemblobselecionado
emumsubconjuntoetc
Paralotesmuitograndes/lentas,parcelasintermediriassubamostradassoopcionalmenteexibidoduranteopan/zoom
paramelhoraracapacidadederesposta.
Botesdabarradeferramentasreorganizadososbotesparaadicionareremovercontrolesdecamadaestoagoranopainel
decontroledacamadanoabarradeferramentasdajaneladeplotagemprincipal.
Quandoumcrossmatchparconcludacomxito,vocteraopodeplotarosresultados,quemostraexatamentecomoos
jogoslocalizadosrelacionamcomasposiesdeentrada(paresdepontosplotados).
Rtulodetextotraandoagoraaglomerandoopesdeconfigurao:deacordocomaconfigurao,rtulosdetextoso
apenasempatadasenohtambmmuitosjuntos.
Novasopesdeconfiguraodecoresdegradeeumaetiquetaparaavioecuparcelas.
Maismapasdecoracrescentou.
OpoAntialiasingadicionadoparaalinhadegradeedesenhodaetiqueta.
Novomododesombreamentotransparnciaautomtica.
Adicioneumpoucodepreenchimentoaoredordoslimitesdolotedeautodistncia.
Alterartabelaemumenredoagoratentamanterosvaloresdascoordenadasseelesaindafazemsentido.
RotulagemcarrapatoEixomelhorado,inclusiveevitandosobreposiodertulosdecarrapatos.
Skyenredonovamentevariandomelhorado:definidosagorarefaixasamenosqueobotodebloqueiodefinidonovos
dados.
SeletorClipeadicionadoparamapasdedensidadeecoraux,oquesignificaqueagoravocpodeusarapenasumapartede
ummapadecores,dandolhemuitomaiscontrolesobrecolorao.
FormataoposioSkytramaagorahomenageiadefiniosexagesimal.
Algumaspequenasmelhoriassegmentao/desempenho.
TempoExperimentaltipodegrficoacrescentou.Estetipodegrficoconsideradoexperimentaleaparecenomenude
grficos,masnoatualmentenabarradeferramentasprincipal.Podetraarsriestemporaiseespectrogramas.Podeser
melhoradoemfuturasverses.
Ocontroleparatraarparesdepontosfuncionadeformadiferente(agoratemseuprpriocontroledecamadanoapenas
umformulrio).Oformulriodetripleponto(quenofuncionoucorretamente)retiradoporenquanto.
Outrasmelhorias:
UmanovamensagemexperimentalSAMPtable.get.stilsuportado,permitindoqueosclientesSAMPpararecuperar
tabelasdeTOPCAT.
CamposdoseletordeURLnajaneladeAodeativaoestoagoraeditvel.
Adicionaralgoritmojogocubideparacoincidircomjanelas.
OcombinadorExactagoraconsideravaloresnumricosescalaresiguaisseelestmomesmovalornumricoelesnoso
maisobrigadosateromesmotipo.
Itensdemetadadoscomvalordematrizporcolunasagorasoexibidoscorretamente.
OtoStringfunoagoratrabalhaparabyteevaloresbooleanos,bemcomooutrostiposdedados.
Substituao(poucoperigoso,tambmemsituaoirregular)AplicaropoSubconjuntonajaneladovisualizadordemesa
comumanovaopoHighlightsubconjunto.TambmadicionarumanovaopoSubconjuntoDestaquenajanela

http://127.0.0.1:2525/doc/sun253/sun253.html

207/208

21/4/2014

TOPCAT - Ferramenta para operaes em catlogos e tabelas

Subconjuntos.
Nohistogramaenredodeestiloantigo,exportandooagoraoferececontagenscumulativasseohistogramavisvelestem
modocumulativo.
Ofocodotecladomaisproveitosamenteposicionadoporpadroemalgumasjanelasdedilogo(quecomeanoprimeiro
campodetexto).
Correesdebugsetc:
Corrigirumbugrelacionadoaoacessoaoregistronamespaces.AgorafinalmentepossvelconsultaroregistroSTScI/
NVO/VAO,bemcomoosregistrosAstroGrideEuroVO,apartirdasjanelasVOCone/SIA/SSA/TAP.Consultasao
registoSTScInoforamtrabalhardesdemeadosde2010,comoconseqnciadeerrosem(principalmente)ocliente
TOPCATe(parcialmente)oservioderegistroSTScI.
ContornarbugnoMacOSrenderizaodetextoemparcelasquepintadastextonadireoerradaquandonohorizontais
(porexemplo,cartasindoparatrsaoexecutarverticalmente).Asoluoenvolveafaltadetextosuavizadoaodesenhar
gradeseixosparaMacOS.,Bemcomoobterotextodamaneiracertarodadaestepareceumpoucomaisagradvel,mas
tambmperceptivelmentemaislento.Seavelocidademaisimportantedoqueacorreovocpodedesliglousandoo
AntialiascaixadeseleonaMachadosGradeguiasdasvriasjanelasdeplotagem.
RetirarrtulosguianatramaSphere,umavezquenofiznada.
Renomeieoarquivodemenunamaioriadasjanelasdejanela,oquemuitomaisapropriado.
Corrigirerroaoconcatenartabelascujasclulasdadospodemtersidoeditadomanualmente.
Fixbugseleodeservio(NullPointerException)noWindowsmultiSIA/SSA.
Fixbugqueimpediaoacessoaoselementosdoarrayinteirolongodelinguagemdeexpresso.
CorrigirerronajaneladeEstatsticasparaqueascolunasbooleanasreportarcorretamenteosvaloresmdios(true+
proporo/false).
FixmanipuladorentradaTSTTSTassimarquivoscommenosde3colunaspodeserlido.
Atualizeparaaverso1.34JSAMP(hubsuportaagoraosclientesdaWebcomhttpsURLs).
Movidotextodocumentaotable.load.cdfetable.load.stilSAMPMTypesdaseodetransmisso(errado)para
aseoderecepo(direita)destedocumento.
PequenasmelhoriasaosuporteCDF.
Corrigiralgunsproblemasdeencadeamentodatrama.
Acontagemdepontosrelatoumelhoraemparcelas.
MelhormanipulaodeOutOfMemoryErrorsduranteaplotagem.
MelhormanipulaodeerrosnamarcaoLaTeXeixo.
TOPCATFerramentaparaoperaesemcatlogosetabelas
StarlinkusurioNote253
pginawebTOPCAT:http://www.starlink.ac.uk/topcat/
Autoremail:mbtaylor@bristol.ac.uk
listadediscusso:topcatuser@bristol.ac.uk

http://127.0.0.1:2525/doc/sun253/sun253.html

208/208

S-ar putea să vă placă și